AWS SDK for C++AWS SDK for C++ Version 1.11.606 |
#include <KendraClient.h>
Amazon Kendra is a service for indexing large document sets.
Definition at line 21 of file KendraClient.h.
Definition at line 24 of file KendraClient.h.
Definition at line 28 of file KendraClient.h.
Definition at line 29 of file KendraClient.h.
Aws::kendra::KendraClientConfiguration()
,
nullptr
Initializes client to use DefaultCredentialProviderChain, with default http client factory, and optional client config. If client config is not specified, it will be initialized to default values.
nullptr
,
Aws::kendra::KendraClientConfiguration()
Initializes client to use SimpleAWSCredentialsProvider, with default http client factory, and optional client config. If client config is not specified, it will be initialized to default values.
nullptr
,
Aws::kendra::KendraClientConfiguration()
Initializes client to use specified credentials provider with specified client config. If http client factory is not supplied, the default http client factory will be used
Initializes client to use DefaultCredentialProviderChain, with default http client factory, and optional client config. If client config is not specified, it will be initialized to default values.
Initializes client to use SimpleAWSCredentialsProvider, with default http client factory, and optional client config. If client config is not specified, it will be initialized to default values.
Initializes client to use specified credentials provider with specified client config. If http client factory is not supplied, the default http client factory will be used
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.
nullptr
An Async wrapper for AssociateEntitiesToExperience that queues the request into a thread executor and triggers associated callback when operation has finished.
Definition at line 104 of file KendraClient.h.
A Callable wrapper for AssociateEntitiesToExperience that returns a future to the operation so that it can be executed in parallel to other requests.
Definition at line 95 of file KendraClient.h.
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.
nullptr
An Async wrapper for AssociatePersonasToEntities that queues the request into a thread executor and triggers associated callback when operation has finished.
Definition at line 134 of file KendraClient.h.
A Callable wrapper for AssociatePersonasToEntities that returns a future to the operation so that it can be executed in parallel to other requests.
Definition at line 125 of file KendraClient.h.
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.
nullptr
An Async wrapper for BatchDeleteDocument that queues the request into a thread executor and triggers associated callback when operation has finished.
Definition at line 167 of file KendraClient.h.
A Callable wrapper for BatchDeleteDocument that returns a future to the operation so that it can be executed in parallel to other requests.
Definition at line 158 of file KendraClient.h.
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.
nullptr
An Async wrapper for BatchDeleteFeaturedResultsSet that queues the request into a thread executor and triggers associated callback when operation has finished.
Definition at line 195 of file KendraClient.h.
A Callable wrapper for BatchDeleteFeaturedResultsSet that returns a future to the operation so that it can be executed in parallel to other requests.
Definition at line 186 of file KendraClient.h.
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.
nullptr
An Async wrapper for BatchGetDocumentStatus that queues the request into a thread executor and triggers associated callback when operation has finished.
Definition at line 231 of file KendraClient.h.
A Callable wrapper for BatchGetDocumentStatus that returns a future to the operation so that it can be executed in parallel to other requests.
Definition at line 222 of file KendraClient.h.
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.
nullptr
An Async wrapper for BatchPutDocument that queues the request into a thread executor and triggers associated callback when operation has finished.
Definition at line 268 of file KendraClient.h.
A Callable wrapper for BatchPutDocument that returns a future to the operation so that it can be executed in parallel to other requests.
Definition at line 259 of file KendraClient.h.
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.
nullptr
An Async wrapper for ClearQuerySuggestions that queues the request into a thread executor and triggers associated callback when operation has finished.
Definition at line 300 of file KendraClient.h.
A Callable wrapper for ClearQuerySuggestions that returns a future to the operation so that it can be executed in parallel to other requests.
Definition at line 291 of file KendraClient.h.
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.
nullptr
An Async wrapper for CreateAccessControlConfiguration that queues the request into a thread executor and triggers associated callback when operation has finished.
Definition at line 352 of file KendraClient.h.
A Callable wrapper for CreateAccessControlConfiguration that returns a future to the operation so that it can be executed in parallel to other requests.
Definition at line 343 of file KendraClient.h.
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.
nullptr
An Async wrapper for CreateDataSource that queues the request into a thread executor and triggers associated callback when operation has finished.
Definition at line 388 of file KendraClient.h.
A Callable wrapper for CreateDataSource that returns a future to the operation so that it can be executed in parallel to other requests.
Definition at line 379 of file KendraClient.h.
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.
nullptr
An Async wrapper for CreateExperience that queues the request into a thread executor and triggers associated callback when operation has finished.
Definition at line 417 of file KendraClient.h.
A Callable wrapper for CreateExperience that returns a future to the operation so that it can be executed in parallel to other requests.
Definition at line 408 of file KendraClient.h.
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.
nullptr
An Async wrapper for CreateFaq that queues the request into a thread executor and triggers associated callback when operation has finished.
Definition at line 447 of file KendraClient.h.
A Callable wrapper for CreateFaq that returns a future to the operation so that it can be executed in parallel to other requests.
Definition at line 438 of file KendraClient.h.
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.
nullptr
An Async wrapper for CreateFeaturedResultsSet that queues the request into a thread executor and triggers associated callback when operation has finished.
Definition at line 479 of file KendraClient.h.
A Callable wrapper for CreateFeaturedResultsSet that returns a future to the operation so that it can be executed in parallel to other requests.
Definition at line 470 of file KendraClient.h.
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.
nullptr
An Async wrapper for CreateIndex that queues the request into a thread executor and triggers associated callback when operation has finished.
Definition at line 517 of file KendraClient.h.
A Callable wrapper for CreateIndex that returns a future to the operation so that it can be executed in parallel to other requests.
Definition at line 508 of file KendraClient.h.
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.
nullptr
An Async wrapper for CreateQuerySuggestionsBlockList that queues the request into a thread executor and triggers associated callback when operation has finished.
Definition at line 554 of file KendraClient.h.
A Callable wrapper for CreateQuerySuggestionsBlockList that returns a future to the operation so that it can be executed in parallel to other requests.
Definition at line 545 of file KendraClient.h.
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.
nullptr
An Async wrapper for CreateThesaurus that queues the request into a thread executor and triggers associated callback when operation has finished.
Definition at line 583 of file KendraClient.h.
A Callable wrapper for CreateThesaurus that returns a future to the operation so that it can be executed in parallel to other requests.
Definition at line 574 of file KendraClient.h.
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.
nullptr
An Async wrapper for DeleteAccessControlConfiguration that queues the request into a thread executor and triggers associated callback when operation has finished.
Definition at line 612 of file KendraClient.h.
A Callable wrapper for DeleteAccessControlConfiguration that returns a future to the operation so that it can be executed in parallel to other requests.
Definition at line 603 of file KendraClient.h.
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.
nullptr
An Async wrapper for DeleteDataSource that queues the request into a thread executor and triggers associated callback when operation has finished.
Definition at line 646 of file KendraClient.h.
A Callable wrapper for DeleteDataSource that returns a future to the operation so that it can be executed in parallel to other requests.
Definition at line 637 of file KendraClient.h.
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.
nullptr
An Async wrapper for DeleteExperience that queues the request into a thread executor and triggers associated callback when operation has finished.
Definition at line 674 of file KendraClient.h.
A Callable wrapper for DeleteExperience that returns a future to the operation so that it can be executed in parallel to other requests.
Definition at line 665 of file KendraClient.h.
nullptr
An Async wrapper for DeleteFaq that queues the request into a thread executor and triggers associated callback when operation has finished.
Definition at line 699 of file KendraClient.h.
A Callable wrapper for DeleteFaq that returns a future to the operation so that it can be executed in parallel to other requests.
Definition at line 690 of file KendraClient.h.
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
.
nullptr
An Async wrapper for DeleteIndex that queues the request into a thread executor and triggers associated callback when operation has finished.
Definition at line 727 of file KendraClient.h.
A Callable wrapper for DeleteIndex that returns a future to the operation so that it can be executed in parallel to other requests.
Definition at line 718 of file KendraClient.h.
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.
nullptr
An Async wrapper for DeletePrincipalMapping that queues the request into a thread executor and triggers associated callback when operation has finished.
Definition at line 764 of file KendraClient.h.
A Callable wrapper for DeletePrincipalMapping that returns a future to the operation so that it can be executed in parallel to other requests.
Definition at line 755 of file KendraClient.h.
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.
nullptr
An Async wrapper for DeleteQuerySuggestionsBlockList that queues the request into a thread executor and triggers associated callback when operation has finished.
Definition at line 794 of file KendraClient.h.
A Callable wrapper for DeleteQuerySuggestionsBlockList that returns a future to the operation so that it can be executed in parallel to other requests.
Definition at line 785 of file KendraClient.h.
nullptr
An Async wrapper for DeleteThesaurus that queues the request into a thread executor and triggers associated callback when operation has finished.
Definition at line 819 of file KendraClient.h.
A Callable wrapper for DeleteThesaurus that returns a future to the operation so that it can be executed in parallel to other requests.
Definition at line 810 of file KendraClient.h.
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.
nullptr
An Async wrapper for DescribeAccessControlConfiguration that queues the request into a thread executor and triggers associated callback when operation has finished.
Definition at line 848 of file KendraClient.h.
A Callable wrapper for DescribeAccessControlConfiguration that returns a future to the operation so that it can be executed in parallel to other requests.
Definition at line 839 of file KendraClient.h.
nullptr
An Async wrapper for DescribeDataSource that queues the request into a thread executor and triggers associated callback when operation has finished.
Definition at line 874 of file KendraClient.h.
A Callable wrapper for DescribeDataSource that returns a future to the operation so that it can be executed in parallel to other requests.
Definition at line 865 of file KendraClient.h.
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.
nullptr
An Async wrapper for DescribeExperience that queues the request into a thread executor and triggers associated callback when operation has finished.
Definition at line 903 of file KendraClient.h.
A Callable wrapper for DescribeExperience that returns a future to the operation so that it can be executed in parallel to other requests.
Definition at line 894 of file KendraClient.h.
nullptr
An Async wrapper for DescribeFaq that queues the request into a thread executor and triggers associated callback when operation has finished.
Definition at line 928 of file KendraClient.h.
A Callable wrapper for DescribeFaq that returns a future to the operation so that it can be executed in parallel to other requests.
Definition at line 919 of file KendraClient.h.
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.
nullptr
An Async wrapper for DescribeFeaturedResultsSet that queues the request into a thread executor and triggers associated callback when operation has finished.
Definition at line 956 of file KendraClient.h.
A Callable wrapper for DescribeFeaturedResultsSet that returns a future to the operation so that it can be executed in parallel to other requests.
Definition at line 947 of file KendraClient.h.
nullptr
An Async wrapper for DescribeIndex that queues the request into a thread executor and triggers associated callback when operation has finished.
Definition at line 981 of file KendraClient.h.
A Callable wrapper for DescribeIndex that returns a future to the operation so that it can be executed in parallel to other requests.
Definition at line 972 of file KendraClient.h.
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.
nullptr
An Async wrapper for DescribePrincipalMapping that queues the request into a thread executor and triggers associated callback when operation has finished.
Definition at line 1013 of file KendraClient.h.
A Callable wrapper for DescribePrincipalMapping that returns a future to the operation so that it can be executed in parallel to other requests.
Definition at line 1004 of file KendraClient.h.
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.
nullptr
An Async wrapper for DescribeQuerySuggestionsBlockList that queues the request into a thread executor and triggers associated callback when operation has finished.
Definition at line 1042 of file KendraClient.h.
A Callable wrapper for DescribeQuerySuggestionsBlockList that returns a future to the operation so that it can be executed in parallel to other requests.
Definition at line 1033 of file KendraClient.h.
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.
nullptr
An Async wrapper for DescribeQuerySuggestionsConfig that queues the request into a thread executor and triggers associated callback when operation has finished.
Definition at line 1070 of file KendraClient.h.
A Callable wrapper for DescribeQuerySuggestionsConfig that returns a future to the operation so that it can be executed in parallel to other requests.
Definition at line 1061 of file KendraClient.h.
nullptr
An Async wrapper for DescribeThesaurus that queues the request into a thread executor and triggers associated callback when operation has finished.
Definition at line 1096 of file KendraClient.h.
A Callable wrapper for DescribeThesaurus that returns a future to the operation so that it can be executed in parallel to other requests.
Definition at line 1087 of file KendraClient.h.
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.
nullptr
An Async wrapper for DisassociateEntitiesFromExperience that queues the request into a thread executor and triggers associated callback when operation has finished.
Definition at line 1126 of file KendraClient.h.
A Callable wrapper for DisassociateEntitiesFromExperience that returns a future to the operation so that it can be executed in parallel to other requests.
Definition at line 1117 of file KendraClient.h.
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.
nullptr
An Async wrapper for DisassociatePersonasFromEntities that queues the request into a thread executor and triggers associated callback when operation has finished.
Definition at line 1156 of file KendraClient.h.
A Callable wrapper for DisassociatePersonasFromEntities that returns a future to the operation so that it can be executed in parallel to other requests.
Definition at line 1147 of file KendraClient.h.
Fetches the queries that are suggested to your users.
GetQuerySuggestions
is currently not supported in the Amazon Web Services GovCloud (US-West) region.
nullptr
An Async wrapper for GetQuerySuggestions that queues the request into a thread executor and triggers associated callback when operation has finished.
Definition at line 1183 of file KendraClient.h.
A Callable wrapper for GetQuerySuggestions that returns a future to the operation so that it can be executed in parallel to other requests.
Definition at line 1174 of file KendraClient.h.
Retrieves search metrics data. The data provides a snapshot of how your users interact with your search application and how effective the application is.
nullptr
An Async wrapper for GetSnapshots that queues the request into a thread executor and triggers associated callback when operation has finished.
Definition at line 1210 of file KendraClient.h.
A Callable wrapper for GetSnapshots that returns a future to the operation so that it can be executed in parallel to other requests.
Definition at line 1201 of file KendraClient.h.
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.
nullptr
An Async wrapper for ListAccessControlConfigurations that queues the request into a thread executor and triggers associated callback when operation has finished.
Definition at line 1238 of file KendraClient.h.
A Callable wrapper for ListAccessControlConfigurations that returns a future to the operation so that it can be executed in parallel to other requests.
Definition at line 1229 of file KendraClient.h.
nullptr
An Async wrapper for ListDataSources that queues the request into a thread executor and triggers associated callback when operation has finished.
Definition at line 1290 of file KendraClient.h.
A Callable wrapper for ListDataSources that returns a future to the operation so that it can be executed in parallel to other requests.
Definition at line 1281 of file KendraClient.h.
nullptr
An Async wrapper for ListDataSourceSyncJobs that queues the request into a thread executor and triggers associated callback when operation has finished.
Definition at line 1264 of file KendraClient.h.
A Callable wrapper for ListDataSourceSyncJobs that returns a future to the operation so that it can be executed in parallel to other requests.
Definition at line 1255 of file KendraClient.h.
Lists specific permissions of users and groups with access to your Amazon Kendra experience.
nullptr
An Async wrapper for ListEntityPersonas that queues the request into a thread executor and triggers associated callback when operation has finished.
Definition at line 1316 of file KendraClient.h.
A Callable wrapper for ListEntityPersonas that returns a future to the operation so that it can be executed in parallel to other requests.
Definition at line 1307 of file KendraClient.h.
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.
nullptr
An Async wrapper for ListExperienceEntities that queues the request into a thread executor and triggers associated callback when operation has finished.
Definition at line 1346 of file KendraClient.h.
A Callable wrapper for ListExperienceEntities that returns a future to the operation so that it can be executed in parallel to other requests.
Definition at line 1337 of file KendraClient.h.
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.
nullptr
An Async wrapper for ListExperiences that queues the request into a thread executor and triggers associated callback when operation has finished.
Definition at line 1375 of file KendraClient.h.
A Callable wrapper for ListExperiences that returns a future to the operation so that it can be executed in parallel to other requests.
Definition at line 1366 of file KendraClient.h.
nullptr
An Async wrapper for ListFaqs that queues the request into a thread executor and triggers associated callback when operation has finished.
Definition at line 1400 of file KendraClient.h.
A Callable wrapper for ListFaqs that returns a future to the operation so that it can be executed in parallel to other requests.
Definition at line 1391 of file KendraClient.h.
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.
nullptr
An Async wrapper for ListFeaturedResultsSets that queues the request into a thread executor and triggers associated callback when operation has finished.
Definition at line 1428 of file KendraClient.h.
A Callable wrapper for ListFeaturedResultsSets that returns a future to the operation so that it can be executed in parallel to other requests.
Definition at line 1419 of file KendraClient.h.
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.
nullptr
An Async wrapper for ListGroupsOlderThanOrderingId that queues the request into a thread executor and triggers associated callback when operation has finished.
Definition at line 1456 of file KendraClient.h.
A Callable wrapper for ListGroupsOlderThanOrderingId that returns a future to the operation so that it can be executed in parallel to other requests.
Definition at line 1447 of file KendraClient.h.
{}
)
const
nullptr
,
{}
An Async wrapper for ListIndices that queues the request into a thread executor and triggers associated callback when operation has finished.
Definition at line 1482 of file KendraClient.h.
{}
)
const
A Callable wrapper for ListIndices that returns a future to the operation so that it can be executed in parallel to other requests.
Definition at line 1473 of file KendraClient.h.
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.
nullptr
An Async wrapper for ListQuerySuggestionsBlockLists that queues the request into a thread executor and triggers associated callback when operation has finished.
Definition at line 1512 of file KendraClient.h.
A Callable wrapper for ListQuerySuggestionsBlockLists that returns a future to the operation so that it can be executed in parallel to other requests.
Definition at line 1503 of file KendraClient.h.
Gets a list of tags associated with a resource. Indexes, FAQs, data sources, and other resources can have tags associated with them.
nullptr
An Async wrapper for ListTagsForResource that queues the request into a thread executor and triggers associated callback when operation has finished.
Definition at line 1539 of file KendraClient.h.
A Callable wrapper for ListTagsForResource that returns a future to the operation so that it can be executed in parallel to other requests.
Definition at line 1530 of file KendraClient.h.
nullptr
An Async wrapper for ListThesauri that queues the request into a thread executor and triggers associated callback when operation has finished.
Definition at line 1564 of file KendraClient.h.
A Callable wrapper for ListThesauri that returns a future to the operation so that it can be executed in parallel to other requests.
Definition at line 1555 of file KendraClient.h.
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.
nullptr
An Async wrapper for PutPrincipalMapping that queues the request into a thread executor and triggers associated callback when operation has finished.
Definition at line 1601 of file KendraClient.h.
A Callable wrapper for PutPrincipalMapping that returns a future to the operation so that it can be executed in parallel to other requests.
Definition at line 1592 of file KendraClient.h.
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.
nullptr
An Async wrapper for Query that queues the request into a thread executor and triggers associated callback when operation has finished.
Definition at line 1653 of file KendraClient.h.
A Callable wrapper for Query that returns a future to the operation so that it can be executed in parallel to other requests.
Definition at line 1644 of file KendraClient.h.
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.
nullptr
An Async wrapper for Retrieve that queues the request into a thread executor and triggers associated callback when operation has finished.
Definition at line 1709 of file KendraClient.h.
A Callable wrapper for Retrieve that returns a future to the operation so that it can be executed in parallel to other requests.
Definition at line 1700 of file KendraClient.h.
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.
nullptr
An Async wrapper for StartDataSourceSyncJob that queues the request into a thread executor and triggers associated callback when operation has finished.
Definition at line 1739 of file KendraClient.h.
A Callable wrapper for StartDataSourceSyncJob that returns a future to the operation so that it can be executed in parallel to other requests.
Definition at line 1730 of file KendraClient.h.
Stops a synchronization job that is currently running. You can't stop a scheduled synchronization job.
nullptr
An Async wrapper for StopDataSourceSyncJob that queues the request into a thread executor and triggers associated callback when operation has finished.
Definition at line 1765 of file KendraClient.h.
A Callable wrapper for StopDataSourceSyncJob that returns a future to the operation so that it can be executed in parallel to other requests.
Definition at line 1756 of file KendraClient.h.
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.
nullptr
An Async wrapper for SubmitFeedback that queues the request into a thread executor and triggers associated callback when operation has finished.
Definition at line 1792 of file KendraClient.h.
A Callable wrapper for SubmitFeedback that returns a future to the operation so that it can be executed in parallel to other requests.
Definition at line 1783 of file KendraClient.h.
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.
nullptr
An Async wrapper for TagResource that queues the request into a thread executor and triggers associated callback when operation has finished.
Definition at line 1819 of file KendraClient.h.
A Callable wrapper for TagResource that returns a future to the operation so that it can be executed in parallel to other requests.
Definition at line 1810 of file KendraClient.h.
nullptr
An Async wrapper for UntagResource that queues the request into a thread executor and triggers associated callback when operation has finished.
Definition at line 1845 of file KendraClient.h.
A Callable wrapper for UntagResource that returns a future to the operation so that it can be executed in parallel to other requests.
Definition at line 1836 of file KendraClient.h.
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.
nullptr
An Async wrapper for UpdateAccessControlConfiguration that queues the request into a thread executor and triggers associated callback when operation has finished.
Definition at line 1896 of file KendraClient.h.
A Callable wrapper for UpdateAccessControlConfiguration that returns a future to the operation so that it can be executed in parallel to other requests.
Definition at line 1887 of file KendraClient.h.
nullptr
An Async wrapper for UpdateDataSource that queues the request into a thread executor and triggers associated callback when operation has finished.
Definition at line 1921 of file KendraClient.h.
A Callable wrapper for UpdateDataSource that returns a future to the operation so that it can be executed in parallel to other requests.
Definition at line 1912 of file KendraClient.h.
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.
nullptr
An Async wrapper for UpdateExperience that queues the request into a thread executor and triggers associated callback when operation has finished.
Definition at line 1949 of file KendraClient.h.
A Callable wrapper for UpdateExperience that returns a future to the operation so that it can be executed in parallel to other requests.
Definition at line 1940 of file KendraClient.h.
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.
nullptr
An Async wrapper for UpdateFeaturedResultsSet that queues the request into a thread executor and triggers associated callback when operation has finished.
Definition at line 1978 of file KendraClient.h.
A Callable wrapper for UpdateFeaturedResultsSet that returns a future to the operation so that it can be executed in parallel to other requests.
Definition at line 1969 of file KendraClient.h.
nullptr
An Async wrapper for UpdateIndex that queues the request into a thread executor and triggers associated callback when operation has finished.
Definition at line 2003 of file KendraClient.h.
A Callable wrapper for UpdateIndex that returns a future to the operation so that it can be executed in parallel to other requests.
Definition at line 1994 of file KendraClient.h.
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.
nullptr
An Async wrapper for UpdateQuerySuggestionsBlockList that queues the request into a thread executor and triggers associated callback when operation has finished.
Definition at line 2036 of file KendraClient.h.
A Callable wrapper for UpdateQuerySuggestionsBlockList that returns a future to the operation so that it can be executed in parallel to other requests.
Definition at line 2027 of file KendraClient.h.
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.
nullptr
An Async wrapper for UpdateQuerySuggestionsConfig that queues the request into a thread executor and triggers associated callback when operation has finished.
Definition at line 2070 of file KendraClient.h.
A Callable wrapper for UpdateQuerySuggestionsConfig that returns a future to the operation so that it can be executed in parallel to other requests.
Definition at line 2061 of file KendraClient.h.
nullptr
An Async wrapper for UpdateThesaurus that queues the request into a thread executor and triggers associated callback when operation has finished.
Definition at line 2095 of file KendraClient.h.
A Callable wrapper for UpdateThesaurus that returns a future to the operation so that it can be executed in parallel to other requests.
Definition at line 2086 of file KendraClient.h.
Definition at line 2102 of file KendraClient.h.