@ThreadSafe @Generated(value="com.amazonaws:aws-java-sdk-code-generator") public class AWSkendraClient extends AmazonWebServiceClient implements AWSkendra
Amazon Kendra is a service for indexing large document sets.
LOGGING_AWS_REQUEST_METRIC
ENDPOINT_PREFIX
Modifier and Type | Method and Description |
---|---|
AssociateEntitiesToExperienceResult |
associateEntitiesToExperience(AssociateEntitiesToExperienceRequest request)
Grants users or groups in your IAM Identity Center identity source access to your Amazon Kendra experience.
|
AssociatePersonasToEntitiesResult |
associatePersonasToEntities(AssociatePersonasToEntitiesRequest request)
Defines the specific permissions of users or groups in your IAM Identity Center identity source with access to
your Amazon Kendra experience.
|
BatchDeleteDocumentResult |
batchDeleteDocument(BatchDeleteDocumentRequest request)
Removes one or more documents from an index.
|
BatchDeleteFeaturedResultsSetResult |
batchDeleteFeaturedResultsSet(BatchDeleteFeaturedResultsSetRequest request)
Removes one or more sets of featured results.
|
BatchGetDocumentStatusResult |
batchGetDocumentStatus(BatchGetDocumentStatusRequest request)
Returns the indexing status for one or more documents submitted with the BatchPutDocument API.
|
BatchPutDocumentResult |
batchPutDocument(BatchPutDocumentRequest request)
Adds one or more documents to an index.
|
static AWSkendraClientBuilder |
builder() |
ClearQuerySuggestionsResult |
clearQuerySuggestions(ClearQuerySuggestionsRequest request)
Clears existing query suggestions from an index.
|
CreateAccessControlConfigurationResult |
createAccessControlConfiguration(CreateAccessControlConfigurationRequest request)
Creates an access configuration for your documents.
|
CreateDataSourceResult |
createDataSource(CreateDataSourceRequest request)
Creates a data source connector that you want to use with an Amazon Kendra index.
|
CreateExperienceResult |
createExperience(CreateExperienceRequest request)
Creates an Amazon Kendra experience such as a search application.
|
CreateFaqResult |
createFaq(CreateFaqRequest request)
Creates a set of frequently ask questions (FAQs) using a specified FAQ file stored in an Amazon S3 bucket.
|
CreateFeaturedResultsSetResult |
createFeaturedResultsSet(CreateFeaturedResultsSetRequest request)
Creates a set of featured results to display at the top of the search results page.
|
CreateIndexResult |
createIndex(CreateIndexRequest request)
Creates an Amazon Kendra index.
|
CreateQuerySuggestionsBlockListResult |
createQuerySuggestionsBlockList(CreateQuerySuggestionsBlockListRequest request)
Creates a block list to exlcude certain queries from suggestions.
|
CreateThesaurusResult |
createThesaurus(CreateThesaurusRequest request)
Creates a thesaurus for an index.
|
DeleteAccessControlConfigurationResult |
deleteAccessControlConfiguration(DeleteAccessControlConfigurationRequest request)
Deletes an access control configuration that you created for your documents in an index.
|
DeleteDataSourceResult |
deleteDataSource(DeleteDataSourceRequest request)
Deletes an Amazon Kendra data source connector.
|
DeleteExperienceResult |
deleteExperience(DeleteExperienceRequest request)
Deletes your Amazon Kendra experience such as a search application.
|
DeleteFaqResult |
deleteFaq(DeleteFaqRequest request)
Removes an FAQ from an index.
|
DeleteIndexResult |
deleteIndex(DeleteIndexRequest request)
Deletes an Amazon Kendra index.
|
DeletePrincipalMappingResult |
deletePrincipalMapping(DeletePrincipalMappingRequest request)
Deletes a group so that all users and sub groups that belong to the group can no longer access documents only
available to that group.
|
DeleteQuerySuggestionsBlockListResult |
deleteQuerySuggestionsBlockList(DeleteQuerySuggestionsBlockListRequest request)
Deletes a block list used for query suggestions for an index.
|
DeleteThesaurusResult |
deleteThesaurus(DeleteThesaurusRequest request)
Deletes an Amazon Kendra thesaurus.
|
DescribeAccessControlConfigurationResult |
describeAccessControlConfiguration(DescribeAccessControlConfigurationRequest request)
Gets information about an access control configuration that you created for your documents in an index.
|
DescribeDataSourceResult |
describeDataSource(DescribeDataSourceRequest request)
Gets information about an Amazon Kendra data source connector.
|
DescribeExperienceResult |
describeExperience(DescribeExperienceRequest request)
Gets information about your Amazon Kendra experience such as a search application.
|
DescribeFaqResult |
describeFaq(DescribeFaqRequest request)
Gets information about an FAQ list.
|
DescribeFeaturedResultsSetResult |
describeFeaturedResultsSet(DescribeFeaturedResultsSetRequest request)
Gets information about a set of featured results.
|
DescribeIndexResult |
describeIndex(DescribeIndexRequest request)
Gets information about an Amazon Kendra index.
|
DescribePrincipalMappingResult |
describePrincipalMapping(DescribePrincipalMappingRequest request)
Describes the processing of
PUT and DELETE actions for mapping users to their groups. |
DescribeQuerySuggestionsBlockListResult |
describeQuerySuggestionsBlockList(DescribeQuerySuggestionsBlockListRequest request)
Gets information about a block list used for query suggestions for an index.
|
DescribeQuerySuggestionsConfigResult |
describeQuerySuggestionsConfig(DescribeQuerySuggestionsConfigRequest request)
Gets information on the settings of query suggestions for an index.
|
DescribeThesaurusResult |
describeThesaurus(DescribeThesaurusRequest request)
Gets information about an Amazon Kendra thesaurus.
|
DisassociateEntitiesFromExperienceResult |
disassociateEntitiesFromExperience(DisassociateEntitiesFromExperienceRequest request)
Prevents users or groups in your IAM Identity Center identity source from accessing your Amazon Kendra
experience.
|
DisassociatePersonasFromEntitiesResult |
disassociatePersonasFromEntities(DisassociatePersonasFromEntitiesRequest request)
Removes the specific permissions of users or groups in your IAM Identity Center identity source with access to
your Amazon Kendra experience.
|
ResponseMetadata |
getCachedResponseMetadata(AmazonWebServiceRequest request)
Returns additional metadata for a previously executed successful, request, typically used for debugging issues
where a service isn't acting as expected.
|
GetQuerySuggestionsResult |
getQuerySuggestions(GetQuerySuggestionsRequest request)
Fetches the queries that are suggested to your users.
|
GetSnapshotsResult |
getSnapshots(GetSnapshotsRequest request)
Retrieves search metrics data.
|
ListAccessControlConfigurationsResult |
listAccessControlConfigurations(ListAccessControlConfigurationsRequest request)
Lists one or more access control configurations for an index.
|
ListDataSourcesResult |
listDataSources(ListDataSourcesRequest request)
Lists the data source connectors that you have created.
|
ListDataSourceSyncJobsResult |
listDataSourceSyncJobs(ListDataSourceSyncJobsRequest request)
Gets statistics about synchronizing a data source connector.
|
ListEntityPersonasResult |
listEntityPersonas(ListEntityPersonasRequest request)
Lists specific permissions of users and groups with access to your Amazon Kendra experience.
|
ListExperienceEntitiesResult |
listExperienceEntities(ListExperienceEntitiesRequest request)
Lists users or groups in your IAM Identity Center identity source that are granted access to your Amazon Kendra
experience.
|
ListExperiencesResult |
listExperiences(ListExperiencesRequest request)
Lists one or more Amazon Kendra experiences.
|
ListFaqsResult |
listFaqs(ListFaqsRequest request)
Gets a list of FAQ lists associated with an index.
|
ListFeaturedResultsSetsResult |
listFeaturedResultsSets(ListFeaturedResultsSetsRequest request)
Lists all your sets of featured results for a given index.
|
ListGroupsOlderThanOrderingIdResult |
listGroupsOlderThanOrderingId(ListGroupsOlderThanOrderingIdRequest request)
Provides a list of groups that are mapped to users before a given ordering or timestamp identifier.
|
ListIndicesResult |
listIndices(ListIndicesRequest request)
Lists the Amazon Kendra indexes that you created.
|
ListQuerySuggestionsBlockListsResult |
listQuerySuggestionsBlockLists(ListQuerySuggestionsBlockListsRequest request)
Lists the block lists used for query suggestions for an index.
|
ListTagsForResourceResult |
listTagsForResource(ListTagsForResourceRequest request)
Gets a list of tags associated with a specified resource.
|
ListThesauriResult |
listThesauri(ListThesauriRequest request)
Lists the thesauri for an index.
|
PutPrincipalMappingResult |
putPrincipalMapping(PutPrincipalMappingRequest request)
Maps users to their groups so that you only need to provide the user ID when you issue the query.
|
QueryResult |
query(QueryRequest request)
Searches an index given an input query.
|
RetrieveResult |
retrieve(RetrieveRequest request)
Retrieves relevant passages or text excerpts given an input query.
|
void |
shutdown()
Shuts down this client object, releasing any resources that might be held
open.
|
StartDataSourceSyncJobResult |
startDataSourceSyncJob(StartDataSourceSyncJobRequest request)
Starts a synchronization job for a data source connector.
|
StopDataSourceSyncJobResult |
stopDataSourceSyncJob(StopDataSourceSyncJobRequest request)
Stops a synchronization job that is currently running.
|
SubmitFeedbackResult |
submitFeedback(SubmitFeedbackRequest request)
Enables you to provide feedback to Amazon Kendra to improve the performance of your index.
|
TagResourceResult |
tagResource(TagResourceRequest request)
Adds the specified tag to the specified index, FAQ, or data source resource.
|
UntagResourceResult |
untagResource(UntagResourceRequest request)
Removes a tag from an index, FAQ, or a data source.
|
UpdateAccessControlConfigurationResult |
updateAccessControlConfiguration(UpdateAccessControlConfigurationRequest request)
Updates an access control configuration for your documents in an index.
|
UpdateDataSourceResult |
updateDataSource(UpdateDataSourceRequest request)
Updates an Amazon Kendra data source connector.
|
UpdateExperienceResult |
updateExperience(UpdateExperienceRequest request)
Updates your Amazon Kendra experience such as a search application.
|
UpdateFeaturedResultsSetResult |
updateFeaturedResultsSet(UpdateFeaturedResultsSetRequest request)
Updates a set of featured results.
|
UpdateIndexResult |
updateIndex(UpdateIndexRequest request)
Updates an Amazon Kendra index.
|
UpdateQuerySuggestionsBlockListResult |
updateQuerySuggestionsBlockList(UpdateQuerySuggestionsBlockListRequest request)
Updates a block list used for query suggestions for an index.
|
UpdateQuerySuggestionsConfigResult |
updateQuerySuggestionsConfig(UpdateQuerySuggestionsConfigRequest request)
Updates the settings of query suggestions for an index.
|
UpdateThesaurusResult |
updateThesaurus(UpdateThesaurusRequest request)
Updates a thesaurus for an index.
|
addRequestHandler, addRequestHandler, configureRegion, getClientConfiguration, getEndpointPrefix, getMonitoringListeners, getRequestMetricsCollector, getServiceName, getSignerByURI, getSignerOverride, getSignerRegionOverride, getTimeOffset, makeImmutable, removeRequestHandler, removeRequestHandler, setEndpoint, setEndpoint, setRegion, setServiceNameIntern, setSignerRegionOverride, setTimeOffset, withEndpoint, withRegion, withRegion, withTimeOffset
public static AWSkendraClientBuilder builder()
public AssociateEntitiesToExperienceResult associateEntitiesToExperience(AssociateEntitiesToExperienceRequest request)
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.
associateEntitiesToExperience
in interface AWSkendra
associateEntitiesToExperienceRequest
- ValidationException
- The input fails to satisfy the constraints set by the Amazon Kendra service. Please provide the correct
input and try again.ResourceNotFoundException
- The resource you want to use doesn’t exist. Please check you have provided the correct resource and try
again.ResourceAlreadyExistException
- The resource you want to use already exists. Please check you have provided the correct resource and try
again.ThrottlingException
- The request was denied due to request throttling. Please reduce the number of requests and try again.AccessDeniedException
- You don't have sufficient access to perform this action. Please ensure you have the required permission
policies and user accounts and try again.InternalServerException
- 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.public AssociatePersonasToEntitiesResult associatePersonasToEntities(AssociatePersonasToEntitiesRequest request)
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.
associatePersonasToEntities
in interface AWSkendra
associatePersonasToEntitiesRequest
- ValidationException
- The input fails to satisfy the constraints set by the Amazon Kendra service. Please provide the correct
input and try again.ResourceNotFoundException
- The resource you want to use doesn’t exist. Please check you have provided the correct resource and try
again.ResourceAlreadyExistException
- The resource you want to use already exists. Please check you have provided the correct resource and try
again.ThrottlingException
- The request was denied due to request throttling. Please reduce the number of requests and try again.AccessDeniedException
- You don't have sufficient access to perform this action. Please ensure you have the required permission
policies and user accounts and try again.InternalServerException
- 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.public BatchDeleteDocumentResult batchDeleteDocument(BatchDeleteDocumentRequest request)
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.
batchDeleteDocument
in interface AWSkendra
batchDeleteDocumentRequest
- ValidationException
- The input fails to satisfy the constraints set by the Amazon Kendra service. Please provide the correct
input and try again.ConflictException
- A conflict occurred with the request. Please fix any inconsistences with your resources and try again.ResourceNotFoundException
- The resource you want to use doesn’t exist. Please check you have provided the correct resource and try
again.ThrottlingException
- The request was denied due to request throttling. Please reduce the number of requests and try again.AccessDeniedException
- You don't have sufficient access to perform this action. Please ensure you have the required permission
policies and user accounts and try again.InternalServerException
- 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.public BatchDeleteFeaturedResultsSetResult batchDeleteFeaturedResultsSet(BatchDeleteFeaturedResultsSetRequest request)
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.
batchDeleteFeaturedResultsSet
in interface AWSkendra
batchDeleteFeaturedResultsSetRequest
- ResourceNotFoundException
- The resource you want to use doesn’t exist. Please check you have provided the correct resource and try
again.AccessDeniedException
- You don't have sufficient access to perform this action. Please ensure you have the required permission
policies and user accounts and try again.ValidationException
- The input fails to satisfy the constraints set by the Amazon Kendra service. Please provide the correct
input and try again.ThrottlingException
- The request was denied due to request throttling. Please reduce the number of requests and try again.InternalServerException
- 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.public BatchGetDocumentStatusResult batchGetDocumentStatus(BatchGetDocumentStatusRequest request)
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.
batchGetDocumentStatus
in interface AWSkendra
batchGetDocumentStatusRequest
- ValidationException
- The input fails to satisfy the constraints set by the Amazon Kendra service. Please provide the correct
input and try again.ConflictException
- A conflict occurred with the request. Please fix any inconsistences with your resources and try again.ResourceNotFoundException
- The resource you want to use doesn’t exist. Please check you have provided the correct resource and try
again.ThrottlingException
- The request was denied due to request throttling. Please reduce the number of requests and try again.AccessDeniedException
- You don't have sufficient access to perform this action. Please ensure you have the required permission
policies and user accounts and try again.InternalServerException
- 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.public BatchPutDocumentResult batchPutDocument(BatchPutDocumentRequest request)
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.
batchPutDocument
in interface AWSkendra
batchPutDocumentRequest
- ValidationException
- The input fails to satisfy the constraints set by the Amazon Kendra service. Please provide the correct
input and try again.ConflictException
- A conflict occurred with the request. Please fix any inconsistences with your resources and try again.ResourceNotFoundException
- The resource you want to use doesn’t exist. Please check you have provided the correct resource and try
again.ThrottlingException
- The request was denied due to request throttling. Please reduce the number of requests and try again.AccessDeniedException
- You don't have sufficient access to perform this action. Please ensure you have the required permission
policies and user accounts and try again.ServiceQuotaExceededException
- 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.InternalServerException
- 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.public ClearQuerySuggestionsResult clearQuerySuggestions(ClearQuerySuggestionsRequest request)
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.
clearQuerySuggestions
in interface AWSkendra
clearQuerySuggestionsRequest
- ValidationException
- The input fails to satisfy the constraints set by the Amazon Kendra service. Please provide the correct
input and try again.ResourceNotFoundException
- The resource you want to use doesn’t exist. Please check you have provided the correct resource and try
again.ThrottlingException
- The request was denied due to request throttling. Please reduce the number of requests and try again.ConflictException
- A conflict occurred with the request. Please fix any inconsistences with your resources and try again.AccessDeniedException
- You don't have sufficient access to perform this action. Please ensure you have the required permission
policies and user accounts and try again.InternalServerException
- 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.public CreateAccessControlConfigurationResult createAccessControlConfiguration(CreateAccessControlConfigurationRequest request)
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.
createAccessControlConfiguration
in interface AWSkendra
createAccessControlConfigurationRequest
- ServiceQuotaExceededException
- 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.ValidationException
- The input fails to satisfy the constraints set by the Amazon Kendra service. Please provide the correct
input and try again.ThrottlingException
- The request was denied due to request throttling. Please reduce the number of requests and try again.ConflictException
- A conflict occurred with the request. Please fix any inconsistences with your resources and try again.AccessDeniedException
- You don't have sufficient access to perform this action. Please ensure you have the required permission
policies and user accounts and try again.ResourceNotFoundException
- The resource you want to use doesn’t exist. Please check you have provided the correct resource and try
again.InternalServerException
- 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.public CreateDataSourceResult createDataSource(CreateDataSourceRequest request)
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.
createDataSource
in interface AWSkendra
createDataSourceRequest
- ValidationException
- The input fails to satisfy the constraints set by the Amazon Kendra service. Please provide the correct
input and try again.ConflictException
- A conflict occurred with the request. Please fix any inconsistences with your resources and try again.ResourceNotFoundException
- The resource you want to use doesn’t exist. Please check you have provided the correct resource and try
again.ResourceAlreadyExistException
- The resource you want to use already exists. Please check you have provided the correct resource and try
again.ServiceQuotaExceededException
- 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.ThrottlingException
- The request was denied due to request throttling. Please reduce the number of requests and try again.AccessDeniedException
- You don't have sufficient access to perform this action. Please ensure you have the required permission
policies and user accounts and try again.InternalServerException
- 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.public CreateExperienceResult createExperience(CreateExperienceRequest request)
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.
createExperience
in interface AWSkendra
createExperienceRequest
- ValidationException
- The input fails to satisfy the constraints set by the Amazon Kendra service. Please provide the correct
input and try again.ConflictException
- A conflict occurred with the request. Please fix any inconsistences with your resources and try again.ResourceNotFoundException
- The resource you want to use doesn’t exist. Please check you have provided the correct resource and try
again.ServiceQuotaExceededException
- 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.ThrottlingException
- The request was denied due to request throttling. Please reduce the number of requests and try again.AccessDeniedException
- You don't have sufficient access to perform this action. Please ensure you have the required permission
policies and user accounts and try again.InternalServerException
- 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.public CreateFaqResult createFaq(CreateFaqRequest request)
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.
createFaq
in interface AWSkendra
createFaqRequest
- ValidationException
- The input fails to satisfy the constraints set by the Amazon Kendra service. Please provide the correct
input and try again.ConflictException
- A conflict occurred with the request. Please fix any inconsistences with your resources and try again.ResourceNotFoundException
- The resource you want to use doesn’t exist. Please check you have provided the correct resource and try
again.ThrottlingException
- The request was denied due to request throttling. Please reduce the number of requests and try again.ServiceQuotaExceededException
- 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.AccessDeniedException
- You don't have sufficient access to perform this action. Please ensure you have the required permission
policies and user accounts and try again.InternalServerException
- 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.public CreateFeaturedResultsSetResult createFeaturedResultsSet(CreateFeaturedResultsSetRequest request)
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.
createFeaturedResultsSet
in interface AWSkendra
createFeaturedResultsSetRequest
- ResourceNotFoundException
- The resource you want to use doesn’t exist. Please check you have provided the correct resource and try
again.AccessDeniedException
- You don't have sufficient access to perform this action. Please ensure you have the required permission
policies and user accounts and try again.FeaturedResultsConflictException
- 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.ValidationException
- The input fails to satisfy the constraints set by the Amazon Kendra service. Please provide the correct
input and try again.ThrottlingException
- The request was denied due to request throttling. Please reduce the number of requests and try again.ConflictException
- A conflict occurred with the request. Please fix any inconsistences with your resources and try again.InternalServerException
- 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.public CreateIndexResult createIndex(CreateIndexRequest request)
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.
createIndex
in interface AWSkendra
createIndexRequest
- ValidationException
- The input fails to satisfy the constraints set by the Amazon Kendra service. Please provide the correct
input and try again.ResourceAlreadyExistException
- The resource you want to use already exists. Please check you have provided the correct resource and try
again.ServiceQuotaExceededException
- 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.ThrottlingException
- The request was denied due to request throttling. Please reduce the number of requests and try again.AccessDeniedException
- You don't have sufficient access to perform this action. Please ensure you have the required permission
policies and user accounts and try again.ConflictException
- A conflict occurred with the request. Please fix any inconsistences with your resources and try again.InternalServerException
- 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.public CreateQuerySuggestionsBlockListResult createQuerySuggestionsBlockList(CreateQuerySuggestionsBlockListRequest request)
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.
createQuerySuggestionsBlockList
in interface AWSkendra
createQuerySuggestionsBlockListRequest
- ValidationException
- The input fails to satisfy the constraints set by the Amazon Kendra service. Please provide the correct
input and try again.ResourceNotFoundException
- The resource you want to use doesn’t exist. Please check you have provided the correct resource and try
again.ThrottlingException
- The request was denied due to request throttling. Please reduce the number of requests and try again.AccessDeniedException
- You don't have sufficient access to perform this action. Please ensure you have the required permission
policies and user accounts and try again.ServiceQuotaExceededException
- 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.ConflictException
- A conflict occurred with the request. Please fix any inconsistences with your resources and try again.InternalServerException
- 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.public CreateThesaurusResult createThesaurus(CreateThesaurusRequest request)
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.
createThesaurus
in interface AWSkendra
createThesaurusRequest
- ValidationException
- The input fails to satisfy the constraints set by the Amazon Kendra service. Please provide the correct
input and try again.ConflictException
- A conflict occurred with the request. Please fix any inconsistences with your resources and try again.ResourceNotFoundException
- The resource you want to use doesn’t exist. Please check you have provided the correct resource and try
again.ThrottlingException
- The request was denied due to request throttling. Please reduce the number of requests and try again.ServiceQuotaExceededException
- 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.AccessDeniedException
- You don't have sufficient access to perform this action. Please ensure you have the required permission
policies and user accounts and try again.InternalServerException
- 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.public DeleteAccessControlConfigurationResult deleteAccessControlConfiguration(DeleteAccessControlConfigurationRequest request)
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.
deleteAccessControlConfiguration
in interface AWSkendra
deleteAccessControlConfigurationRequest
- ValidationException
- The input fails to satisfy the constraints set by the Amazon Kendra service. Please provide the correct
input and try again.ThrottlingException
- The request was denied due to request throttling. Please reduce the number of requests and try again.ConflictException
- A conflict occurred with the request. Please fix any inconsistences with your resources and try again.ResourceNotFoundException
- The resource you want to use doesn’t exist. Please check you have provided the correct resource and try
again.AccessDeniedException
- You don't have sufficient access to perform this action. Please ensure you have the required permission
policies and user accounts and try again.InternalServerException
- 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.public DeleteDataSourceResult deleteDataSource(DeleteDataSourceRequest request)
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.
deleteDataSource
in interface AWSkendra
deleteDataSourceRequest
- AccessDeniedException
- You don't have sufficient access to perform this action. Please ensure you have the required permission
policies and user accounts and try again.ValidationException
- The input fails to satisfy the constraints set by the Amazon Kendra service. Please provide the correct
input and try again.ConflictException
- A conflict occurred with the request. Please fix any inconsistences with your resources and try again.ResourceNotFoundException
- The resource you want to use doesn’t exist. Please check you have provided the correct resource and try
again.ThrottlingException
- The request was denied due to request throttling. Please reduce the number of requests and try again.InternalServerException
- 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.public DeleteExperienceResult deleteExperience(DeleteExperienceRequest request)
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.
deleteExperience
in interface AWSkendra
deleteExperienceRequest
- AccessDeniedException
- You don't have sufficient access to perform this action. Please ensure you have the required permission
policies and user accounts and try again.ValidationException
- The input fails to satisfy the constraints set by the Amazon Kendra service. Please provide the correct
input and try again.ConflictException
- A conflict occurred with the request. Please fix any inconsistences with your resources and try again.ResourceNotFoundException
- The resource you want to use doesn’t exist. Please check you have provided the correct resource and try
again.ThrottlingException
- The request was denied due to request throttling. Please reduce the number of requests and try again.InternalServerException
- 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.public DeleteFaqResult deleteFaq(DeleteFaqRequest request)
Removes an FAQ from an index.
deleteFaq
in interface AWSkendra
deleteFaqRequest
- ValidationException
- The input fails to satisfy the constraints set by the Amazon Kendra service. Please provide the correct
input and try again.ConflictException
- A conflict occurred with the request. Please fix any inconsistences with your resources and try again.ResourceNotFoundException
- The resource you want to use doesn’t exist. Please check you have provided the correct resource and try
again.ThrottlingException
- The request was denied due to request throttling. Please reduce the number of requests and try again.AccessDeniedException
- You don't have sufficient access to perform this action. Please ensure you have the required permission
policies and user accounts and try again.InternalServerException
- 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.public DeleteIndexResult deleteIndex(DeleteIndexRequest request)
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
.
deleteIndex
in interface AWSkendra
deleteIndexRequest
- ValidationException
- The input fails to satisfy the constraints set by the Amazon Kendra service. Please provide the correct
input and try again.ConflictException
- A conflict occurred with the request. Please fix any inconsistences with your resources and try again.ResourceNotFoundException
- The resource you want to use doesn’t exist. Please check you have provided the correct resource and try
again.ThrottlingException
- The request was denied due to request throttling. Please reduce the number of requests and try again.AccessDeniedException
- You don't have sufficient access to perform this action. Please ensure you have the required permission
policies and user accounts and try again.InternalServerException
- 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.public DeletePrincipalMappingResult deletePrincipalMapping(DeletePrincipalMappingRequest request)
Deletes a group so that all users and sub groups 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.
deletePrincipalMapping
in interface AWSkendra
deletePrincipalMappingRequest
- ValidationException
- The input fails to satisfy the constraints set by the Amazon Kendra service. Please provide the correct
input and try again.ConflictException
- A conflict occurred with the request. Please fix any inconsistences with your resources and try again.ResourceNotFoundException
- The resource you want to use doesn’t exist. Please check you have provided the correct resource and try
again.ThrottlingException
- The request was denied due to request throttling. Please reduce the number of requests and try again.AccessDeniedException
- You don't have sufficient access to perform this action. Please ensure you have the required permission
policies and user accounts and try again.InternalServerException
- 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.public DeleteQuerySuggestionsBlockListResult deleteQuerySuggestionsBlockList(DeleteQuerySuggestionsBlockListRequest request)
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.
deleteQuerySuggestionsBlockList
in interface AWSkendra
deleteQuerySuggestionsBlockListRequest
- ValidationException
- The input fails to satisfy the constraints set by the Amazon Kendra service. Please provide the correct
input and try again.ResourceNotFoundException
- The resource you want to use doesn’t exist. Please check you have provided the correct resource and try
again.ThrottlingException
- The request was denied due to request throttling. Please reduce the number of requests and try again.AccessDeniedException
- You don't have sufficient access to perform this action. Please ensure you have the required permission
policies and user accounts and try again.ConflictException
- A conflict occurred with the request. Please fix any inconsistences with your resources and try again.InternalServerException
- 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.public DeleteThesaurusResult deleteThesaurus(DeleteThesaurusRequest request)
Deletes an Amazon Kendra thesaurus.
deleteThesaurus
in interface AWSkendra
deleteThesaurusRequest
- ValidationException
- The input fails to satisfy the constraints set by the Amazon Kendra service. Please provide the correct
input and try again.ConflictException
- A conflict occurred with the request. Please fix any inconsistences with your resources and try again.ResourceNotFoundException
- The resource you want to use doesn’t exist. Please check you have provided the correct resource and try
again.ThrottlingException
- The request was denied due to request throttling. Please reduce the number of requests and try again.AccessDeniedException
- You don't have sufficient access to perform this action. Please ensure you have the required permission
policies and user accounts and try again.InternalServerException
- 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.public DescribeAccessControlConfigurationResult describeAccessControlConfiguration(DescribeAccessControlConfigurationRequest request)
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.
describeAccessControlConfiguration
in interface AWSkendra
describeAccessControlConfigurationRequest
- ValidationException
- The input fails to satisfy the constraints set by the Amazon Kendra service. Please provide the correct
input and try again.ThrottlingException
- The request was denied due to request throttling. Please reduce the number of requests and try again.ResourceNotFoundException
- The resource you want to use doesn’t exist. Please check you have provided the correct resource and try
again.AccessDeniedException
- You don't have sufficient access to perform this action. Please ensure you have the required permission
policies and user accounts and try again.InternalServerException
- 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.public DescribeDataSourceResult describeDataSource(DescribeDataSourceRequest request)
Gets information about an Amazon Kendra data source connector.
describeDataSource
in interface AWSkendra
describeDataSourceRequest
- ValidationException
- The input fails to satisfy the constraints set by the Amazon Kendra service. Please provide the correct
input and try again.ResourceNotFoundException
- The resource you want to use doesn’t exist. Please check you have provided the correct resource and try
again.ThrottlingException
- The request was denied due to request throttling. Please reduce the number of requests and try again.AccessDeniedException
- You don't have sufficient access to perform this action. Please ensure you have the required permission
policies and user accounts and try again.InternalServerException
- 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.public DescribeExperienceResult describeExperience(DescribeExperienceRequest request)
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.
describeExperience
in interface AWSkendra
describeExperienceRequest
- ValidationException
- The input fails to satisfy the constraints set by the Amazon Kendra service. Please provide the correct
input and try again.ResourceNotFoundException
- The resource you want to use doesn’t exist. Please check you have provided the correct resource and try
again.ThrottlingException
- The request was denied due to request throttling. Please reduce the number of requests and try again.AccessDeniedException
- You don't have sufficient access to perform this action. Please ensure you have the required permission
policies and user accounts and try again.InternalServerException
- 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.public DescribeFaqResult describeFaq(DescribeFaqRequest request)
Gets information about an FAQ list.
describeFaq
in interface AWSkendra
describeFaqRequest
- ValidationException
- The input fails to satisfy the constraints set by the Amazon Kendra service. Please provide the correct
input and try again.ResourceNotFoundException
- The resource you want to use doesn’t exist. Please check you have provided the correct resource and try
again.ThrottlingException
- The request was denied due to request throttling. Please reduce the number of requests and try again.AccessDeniedException
- You don't have sufficient access to perform this action. Please ensure you have the required permission
policies and user accounts and try again.InternalServerException
- 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.public DescribeFeaturedResultsSetResult describeFeaturedResultsSet(DescribeFeaturedResultsSetRequest request)
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.
describeFeaturedResultsSet
in interface AWSkendra
describeFeaturedResultsSetRequest
- ResourceNotFoundException
- The resource you want to use doesn’t exist. Please check you have provided the correct resource and try
again.AccessDeniedException
- You don't have sufficient access to perform this action. Please ensure you have the required permission
policies and user accounts and try again.ValidationException
- The input fails to satisfy the constraints set by the Amazon Kendra service. Please provide the correct
input and try again.ThrottlingException
- The request was denied due to request throttling. Please reduce the number of requests and try again.InternalServerException
- 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.public DescribeIndexResult describeIndex(DescribeIndexRequest request)
Gets information about an Amazon Kendra index.
describeIndex
in interface AWSkendra
describeIndexRequest
- ValidationException
- The input fails to satisfy the constraints set by the Amazon Kendra service. Please provide the correct
input and try again.ResourceNotFoundException
- The resource you want to use doesn’t exist. Please check you have provided the correct resource and try
again.ThrottlingException
- The request was denied due to request throttling. Please reduce the number of requests and try again.AccessDeniedException
- You don't have sufficient access to perform this action. Please ensure you have the required permission
policies and user accounts and try again.InternalServerException
- 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.public DescribePrincipalMappingResult describePrincipalMapping(DescribePrincipalMappingRequest request)
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.
describePrincipalMapping
in interface AWSkendra
describePrincipalMappingRequest
- ValidationException
- The input fails to satisfy the constraints set by the Amazon Kendra service. Please provide the correct
input and try again.ResourceNotFoundException
- The resource you want to use doesn’t exist. Please check you have provided the correct resource and try
again.ThrottlingException
- The request was denied due to request throttling. Please reduce the number of requests and try again.AccessDeniedException
- You don't have sufficient access to perform this action. Please ensure you have the required permission
policies and user accounts and try again.InternalServerException
- 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.public DescribeQuerySuggestionsBlockListResult describeQuerySuggestionsBlockList(DescribeQuerySuggestionsBlockListRequest request)
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.
describeQuerySuggestionsBlockList
in interface AWSkendra
describeQuerySuggestionsBlockListRequest
- ValidationException
- The input fails to satisfy the constraints set by the Amazon Kendra service. Please provide the correct
input and try again.ResourceNotFoundException
- The resource you want to use doesn’t exist. Please check you have provided the correct resource and try
again.ThrottlingException
- The request was denied due to request throttling. Please reduce the number of requests and try again.AccessDeniedException
- You don't have sufficient access to perform this action. Please ensure you have the required permission
policies and user accounts and try again.InternalServerException
- 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.public DescribeQuerySuggestionsConfigResult describeQuerySuggestionsConfig(DescribeQuerySuggestionsConfigRequest request)
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.
describeQuerySuggestionsConfig
in interface AWSkendra
describeQuerySuggestionsConfigRequest
- ValidationException
- The input fails to satisfy the constraints set by the Amazon Kendra service. Please provide the correct
input and try again.ResourceNotFoundException
- The resource you want to use doesn’t exist. Please check you have provided the correct resource and try
again.ThrottlingException
- The request was denied due to request throttling. Please reduce the number of requests and try again.AccessDeniedException
- You don't have sufficient access to perform this action. Please ensure you have the required permission
policies and user accounts and try again.InternalServerException
- 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.public DescribeThesaurusResult describeThesaurus(DescribeThesaurusRequest request)
Gets information about an Amazon Kendra thesaurus.
describeThesaurus
in interface AWSkendra
describeThesaurusRequest
- ValidationException
- The input fails to satisfy the constraints set by the Amazon Kendra service. Please provide the correct
input and try again.ResourceNotFoundException
- The resource you want to use doesn’t exist. Please check you have provided the correct resource and try
again.ThrottlingException
- The request was denied due to request throttling. Please reduce the number of requests and try again.AccessDeniedException
- You don't have sufficient access to perform this action. Please ensure you have the required permission
policies and user accounts and try again.InternalServerException
- 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.public DisassociateEntitiesFromExperienceResult disassociateEntitiesFromExperience(DisassociateEntitiesFromExperienceRequest request)
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.
disassociateEntitiesFromExperience
in interface AWSkendra
disassociateEntitiesFromExperienceRequest
- ValidationException
- The input fails to satisfy the constraints set by the Amazon Kendra service. Please provide the correct
input and try again.ResourceNotFoundException
- The resource you want to use doesn’t exist. Please check you have provided the correct resource and try
again.ThrottlingException
- The request was denied due to request throttling. Please reduce the number of requests and try again.AccessDeniedException
- You don't have sufficient access to perform this action. Please ensure you have the required permission
policies and user accounts and try again.InternalServerException
- 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.public DisassociatePersonasFromEntitiesResult disassociatePersonasFromEntities(DisassociatePersonasFromEntitiesRequest request)
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.
disassociatePersonasFromEntities
in interface AWSkendra
disassociatePersonasFromEntitiesRequest
- ValidationException
- The input fails to satisfy the constraints set by the Amazon Kendra service. Please provide the correct
input and try again.ResourceNotFoundException
- The resource you want to use doesn’t exist. Please check you have provided the correct resource and try
again.ThrottlingException
- The request was denied due to request throttling. Please reduce the number of requests and try again.AccessDeniedException
- You don't have sufficient access to perform this action. Please ensure you have the required permission
policies and user accounts and try again.InternalServerException
- 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.public GetQuerySuggestionsResult getQuerySuggestions(GetQuerySuggestionsRequest request)
Fetches the queries that are suggested to your users.
GetQuerySuggestions
is currently not supported in the Amazon Web Services GovCloud (US-West) region.
getQuerySuggestions
in interface AWSkendra
getQuerySuggestionsRequest
- ValidationException
- The input fails to satisfy the constraints set by the Amazon Kendra service. Please provide the correct
input and try again.ResourceNotFoundException
- The resource you want to use doesn’t exist. Please check you have provided the correct resource and try
again.ThrottlingException
- The request was denied due to request throttling. Please reduce the number of requests and try again.AccessDeniedException
- You don't have sufficient access to perform this action. Please ensure you have the required permission
policies and user accounts and try again.ServiceQuotaExceededException
- 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.ConflictException
- A conflict occurred with the request. Please fix any inconsistences with your resources and try again.InternalServerException
- 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.public GetSnapshotsResult getSnapshots(GetSnapshotsRequest request)
Retrieves search metrics data. The data provides a snapshot of how your users interact with your search application and how effective the application is.
getSnapshots
in interface AWSkendra
getSnapshotsRequest
- InvalidRequestException
- The input to the request is not valid. Please provide the correct input and try again.ResourceNotFoundException
- The resource you want to use doesn’t exist. Please check you have provided the correct resource and try
again.AccessDeniedException
- You don't have sufficient access to perform this action. Please ensure you have the required permission
policies and user accounts and try again.InternalServerException
- 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.public ListAccessControlConfigurationsResult listAccessControlConfigurations(ListAccessControlConfigurationsRequest request)
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.
listAccessControlConfigurations
in interface AWSkendra
listAccessControlConfigurationsRequest
- ValidationException
- The input fails to satisfy the constraints set by the Amazon Kendra service. Please provide the correct
input and try again.ThrottlingException
- The request was denied due to request throttling. Please reduce the number of requests and try again.ResourceNotFoundException
- The resource you want to use doesn’t exist. Please check you have provided the correct resource and try
again.AccessDeniedException
- You don't have sufficient access to perform this action. Please ensure you have the required permission
policies and user accounts and try again.InternalServerException
- 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.public ListDataSourceSyncJobsResult listDataSourceSyncJobs(ListDataSourceSyncJobsRequest request)
Gets statistics about synchronizing a data source connector.
listDataSourceSyncJobs
in interface AWSkendra
listDataSourceSyncJobsRequest
- ValidationException
- The input fails to satisfy the constraints set by the Amazon Kendra service. Please provide the correct
input and try again.ResourceNotFoundException
- The resource you want to use doesn’t exist. Please check you have provided the correct resource and try
again.ThrottlingException
- The request was denied due to request throttling. Please reduce the number of requests and try again.AccessDeniedException
- You don't have sufficient access to perform this action. Please ensure you have the required permission
policies and user accounts and try again.ConflictException
- A conflict occurred with the request. Please fix any inconsistences with your resources and try again.InternalServerException
- 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.public ListDataSourcesResult listDataSources(ListDataSourcesRequest request)
Lists the data source connectors that you have created.
listDataSources
in interface AWSkendra
listDataSourcesRequest
- ValidationException
- The input fails to satisfy the constraints set by the Amazon Kendra service. Please provide the correct
input and try again.ResourceNotFoundException
- The resource you want to use doesn’t exist. Please check you have provided the correct resource and try
again.AccessDeniedException
- You don't have sufficient access to perform this action. Please ensure you have the required permission
policies and user accounts and try again.ThrottlingException
- The request was denied due to request throttling. Please reduce the number of requests and try again.InternalServerException
- 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.public ListEntityPersonasResult listEntityPersonas(ListEntityPersonasRequest request)
Lists specific permissions of users and groups with access to your Amazon Kendra experience.
listEntityPersonas
in interface AWSkendra
listEntityPersonasRequest
- ValidationException
- The input fails to satisfy the constraints set by the Amazon Kendra service. Please provide the correct
input and try again.ResourceNotFoundException
- The resource you want to use doesn’t exist. Please check you have provided the correct resource and try
again.AccessDeniedException
- You don't have sufficient access to perform this action. Please ensure you have the required permission
policies and user accounts and try again.ThrottlingException
- The request was denied due to request throttling. Please reduce the number of requests and try again.InternalServerException
- 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.public ListExperienceEntitiesResult listExperienceEntities(ListExperienceEntitiesRequest request)
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.
listExperienceEntities
in interface AWSkendra
listExperienceEntitiesRequest
- ValidationException
- The input fails to satisfy the constraints set by the Amazon Kendra service. Please provide the correct
input and try again.ResourceNotFoundException
- The resource you want to use doesn’t exist. Please check you have provided the correct resource and try
again.AccessDeniedException
- You don't have sufficient access to perform this action. Please ensure you have the required permission
policies and user accounts and try again.ThrottlingException
- The request was denied due to request throttling. Please reduce the number of requests and try again.InternalServerException
- 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.public ListExperiencesResult listExperiences(ListExperiencesRequest request)
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.
listExperiences
in interface AWSkendra
listExperiencesRequest
- ValidationException
- The input fails to satisfy the constraints set by the Amazon Kendra service. Please provide the correct
input and try again.ResourceNotFoundException
- The resource you want to use doesn’t exist. Please check you have provided the correct resource and try
again.AccessDeniedException
- You don't have sufficient access to perform this action. Please ensure you have the required permission
policies and user accounts and try again.ThrottlingException
- The request was denied due to request throttling. Please reduce the number of requests and try again.InternalServerException
- 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.public ListFaqsResult listFaqs(ListFaqsRequest request)
Gets a list of FAQ lists associated with an index.
listFaqs
in interface AWSkendra
listFaqsRequest
- ValidationException
- The input fails to satisfy the constraints set by the Amazon Kendra service. Please provide the correct
input and try again.ResourceNotFoundException
- The resource you want to use doesn’t exist. Please check you have provided the correct resource and try
again.ThrottlingException
- The request was denied due to request throttling. Please reduce the number of requests and try again.AccessDeniedException
- You don't have sufficient access to perform this action. Please ensure you have the required permission
policies and user accounts and try again.InternalServerException
- 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.public ListFeaturedResultsSetsResult listFeaturedResultsSets(ListFeaturedResultsSetsRequest request)
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.
listFeaturedResultsSets
in interface AWSkendra
listFeaturedResultsSetsRequest
- ResourceNotFoundException
- The resource you want to use doesn’t exist. Please check you have provided the correct resource and try
again.AccessDeniedException
- You don't have sufficient access to perform this action. Please ensure you have the required permission
policies and user accounts and try again.ValidationException
- The input fails to satisfy the constraints set by the Amazon Kendra service. Please provide the correct
input and try again.ThrottlingException
- The request was denied due to request throttling. Please reduce the number of requests and try again.InternalServerException
- 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.public ListGroupsOlderThanOrderingIdResult listGroupsOlderThanOrderingId(ListGroupsOlderThanOrderingIdRequest request)
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.
listGroupsOlderThanOrderingId
in interface AWSkendra
listGroupsOlderThanOrderingIdRequest
- ValidationException
- The input fails to satisfy the constraints set by the Amazon Kendra service. Please provide the correct
input and try again.ResourceNotFoundException
- The resource you want to use doesn’t exist. Please check you have provided the correct resource and try
again.AccessDeniedException
- You don't have sufficient access to perform this action. Please ensure you have the required permission
policies and user accounts and try again.ThrottlingException
- The request was denied due to request throttling. Please reduce the number of requests and try again.ConflictException
- A conflict occurred with the request. Please fix any inconsistences with your resources and try again.InternalServerException
- 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.public ListIndicesResult listIndices(ListIndicesRequest request)
Lists the Amazon Kendra indexes that you created.
listIndices
in interface AWSkendra
listIndicesRequest
- ValidationException
- The input fails to satisfy the constraints set by the Amazon Kendra service. Please provide the correct
input and try again.ThrottlingException
- The request was denied due to request throttling. Please reduce the number of requests and try again.AccessDeniedException
- You don't have sufficient access to perform this action. Please ensure you have the required permission
policies and user accounts and try again.InternalServerException
- 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.public ListQuerySuggestionsBlockListsResult listQuerySuggestionsBlockLists(ListQuerySuggestionsBlockListsRequest request)
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.
listQuerySuggestionsBlockLists
in interface AWSkendra
listQuerySuggestionsBlockListsRequest
- ValidationException
- The input fails to satisfy the constraints set by the Amazon Kendra service. Please provide the correct
input and try again.ResourceNotFoundException
- The resource you want to use doesn’t exist. Please check you have provided the correct resource and try
again.ThrottlingException
- The request was denied due to request throttling. Please reduce the number of requests and try again.AccessDeniedException
- You don't have sufficient access to perform this action. Please ensure you have the required permission
policies and user accounts and try again.InternalServerException
- 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.public ListTagsForResourceResult listTagsForResource(ListTagsForResourceRequest request)
Gets a list of tags associated with a specified resource. Indexes, FAQs, and data sources can have tags associated with them.
listTagsForResource
in interface AWSkendra
listTagsForResourceRequest
- ValidationException
- The input fails to satisfy the constraints set by the Amazon Kendra service. Please provide the correct
input and try again.ResourceUnavailableException
- The resource you want to use isn't available. Please check you have provided the correct resource and try
again.ThrottlingException
- The request was denied due to request throttling. Please reduce the number of requests and try again.AccessDeniedException
- You don't have sufficient access to perform this action. Please ensure you have the required permission
policies and user accounts and try again.InternalServerException
- 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.public ListThesauriResult listThesauri(ListThesauriRequest request)
Lists the thesauri for an index.
listThesauri
in interface AWSkendra
listThesauriRequest
- ValidationException
- The input fails to satisfy the constraints set by the Amazon Kendra service. Please provide the correct
input and try again.ResourceNotFoundException
- The resource you want to use doesn’t exist. Please check you have provided the correct resource and try
again.ThrottlingException
- The request was denied due to request throttling. Please reduce the number of requests and try again.AccessDeniedException
- You don't have sufficient access to perform this action. Please ensure you have the required permission
policies and user accounts and try again.InternalServerException
- 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.public PutPrincipalMappingResult putPrincipalMapping(PutPrincipalMappingRequest request)
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.
putPrincipalMapping
in interface AWSkendra
putPrincipalMappingRequest
- ValidationException
- The input fails to satisfy the constraints set by the Amazon Kendra service. Please provide the correct
input and try again.ConflictException
- A conflict occurred with the request. Please fix any inconsistences with your resources and try again.ResourceNotFoundException
- The resource you want to use doesn’t exist. Please check you have provided the correct resource and try
again.ThrottlingException
- The request was denied due to request throttling. Please reduce the number of requests and try again.AccessDeniedException
- You don't have sufficient access to perform this action. Please ensure you have the required permission
policies and user accounts and try again.ServiceQuotaExceededException
- 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.InternalServerException
- 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.public QueryResult query(QueryRequest request)
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.
query
in interface AWSkendra
queryRequest
- ValidationException
- The input fails to satisfy the constraints set by the Amazon Kendra service. Please provide the correct
input and try again.ConflictException
- A conflict occurred with the request. Please fix any inconsistences with your resources and try again.ResourceNotFoundException
- The resource you want to use doesn’t exist. Please check you have provided the correct resource and try
again.ThrottlingException
- The request was denied due to request throttling. Please reduce the number of requests and try again.AccessDeniedException
- You don't have sufficient access to perform this action. Please ensure you have the required permission
policies and user accounts and try again.ServiceQuotaExceededException
- 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.InternalServerException
- 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.public RetrieveResult retrieve(RetrieveRequest request)
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.
retrieve
in interface AWSkendra
retrieveRequest
- ValidationException
- The input fails to satisfy the constraints set by the Amazon Kendra service. Please provide the correct
input and try again.ConflictException
- A conflict occurred with the request. Please fix any inconsistences with your resources and try again.ResourceNotFoundException
- The resource you want to use doesn’t exist. Please check you have provided the correct resource and try
again.ThrottlingException
- The request was denied due to request throttling. Please reduce the number of requests and try again.AccessDeniedException
- You don't have sufficient access to perform this action. Please ensure you have the required permission
policies and user accounts and try again.ServiceQuotaExceededException
- 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.InternalServerException
- 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.public StartDataSourceSyncJobResult startDataSourceSyncJob(StartDataSourceSyncJobRequest request)
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.
startDataSourceSyncJob
in interface AWSkendra
startDataSourceSyncJobRequest
- ValidationException
- The input fails to satisfy the constraints set by the Amazon Kendra service. Please provide the correct
input and try again.ResourceNotFoundException
- The resource you want to use doesn’t exist. Please check you have provided the correct resource and try
again.ResourceInUseException
- The resource you want to use is currently in use. Please check you have provided the correct resource and
try again.ThrottlingException
- The request was denied due to request throttling. Please reduce the number of requests and try again.AccessDeniedException
- You don't have sufficient access to perform this action. Please ensure you have the required permission
policies and user accounts and try again.ConflictException
- A conflict occurred with the request. Please fix any inconsistences with your resources and try again.InternalServerException
- 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.public StopDataSourceSyncJobResult stopDataSourceSyncJob(StopDataSourceSyncJobRequest request)
Stops a synchronization job that is currently running. You can't stop a scheduled synchronization job.
stopDataSourceSyncJob
in interface AWSkendra
stopDataSourceSyncJobRequest
- ValidationException
- The input fails to satisfy the constraints set by the Amazon Kendra service. Please provide the correct
input and try again.ResourceNotFoundException
- The resource you want to use doesn’t exist. Please check you have provided the correct resource and try
again.ThrottlingException
- The request was denied due to request throttling. Please reduce the number of requests and try again.AccessDeniedException
- You don't have sufficient access to perform this action. Please ensure you have the required permission
policies and user accounts and try again.InternalServerException
- 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.public SubmitFeedbackResult submitFeedback(SubmitFeedbackRequest request)
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.
submitFeedback
in interface AWSkendra
submitFeedbackRequest
- ValidationException
- The input fails to satisfy the constraints set by the Amazon Kendra service. Please provide the correct
input and try again.ResourceUnavailableException
- The resource you want to use isn't available. Please check you have provided the correct resource and try
again.ResourceNotFoundException
- The resource you want to use doesn’t exist. Please check you have provided the correct resource and try
again.ThrottlingException
- The request was denied due to request throttling. Please reduce the number of requests and try again.AccessDeniedException
- You don't have sufficient access to perform this action. Please ensure you have the required permission
policies and user accounts and try again.InternalServerException
- 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.public TagResourceResult tagResource(TagResourceRequest request)
Adds the specified tag to the specified index, FAQ, or data source resource. If the tag already exists, the existing value is replaced with the new value.
tagResource
in interface AWSkendra
tagResourceRequest
- ValidationException
- The input fails to satisfy the constraints set by the Amazon Kendra service. Please provide the correct
input and try again.ResourceUnavailableException
- The resource you want to use isn't available. Please check you have provided the correct resource and try
again.ThrottlingException
- The request was denied due to request throttling. Please reduce the number of requests and try again.AccessDeniedException
- You don't have sufficient access to perform this action. Please ensure you have the required permission
policies and user accounts and try again.InternalServerException
- 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.public UntagResourceResult untagResource(UntagResourceRequest request)
Removes a tag from an index, FAQ, or a data source.
untagResource
in interface AWSkendra
untagResourceRequest
- ValidationException
- The input fails to satisfy the constraints set by the Amazon Kendra service. Please provide the correct
input and try again.ResourceUnavailableException
- The resource you want to use isn't available. Please check you have provided the correct resource and try
again.ThrottlingException
- The request was denied due to request throttling. Please reduce the number of requests and try again.AccessDeniedException
- You don't have sufficient access to perform this action. Please ensure you have the required permission
policies and user accounts and try again.InternalServerException
- 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.public UpdateAccessControlConfigurationResult updateAccessControlConfiguration(UpdateAccessControlConfigurationRequest request)
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.
updateAccessControlConfiguration
in interface AWSkendra
updateAccessControlConfigurationRequest
- ValidationException
- The input fails to satisfy the constraints set by the Amazon Kendra service. Please provide the correct
input and try again.ThrottlingException
- The request was denied due to request throttling. Please reduce the number of requests and try again.ConflictException
- A conflict occurred with the request. Please fix any inconsistences with your resources and try again.ResourceNotFoundException
- The resource you want to use doesn’t exist. Please check you have provided the correct resource and try
again.AccessDeniedException
- You don't have sufficient access to perform this action. Please ensure you have the required permission
policies and user accounts and try again.ServiceQuotaExceededException
- 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.InternalServerException
- 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.public UpdateDataSourceResult updateDataSource(UpdateDataSourceRequest request)
Updates an Amazon Kendra data source connector.
updateDataSource
in interface AWSkendra
updateDataSourceRequest
- ValidationException
- The input fails to satisfy the constraints set by the Amazon Kendra service. Please provide the correct
input and try again.ConflictException
- A conflict occurred with the request. Please fix any inconsistences with your resources and try again.ResourceNotFoundException
- The resource you want to use doesn’t exist. Please check you have provided the correct resource and try
again.ThrottlingException
- The request was denied due to request throttling. Please reduce the number of requests and try again.AccessDeniedException
- You don't have sufficient access to perform this action. Please ensure you have the required permission
policies and user accounts and try again.InternalServerException
- 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.public UpdateExperienceResult updateExperience(UpdateExperienceRequest request)
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.
updateExperience
in interface AWSkendra
updateExperienceRequest
- ValidationException
- The input fails to satisfy the constraints set by the Amazon Kendra service. Please provide the correct
input and try again.ConflictException
- A conflict occurred with the request. Please fix any inconsistences with your resources and try again.ResourceNotFoundException
- The resource you want to use doesn’t exist. Please check you have provided the correct resource and try
again.ThrottlingException
- The request was denied due to request throttling. Please reduce the number of requests and try again.AccessDeniedException
- You don't have sufficient access to perform this action. Please ensure you have the required permission
policies and user accounts and try again.InternalServerException
- 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.public UpdateFeaturedResultsSetResult updateFeaturedResultsSet(UpdateFeaturedResultsSetRequest request)
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.
updateFeaturedResultsSet
in interface AWSkendra
updateFeaturedResultsSetRequest
- ResourceNotFoundException
- The resource you want to use doesn’t exist. Please check you have provided the correct resource and try
again.AccessDeniedException
- You don't have sufficient access to perform this action. Please ensure you have the required permission
policies and user accounts and try again.FeaturedResultsConflictException
- 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.ValidationException
- The input fails to satisfy the constraints set by the Amazon Kendra service. Please provide the correct
input and try again.ThrottlingException
- The request was denied due to request throttling. Please reduce the number of requests and try again.InternalServerException
- 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.public UpdateIndexResult updateIndex(UpdateIndexRequest request)
Updates an Amazon Kendra index.
updateIndex
in interface AWSkendra
updateIndexRequest
- ValidationException
- The input fails to satisfy the constraints set by the Amazon Kendra service. Please provide the correct
input and try again.ConflictException
- A conflict occurred with the request. Please fix any inconsistences with your resources and try again.ResourceNotFoundException
- The resource you want to use doesn’t exist. Please check you have provided the correct resource and try
again.ThrottlingException
- The request was denied due to request throttling. Please reduce the number of requests and try again.AccessDeniedException
- You don't have sufficient access to perform this action. Please ensure you have the required permission
policies and user accounts and try again.ServiceQuotaExceededException
- 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.InternalServerException
- 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.public UpdateQuerySuggestionsBlockListResult updateQuerySuggestionsBlockList(UpdateQuerySuggestionsBlockListRequest request)
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.
updateQuerySuggestionsBlockList
in interface AWSkendra
updateQuerySuggestionsBlockListRequest
- ValidationException
- The input fails to satisfy the constraints set by the Amazon Kendra service. Please provide the correct
input and try again.ResourceNotFoundException
- The resource you want to use doesn’t exist. Please check you have provided the correct resource and try
again.ThrottlingException
- The request was denied due to request throttling. Please reduce the number of requests and try again.AccessDeniedException
- You don't have sufficient access to perform this action. Please ensure you have the required permission
policies and user accounts and try again.ConflictException
- A conflict occurred with the request. Please fix any inconsistences with your resources and try again.InternalServerException
- 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.public UpdateQuerySuggestionsConfigResult updateQuerySuggestionsConfig(UpdateQuerySuggestionsConfigRequest request)
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.
updateQuerySuggestionsConfig
in interface AWSkendra
updateQuerySuggestionsConfigRequest
- ValidationException
- The input fails to satisfy the constraints set by the Amazon Kendra service. Please provide the correct
input and try again.ConflictException
- A conflict occurred with the request. Please fix any inconsistences with your resources and try again.ResourceNotFoundException
- The resource you want to use doesn’t exist. Please check you have provided the correct resource and try
again.ThrottlingException
- The request was denied due to request throttling. Please reduce the number of requests and try again.AccessDeniedException
- You don't have sufficient access to perform this action. Please ensure you have the required permission
policies and user accounts and try again.InternalServerException
- 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.public UpdateThesaurusResult updateThesaurus(UpdateThesaurusRequest request)
Updates a thesaurus for an index.
updateThesaurus
in interface AWSkendra
updateThesaurusRequest
- ValidationException
- The input fails to satisfy the constraints set by the Amazon Kendra service. Please provide the correct
input and try again.ResourceNotFoundException
- The resource you want to use doesn’t exist. Please check you have provided the correct resource and try
again.ThrottlingException
- The request was denied due to request throttling. Please reduce the number of requests and try again.AccessDeniedException
- You don't have sufficient access to perform this action. Please ensure you have the required permission
policies and user accounts and try again.ConflictException
- A conflict occurred with the request. Please fix any inconsistences with your resources and try again.InternalServerException
- 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.public ResponseMetadata getCachedResponseMetadata(AmazonWebServiceRequest request)
Response metadata is only cached for a limited period of time, so if you need to access this extra diagnostic information for an executed request, you should use this method to retrieve it as soon as possible after executing the request.
getCachedResponseMetadata
in interface AWSkendra
request
- The originally executed requestpublic void shutdown()
AmazonWebServiceClient
shutdown
in interface AWSkendra
shutdown
in class AmazonWebServiceClient