We recommend new projects start with resources from the AWS provider.
aws-native.kendra.getIndex
Explore with Pulumi AI
We recommend new projects start with resources from the AWS provider.
A Kendra index
Using getIndex
Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.
function getIndex(args: GetIndexArgs, opts?: InvokeOptions): Promise<GetIndexResult>
function getIndexOutput(args: GetIndexOutputArgs, opts?: InvokeOptions): Output<GetIndexResult>
def get_index(id: Optional[str] = None,
opts: Optional[InvokeOptions] = None) -> GetIndexResult
def get_index_output(id: Optional[pulumi.Input[str]] = None,
opts: Optional[InvokeOptions] = None) -> Output[GetIndexResult]
func LookupIndex(ctx *Context, args *LookupIndexArgs, opts ...InvokeOption) (*LookupIndexResult, error)
func LookupIndexOutput(ctx *Context, args *LookupIndexOutputArgs, opts ...InvokeOption) LookupIndexResultOutput
> Note: This function is named LookupIndex
in the Go SDK.
public static class GetIndex
{
public static Task<GetIndexResult> InvokeAsync(GetIndexArgs args, InvokeOptions? opts = null)
public static Output<GetIndexResult> Invoke(GetIndexInvokeArgs args, InvokeOptions? opts = null)
}
public static CompletableFuture<GetIndexResult> getIndex(GetIndexArgs args, InvokeOptions options)
// Output-based functions aren't available in Java yet
fn::invoke:
function: aws-native:kendra:getIndex
arguments:
# arguments dictionary
The following arguments are supported:
- Id string
- The identifier for the index. For example:
f4aeaa10-8056-4b2c-a343-522ca0f41234
.
- Id string
- The identifier for the index. For example:
f4aeaa10-8056-4b2c-a343-522ca0f41234
.
- id String
- The identifier for the index. For example:
f4aeaa10-8056-4b2c-a343-522ca0f41234
.
- id string
- The identifier for the index. For example:
f4aeaa10-8056-4b2c-a343-522ca0f41234
.
- id str
- The identifier for the index. For example:
f4aeaa10-8056-4b2c-a343-522ca0f41234
.
- id String
- The identifier for the index. For example:
f4aeaa10-8056-4b2c-a343-522ca0f41234
.
getIndex Result
The following output properties are available:
- Arn string
- The Amazon Resource Name (ARN) of the index. For example:
arn:aws:kendra:us-west-2:111122223333:index/0123456789abcdef
. - Capacity
Units Pulumi.Aws Native. Kendra. Outputs. Index Capacity Units Configuration - Capacity units
- Description string
- A description for the index
- Document
Metadata List<Pulumi.Configurations Aws Native. Kendra. Outputs. Index Document Metadata Configuration> - Document metadata configurations
- Id string
- The identifier for the index. For example:
f4aeaa10-8056-4b2c-a343-522ca0f41234
. - Name string
- The name of the index.
- Role
Arn string - An IAM role that gives Amazon Kendra permissions to access your Amazon CloudWatch logs and metrics. This is also the role used when you use the BatchPutDocument operation to index documents from an Amazon S3 bucket.
- List<Pulumi.
Aws Native. Outputs. Tag> - Tags for labeling the index
- User
Context Pulumi.Policy Aws Native. Kendra. Index User Context Policy The user context policy.
ATTRIBUTE_FILTER
- All indexed content is searchable and displayable for all users. If you want to filter search results on user context, you can use the attribute filters of
_user_id
and_group_ids
or you can provide user and group information inUserContext
.
USER_TOKEN
- Enables token-based user access control to filter search results on user context. All documents with no access control and all documents accessible to the user will be searchable and displayable.
- All indexed content is searchable and displayable for all users. If you want to filter search results on user context, you can use the attribute filters of
- User
Token List<Pulumi.Configurations Aws Native. Kendra. Outputs. Index User Token Configuration> - Defines the type of user token used for the index.
- Arn string
- The Amazon Resource Name (ARN) of the index. For example:
arn:aws:kendra:us-west-2:111122223333:index/0123456789abcdef
. - Capacity
Units IndexCapacity Units Configuration - Capacity units
- Description string
- A description for the index
- Document
Metadata []IndexConfigurations Document Metadata Configuration - Document metadata configurations
- Id string
- The identifier for the index. For example:
f4aeaa10-8056-4b2c-a343-522ca0f41234
. - Name string
- The name of the index.
- Role
Arn string - An IAM role that gives Amazon Kendra permissions to access your Amazon CloudWatch logs and metrics. This is also the role used when you use the BatchPutDocument operation to index documents from an Amazon S3 bucket.
- Tag
- Tags for labeling the index
- User
Context IndexPolicy User Context Policy The user context policy.
ATTRIBUTE_FILTER
- All indexed content is searchable and displayable for all users. If you want to filter search results on user context, you can use the attribute filters of
_user_id
and_group_ids
or you can provide user and group information inUserContext
.
USER_TOKEN
- Enables token-based user access control to filter search results on user context. All documents with no access control and all documents accessible to the user will be searchable and displayable.
- All indexed content is searchable and displayable for all users. If you want to filter search results on user context, you can use the attribute filters of
- User
Token []IndexConfigurations User Token Configuration - Defines the type of user token used for the index.
- arn String
- The Amazon Resource Name (ARN) of the index. For example:
arn:aws:kendra:us-west-2:111122223333:index/0123456789abcdef
. - capacity
Units IndexCapacity Units Configuration - Capacity units
- description String
- A description for the index
- document
Metadata List<IndexConfigurations Document Metadata Configuration> - Document metadata configurations
- id String
- The identifier for the index. For example:
f4aeaa10-8056-4b2c-a343-522ca0f41234
. - name String
- The name of the index.
- role
Arn String - An IAM role that gives Amazon Kendra permissions to access your Amazon CloudWatch logs and metrics. This is also the role used when you use the BatchPutDocument operation to index documents from an Amazon S3 bucket.
- List<Tag>
- Tags for labeling the index
- user
Context IndexPolicy User Context Policy The user context policy.
ATTRIBUTE_FILTER
- All indexed content is searchable and displayable for all users. If you want to filter search results on user context, you can use the attribute filters of
_user_id
and_group_ids
or you can provide user and group information inUserContext
.
USER_TOKEN
- Enables token-based user access control to filter search results on user context. All documents with no access control and all documents accessible to the user will be searchable and displayable.
- All indexed content is searchable and displayable for all users. If you want to filter search results on user context, you can use the attribute filters of
- user
Token List<IndexConfigurations User Token Configuration> - Defines the type of user token used for the index.
- arn string
- The Amazon Resource Name (ARN) of the index. For example:
arn:aws:kendra:us-west-2:111122223333:index/0123456789abcdef
. - capacity
Units IndexCapacity Units Configuration - Capacity units
- description string
- A description for the index
- document
Metadata IndexConfigurations Document Metadata Configuration[] - Document metadata configurations
- id string
- The identifier for the index. For example:
f4aeaa10-8056-4b2c-a343-522ca0f41234
. - name string
- The name of the index.
- role
Arn string - An IAM role that gives Amazon Kendra permissions to access your Amazon CloudWatch logs and metrics. This is also the role used when you use the BatchPutDocument operation to index documents from an Amazon S3 bucket.
- Tag[]
- Tags for labeling the index
- user
Context IndexPolicy User Context Policy The user context policy.
ATTRIBUTE_FILTER
- All indexed content is searchable and displayable for all users. If you want to filter search results on user context, you can use the attribute filters of
_user_id
and_group_ids
or you can provide user and group information inUserContext
.
USER_TOKEN
- Enables token-based user access control to filter search results on user context. All documents with no access control and all documents accessible to the user will be searchable and displayable.
- All indexed content is searchable and displayable for all users. If you want to filter search results on user context, you can use the attribute filters of
- user
Token IndexConfigurations User Token Configuration[] - Defines the type of user token used for the index.
- arn str
- The Amazon Resource Name (ARN) of the index. For example:
arn:aws:kendra:us-west-2:111122223333:index/0123456789abcdef
. - capacity_
units IndexCapacity Units Configuration - Capacity units
- description str
- A description for the index
- document_
metadata_ Sequence[Indexconfigurations Document Metadata Configuration] - Document metadata configurations
- id str
- The identifier for the index. For example:
f4aeaa10-8056-4b2c-a343-522ca0f41234
. - name str
- The name of the index.
- role_
arn str - An IAM role that gives Amazon Kendra permissions to access your Amazon CloudWatch logs and metrics. This is also the role used when you use the BatchPutDocument operation to index documents from an Amazon S3 bucket.
- Sequence[root_Tag]
- Tags for labeling the index
- user_
context_ Indexpolicy User Context Policy The user context policy.
ATTRIBUTE_FILTER
- All indexed content is searchable and displayable for all users. If you want to filter search results on user context, you can use the attribute filters of
_user_id
and_group_ids
or you can provide user and group information inUserContext
.
USER_TOKEN
- Enables token-based user access control to filter search results on user context. All documents with no access control and all documents accessible to the user will be searchable and displayable.
- All indexed content is searchable and displayable for all users. If you want to filter search results on user context, you can use the attribute filters of
- user_
token_ Sequence[Indexconfigurations User Token Configuration] - Defines the type of user token used for the index.
- arn String
- The Amazon Resource Name (ARN) of the index. For example:
arn:aws:kendra:us-west-2:111122223333:index/0123456789abcdef
. - capacity
Units Property Map - Capacity units
- description String
- A description for the index
- document
Metadata List<Property Map>Configurations - Document metadata configurations
- id String
- The identifier for the index. For example:
f4aeaa10-8056-4b2c-a343-522ca0f41234
. - name String
- The name of the index.
- role
Arn String - An IAM role that gives Amazon Kendra permissions to access your Amazon CloudWatch logs and metrics. This is also the role used when you use the BatchPutDocument operation to index documents from an Amazon S3 bucket.
- List<Property Map>
- Tags for labeling the index
- user
Context "ATTRIBUTE_FILTER" | "USER_TOKEN"Policy The user context policy.
ATTRIBUTE_FILTER
- All indexed content is searchable and displayable for all users. If you want to filter search results on user context, you can use the attribute filters of
_user_id
and_group_ids
or you can provide user and group information inUserContext
.
USER_TOKEN
- Enables token-based user access control to filter search results on user context. All documents with no access control and all documents accessible to the user will be searchable and displayable.
- All indexed content is searchable and displayable for all users. If you want to filter search results on user context, you can use the attribute filters of
- user
Token List<Property Map>Configurations - Defines the type of user token used for the index.
Supporting Types
IndexCapacityUnitsConfiguration
- Query
Capacity intUnits The amount of extra query capacity for an index and GetQuerySuggestions capacity.
A single extra capacity unit for an index provides 0.1 queries per second or approximately 8,000 queries per day. You can add up to 100 extra capacity units.
GetQuerySuggestions
capacity is five times the provisioned query capacity for an index, or the base capacity of 2.5 calls per second, whichever is higher. For example, the base capacity for an index is 0.1 queries per second, andGetQuerySuggestions
capacity has a base of 2.5 calls per second. If you add another 0.1 queries per second to total 0.2 queries per second for an index, theGetQuerySuggestions
capacity is 2.5 calls per second (higher than five times 0.2 queries per second).- Storage
Capacity intUnits - The amount of extra storage capacity for an index. A single capacity unit provides 30 GB of storage space or 100,000 documents, whichever is reached first. You can add up to 100 extra capacity units.
- Query
Capacity intUnits The amount of extra query capacity for an index and GetQuerySuggestions capacity.
A single extra capacity unit for an index provides 0.1 queries per second or approximately 8,000 queries per day. You can add up to 100 extra capacity units.
GetQuerySuggestions
capacity is five times the provisioned query capacity for an index, or the base capacity of 2.5 calls per second, whichever is higher. For example, the base capacity for an index is 0.1 queries per second, andGetQuerySuggestions
capacity has a base of 2.5 calls per second. If you add another 0.1 queries per second to total 0.2 queries per second for an index, theGetQuerySuggestions
capacity is 2.5 calls per second (higher than five times 0.2 queries per second).- Storage
Capacity intUnits - The amount of extra storage capacity for an index. A single capacity unit provides 30 GB of storage space or 100,000 documents, whichever is reached first. You can add up to 100 extra capacity units.
- query
Capacity IntegerUnits The amount of extra query capacity for an index and GetQuerySuggestions capacity.
A single extra capacity unit for an index provides 0.1 queries per second or approximately 8,000 queries per day. You can add up to 100 extra capacity units.
GetQuerySuggestions
capacity is five times the provisioned query capacity for an index, or the base capacity of 2.5 calls per second, whichever is higher. For example, the base capacity for an index is 0.1 queries per second, andGetQuerySuggestions
capacity has a base of 2.5 calls per second. If you add another 0.1 queries per second to total 0.2 queries per second for an index, theGetQuerySuggestions
capacity is 2.5 calls per second (higher than five times 0.2 queries per second).- storage
Capacity IntegerUnits - The amount of extra storage capacity for an index. A single capacity unit provides 30 GB of storage space or 100,000 documents, whichever is reached first. You can add up to 100 extra capacity units.
- query
Capacity numberUnits The amount of extra query capacity for an index and GetQuerySuggestions capacity.
A single extra capacity unit for an index provides 0.1 queries per second or approximately 8,000 queries per day. You can add up to 100 extra capacity units.
GetQuerySuggestions
capacity is five times the provisioned query capacity for an index, or the base capacity of 2.5 calls per second, whichever is higher. For example, the base capacity for an index is 0.1 queries per second, andGetQuerySuggestions
capacity has a base of 2.5 calls per second. If you add another 0.1 queries per second to total 0.2 queries per second for an index, theGetQuerySuggestions
capacity is 2.5 calls per second (higher than five times 0.2 queries per second).- storage
Capacity numberUnits - The amount of extra storage capacity for an index. A single capacity unit provides 30 GB of storage space or 100,000 documents, whichever is reached first. You can add up to 100 extra capacity units.
- query_
capacity_ intunits The amount of extra query capacity for an index and GetQuerySuggestions capacity.
A single extra capacity unit for an index provides 0.1 queries per second or approximately 8,000 queries per day. You can add up to 100 extra capacity units.
GetQuerySuggestions
capacity is five times the provisioned query capacity for an index, or the base capacity of 2.5 calls per second, whichever is higher. For example, the base capacity for an index is 0.1 queries per second, andGetQuerySuggestions
capacity has a base of 2.5 calls per second. If you add another 0.1 queries per second to total 0.2 queries per second for an index, theGetQuerySuggestions
capacity is 2.5 calls per second (higher than five times 0.2 queries per second).- storage_
capacity_ intunits - The amount of extra storage capacity for an index. A single capacity unit provides 30 GB of storage space or 100,000 documents, whichever is reached first. You can add up to 100 extra capacity units.
- query
Capacity NumberUnits The amount of extra query capacity for an index and GetQuerySuggestions capacity.
A single extra capacity unit for an index provides 0.1 queries per second or approximately 8,000 queries per day. You can add up to 100 extra capacity units.
GetQuerySuggestions
capacity is five times the provisioned query capacity for an index, or the base capacity of 2.5 calls per second, whichever is higher. For example, the base capacity for an index is 0.1 queries per second, andGetQuerySuggestions
capacity has a base of 2.5 calls per second. If you add another 0.1 queries per second to total 0.2 queries per second for an index, theGetQuerySuggestions
capacity is 2.5 calls per second (higher than five times 0.2 queries per second).- storage
Capacity NumberUnits - The amount of extra storage capacity for an index. A single capacity unit provides 30 GB of storage space or 100,000 documents, whichever is reached first. You can add up to 100 extra capacity units.
IndexDocumentAttributeValueType
IndexDocumentMetadataConfiguration
IndexJsonTokenTypeConfiguration
- Group
Attribute stringField - User
Name stringAttribute Field
- Group
Attribute stringField - User
Name stringAttribute Field
- group
Attribute StringField - user
Name StringAttribute Field
- group
Attribute stringField - user
Name stringAttribute Field
- group
Attribute StringField - user
Name StringAttribute Field
IndexJwtTokenTypeConfiguration
- Key
Location Pulumi.Aws Native. Kendra. Index Key Location - Claim
Regex string - Group
Attribute stringField - Issuer string
- Secret
Manager stringArn - Url string
- User
Name stringAttribute Field
- Key
Location IndexKey Location - Claim
Regex string - Group
Attribute stringField - Issuer string
- Secret
Manager stringArn - Url string
- User
Name stringAttribute Field
- key
Location IndexKey Location - claim
Regex String - group
Attribute StringField - issuer String
- secret
Manager StringArn - url String
- user
Name StringAttribute Field
- key
Location IndexKey Location - claim
Regex string - group
Attribute stringField - issuer string
- secret
Manager stringArn - url string
- user
Name stringAttribute Field
- key
Location "URL" | "SECRET_MANAGER" - claim
Regex String - group
Attribute StringField - issuer String
- secret
Manager StringArn - url String
- user
Name StringAttribute Field
IndexKeyLocation
IndexOrder
IndexRelevance
- duration String
- freshness Boolean
- importance Integer
- rank
Order IndexOrder - value
Importance List<IndexItems Value Importance Item>
- duration string
- freshness boolean
- importance number
- rank
Order IndexOrder - value
Importance IndexItems Value Importance Item[]
IndexSearch
- Displayable bool
- Facetable bool
- Searchable bool
- Sortable bool
- Displayable bool
- Facetable bool
- Searchable bool
- Sortable bool
- displayable Boolean
- facetable Boolean
- searchable Boolean
- sortable Boolean
- displayable boolean
- facetable boolean
- searchable boolean
- sortable boolean
- displayable bool
- facetable bool
- searchable bool
- sortable bool
- displayable Boolean
- facetable Boolean
- searchable Boolean
- sortable Boolean
IndexUserContextPolicy
IndexUserTokenConfiguration
IndexValueImportanceItem
Tag
Package Details
- Repository
- AWS Native pulumi/pulumi-aws-native
- License
- Apache-2.0
We recommend new projects start with resources from the AWS provider.