Module Awso_kendra.ValuesSource

Sourceval service : Awso.Service.t
Sourceval apiVersion : string
Sourceval endpointPrefix : string
Sourceval serviceFullName : string
Sourceval signatureVersion : string
Sourceval protocol : string
Sourceval globalEndpoint : string
Sourceval serviceAbbreviation : string
Sourceval targetPrefix : string
Sourceval simple_to_json : ('a -> Awso__Botodata.value) -> 'a -> Yojson.Safe.t
Sourceval composed_to_json : ('a -> Awso__Botodata.value) -> 'a -> Yojson.Safe.t
Sourceval to_query : ('a -> Awso.Client.Query.value) -> 'a -> Awso.Client.Query.t
Sourceval structure_to_value_aux : ('a * 'b option) list -> f:(('a * 'b) list -> 'c) -> [> `Structure of 'c ]
Sourceval structure_to_value : ('a * 'b option) list -> [> `Structure of ('a * 'b) list ]
Sourceval structure_to_wrapped_value : wrapper:'a -> response:'a -> ('b * 'c option) list -> [> `Structure of ('a * [> `Structure of ('b * 'c) list ]) list ]

Summary information on an access control configuration that you created for your documents in an index.

Sourcemodule S3ObjectKey : sig ... end

Access Control List files for the documents in a data source. For the format of the file, see Access control for S3 data sources.

Sourcemodule ErrorMessage : sig ... end
Sourcemodule AccessDeniedException : sig ... end

You don't have sufficient access to perform this action. Please ensure you have the required permission policies and user accounts and try again.

Sourcemodule ColumnName : sig ... end
Sourcemodule AclConfiguration : sig ... end

Provides information about the column that should be used for filtering the query response by groups.

Sourcemodule String_ : sig ... end
Sourcemodule Integer : sig ... end
Sourcemodule HighlightType : sig ... end
Sourcemodule Boolean : sig ... end
Sourcemodule Highlight : sig ... end

Provides information that you can use to highlight a search result so that your users can quickly identify terms in the response.

Sourcemodule HighlightList : sig ... end
Sourcemodule TextWithHighlights : sig ... end

Provides text and information about where to highlight the text.

An attribute returned with a document from a search.

Sourcemodule AdditionalResultAttribute : sig ... end

An attribute returned from an index query.

Sourcemodule SiteUrl : sig ... end
Sourcemodule SiteId : sig ... end
Sourcemodule SecretArn : sig ... end
Sourcemodule S3BucketName : sig ... end
Sourcemodule S3Path : sig ... end

Information required to find a specific file in an Amazon S3 bucket.

Sourcemodule AlfrescoEntity : sig ... end
Sourcemodule EntityFilter : sig ... end
Sourcemodule SubnetId : sig ... end
Sourcemodule SubnetIdList : sig ... end
Sourcemodule VpcSecurityGroupId : sig ... end
Sourcemodule SecurityGroupIdList : sig ... end

Provides the configuration information to connect to an Amazon VPC.

Sourcemodule IndexFieldName : sig ... end
Sourcemodule DataSourceFieldName : sig ... end
Sourcemodule DataSourceDateFieldFormat : sig ... end

Maps attributes or field names of the documents synced from the data source to Amazon Kendra index field names. You can set up field mappings for each data source when calling CreateDataSource or UpdateDataSource API. To create custom fields, use the UpdateIndex API to first create an index field and then map to the data source field. For more information, see Mapping data source fields.

Sourcemodule AlfrescoConfiguration : sig ... end

Provides the configuration information to connect to Alfresco as your data source. Support for AlfrescoConfiguration ended May 2023. We recommend migrating to or using the Alfresco data source template schema / TemplateConfiguration API.

Sourcemodule AmazonResourceName : sig ... end
Sourcemodule EntityId : sig ... end
Sourcemodule FailedEntity : sig ... end

Information on the users or groups in your IAM Identity Center identity source that failed to properly configure with your Amazon Kendra experience.

Sourcemodule IndexId : sig ... end
Sourcemodule ExperienceId : sig ... end
Sourcemodule EntityType : sig ... end
Sourcemodule EntityConfiguration : sig ... end

Provides the configuration information for users or groups in your IAM Identity Center identity source to grant access your Amazon Kendra experience.

Sourcemodule AssociateEntityList : sig ... end

Grants users or groups in your IAM Identity Center identity source access to your Amazon Kendra experience. You can create an Amazon Kendra experience such as a search application. For more information on creating a search application experience, see Building a search experience with no code.

Sourcemodule ValidationException : sig ... end

The input fails to satisfy the constraints set by the Amazon Kendra service. Please provide the correct input and try again.

Sourcemodule ThrottlingException : sig ... end

The request was denied due to request throttling. Please reduce the number of requests and try again.

Sourcemodule ResourceNotFoundException : sig ... end

The resource you want to use doesn’t exist. Please check you have provided the correct resource and try again.

The resource you want to use already exists. Please check you have provided the correct resource and try again.

Sourcemodule InternalServerException : sig ... end

An issue occurred with the internal server used for your Amazon Kendra service. Please wait a few minutes and try again, or contact Support for help.

Grants users or groups in your IAM Identity Center identity source access to your Amazon Kendra experience. You can create an Amazon Kendra experience such as a search application. For more information on creating a search application experience, see Building a search experience with no code.

Sourcemodule Persona : sig ... end

Provides the configuration information for users or groups in your IAM Identity Center identity source for access to your Amazon Kendra experience. Specific permissions are defined for each user or group once they are granted access to your Amazon Kendra experience.

Defines the specific permissions of users or groups in your IAM Identity Center identity source with access to your Amazon Kendra experience. You can create an Amazon Kendra experience such as a search application. For more information on creating a search application experience, see Building a search experience with no code.

Sourcemodule FailedEntityList : sig ... end

Defines the specific permissions of users or groups in your IAM Identity Center identity source with access to your Amazon Kendra experience. You can create an Amazon Kendra experience such as a search application. For more information on creating a search application experience, see Building a search experience with no code.

Sourcemodule Timestamp : sig ... end
Sourcemodule Long : sig ... end
Sourcemodule DocumentAttributeValue : sig ... end

The value of a document attribute. You can only provide one value for a document attribute.

Sourcemodule DocumentAttributeKey : sig ... end
Sourcemodule DocumentAttribute : sig ... end

A document attribute or metadata field. To create custom document attributes, see Custom attributes.

module AttributeFilter : sig ... end

Filters the search results based on document attributes or fields. You can filter results using attributes for your particular documents. The attributes must exist in your index. For example, if your documents include the custom attribute "Department", you can filter documents that belong to the "HR" department. You would use the EqualsTo operation to filter results or documents with "Department" equals to "HR". You can use AndAllFilters and OrAllFilters in combination with each other or with other operations such as EqualsTo. For example: AndAllFilters EqualsTo: "Department", "HR" OrAllFilters ContainsAny: "Project Name", ["new hires", "new hiring"] This example filters results or documents that belong to the HR department AND belong to projects that contain "new hires" OR "new hiring" in the project name (must use ContainAny with StringListValue). This example is filtering with a depth of 2. You cannot filter more than a depth of 2, otherwise you receive a ValidationException exception with the message "AttributeFilter cannot have a depth of more than 2." Also, if you use more than 10 attribute filters in a given list for AndAllFilters or OrAllFilters, you receive a ValidationException with the message "AttributeFilter cannot have a length of more than 10". For examples of using AttributeFilter, see Using document attributes to filter search results.

module AttributeFilterList : sig ... end
Sourcemodule ObjectBoolean : sig ... end
Sourcemodule SuggestableConfig : sig ... end

Provides the configuration information for a document field/attribute that you want to base query suggestions on.

Sourcemodule SuggestableConfigList : sig ... end
Sourcemodule AttributeSuggestionsMode : sig ... end

Gets information on the configuration of document fields/attributes that you want to base query suggestions on. To change your configuration, use AttributeSuggestionsUpdateConfig and then call UpdateQuerySuggestionsConfig.

Sourcemodule Token : sig ... end
Sourcemodule PrincipalName : sig ... end
Sourcemodule Groups : sig ... end
Sourcemodule DataSourceId : sig ... end
Sourcemodule DataSourceGroup : sig ... end

Data source information for user context filtering.

Sourcemodule DataSourceGroups : sig ... end
Sourcemodule UserContext : sig ... end

Provides information about the user context for an Amazon Kendra index. User context filtering is a kind of personalized search with the benefit of controlling access to documents. For example, not all teams that search the company portal for information should access top-secret company documents, nor are these documents relevant to all users. Only specific users or groups of teams given access to top-secret documents should see these documents in their search results. You provide one of the following: User token User ID, the groups the user belongs to, and any data sources the groups can access. If you provide both, an exception is thrown. If you're using an Amazon Kendra Gen AI Enterprise Edition index, you can use UserId, Groups, and DataSourceGroups to filter content. If you set the UserId to a particular user ID, it also includes all public documents. Amazon Kendra Gen AI Enterprise Edition indices don't support token based document filtering. If you're using an Amazon Kendra Gen AI Enterprise Edition index, Amazon Kendra returns a ValidationException error if the Token field has a non-null value.

Sourcemodule DocumentAttributeKeyList : sig ... end

Provides the configuration information for the document fields/attributes that you want to base query suggestions on.

Updates the configuration information for the document fields/attributes that you want to base query suggestions on. To deactivate using documents fields for query suggestions, set the mode to INACTIVE. You must also set SuggestionTypes as either QUERY or DOCUMENT_ATTRIBUTES and then call GetQuerySuggestions. If you set to QUERY, then Amazon Kendra uses the query history to base suggestions on. If you set to DOCUMENT_ATTRIBUTES, then Amazon Kendra uses the contents of document fields to base suggestions on.

Sourcemodule Port : sig ... end
Sourcemodule Host : sig ... end

Provides the configuration information to connect to websites that require basic user authentication.

Provides the configuration information to connect to websites that require user authentication.

Sourcemodule DocumentId : sig ... end
Sourcemodule DocumentIdList : sig ... end
Sourcemodule DataSourceSyncJobId : sig ... end

Maps a particular data source sync job to a particular data source.

Removes one or more documents from an index. The documents must have been added with the BatchPutDocument API. The documents are deleted asynchronously. You can see the progress of the deletion by using Amazon Web Services CloudWatch. Any error messages related to the processing of the batch are sent to your Amazon Web Services CloudWatch log. You can also use the BatchGetDocumentStatus API to monitor the progress of deleting your documents. Deleting documents from an index using BatchDeleteDocument could take up to an hour or more, depending on the number of documents you want to delete.

Sourcemodule ConflictException : sig ... end

A conflict occurred with the request. Please fix any inconsistences with your resources and try again.

Sourcemodule ErrorCode : sig ... end

Provides information about documents that could not be removed from an index by the BatchDeleteDocument API.

Removes one or more documents from an index. The documents must have been added with the BatchPutDocument API. The documents are deleted asynchronously. You can see the progress of the deletion by using Amazon Web Services CloudWatch. Any error messages related to the processing of the batch are sent to your Amazon Web Services CloudWatch log. You can also use the BatchGetDocumentStatus API to monitor the progress of deleting your documents. Deleting documents from an index using BatchDeleteDocument could take up to an hour or more, depending on the number of documents you want to delete.

Sourcemodule FeaturedResultsSetId : sig ... end

Provides information about a set of featured results that couldn't be removed from an index by the BatchDeleteFeaturedResultsSet API.

Sourcemodule FeaturedResultsSetIdList : sig ... end

Removes one or more sets of featured results. Features results are placed above all other results for certain queries. If there's an exact match of a query, then one or more specific documents are featured in the search results.

Removes one or more sets of featured results. Features results are placed above all other results for certain queries. If there's an exact match of a query, then one or more specific documents are featured in the search results.

Sourcemodule DocumentAttributeList : sig ... end
Sourcemodule DocumentInfo : sig ... end

Identifies a document for which to retrieve status information

Sourcemodule DocumentInfoList : sig ... end

Returns the indexing status for one or more documents submitted with the BatchPutDocument API. When you use the BatchPutDocument API, documents are indexed asynchronously. You can use the BatchGetDocumentStatus API to get the current status of a list of documents so that you can determine if they have been successfully indexed. You can also use the BatchGetDocumentStatus API to check the status of the BatchDeleteDocument API. When a document is deleted from the index, Amazon Kendra returns NOT_FOUND as the status.

Sourcemodule DocumentStatus : sig ... end
Sourcemodule Status : sig ... end

Provides information about the status of documents submitted for indexing.

Sourcemodule DocumentStatusList : sig ... end

Provides a response when the status of a document could not be retrieved.

Returns the indexing status for one or more documents submitted with the BatchPutDocument API. When you use the BatchPutDocument API, documents are indexed asynchronously. You can use the BatchGetDocumentStatus API to get the current status of a list of documents so that you can determine if they have been successfully indexed. You can also use the BatchGetDocumentStatus API to check the status of the BatchDeleteDocument API. When a document is deleted from the index, Amazon Kendra returns NOT_FOUND as the status.

Sourcemodule RoleArn : sig ... end
Sourcemodule Title : sig ... end
Sourcemodule ReadAccessType : sig ... end
Sourcemodule PrincipalType : sig ... end
Sourcemodule Principal : sig ... end

Provides user and group information for user context filtering.

Sourcemodule PrincipalList : sig ... end
Sourcemodule HierarchicalPrincipal : sig ... end

Information to define the hierarchy for which documents users should have access to.

Sourcemodule HierarchicalPrincipalList : sig ... end
Sourcemodule ContentType : sig ... end
Sourcemodule Blob : sig ... end
Sourcemodule Document : sig ... end

A document in an index.

Sourcemodule DocumentList : sig ... end
Sourcemodule DocumentAttributeTarget : sig ... end

The target document attribute or metadata field you want to alter when ingesting documents into Amazon Kendra. For example, you can delete customer identification numbers associated with the documents, stored in the document metadata field called 'Customer_ID'. You set the target key as 'Customer_ID' and the deletion flag to TRUE. This removes all customer ID values in the field 'Customer_ID'. This would scrub personally identifiable information from each document's metadata. Amazon Kendra cannot create a target field if it has not already been created as an index field. After you create your index field, you can create a document metadata field using DocumentAttributeTarget. Amazon Kendra then will map your newly created metadata field to your index field. You can also use this with DocumentAttributeCondition.

Sourcemodule ConditionOperator : sig ... end

The condition used for the target document attribute or metadata field when ingesting documents into Amazon Kendra. You use this with DocumentAttributeTarget to apply the condition. For example, you can create the 'Department' target field and have it prefill department names associated with the documents based on information in the 'Source_URI' field. Set the condition that if the 'Source_URI' field contains 'financial' in its URI value, then prefill the target field 'Department' with the target value 'Finance' for the document. Amazon Kendra cannot create a target field if it has not already been created as an index field. After you create your index field, you can create a document metadata field using DocumentAttributeTarget. Amazon Kendra then will map your newly created metadata field to your index field.

Provides the configuration information for applying basic logic to alter document metadata and content when ingesting documents into Amazon Kendra. To apply advanced logic, to go beyond what you can do with basic logic, see HookConfiguration. For more information, see Customizing document metadata during the ingestion process.

Sourcemodule LambdaArn : sig ... end
Sourcemodule HookConfiguration : sig ... end

Provides the configuration information for invoking a Lambda function in Lambda to alter document metadata and content when ingesting documents into Amazon Kendra. You can configure your Lambda function using PreExtractionHookConfiguration if you want to apply advanced alterations on the original or raw documents. If you want to apply advanced alterations on the Amazon Kendra structured documents, you must configure your Lambda function using PostExtractionHookConfiguration. You can only invoke one Lambda function. However, this function can invoke other functions it requires. For more information, see Customizing document metadata during the ingestion process.

Provides the configuration information for altering document metadata and content during the document ingestion process. For more information, see Customizing document metadata during the ingestion process.

Sourcemodule BatchPutDocumentRequest : sig ... end

Adds one or more documents to an index. The BatchPutDocument API enables you to ingest inline documents or a set of documents stored in an Amazon S3 bucket. Use this API to ingest your text and unstructured text into an index, add custom attributes to the documents, and to attach an access control list to the documents added to the index. The documents are indexed asynchronously. You can see the progress of the batch using Amazon Web Services CloudWatch. Any error messages related to processing the batch are sent to your Amazon Web Services CloudWatch log. You can also use the BatchGetDocumentStatus API to monitor the progress of indexing your documents. For an example of ingesting inline documents using Python and Java SDKs, see Adding files directly to an index.

You have exceeded the set limits for your Amazon Kendra service. Please see Quotas for more information, or contact Support to inquire about an increase of limits.

Provides information about a document that could not be indexed.

Sourcemodule BatchPutDocumentResponse : sig ... end

Adds one or more documents to an index. The BatchPutDocument API enables you to ingest inline documents or a set of documents stored in an Amazon S3 bucket. Use this API to ingest your text and unstructured text into an index, add custom attributes to the documents, and to attach an access control list to the documents added to the index. The documents are indexed asynchronously. You can see the progress of the batch using Amazon Web Services CloudWatch. Any error messages related to processing the batch are sent to your Amazon Web Services CloudWatch log. You can also use the BatchGetDocumentStatus API to monitor the progress of indexing your documents. For an example of ingesting inline documents using Python and Java SDKs, see Adding files directly to an index.

Sourcemodule EnterpriseId : sig ... end
Sourcemodule BoxConfiguration : sig ... end

Provides the configuration information to connect to Box as your data source.

Sourcemodule StorageCapacityUnit : sig ... end
Sourcemodule QueryCapacityUnit : sig ... end

Specifies additional capacity units configured for your Enterprise Edition index. You can add and remove capacity units to fit your usage requirements.

Sourcemodule ChangeDetectingColumns : sig ... end
Sourcemodule ClaimRegex : sig ... end

Clears existing query suggestions from an index. This deletes existing suggestions only, not the queries in the query log. After you clear suggestions, Amazon Kendra learns new suggestions based on new queries added to the query log from the time you cleared suggestions. If you do not see any new suggestions, then please allow Amazon Kendra to collect enough queries to learn new suggestions. ClearQuerySuggestions is currently not supported in the Amazon Web Services GovCloud (US-West) region.

Sourcemodule ResultId : sig ... end
Sourcemodule ClickFeedback : sig ... end

Gathers information about when a particular result was clicked by a user. Your application uses the SubmitFeedback API to provide click information.

Sourcemodule ClickFeedbackList : sig ... end
Sourcemodule ClientTokenName : sig ... end
Sourcemodule SortOrder : sig ... end
Sourcemodule SortingConfiguration : sig ... end

Specifies the document attribute to use to sort the response to a Amazon Kendra query. You can specify a single attribute for sorting. The attribute must have the Sortable flag set to true, otherwise Amazon Kendra returns an exception. You can sort attributes of the following types. Date value Long value String value You can't sort attributes of the following type. String list value

Sourcemodule SortingConfigurationList : sig ... end
Sourcemodule ExpandConfiguration : sig ... end

Specifies the configuration information needed to customize how collapsed search result groups expand.

Sourcemodule CollapseConfiguration : sig ... end

Specifies how to group results by document attribute value, and how to display them collapsed/expanded under a designated primary document for each group.

Sourcemodule Url : sig ... end
Sourcemodule ExpandedResultItem : sig ... end

A single expanded result in a collapsed group of search results. An expanded result item contains information about an expanded result document within a collapsed group of search results. This includes the original location of the document, a list of attributes assigned to the document, and relevant text from the document that satisfies the query.

Sourcemodule ExpandedResultList : sig ... end
Sourcemodule CollapsedResultDetail : sig ... end

Provides details about a collapsed group of search results.

Sourcemodule ColumnConfiguration : sig ... end

Provides information about how Amazon Kendra should use the columns of a database in an index.

Sourcemodule QueryText : sig ... end
Sourcemodule ConflictingItem : sig ... end

Information about a conflicting query used across different sets of featured results. When you create a featured results set, you must check that the queries are unique per featured results set for each index.

Sourcemodule ConflictingItems : sig ... end

Maps attributes or field names of Confluence attachments to Amazon Kendra index field names. To create custom fields, use the UpdateIndex API before you map to Confluence fields. For more information, see Mapping data source fields. The Confuence data source field names must exist in your Confluence custom metadata.

Configuration of attachment settings for the Confluence data source. Attachment settings are optional, if you don't specify settings attachments, Amazon Kendra won't index them.

Sourcemodule ConfluenceBlogFieldName : sig ... end

Maps attributes or field names of Confluence blog to Amazon Kendra index field names. To create custom fields, use the UpdateIndex API before you map to Confluence fields. For more information, see Mapping data source fields. The Confluence data source field names must exist in your Confluence custom metadata.

Configuration of blog settings for the Confluence data source. Blogs are always indexed unless filtered from the index by the ExclusionPatterns or InclusionPatterns fields in the ConfluenceConfiguration object.

Sourcemodule ProxyConfiguration : sig ... end

Provides the configuration information for a web proxy to connect to website hosts.

Sourcemodule ConfluenceVersion : sig ... end
Sourcemodule ConfluenceSpaceIdentifier : sig ... end
Sourcemodule ConfluenceSpaceList : sig ... end
Sourcemodule ConfluenceSpaceFieldName : sig ... end

Maps attributes or field names of Confluence spaces to Amazon Kendra index field names. To create custom fields, use the UpdateIndex API before you map to Confluence fields. For more information, see Mapping data source fields. The Confluence data source field names must exist in your Confluence custom metadata.

Configuration information for indexing Confluence spaces.

Sourcemodule ConfluencePageFieldName : sig ... end

Maps attributes or field names of Confluence pages to Amazon Kendra index field names. To create custom fields, use the UpdateIndex API before you map to Confluence fields. For more information, see Mapping data source fields. The Confluence data source field names must exist in your Confluence custom metadata.

Configuration of the page settings for the Confluence data source.

Sourcemodule ConfluenceConfiguration : sig ... end

Provides the configuration information to connect to Confluence as your data source.

Sourcemodule TableName : sig ... end
Sourcemodule DatabasePort : sig ... end
Sourcemodule DatabaseName : sig ... end
Sourcemodule DatabaseHost : sig ... end
Sourcemodule ConnectionConfiguration : sig ... end

Provides the configuration information that's required to connect to a database.

Sourcemodule Content : sig ... end
Sourcemodule FaqId : sig ... end
Sourcemodule FaqIdsList : sig ... end
Sourcemodule DataSourceIdList : sig ... end

Provides the configuration information for your content sources, such as data sources, FAQs, and content indexed directly via BatchPutDocument.

Sourcemodule Correction : sig ... end

A corrected misspelled word in a query.

Sourcemodule CorrectionList : sig ... end
Sourcemodule CrawlDepth : sig ... end
Sourcemodule Description : sig ... end

Creates an access configuration for your documents. This includes user and group access information for your documents. This is useful for user context filtering, where search results are filtered based on the user or their group access to documents. You can use this to re-configure your existing document level access control without indexing all of your documents again. For example, your index contains top-secret company documents that only certain employees or users should access. One of these users leaves the company or switches to a team that should be blocked from accessing top-secret documents. The user still has access to top-secret documents because the user had access when your documents were previously indexed. You can create a specific access control configuration for the user with deny access. You can later update the access control configuration to allow access if the user returns to the company and re-joins the 'top-secret' team. You can re-configure access control for your documents as circumstances change. To apply your access control configuration to certain documents, you call the BatchPutDocument API with the AccessControlConfigurationId included in the Document object. If you use an S3 bucket as a data source, you update the .metadata.json with the AccessControlConfigurationId and synchronize your data source. Amazon Kendra currently only supports access control configuration for S3 data sources and documents indexed using the BatchPutDocument API. You can't configure access control using CreateAccessControlConfiguration for an Amazon Kendra Gen AI Enterprise Edition index. Amazon Kendra will return a ValidationException error for a Gen_AI_ENTERPRISE_EDITION index.

Creates an access configuration for your documents. This includes user and group access information for your documents. This is useful for user context filtering, where search results are filtered based on the user or their group access to documents. You can use this to re-configure your existing document level access control without indexing all of your documents again. For example, your index contains top-secret company documents that only certain employees or users should access. One of these users leaves the company or switches to a team that should be blocked from accessing top-secret documents. The user still has access to top-secret documents because the user had access when your documents were previously indexed. You can create a specific access control configuration for the user with deny access. You can later update the access control configuration to allow access if the user returns to the company and re-joins the 'top-secret' team. You can re-configure access control for your documents as circumstances change. To apply your access control configuration to certain documents, you call the BatchPutDocument API with the AccessControlConfigurationId included in the Document object. If you use an S3 bucket as a data source, you update the .metadata.json with the AccessControlConfigurationId and synchronize your data source. Amazon Kendra currently only supports access control configuration for S3 data sources and documents indexed using the BatchPutDocument API. You can't configure access control using CreateAccessControlConfiguration for an Amazon Kendra Gen AI Enterprise Edition index. Amazon Kendra will return a ValidationException error for a Gen_AI_ENTERPRISE_EDITION index.

Sourcemodule TagValue : sig ... end
Sourcemodule TagKey : sig ... end
Sourcemodule Tag : sig ... end

A key-value pair that identifies or categorizes an index, FAQ, data source, or other resource. TA tag key and value can consist of Unicode letters, digits, white space, and any of the following symbols: _ . : / = + - @.

Sourcemodule TagList : sig ... end
Sourcemodule ScanSchedule : sig ... end
Sourcemodule LanguageCode : sig ... end

The code for a language. The default language is English. For more information on supported languages, including their codes, see Adding documents in languages other than English.

Sourcemodule DataSourceType : sig ... end
Sourcemodule DataSourceName : sig ... end
Sourcemodule OrganizationId : sig ... end
Sourcemodule WorkDocsConfiguration : sig ... end

Provides the configuration information to connect to Amazon WorkDocs as your data source. Amazon WorkDocs connector is available in Oregon, North Virginia, Sydney, Singapore and Ireland regions.

Sourcemodule SiteMap : sig ... end
Sourcemodule SiteMapsList : sig ... end
Sourcemodule SiteMapsConfiguration : sig ... end

Provides the configuration information for the sitemap URLs to crawl. When selecting websites to index, you must adhere to the Amazon Acceptable Use Policy and all other Amazon terms. Remember that you must only use Amazon Kendra Web Crawler to index your own web pages, or web pages that you have authorization to index.

Sourcemodule WebCrawlerMode : sig ... end
Sourcemodule SeedUrl : sig ... end
Sourcemodule SeedUrlList : sig ... end
Sourcemodule SeedUrlConfiguration : sig ... end

Provides the configuration information for the seed or starting point URLs to crawl. When selecting websites to index, you must adhere to the Amazon Acceptable Use Policy and all other Amazon terms. Remember that you must only use Amazon Kendra Web Crawler to index your own web pages, or web pages that you have authorization to index.

Sourcemodule Urls : sig ... end

Provides the configuration information of the URLs to crawl. You can only crawl websites that use the secure communication protocol, Hypertext Transfer Protocol Secure (HTTPS). If you receive an error when crawling a website, it could be that the website is blocked from crawling. When selecting websites to index, you must adhere to the Amazon Acceptable Use Policy and all other Amazon terms. Remember that you must only use Amazon Kendra Web Crawler to index your own web pages, or web pages that you have authorization to index.

Sourcemodule MaxUrlsPerMinuteCrawlRate : sig ... end
Sourcemodule MaxLinksPerPage : sig ... end
Sourcemodule WebCrawlerConfiguration : sig ... end

Provides the configuration information required for Amazon Kendra Web Crawler.

Sourcemodule Template : sig ... end

The template schema used for the data source, where templates schemas are supported. See Data source template schemas.

Sourcemodule TemplateConfiguration : sig ... end

Provides a template for the configuration information to connect to your data source.

Sourcemodule TeamId : sig ... end
Sourcemodule SlackEntity : sig ... end
Sourcemodule SlackEntityList : sig ... end
Sourcemodule SinceCrawlDate : sig ... end
Sourcemodule PublicChannelFilter : sig ... end
Sourcemodule PrivateChannelFilter : sig ... end
Sourcemodule LookBackPeriod : sig ... end
Sourcemodule SlackConfiguration : sig ... end

Provides the configuration information to connect to Slack as your data source. Amazon Kendra now supports an upgraded Slack connector. You must now use the TemplateConfiguration object instead of the SlackConfiguration object to configure your connector. Connectors configured using the older console and API architecture will continue to function as configured. However, you won’t be able to edit or update them. If you want to edit or update your connector configuration, you must create a new connector. We recommended migrating your connector workflow to the upgraded version. Support for connectors configured using the older architecture is scheduled to end by June 2024.

Sourcemodule SharePointVersion : sig ... end
Sourcemodule SharePointUrlList : sig ... end
Sourcemodule SharePointConfiguration : sig ... end

Provides the configuration information to connect to Microsoft SharePoint as your data source.

Provides the configuration information for crawling service catalog items in the ServiceNow site

Provides the configuration information for crawling knowledge articles in the ServiceNow site.

Sourcemodule ServiceNowHostUrl : sig ... end
Sourcemodule ServiceNowConfiguration : sig ... end

Provides the configuration information to connect to ServiceNow as your data source.

Provides the configuration information for indexing a single standard object.

Provides the configuration information for processing attachments to Salesforce standard objects.

Provides the configuration information for standard Salesforce knowledge articles.

Provides the configuration information for indexing Salesforce custom articles.

Provides the configuration information for the knowledge article types that Amazon Kendra indexes. Amazon Kendra indexes standard knowledge articles and the standard fields of knowledge articles, or the custom fields of custom knowledge articles, but not both

The configuration information for syncing a Salesforce chatter feed. The contents of the object comes from the Salesforce FeedItem table.

Sourcemodule SalesforceConfiguration : sig ... end

Provides the configuration information to connect to Salesforce as your data source.

Document metadata files that contain information such as the document access control information, source URI, document author, and custom attributes. Each metadata file contains metadata about a single document.

Sourcemodule S3DataSourceConfiguration : sig ... end

Provides the configuration information to connect to an Amazon S3 bucket. Amazon Kendra now supports an upgraded Amazon S3 connector. You must now use the TemplateConfiguration object instead of the S3DataSourceConfiguration object to configure your connector. Connectors configured using the older console and API architecture will continue to function as configured. However, you won't be able to edit or update them. If you want to edit or update your connector configuration, you must create a new connector. We recommended migrating your connector workflow to the upgraded version. Support for connectors configured using the older architecture is scheduled to end by June 2024.

Sourcemodule FolderId : sig ... end
Sourcemodule FolderIdList : sig ... end
Sourcemodule Domain : sig ... end
Sourcemodule QuipConfiguration : sig ... end

Provides the configuration information to connect to Quip as your data source.

Sourcemodule TenantDomain : sig ... end
Sourcemodule OneDriveUser : sig ... end
Sourcemodule OneDriveUserList : sig ... end
Sourcemodule OneDriveUsers : sig ... end

User accounts whose documents should be indexed.

Sourcemodule OneDriveConfiguration : sig ... end

Provides the configuration information to connect to OneDrive as your data source.

Sourcemodule Project : sig ... end
Sourcemodule JiraStatus : sig ... end
Sourcemodule JiraAccountUrl : sig ... end
Sourcemodule IssueType : sig ... end
Sourcemodule IssueSubEntity : sig ... end
Sourcemodule IssueSubEntityFilter : sig ... end
Sourcemodule JiraConfiguration : sig ... end

Provides the configuration information to connect to Jira as your data source.

Sourcemodule UserAccount : sig ... end
Sourcemodule ExcludeUserAccountsList : sig ... end
Sourcemodule SharedDriveId : sig ... end
Sourcemodule ExcludeSharedDrivesList : sig ... end
Sourcemodule MimeType : sig ... end
Sourcemodule ExcludeMimeTypesList : sig ... end
Sourcemodule GoogleDriveConfiguration : sig ... end

Provides the configuration information to connect to Google Drive as your data source.

Sourcemodule Type : sig ... end
Sourcemodule StringList : sig ... end
Sourcemodule OrganizationName : sig ... end
Sourcemodule SaaSConfiguration : sig ... end

Provides the configuration information to connect to GitHub Enterprise Cloud (SaaS).

Sourcemodule RepositoryName : sig ... end
Sourcemodule RepositoryNames : sig ... end
Sourcemodule OnPremiseConfiguration : sig ... end

Provides the configuration information to connect to GitHub Enterprise Server (on premises).

Provides the configuration information to include certain types of GitHub content. You can configure to index repository files only, or also include issues and pull requests, comments, and comment attachments.

Sourcemodule GitHubConfiguration : sig ... end

Provides the configuration information to connect to GitHub as your data source. Amazon Kendra now supports an upgraded GitHub connector. You must now use the TemplateConfiguration object instead of the GitHubConfiguration object to configure your connector. Connectors configured using the older console and API architecture will continue to function as configured. However, you won’t be able to edit or update them. If you want to edit or update your connector configuration, you must create a new connector. We recommended migrating your connector workflow to the upgraded version. Support for connectors configured using the older architecture is scheduled to end by June 2024.

Sourcemodule FsxFileSystemType : sig ... end
Sourcemodule FileSystemId : sig ... end
Sourcemodule FsxConfiguration : sig ... end

Provides the configuration information to connect to Amazon FSx as your data source. Amazon Kendra now supports an upgraded Amazon FSx Windows connector. You must now use the TemplateConfiguration object instead of the FsxConfiguration object to configure your connector. Connectors configured using the older console and API architecture will continue to function as configured. However, you won't be able to edit or update them. If you want to edit or update your connector configuration, you must create a new connector. We recommended migrating your connector workflow to the upgraded version. Support for connectors configured using the older architecture is scheduled to end by June 2024.

Sourcemodule SqlConfiguration : sig ... end

Provides the configuration information to use a SQL database.

Sourcemodule DatabaseEngineType : sig ... end
Sourcemodule DatabaseConfiguration : sig ... end

Provides the configuration information to an Amazon Kendra supported database.

Sourcemodule DataSourceConfiguration : sig ... end

Provides the configuration information for an Amazon Kendra data source.

Sourcemodule CreateDataSourceRequest : sig ... end

Creates a data source connector that you want to use with an Amazon Kendra index. You specify a name, data source connector type and description for your data source. You also specify configuration information for the data source connector. CreateDataSource is a synchronous operation. The operation returns 200 if the data source was successfully created. Otherwise, an exception is raised. For an example of creating an index and data source using the Python SDK, see Getting started with Python SDK. For an example of creating an index and data source using the Java SDK, see Getting started with Java SDK.

Sourcemodule CreateDataSourceResponse : sig ... end

Creates a data source connector that you want to use with an Amazon Kendra index. You specify a name, data source connector type and description for your data source. You also specify configuration information for the data source connector. CreateDataSource is a synchronous operation. The operation returns 200 if the data source was successfully created. Otherwise, an exception is raised. For an example of creating an index and data source using the Python SDK, see Getting started with Python SDK. For an example of creating an index and data source using the Java SDK, see Getting started with Java SDK.

Sourcemodule ExperienceName : sig ... end
Sourcemodule IdentityAttributeName : sig ... end
Sourcemodule UserIdentityConfiguration : sig ... end

Provides the configuration information for the identifiers of your users.

Sourcemodule ExperienceConfiguration : sig ... end

Provides the configuration information for your Amazon Kendra experience. This includes the data source IDs and/or FAQ IDs, and user or group information to grant access to your Amazon Kendra experience.

Sourcemodule CreateExperienceRequest : sig ... end

Creates an Amazon Kendra experience such as a search application. For more information on creating a search application experience, including using the Python and Java SDKs, see Building a search experience with no code.

Sourcemodule CreateExperienceResponse : sig ... end

Creates an Amazon Kendra experience such as a search application. For more information on creating a search application experience, including using the Python and Java SDKs, see Building a search experience with no code.

Sourcemodule FaqName : sig ... end
Sourcemodule FaqFileFormat : sig ... end
Sourcemodule CreateFaqRequest : sig ... end

Creates a set of frequently ask questions (FAQs) using a specified FAQ file stored in an Amazon S3 bucket. Adding FAQs to an index is an asynchronous operation. For an example of adding an FAQ to an index using Python and Java SDKs, see Using your FAQ file.

Sourcemodule CreateFaqResponse : sig ... end

Creates a set of frequently ask questions (FAQs) using a specified FAQ file stored in an Amazon S3 bucket. Adding FAQs to an index is an asynchronous operation. For an example of adding an FAQ to an index using Python and Java SDKs, see Using your FAQ file.

Sourcemodule QueryTextList : sig ... end
Sourcemodule FeaturedResultsSetStatus : sig ... end
Sourcemodule FeaturedResultsSetName : sig ... end
Sourcemodule FeaturedDocument : sig ... end

A featured document. This document is displayed at the top of the search results page, placed above all other results for certain queries. If there's an exact match of a query, then the document is featured in the search results.

Sourcemodule FeaturedDocumentList : sig ... end

Creates a set of featured results to display at the top of the search results page. Featured results are placed above all other results for certain queries. You map specific queries to specific documents for featuring in the results. If a query contains an exact match, then one or more specific documents are featured in the search results. You can create up to 50 sets of featured results per index. You can request to increase this limit by contacting Support.

Sourcemodule FeaturedResultsSet : sig ... end

A set of featured results that are displayed at the top of your search results. Featured results are placed above all other results for certain queries. If there's an exact match of a query, then one or more specific documents are featured in the search results.

An error message with a list of conflicting queries used across different sets of featured results. This occurred with the request for a new featured results set. Check that the queries you specified for featured results are unique per featured results set for each index.

Creates a set of featured results to display at the top of the search results page. Featured results are placed above all other results for certain queries. You map specific queries to specific documents for featuring in the results. If a query contains an exact match, then one or more specific documents are featured in the search results. You can create up to 50 sets of featured results per index. You can request to increase this limit by contacting Support.

Sourcemodule UserNameAttributeField : sig ... end
Sourcemodule KeyLocation : sig ... end
Sourcemodule Issuer : sig ... end
Sourcemodule GroupAttributeField : sig ... end
Sourcemodule JwtTokenTypeConfiguration : sig ... end

Provides the configuration information for the JWT token type.

Provides the configuration information for the JSON token type.

Sourcemodule UserTokenConfiguration : sig ... end

Provides the configuration information for a token. If you're using an Amazon Kendra Gen AI Enterprise Edition index and you try to use UserTokenConfigurations to configure user context policy, Amazon Kendra returns a ValidationException error.

Sourcemodule UserGroupResolutionMode : sig ... end

Provides the configuration information to get users and groups from an IAM Identity Center identity source. This is useful for user context filtering, where search results are filtered based on the user or their group access to documents. You can also use the PutPrincipalMapping API to map users to their groups so that you only need to provide the user ID when you issue the query. To set up an IAM Identity Center identity source in the console to use with Amazon Kendra, see Getting started with an IAM Identity Center identity source. You must also grant the required permissions to use IAM Identity Center with Amazon Kendra. For more information, see IAM roles for IAM Identity Center. Amazon Kendra currently does not support using UserGroupResolutionConfiguration with an Amazon Web Services organization member account for your IAM Identity Center identify source. You must create your index in the management account for the organization in order to use UserGroupResolutionConfiguration. If you're using an Amazon Kendra Gen AI Enterprise Edition index, UserGroupResolutionConfiguration isn't supported.

Sourcemodule UserContextPolicy : sig ... end
Sourcemodule KmsKeyId : sig ... end

Provides the identifier of the KMS key used to encrypt data indexed by Amazon Kendra. Amazon Kendra doesn't support asymmetric keys.

Sourcemodule IndexName : sig ... end
Sourcemodule IndexEdition : sig ... end
Sourcemodule CreateIndexRequest : sig ... end

Creates an Amazon Kendra index. Index creation is an asynchronous API. To determine if index creation has completed, check the Status field returned from a call to DescribeIndex. The Status field is set to ACTIVE when the index is ready to use. Once the index is active, you can index your documents using the BatchPutDocument API or using one of the supported data sources. For an example of creating an index and data source using the Python SDK, see Getting started with Python SDK. For an example of creating an index and data source using the Java SDK, see Getting started with Java SDK.

Sourcemodule CreateIndexResponse : sig ... end

Creates an Amazon Kendra index. Index creation is an asynchronous API. To determine if index creation has completed, check the Status field returned from a call to DescribeIndex. The Status field is set to ACTIVE when the index is ready to use. Once the index is active, you can index your documents using the BatchPutDocument API or using one of the supported data sources. For an example of creating an index and data source using the Python SDK, see Getting started with Python SDK. For an example of creating an index and data source using the Java SDK, see Getting started with Java SDK.

Creates a block list to exlcude certain queries from suggestions. Any query that contains words or phrases specified in the block list is blocked or filtered out from being shown as a suggestion. You need to provide the file location of your block list text file in your S3 bucket. In your text file, enter each block word or phrase on a separate line. For information on the current quota limits for block lists, see Quotas for Amazon Kendra. CreateQuerySuggestionsBlockList is currently not supported in the Amazon Web Services GovCloud (US-West) region. For an example of creating a block list for query suggestions using the Python SDK, see Query suggestions block list.

Creates a block list to exlcude certain queries from suggestions. Any query that contains words or phrases specified in the block list is blocked or filtered out from being shown as a suggestion. You need to provide the file location of your block list text file in your S3 bucket. In your text file, enter each block word or phrase on a separate line. For information on the current quota limits for block lists, see Quotas for Amazon Kendra. CreateQuerySuggestionsBlockList is currently not supported in the Amazon Web Services GovCloud (US-West) region. For an example of creating a block list for query suggestions using the Python SDK, see Query suggestions block list.

Sourcemodule ThesaurusName : sig ... end
Sourcemodule CreateThesaurusRequest : sig ... end

Creates a thesaurus for an index. The thesaurus contains a list of synonyms in Solr format. For an example of adding a thesaurus file to an index, see Adding custom synonyms to an index.

Sourcemodule ThesaurusId : sig ... end
Sourcemodule CreateThesaurusResponse : sig ... end

Creates a thesaurus for an index. The thesaurus contains a list of synonyms in Solr format. For an example of adding a thesaurus file to an index, see Adding custom synonyms to an index.

Sourcemodule DataSourceStatus : sig ... end
Sourcemodule DataSourceSummary : sig ... end

Summary information for a Amazon Kendra data source.

Sourcemodule DataSourceSummaryList : sig ... end
Sourcemodule DataSourceSyncJobStatus : sig ... end
Sourcemodule MetricValue : sig ... end
Sourcemodule DataSourceSyncJobMetrics : sig ... end

Maps a batch delete document request to a specific data source sync job. This is optional and should only be supplied when documents are deleted by a data source connector.

Sourcemodule DataSourceSyncJob : sig ... end

Provides information about a data source synchronization job.

Deletes an access control configuration that you created for your documents in an index. This includes user and group access information for your documents. This is useful for user context filtering, where search results are filtered based on the user or their group access to documents.

Deletes an access control configuration that you created for your documents in an index. This includes user and group access information for your documents. This is useful for user context filtering, where search results are filtered based on the user or their group access to documents.

Sourcemodule DeleteDataSourceRequest : sig ... end

Deletes an Amazon Kendra data source connector. An exception is not thrown if the data source is already being deleted. While the data source is being deleted, the Status field returned by a call to the DescribeDataSource API is set to DELETING. For more information, see Deleting Data Sources. Deleting an entire data source or re-syncing your index after deleting specific documents from a data source could take up to an hour or more, depending on the number of documents you want to delete.

Sourcemodule DeleteExperienceRequest : sig ... end

Deletes your Amazon Kendra experience such as a search application. For more information on creating a search application experience, see Building a search experience with no code.

Sourcemodule DeleteExperienceResponse : sig ... end

Deletes your Amazon Kendra experience such as a search application. For more information on creating a search application experience, see Building a search experience with no code.

Sourcemodule DeleteFaqRequest : sig ... end

Removes a FAQ from an index.

Sourcemodule DeleteIndexRequest : sig ... end

Deletes an Amazon Kendra index. An exception is not thrown if the index is already being deleted. While the index is being deleted, the Status field returned by a call to the DescribeIndex API is set to DELETING.

Sourcemodule PrincipalOrderingId : sig ... end
Sourcemodule GroupId : sig ... end

Deletes a group so that all users that belong to the group can no longer access documents only available to that group. For example, after deleting the group "Summer Interns", all interns who belonged to that group no longer see intern-only documents in their search results. If you want to delete or replace users or sub groups of a group, you need to use the PutPrincipalMapping operation. For example, if a user in the group "Engineering" leaves the engineering team and another user takes their place, you provide an updated list of users or sub groups that belong to the "Engineering" group when calling PutPrincipalMapping. You can update your internal list of users or sub groups and input this list when calling PutPrincipalMapping. DeletePrincipalMapping is currently not supported in the Amazon Web Services GovCloud (US-West) region.

Deletes a block list used for query suggestions for an index. A deleted block list might not take effect right away. Amazon Kendra needs to refresh the entire suggestions list to add back the queries that were previously blocked. DeleteQuerySuggestionsBlockList is currently not supported in the Amazon Web Services GovCloud (US-West) region.

Sourcemodule DeleteThesaurusRequest : sig ... end

Deletes an Amazon Kendra thesaurus.

Gets information about an access control configuration that you created for your documents in an index. This includes user and group access information for your documents. This is useful for user context filtering, where search results are filtered based on the user or their group access to documents.

Gets information about an access control configuration that you created for your documents in an index. This includes user and group access information for your documents. This is useful for user context filtering, where search results are filtered based on the user or their group access to documents.

Sourcemodule DescribeDataSourceRequest : sig ... end

Gets information about an Amazon Kendra data source connector.

Gets information about an Amazon Kendra data source connector.

Sourcemodule DescribeExperienceRequest : sig ... end

Gets information about your Amazon Kendra experience such as a search application. For more information on creating a search application experience, see Building a search experience with no code.

Sourcemodule ExperienceStatus : sig ... end
Sourcemodule EndpointType : sig ... end
Sourcemodule Endpoint : sig ... end
Sourcemodule ExperienceEndpoint : sig ... end

Provides the configuration information for the endpoint for your Amazon Kendra experience.

Sourcemodule ExperienceEndpoints : sig ... end

Gets information about your Amazon Kendra experience such as a search application. For more information on creating a search application experience, see Building a search experience with no code.

Sourcemodule DescribeFaqRequest : sig ... end

Gets information about a FAQ.

Sourcemodule FaqStatus : sig ... end
Sourcemodule DescribeFaqResponse : sig ... end

Gets information about a FAQ.

Gets information about a set of featured results. Features results are placed above all other results for certain queries. If there's an exact match of a query, then one or more specific documents are featured in the search results.

A featured document with its metadata information. This document is displayed at the top of the search results page, placed above all other results for certain queries. If there's an exact match of a query, then the document is featured in the search results.

Sourcemodule FeaturedDocumentMissing : sig ... end

A document ID doesn't exist but you have specified as a featured document. Amazon Kendra cannot feature the document if it doesn't exist in the index. You can check the status of a document and its ID or check for documents with status errors using the BatchGetDocumentStatus API.

Gets information about a set of featured results. Features results are placed above all other results for certain queries. If there's an exact match of a query, then one or more specific documents are featured in the search results.

Sourcemodule DescribeIndexRequest : sig ... end

Gets information about an Amazon Kendra index.

Sourcemodule IndexStatus : sig ... end
Sourcemodule IndexedTextDocumentsCount : sig ... end
Sourcemodule IndexedTextBytes : sig ... end
Sourcemodule TextDocumentStatistics : sig ... end

Provides information about text documents indexed in an index.

Sourcemodule FaqStatistics : sig ... end

Provides statistical information about the FAQ questions and answers for an index.

Sourcemodule IndexStatistics : sig ... end

Provides information about the number of documents and the number of questions and answers in an index.

Provides information about how a custom index field is used during a search.

Sourcemodule ValueImportanceMapKey : sig ... end
Sourcemodule Importance : sig ... end
Sourcemodule ValueImportanceMap : sig ... end
Sourcemodule Order : sig ... end
Sourcemodule Duration : sig ... end
Sourcemodule DocumentMetadataBoolean : sig ... end
Sourcemodule Relevance : sig ... end

Provides information for tuning the relevance of a field in a search. When a query includes terms that match the field, the results are given a boost in the response based on these tuning parameters.

Specifies the properties, such as relevance tuning and searchability, of an index field.

Sourcemodule DescribeIndexResponse : sig ... end

Gets information about an Amazon Kendra index.

Describes the processing of PUT and DELETE actions for mapping users to their groups. This includes information on the status of actions currently processing or yet to be processed, when actions were last updated, when actions were received by Amazon Kendra, the latest action that should process and apply after other actions, and useful error messages if an action could not be processed. DescribePrincipalMapping is currently not supported in the Amazon Web Services GovCloud (US-West) region.

Sourcemodule PrincipalMappingStatus : sig ... end
Sourcemodule FailureReason : sig ... end
Sourcemodule GroupOrderingIdSummary : sig ... end

Summary information on the processing of PUT and DELETE actions for mapping users to their groups.

Sourcemodule GroupOrderingIdSummaries : sig ... end

Describes the processing of PUT and DELETE actions for mapping users to their groups. This includes information on the status of actions currently processing or yet to be processed, when actions were last updated, when actions were received by Amazon Kendra, the latest action that should process and apply after other actions, and useful error messages if an action could not be processed. DescribePrincipalMapping is currently not supported in the Amazon Web Services GovCloud (US-West) region.

Gets information about a block list used for query suggestions for an index. This is used to check the current settings that are applied to a block list. DescribeQuerySuggestionsBlockList is currently not supported in the Amazon Web Services GovCloud (US-West) region.

Gets information about a block list used for query suggestions for an index. This is used to check the current settings that are applied to a block list. DescribeQuerySuggestionsBlockList is currently not supported in the Amazon Web Services GovCloud (US-West) region.

Gets information on the settings of query suggestions for an index. This is used to check the current settings applied to query suggestions. DescribeQuerySuggestionsConfig is currently not supported in the Amazon Web Services GovCloud (US-West) region.

Sourcemodule QuerySuggestionsStatus : sig ... end
Sourcemodule Mode : sig ... end
Sourcemodule MinimumQueryCount : sig ... end

Gets information on the settings of query suggestions for an index. This is used to check the current settings applied to query suggestions. DescribeQuerySuggestionsConfig is currently not supported in the Amazon Web Services GovCloud (US-West) region.

Sourcemodule DescribeThesaurusRequest : sig ... end

Gets information about an Amazon Kendra thesaurus.

Sourcemodule ThesaurusStatus : sig ... end
Sourcemodule DescribeThesaurusResponse : sig ... end

Gets information about an Amazon Kendra thesaurus.

Sourcemodule DisassociateEntityList : sig ... end

Prevents users or groups in your IAM Identity Center identity source from accessing your Amazon Kendra experience. You can create an Amazon Kendra experience such as a search application. For more information on creating a search application experience, see Building a search experience with no code.

Prevents users or groups in your IAM Identity Center identity source from accessing your Amazon Kendra experience. You can create an Amazon Kendra experience such as a search application. For more information on creating a search application experience, see Building a search experience with no code.

Sourcemodule EntityIdsList : sig ... end

Removes the specific permissions of users or groups in your IAM Identity Center identity source with access to your Amazon Kendra experience. You can create an Amazon Kendra experience such as a search application. For more information on creating a search application experience, see Building a search experience with no code.

Removes the specific permissions of users or groups in your IAM Identity Center identity source with access to your Amazon Kendra experience. You can create an Amazon Kendra experience such as a search application. For more information on creating a search application experience, see Building a search experience with no code.

module DocumentAttributeValueCountPair : sig ... end

Provides the count of documents that match a particular document attribute or field when doing a faceted search.

module FacetResult : sig ... end

The facet values for the documents in the response.

module FacetResultList : sig ... end

Overrides the document relevance properties of a custom index field.

Sourcemodule DocumentTitle : sig ... end
Sourcemodule NameType : sig ... end
Sourcemodule EntityDisplayData : sig ... end

Information about the user entity.

Sourcemodule ExperienceEntitiesSummary : sig ... end

Summary information for users or groups in your IAM Identity Center identity source with granted access to your Amazon Kendra experience. You can create an Amazon Kendra experience such as a search application. For more information on creating a search application experience, see Building a search experience with no code.

Sourcemodule ExperiencesSummary : sig ... end

Summary information for your Amazon Kendra experience. You can create an Amazon Kendra experience such as a search application. For more information on creating a search application experience, see Building a search experience with no code.

Sourcemodule ExperiencesSummaryList : sig ... end
module Facet : sig ... end

Information about a document attribute or field. You can use document attributes as facets. For example, the document attribute or facet "Department" includes the values "HR", "Engineering", and "Accounting". You can display these values in the search results so that documents can be searched by department. You can display up to 10 facet values per facet for a query. If you want to increase this limit, contact Support.

module FacetList : sig ... end
Sourcemodule FaqSummary : sig ... end

Summary information for frequently asked questions and answers included in an index.

Sourcemodule FaqSummaryItems : sig ... end
Sourcemodule QueryResultType : sig ... end
Sourcemodule FeedbackToken : sig ... end
Sourcemodule FeaturedResultsItem : sig ... end

A single featured result item. A featured result is displayed at the top of the search results page, placed above all other results for certain queries. If there's an exact match of a query, then certain documents are featured in the search results.

Sourcemodule FeaturedResultsItemList : sig ... end
Sourcemodule FeaturedResultsSetSummary : sig ... end

Summary information for a set of featured results. Featured results are placed above all other results for certain queries. If there's an exact match of a query, then one or more specific documents are featured in the search results.

Sourcemodule SuggestionType : sig ... end
Sourcemodule SuggestionTypes : sig ... end
Sourcemodule SuggestionQueryText : sig ... end

Fetches the queries that are suggested to your users. GetQuerySuggestions is currently not supported in the Amazon Web Services GovCloud (US-West) region.

Sourcemodule SuggestionHighlight : sig ... end

The text highlights for a single query suggestion.

Sourcemodule SuggestionHighlightList : sig ... end

Provides text and information about where to highlight the query suggestion text.

Sourcemodule SuggestionValue : sig ... end

The SuggestionTextWithHighlights structure information.

Sourcemodule SourceDocument : sig ... end

The document ID and its fields/attributes that are used for a query suggestion, if document fields set to use for query suggestions.

Sourcemodule SourceDocuments : sig ... end
Sourcemodule Suggestion : sig ... end

A single query suggestion.

Sourcemodule SuggestionList : sig ... end
Sourcemodule QuerySuggestionsId : sig ... end

Fetches the queries that are suggested to your users. GetQuerySuggestions is currently not supported in the Amazon Web Services GovCloud (US-West) region.

Sourcemodule NextToken : sig ... end
Sourcemodule MetricType : sig ... end
Sourcemodule Interval : sig ... end
Sourcemodule GetSnapshotsRequest : sig ... end

Retrieves search metrics data. The data provides a snapshot of how your users interact with your search application and how effective the application is.

Sourcemodule TimeRange : sig ... end

Provides a range of time.

Sourcemodule SnapshotsDataRecord : sig ... end
Sourcemodule SnapshotsDataRecords : sig ... end
Sourcemodule SnapshotsDataHeaderFields : sig ... end
Sourcemodule InvalidRequestException : sig ... end

The input to the request is not valid. Please provide the correct input and try again.

Sourcemodule GetSnapshotsResponse : sig ... end

Retrieves search metrics data. The data provides a snapshot of how your users interact with your search application and how effective the application is.

Sourcemodule UserId : sig ... end
Sourcemodule MemberUser : sig ... end

The users that belong to a group.

Sourcemodule MemberUsers : sig ... end
Sourcemodule MemberGroup : sig ... end

The sub groups that belong to a group.

Sourcemodule MemberGroups : sig ... end
Sourcemodule GroupMembers : sig ... end

A list of users that belong to a group. This is useful for user context filtering, where search results are filtered based on the user or their group access to documents.

Sourcemodule GroupSummary : sig ... end

Summary information for groups.

Sourcemodule IndexConfigurationSummary : sig ... end

Summary information on the configuration of an index.

Lists one or more access control configurations for an index. This includes user and group access information for your documents. This is useful for user context filtering, where search results are filtered based on the user or their group access to documents.

Lists one or more access control configurations for an index. This includes user and group access information for your documents. This is useful for user context filtering, where search results are filtered based on the user or their group access to documents.

Gets statistics about synchronizing a data source connector.

Gets statistics about synchronizing a data source connector.

Sourcemodule ListDataSourcesRequest : sig ... end

Lists the data source connectors that you have created.

Sourcemodule ListDataSourcesResponse : sig ... end

Lists the data source connectors that you have created.

Sourcemodule ListEntityPersonasRequest : sig ... end

Lists specific permissions of users and groups with access to your Amazon Kendra experience.

Sourcemodule PersonasSummary : sig ... end

Summary information for users or groups in your IAM Identity Center identity source. This applies to users and groups with specific permissions that define their level of access to your Amazon Kendra experience. You can create an Amazon Kendra experience such as a search application. For more information on creating a search application experience, see Building a search experience with no code.

Sourcemodule PersonasSummaryList : sig ... end

Lists specific permissions of users and groups with access to your Amazon Kendra experience.

Lists users or groups in your IAM Identity Center identity source that are granted access to your Amazon Kendra experience. You can create an Amazon Kendra experience such as a search application. For more information on creating a search application experience, see Building a search experience with no code.

Lists users or groups in your IAM Identity Center identity source that are granted access to your Amazon Kendra experience. You can create an Amazon Kendra experience such as a search application. For more information on creating a search application experience, see Building a search experience with no code.

Sourcemodule ListExperiencesRequest : sig ... end

Lists one or more Amazon Kendra experiences. You can create an Amazon Kendra experience such as a search application. For more information on creating a search application experience, see Building a search experience with no code.

Sourcemodule ListExperiencesResponse : sig ... end

Lists one or more Amazon Kendra experiences. You can create an Amazon Kendra experience such as a search application. For more information on creating a search application experience, see Building a search experience with no code.

Sourcemodule ListFaqsRequest : sig ... end

Gets a list of FAQs associated with an index.

Sourcemodule ListFaqsResponse : sig ... end

Gets a list of FAQs associated with an index.

Lists all your sets of featured results for a given index. Features results are placed above all other results for certain queries. If there's an exact match of a query, then one or more specific documents are featured in the search results.

Lists all your sets of featured results for a given index. Features results are placed above all other results for certain queries. If there's an exact match of a query, then one or more specific documents are featured in the search results.

Provides a list of groups that are mapped to users before a given ordering or timestamp identifier. ListGroupsOlderThanOrderingId is currently not supported in the Amazon Web Services GovCloud (US-West) region.

Sourcemodule ListOfGroupSummaries : sig ... end

Provides a list of groups that are mapped to users before a given ordering or timestamp identifier. ListGroupsOlderThanOrderingId is currently not supported in the Amazon Web Services GovCloud (US-West) region.

Sourcemodule ListIndicesRequest : sig ... end

Lists the Amazon Kendra indexes that you created.

Sourcemodule ListIndicesResponse : sig ... end

Lists the Amazon Kendra indexes that you created.

Lists the block lists used for query suggestions for an index. For information on the current quota limits for block lists, see Quotas for Amazon Kendra. ListQuerySuggestionsBlockLists is currently not supported in the Amazon Web Services GovCloud (US-West) region.

Summary information on a query suggestions block list. This includes information on the block list ID, block list name, when the block list was created, when the block list was last updated, and the count of block words/phrases in the block list. For information on the current quota limits for block lists, see Quotas for Amazon Kendra.

Lists the block lists used for query suggestions for an index. For information on the current quota limits for block lists, see Quotas for Amazon Kendra. ListQuerySuggestionsBlockLists is currently not supported in the Amazon Web Services GovCloud (US-West) region.

Gets a list of tags associated with a resource. Indexes, FAQs, data sources, and other resources can have tags associated with them.

The resource you want to use isn't available. Please check you have provided the correct resource and try again.

Gets a list of tags associated with a resource. Indexes, FAQs, data sources, and other resources can have tags associated with them.

Sourcemodule ListThesauriRequest : sig ... end

Lists the thesauri for an index.

Sourcemodule ThesaurusSummary : sig ... end

An array of summary information for a thesaurus or multiple thesauri.

Sourcemodule ThesaurusSummaryItems : sig ... end
Sourcemodule ListThesauriResponse : sig ... end

Lists the thesauri for an index.

Maps users to their groups so that you only need to provide the user ID when you issue the query. You can also map sub groups to groups. For example, the group "Company Intellectual Property Teams" includes sub groups "Research" and "Engineering". These sub groups include their own list of users or people who work in these teams. Only users who work in research and engineering, and therefore belong in the intellectual property group, can see top-secret company documents in their search results. This is useful for user context filtering, where search results are filtered based on the user or their group access to documents. For more information, see Filtering on user context. If more than five PUT actions for a group are currently processing, a validation exception is thrown.

Sourcemodule QueryId : sig ... end
Sourcemodule VisitorId : sig ... end

Provides the configuration information for suggested query spell corrections. Suggested spell corrections are based on words that appear in your indexed documents and how closely a corrected word matches a misspelled word. This feature is designed with certain defaults or limits. For information on the current limits and how to request more support for some limits, see the Spell Checker documentation.

Sourcemodule QueryRequest : sig ... end

Searches an index given an input query. If you are working with large language models (LLMs) or implementing retrieval augmented generation (RAG) systems, you can use Amazon Kendra's Retrieve API, which can return longer semantically relevant passages. We recommend using the Retrieve API instead of filing a service limit increase to increase the Query API document excerpt length. You can configure boosting or relevance tuning at the query level to override boosting at the index level, filter based on document fields/attributes and faceted search, and filter based on the user or their group access to documents. You can also include certain fields in the response that might provide useful additional information. A query response contains three types of results. Relevant suggested answers. The answers can be either a text excerpt or table excerpt. The answer can be highlighted in the excerpt. Matching FAQs or questions-answer from your FAQ file. Relevant documents. This result type includes an excerpt of the document with the document title. The searched terms can be highlighted in the excerpt. You can specify that the query return only one type of result using the QueryResultTypeFilter parameter. Each query returns the 100 most relevant results. If you filter result type to only question-answers, a maximum of four results are returned. If you filter result type to only answers, a maximum of three results are returned. If you're using an Amazon Kendra Gen AI Enterprise Edition index, you can only use ATTRIBUTE_FILTER to filter search results by user context. If you're using an Amazon Kendra Gen AI Enterprise Edition index and you try to use USER_TOKEN to configure user context policy, Amazon Kendra returns a ValidationException error.

Sourcemodule WarningMessage : sig ... end
Sourcemodule WarningCode : sig ... end
Sourcemodule Warning : sig ... end

The warning code and message that explains a problem with a query.

Sourcemodule WarningList : sig ... end
Sourcemodule SuggestedQueryText : sig ... end
Sourcemodule SpellCorrectedQuery : sig ... end

A query with suggested spell corrections.

Sourcemodule SpellCorrectedQueryList : sig ... end
Sourcemodule TableCell : sig ... end

Provides information about a table cell in a table excerpt.

Sourcemodule TableCellList : sig ... end
Sourcemodule TableRow : sig ... end

Information about a row in a table excerpt.

Sourcemodule TableRowList : sig ... end
Sourcemodule TableExcerpt : sig ... end

An excerpt from a table within a document. The table excerpt displays up to five columns and three rows, depending on how many table cells are relevant to the query and how many columns are available in the original table. The top most relevant cell is displayed in the table excerpt, along with the next most relevant cells.

Sourcemodule ScoreConfidence : sig ... end
Sourcemodule ScoreAttributes : sig ... end

Provides a relative ranking that indicates how confident Amazon Kendra is that the response is relevant to the query.

Sourcemodule QueryResultFormat : sig ... end
Sourcemodule QueryResultItem : sig ... end

A single query result. A query result contains information about a document returned by the query. This includes the original location of the document, a list of attributes assigned to the document, and relevant text from the document that satisfies the query.

Sourcemodule QueryResultItemList : sig ... end
Sourcemodule QueryResult : sig ... end

Searches an index given an input query. If you are working with large language models (LLMs) or implementing retrieval augmented generation (RAG) systems, you can use Amazon Kendra's Retrieve API, which can return longer semantically relevant passages. We recommend using the Retrieve API instead of filing a service limit increase to increase the Query API document excerpt length. You can configure boosting or relevance tuning at the query level to override boosting at the index level, filter based on document fields/attributes and faceted search, and filter based on the user or their group access to documents. You can also include certain fields in the response that might provide useful additional information. A query response contains three types of results. Relevant suggested answers. The answers can be either a text excerpt or table excerpt. The answer can be highlighted in the excerpt. Matching FAQs or questions-answer from your FAQ file. Relevant documents. This result type includes an excerpt of the document with the document title. The searched terms can be highlighted in the excerpt. You can specify that the query return only one type of result using the QueryResultTypeFilter parameter. Each query returns the 100 most relevant results. If you filter result type to only question-answers, a maximum of four results are returned. If you filter result type to only answers, a maximum of three results are returned. If you're using an Amazon Kendra Gen AI Enterprise Edition index, you can only use ATTRIBUTE_FILTER to filter search results by user context. If you're using an Amazon Kendra Gen AI Enterprise Edition index and you try to use USER_TOKEN to configure user context policy, Amazon Kendra returns a ValidationException error.

Sourcemodule RelevanceType : sig ... end
Sourcemodule RelevanceFeedback : sig ... end

Provides feedback on how relevant a document is to a search. Your application uses the SubmitFeedback API to provide relevance information.

Sourcemodule RelevanceFeedbackList : sig ... end
Sourcemodule ResourceInUseException : sig ... end

The resource you want to use is currently in use. Please check you have provided the correct resource and try again.

Sourcemodule RetrieveRequest : sig ... end

Retrieves relevant passages or text excerpts given an input query. This API is similar to the Query API. However, by default, the Query API only returns excerpt passages of up to 100 token words. With the Retrieve API, you can retrieve longer passages of up to 200 token words and up to 100 semantically relevant passages. This doesn't include question-answer or FAQ type responses from your index. The passages are text excerpts that can be semantically extracted from multiple documents and multiple parts of the same document. If in extreme cases your documents produce zero passages using the Retrieve API, you can alternatively use the Query API and its types of responses. You can also do the following: Override boosting at the index level Filter based on document fields or attributes Filter based on the user or their group access to documents View the confidence score bucket for a retrieved passage result. The confidence bucket provides a relative ranking that indicates how confident Amazon Kendra is that the response is relevant to the query. Confidence score buckets are currently available only for English. You can also include certain fields in the response that might provide useful additional information. The Retrieve API shares the number of query capacity units that you set for your index. For more information on what's included in a single capacity unit and the default base capacity for an index, see Adjusting capacity. If you're using an Amazon Kendra Gen AI Enterprise Edition index, you can only use ATTRIBUTE_FILTER to filter search results by user context. If you're using an Amazon Kendra Gen AI Enterprise Edition index and you try to use USER_TOKEN to configure user context policy, Amazon Kendra returns a ValidationException error.

Sourcemodule RetrieveResultItem : sig ... end

A single retrieved relevant passage result.

Sourcemodule RetrieveResultItemList : sig ... end
Sourcemodule RetrieveResult : sig ... end

Retrieves relevant passages or text excerpts given an input query. This API is similar to the Query API. However, by default, the Query API only returns excerpt passages of up to 100 token words. With the Retrieve API, you can retrieve longer passages of up to 200 token words and up to 100 semantically relevant passages. This doesn't include question-answer or FAQ type responses from your index. The passages are text excerpts that can be semantically extracted from multiple documents and multiple parts of the same document. If in extreme cases your documents produce zero passages using the Retrieve API, you can alternatively use the Query API and its types of responses. You can also do the following: Override boosting at the index level Filter based on document fields or attributes Filter based on the user or their group access to documents View the confidence score bucket for a retrieved passage result. The confidence bucket provides a relative ranking that indicates how confident Amazon Kendra is that the response is relevant to the query. Confidence score buckets are currently available only for English. You can also include certain fields in the response that might provide useful additional information. The Retrieve API shares the number of query capacity units that you set for your index. For more information on what's included in a single capacity unit and the default base capacity for an index, see Adjusting capacity. If you're using an Amazon Kendra Gen AI Enterprise Edition index, you can only use ATTRIBUTE_FILTER to filter search results by user context. If you're using an Amazon Kendra Gen AI Enterprise Edition index and you try to use USER_TOKEN to configure user context policy, Amazon Kendra returns a ValidationException error.

Starts a synchronization job for a data source connector. If a synchronization job is already in progress, Amazon Kendra returns a ResourceInUseException exception. Re-syncing your data source with your index after modifying, adding, or deleting documents from your data source respository could take up to an hour or more, depending on the number of documents to sync.

Starts a synchronization job for a data source connector. If a synchronization job is already in progress, Amazon Kendra returns a ResourceInUseException exception. Re-syncing your data source with your index after modifying, adding, or deleting documents from your data source respository could take up to an hour or more, depending on the number of documents to sync.

Stops a synchronization job that is currently running. You can't stop a scheduled synchronization job.

Sourcemodule SubmitFeedbackRequest : sig ... end

Enables you to provide feedback to Amazon Kendra to improve the performance of your index. SubmitFeedback is currently not supported in the Amazon Web Services GovCloud (US-West) region.

Sourcemodule TagKeyList : sig ... end
Sourcemodule TagResourceRequest : sig ... end

Adds the specified tag to the specified index, FAQ, data source, or other resource. If the tag already exists, the existing value is replaced with the new value.

Sourcemodule TagResourceResponse : sig ... end

Adds the specified tag to the specified index, FAQ, data source, or other resource. If the tag already exists, the existing value is replaced with the new value.

Sourcemodule UntagResourceRequest : sig ... end

Removes a tag from an index, FAQ, data source, or other resource.

Sourcemodule UntagResourceResponse : sig ... end

Removes a tag from an index, FAQ, data source, or other resource.

Updates an access control configuration for your documents in an index. This includes user and group access information for your documents. This is useful for user context filtering, where search results are filtered based on the user or their group access to documents. You can update an access control configuration you created without indexing all of your documents again. For example, your index contains top-secret company documents that only certain employees or users should access. You created an 'allow' access control configuration for one user who recently joined the 'top-secret' team, switching from a team with 'deny' access to top-secret documents. However, the user suddenly returns to their previous team and should no longer have access to top secret documents. You can update the access control configuration to re-configure access control for your documents as circumstances change. You call the BatchPutDocument API to apply the updated access control configuration, with the AccessControlConfigurationId included in the Document object. If you use an S3 bucket as a data source, you synchronize your data source to apply the AccessControlConfigurationId in the .metadata.json file. Amazon Kendra currently only supports access control configuration for S3 data sources and documents indexed using the BatchPutDocument API. You can't configure access control using CreateAccessControlConfiguration for an Amazon Kendra Gen AI Enterprise Edition index. Amazon Kendra will return a ValidationException error for a Gen_AI_ENTERPRISE_EDITION index.

Updates an access control configuration for your documents in an index. This includes user and group access information for your documents. This is useful for user context filtering, where search results are filtered based on the user or their group access to documents. You can update an access control configuration you created without indexing all of your documents again. For example, your index contains top-secret company documents that only certain employees or users should access. You created an 'allow' access control configuration for one user who recently joined the 'top-secret' team, switching from a team with 'deny' access to top-secret documents. However, the user suddenly returns to their previous team and should no longer have access to top secret documents. You can update the access control configuration to re-configure access control for your documents as circumstances change. You call the BatchPutDocument API to apply the updated access control configuration, with the AccessControlConfigurationId included in the Document object. If you use an S3 bucket as a data source, you synchronize your data source to apply the AccessControlConfigurationId in the .metadata.json file. Amazon Kendra currently only supports access control configuration for S3 data sources and documents indexed using the BatchPutDocument API. You can't configure access control using CreateAccessControlConfiguration for an Amazon Kendra Gen AI Enterprise Edition index. Amazon Kendra will return a ValidationException error for a Gen_AI_ENTERPRISE_EDITION index.

Sourcemodule UpdateDataSourceRequest : sig ... end

Updates an Amazon Kendra data source connector.

Sourcemodule UpdateExperienceRequest : sig ... end

Updates your Amazon Kendra experience such as a search application. For more information on creating a search application experience, see Building a search experience with no code.

Updates a set of featured results. Features results are placed above all other results for certain queries. You map specific queries to specific documents for featuring in the results. If a query contains an exact match of a query, then one or more specific documents are featured in the search results.

Updates a set of featured results. Features results are placed above all other results for certain queries. You map specific queries to specific documents for featuring in the results. If a query contains an exact match of a query, then one or more specific documents are featured in the search results.

Sourcemodule UpdateIndexRequest : sig ... end

Updates an Amazon Kendra index.

Updates a block list used for query suggestions for an index. Updates to a block list might not take effect right away. Amazon Kendra needs to refresh the entire suggestions list to apply any updates to the block list. Other changes not related to the block list apply immediately. If a block list is updating, then you need to wait for the first update to finish before submitting another update. Amazon Kendra supports partial updates, so you only need to provide the fields you want to update. UpdateQuerySuggestionsBlockList is currently not supported in the Amazon Web Services GovCloud (US-West) region.

Updates the settings of query suggestions for an index. Amazon Kendra supports partial updates, so you only need to provide the fields you want to update. If an update is currently processing, you need to wait for the update to finish before making another update. Updates to query suggestions settings might not take effect right away. The time for your updated settings to take effect depends on the updates made and the number of search queries in your index. You can still enable/disable query suggestions at any time. UpdateQuerySuggestionsConfig is currently not supported in the Amazon Web Services GovCloud (US-West) region.

Sourcemodule UpdateThesaurusRequest : sig ... end

Updates a thesaurus for an index.