@Generated(value="com.amazonaws:aws-java-sdk-code-generator") public interface AWSkendra
Note: Do not directly implement this interface, new methods are added to it regularly. Extend from
AbstractAWSkendra
instead.
Amazon Kendra is a service for indexing large document sets.
Modifier and Type | Field and Description |
---|---|
static String |
ENDPOINT_PREFIX
The region metadata service name for computing region endpoints.
|
Modifier and Type | Method and Description |
---|---|
AssociateEntitiesToExperienceResult |
associateEntitiesToExperience(AssociateEntitiesToExperienceRequest associateEntitiesToExperienceRequest)
Grants users or groups in your Amazon Web Services SSO identity source access to your Amazon Kendra experience.
|
AssociatePersonasToEntitiesResult |
associatePersonasToEntities(AssociatePersonasToEntitiesRequest associatePersonasToEntitiesRequest)
Defines the specific permissions of users or groups in your Amazon Web Services SSO identity source with access
to your Amazon Kendra experience.
|
BatchDeleteDocumentResult |
batchDeleteDocument(BatchDeleteDocumentRequest batchDeleteDocumentRequest)
Removes one or more documents from an index.
|
BatchGetDocumentStatusResult |
batchGetDocumentStatus(BatchGetDocumentStatusRequest batchGetDocumentStatusRequest)
Returns the indexing status for one or more documents submitted with the BatchPutDocument API.
|
BatchPutDocumentResult |
batchPutDocument(BatchPutDocumentRequest batchPutDocumentRequest)
Adds one or more documents to an index.
|
ClearQuerySuggestionsResult |
clearQuerySuggestions(ClearQuerySuggestionsRequest clearQuerySuggestionsRequest)
Clears existing query suggestions from an index.
|
CreateDataSourceResult |
createDataSource(CreateDataSourceRequest createDataSourceRequest)
Creates a data source that you want to use with an Amazon Kendra index.
|
CreateExperienceResult |
createExperience(CreateExperienceRequest createExperienceRequest)
Creates an Amazon Kendra experience such as a search application.
|
CreateFaqResult |
createFaq(CreateFaqRequest createFaqRequest)
Creates an new set of frequently asked question (FAQ) questions and answers.
|
CreateIndexResult |
createIndex(CreateIndexRequest createIndexRequest)
Creates a new Amazon Kendra index.
|
CreateQuerySuggestionsBlockListResult |
createQuerySuggestionsBlockList(CreateQuerySuggestionsBlockListRequest createQuerySuggestionsBlockListRequest)
Creates a block list to exlcude certain queries from suggestions.
|
CreateThesaurusResult |
createThesaurus(CreateThesaurusRequest createThesaurusRequest)
Creates a thesaurus for an index.
|
DeleteDataSourceResult |
deleteDataSource(DeleteDataSourceRequest deleteDataSourceRequest)
Deletes an Amazon Kendra data source.
|
DeleteExperienceResult |
deleteExperience(DeleteExperienceRequest deleteExperienceRequest)
Deletes your Amazon Kendra experience such as a search application.
|
DeleteFaqResult |
deleteFaq(DeleteFaqRequest deleteFaqRequest)
Removes an FAQ from an index.
|
DeleteIndexResult |
deleteIndex(DeleteIndexRequest deleteIndexRequest)
Deletes an existing Amazon Kendra index.
|
DeletePrincipalMappingResult |
deletePrincipalMapping(DeletePrincipalMappingRequest deletePrincipalMappingRequest)
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 deleteQuerySuggestionsBlockListRequest)
Deletes a block list used for query suggestions for an index.
|
DeleteThesaurusResult |
deleteThesaurus(DeleteThesaurusRequest deleteThesaurusRequest)
Deletes an existing Amazon Kendra thesaurus.
|
DescribeDataSourceResult |
describeDataSource(DescribeDataSourceRequest describeDataSourceRequest)
Gets information about an Amazon Kendra data source.
|
DescribeExperienceResult |
describeExperience(DescribeExperienceRequest describeExperienceRequest)
Gets information about your Amazon Kendra experience such as a search application.
|
DescribeFaqResult |
describeFaq(DescribeFaqRequest describeFaqRequest)
Gets information about an FAQ list.
|
DescribeIndexResult |
describeIndex(DescribeIndexRequest describeIndexRequest)
Describes an existing Amazon Kendra index
|
DescribePrincipalMappingResult |
describePrincipalMapping(DescribePrincipalMappingRequest describePrincipalMappingRequest)
Describes the processing of
PUT and DELETE actions for mapping users to their groups. |
DescribeQuerySuggestionsBlockListResult |
describeQuerySuggestionsBlockList(DescribeQuerySuggestionsBlockListRequest describeQuerySuggestionsBlockListRequest)
Describes a block list used for query suggestions for an index.
|
DescribeQuerySuggestionsConfigResult |
describeQuerySuggestionsConfig(DescribeQuerySuggestionsConfigRequest describeQuerySuggestionsConfigRequest)
Describes the settings of query suggestions for an index.
|
DescribeThesaurusResult |
describeThesaurus(DescribeThesaurusRequest describeThesaurusRequest)
Describes an existing Amazon Kendra thesaurus.
|
DisassociateEntitiesFromExperienceResult |
disassociateEntitiesFromExperience(DisassociateEntitiesFromExperienceRequest disassociateEntitiesFromExperienceRequest)
Prevents users or groups in your Amazon Web Services SSO identity source from accessing your Amazon Kendra
experience.
|
DisassociatePersonasFromEntitiesResult |
disassociatePersonasFromEntities(DisassociatePersonasFromEntitiesRequest disassociatePersonasFromEntitiesRequest)
Removes the specific permissions of users or groups in your Amazon Web Services SSO 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 getQuerySuggestionsRequest)
Fetches the queries that are suggested to your users.
|
GetSnapshotsResult |
getSnapshots(GetSnapshotsRequest getSnapshotsRequest)
Retrieves search metrics data.
|
ListDataSourcesResult |
listDataSources(ListDataSourcesRequest listDataSourcesRequest)
Lists the data sources that you have created.
|
ListDataSourceSyncJobsResult |
listDataSourceSyncJobs(ListDataSourceSyncJobsRequest listDataSourceSyncJobsRequest)
Gets statistics about synchronizing Amazon Kendra with a data source.
|
ListEntityPersonasResult |
listEntityPersonas(ListEntityPersonasRequest listEntityPersonasRequest)
Lists specific permissions of users and groups with access to your Amazon Kendra experience.
|
ListExperienceEntitiesResult |
listExperienceEntities(ListExperienceEntitiesRequest listExperienceEntitiesRequest)
Lists users or groups in your Amazon Web Services SSO identity source that are granted access to your Amazon
Kendra experience.
|
ListExperiencesResult |
listExperiences(ListExperiencesRequest listExperiencesRequest)
Lists one or more Amazon Kendra experiences.
|
ListFaqsResult |
listFaqs(ListFaqsRequest listFaqsRequest)
Gets a list of FAQ lists associated with an index.
|
ListGroupsOlderThanOrderingIdResult |
listGroupsOlderThanOrderingId(ListGroupsOlderThanOrderingIdRequest listGroupsOlderThanOrderingIdRequest)
Provides a list of groups that are mapped to users before a given ordering or timestamp identifier.
|
ListIndicesResult |
listIndices(ListIndicesRequest listIndicesRequest)
Lists the Amazon Kendra indexes that you have created.
|
ListQuerySuggestionsBlockListsResult |
listQuerySuggestionsBlockLists(ListQuerySuggestionsBlockListsRequest listQuerySuggestionsBlockListsRequest)
Lists the block lists used for query suggestions for an index.
|
ListTagsForResourceResult |
listTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest)
Gets a list of tags associated with a specified resource.
|
ListThesauriResult |
listThesauri(ListThesauriRequest listThesauriRequest)
Lists the Amazon Kendra thesauri associated with an index.
|
PutPrincipalMappingResult |
putPrincipalMapping(PutPrincipalMappingRequest putPrincipalMappingRequest)
Maps users to their groups so that you only need to provide the user ID when you issue the query.
|
QueryResult |
query(QueryRequest queryRequest)
Searches an active index.
|
void |
shutdown()
Shuts down this client object, releasing any resources that might be held open.
|
StartDataSourceSyncJobResult |
startDataSourceSyncJob(StartDataSourceSyncJobRequest startDataSourceSyncJobRequest)
Starts a synchronization job for a data source.
|
StopDataSourceSyncJobResult |
stopDataSourceSyncJob(StopDataSourceSyncJobRequest stopDataSourceSyncJobRequest)
Stops a synchronization job that is currently running.
|
SubmitFeedbackResult |
submitFeedback(SubmitFeedbackRequest submitFeedbackRequest)
Enables you to provide feedback to Amazon Kendra to improve the performance of your index.
|
TagResourceResult |
tagResource(TagResourceRequest tagResourceRequest)
Adds the specified tag to the specified index, FAQ, or data source resource.
|
UntagResourceResult |
untagResource(UntagResourceRequest untagResourceRequest)
Removes a tag from an index, FAQ, or a data source.
|
UpdateDataSourceResult |
updateDataSource(UpdateDataSourceRequest updateDataSourceRequest)
Updates an existing Amazon Kendra data source.
|
UpdateExperienceResult |
updateExperience(UpdateExperienceRequest updateExperienceRequest)
Updates your Amazon Kendra experience such as a search application.
|
UpdateIndexResult |
updateIndex(UpdateIndexRequest updateIndexRequest)
Updates an existing Amazon Kendra index.
|
UpdateQuerySuggestionsBlockListResult |
updateQuerySuggestionsBlockList(UpdateQuerySuggestionsBlockListRequest updateQuerySuggestionsBlockListRequest)
Updates a block list used for query suggestions for an index.
|
UpdateQuerySuggestionsConfigResult |
updateQuerySuggestionsConfig(UpdateQuerySuggestionsConfigRequest updateQuerySuggestionsConfigRequest)
Updates the settings of query suggestions for an index.
|
UpdateThesaurusResult |
updateThesaurus(UpdateThesaurusRequest updateThesaurusRequest)
Updates a thesaurus file associated with an index.
|
static final String ENDPOINT_PREFIX
AssociateEntitiesToExperienceResult associateEntitiesToExperience(AssociateEntitiesToExperienceRequest associateEntitiesToExperienceRequest)
Grants users or groups in your Amazon Web Services SSO 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.
associateEntitiesToExperienceRequest
- ValidationException
ResourceNotFoundException
ResourceAlreadyExistException
ThrottlingException
AccessDeniedException
InternalServerException
AssociatePersonasToEntitiesResult associatePersonasToEntities(AssociatePersonasToEntitiesRequest associatePersonasToEntitiesRequest)
Defines the specific permissions of users or groups in your Amazon Web Services SSO 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.
associatePersonasToEntitiesRequest
- ValidationException
ResourceNotFoundException
ResourceAlreadyExistException
ThrottlingException
AccessDeniedException
InternalServerException
BatchDeleteDocumentResult batchDeleteDocument(BatchDeleteDocumentRequest batchDeleteDocumentRequest)
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 you CloudWatch log.
batchDeleteDocumentRequest
- ValidationException
ConflictException
ResourceNotFoundException
ThrottlingException
AccessDeniedException
InternalServerException
BatchGetDocumentStatusResult batchGetDocumentStatus(BatchGetDocumentStatusRequest batchGetDocumentStatusRequest)
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.
batchGetDocumentStatusRequest
- ValidationException
ConflictException
ResourceNotFoundException
ThrottlingException
AccessDeniedException
InternalServerException
BatchPutDocumentResult batchPutDocument(BatchPutDocumentRequest batchPutDocumentRequest)
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.
batchPutDocumentRequest
- ValidationException
ConflictException
ResourceNotFoundException
ThrottlingException
AccessDeniedException
ServiceQuotaExceededException
InternalServerException
ClearQuerySuggestionsResult clearQuerySuggestions(ClearQuerySuggestionsRequest clearQuerySuggestionsRequest)
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.
clearQuerySuggestionsRequest
- ValidationException
ResourceNotFoundException
ThrottlingException
ConflictException
AccessDeniedException
InternalServerException
CreateDataSourceResult createDataSource(CreateDataSourceRequest createDataSourceRequest)
Creates a data source 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.
Amazon S3 and custom data sources are the only supported data sources in the Amazon Web Services GovCloud (US-West) region.
createDataSourceRequest
- ValidationException
ConflictException
ResourceNotFoundException
ResourceAlreadyExistException
ServiceQuotaExceededException
ThrottlingException
AccessDeniedException
InternalServerException
CreateExperienceResult createExperience(CreateExperienceRequest createExperienceRequest)
Creates 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.
createExperienceRequest
- ValidationException
ConflictException
ResourceNotFoundException
ServiceQuotaExceededException
ThrottlingException
AccessDeniedException
InternalServerException
CreateFaqResult createFaq(CreateFaqRequest createFaqRequest)
Creates an new set of frequently asked question (FAQ) questions and answers.
Adding FAQs to an index is an asynchronous operation.
createFaqRequest
- ValidationException
ConflictException
ResourceNotFoundException
ThrottlingException
ServiceQuotaExceededException
AccessDeniedException
InternalServerException
CreateIndexResult createIndex(CreateIndexRequest createIndexRequest)
Creates a new 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.
createIndexRequest
- ValidationException
ResourceAlreadyExistException
ServiceQuotaExceededException
ThrottlingException
AccessDeniedException
ConflictException
InternalServerException
CreateQuerySuggestionsBlockListResult createQuerySuggestionsBlockList(CreateQuerySuggestionsBlockListRequest createQuerySuggestionsBlockListRequest)
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.
createQuerySuggestionsBlockListRequest
- ValidationException
ResourceNotFoundException
ThrottlingException
AccessDeniedException
ServiceQuotaExceededException
ConflictException
InternalServerException
CreateThesaurusResult createThesaurus(CreateThesaurusRequest createThesaurusRequest)
Creates a thesaurus for an index. The thesaurus contains a list of synonyms in Solr format.
createThesaurusRequest
- ValidationException
ConflictException
ResourceNotFoundException
ThrottlingException
ServiceQuotaExceededException
AccessDeniedException
InternalServerException
DeleteDataSourceResult deleteDataSource(DeleteDataSourceRequest deleteDataSourceRequest)
Deletes an Amazon Kendra data source. 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.
deleteDataSourceRequest
- AccessDeniedException
ValidationException
ConflictException
ResourceNotFoundException
ThrottlingException
InternalServerException
DeleteExperienceResult deleteExperience(DeleteExperienceRequest deleteExperienceRequest)
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.
deleteExperienceRequest
- AccessDeniedException
ValidationException
ConflictException
ResourceNotFoundException
ThrottlingException
InternalServerException
DeleteFaqResult deleteFaq(DeleteFaqRequest deleteFaqRequest)
Removes an FAQ from an index.
deleteFaqRequest
- ValidationException
ConflictException
ResourceNotFoundException
ThrottlingException
AccessDeniedException
InternalServerException
DeleteIndexResult deleteIndex(DeleteIndexRequest deleteIndexRequest)
Deletes an existing 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
.
deleteIndexRequest
- ValidationException
ConflictException
ResourceNotFoundException
ThrottlingException
AccessDeniedException
InternalServerException
DeletePrincipalMappingResult deletePrincipalMapping(DeletePrincipalMappingRequest deletePrincipalMappingRequest)
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.
deletePrincipalMappingRequest
- ValidationException
ConflictException
ResourceNotFoundException
ThrottlingException
AccessDeniedException
InternalServerException
DeleteQuerySuggestionsBlockListResult deleteQuerySuggestionsBlockList(DeleteQuerySuggestionsBlockListRequest deleteQuerySuggestionsBlockListRequest)
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.
deleteQuerySuggestionsBlockListRequest
- ValidationException
ResourceNotFoundException
ThrottlingException
AccessDeniedException
ConflictException
InternalServerException
DeleteThesaurusResult deleteThesaurus(DeleteThesaurusRequest deleteThesaurusRequest)
Deletes an existing Amazon Kendra thesaurus.
deleteThesaurusRequest
- ValidationException
ConflictException
ResourceNotFoundException
ThrottlingException
AccessDeniedException
InternalServerException
DescribeDataSourceResult describeDataSource(DescribeDataSourceRequest describeDataSourceRequest)
Gets information about an Amazon Kendra data source.
describeDataSourceRequest
- ValidationException
ResourceNotFoundException
ThrottlingException
AccessDeniedException
InternalServerException
DescribeExperienceResult describeExperience(DescribeExperienceRequest describeExperienceRequest)
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.
describeExperienceRequest
- ValidationException
ResourceNotFoundException
ThrottlingException
AccessDeniedException
InternalServerException
DescribeFaqResult describeFaq(DescribeFaqRequest describeFaqRequest)
Gets information about an FAQ list.
describeFaqRequest
- ValidationException
ResourceNotFoundException
ThrottlingException
AccessDeniedException
InternalServerException
DescribeIndexResult describeIndex(DescribeIndexRequest describeIndexRequest)
Describes an existing Amazon Kendra index
describeIndexRequest
- ValidationException
ResourceNotFoundException
ThrottlingException
AccessDeniedException
InternalServerException
DescribePrincipalMappingResult describePrincipalMapping(DescribePrincipalMappingRequest describePrincipalMappingRequest)
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.
describePrincipalMappingRequest
- ValidationException
ResourceNotFoundException
ThrottlingException
AccessDeniedException
InternalServerException
DescribeQuerySuggestionsBlockListResult describeQuerySuggestionsBlockList(DescribeQuerySuggestionsBlockListRequest describeQuerySuggestionsBlockListRequest)
Describes 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.
describeQuerySuggestionsBlockListRequest
- ValidationException
ResourceNotFoundException
ThrottlingException
AccessDeniedException
InternalServerException
DescribeQuerySuggestionsConfigResult describeQuerySuggestionsConfig(DescribeQuerySuggestionsConfigRequest describeQuerySuggestionsConfigRequest)
Describes 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.
describeQuerySuggestionsConfigRequest
- ValidationException
ResourceNotFoundException
ThrottlingException
AccessDeniedException
InternalServerException
DescribeThesaurusResult describeThesaurus(DescribeThesaurusRequest describeThesaurusRequest)
Describes an existing Amazon Kendra thesaurus.
describeThesaurusRequest
- ValidationException
ResourceNotFoundException
ThrottlingException
AccessDeniedException
InternalServerException
DisassociateEntitiesFromExperienceResult disassociateEntitiesFromExperience(DisassociateEntitiesFromExperienceRequest disassociateEntitiesFromExperienceRequest)
Prevents users or groups in your Amazon Web Services SSO 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.
disassociateEntitiesFromExperienceRequest
- ValidationException
ResourceNotFoundException
ThrottlingException
AccessDeniedException
InternalServerException
DisassociatePersonasFromEntitiesResult disassociatePersonasFromEntities(DisassociatePersonasFromEntitiesRequest disassociatePersonasFromEntitiesRequest)
Removes the specific permissions of users or groups in your Amazon Web Services SSO 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.
disassociatePersonasFromEntitiesRequest
- ValidationException
ResourceNotFoundException
ThrottlingException
AccessDeniedException
InternalServerException
GetQuerySuggestionsResult getQuerySuggestions(GetQuerySuggestionsRequest getQuerySuggestionsRequest)
Fetches the queries that are suggested to your users.
GetQuerySuggestions
is currently not supported in the Amazon Web Services GovCloud (US-West) region.
getQuerySuggestionsRequest
- ValidationException
ResourceNotFoundException
ThrottlingException
AccessDeniedException
ServiceQuotaExceededException
ConflictException
InternalServerException
GetSnapshotsResult getSnapshots(GetSnapshotsRequest getSnapshotsRequest)
Retrieves search metrics data. The data provides a snapshot of how your users interact with your search application and how effective the application is.
getSnapshotsRequest
- InvalidRequestException
- The input to the request is not valid.ResourceNotFoundException
AccessDeniedException
InternalServerException
ListDataSourceSyncJobsResult listDataSourceSyncJobs(ListDataSourceSyncJobsRequest listDataSourceSyncJobsRequest)
Gets statistics about synchronizing Amazon Kendra with a data source.
listDataSourceSyncJobsRequest
- ValidationException
ResourceNotFoundException
ThrottlingException
AccessDeniedException
ConflictException
InternalServerException
ListDataSourcesResult listDataSources(ListDataSourcesRequest listDataSourcesRequest)
Lists the data sources that you have created.
listDataSourcesRequest
- ValidationException
ResourceNotFoundException
AccessDeniedException
ThrottlingException
InternalServerException
ListEntityPersonasResult listEntityPersonas(ListEntityPersonasRequest listEntityPersonasRequest)
Lists specific permissions of users and groups with access to your Amazon Kendra experience.
listEntityPersonasRequest
- ValidationException
ResourceNotFoundException
AccessDeniedException
ThrottlingException
InternalServerException
ListExperienceEntitiesResult listExperienceEntities(ListExperienceEntitiesRequest listExperienceEntitiesRequest)
Lists users or groups in your Amazon Web Services SSO 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.
listExperienceEntitiesRequest
- ValidationException
ResourceNotFoundException
AccessDeniedException
ThrottlingException
InternalServerException
ListExperiencesResult listExperiences(ListExperiencesRequest listExperiencesRequest)
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.
listExperiencesRequest
- ValidationException
ResourceNotFoundException
AccessDeniedException
ThrottlingException
InternalServerException
ListFaqsResult listFaqs(ListFaqsRequest listFaqsRequest)
Gets a list of FAQ lists associated with an index.
listFaqsRequest
- ValidationException
ResourceNotFoundException
ThrottlingException
AccessDeniedException
InternalServerException
ListGroupsOlderThanOrderingIdResult listGroupsOlderThanOrderingId(ListGroupsOlderThanOrderingIdRequest listGroupsOlderThanOrderingIdRequest)
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.
listGroupsOlderThanOrderingIdRequest
- ValidationException
ResourceNotFoundException
AccessDeniedException
ThrottlingException
ConflictException
InternalServerException
ListIndicesResult listIndices(ListIndicesRequest listIndicesRequest)
Lists the Amazon Kendra indexes that you have created.
listIndicesRequest
- ValidationException
ThrottlingException
AccessDeniedException
InternalServerException
ListQuerySuggestionsBlockListsResult listQuerySuggestionsBlockLists(ListQuerySuggestionsBlockListsRequest listQuerySuggestionsBlockListsRequest)
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.
listQuerySuggestionsBlockListsRequest
- ValidationException
ResourceNotFoundException
ThrottlingException
AccessDeniedException
InternalServerException
ListTagsForResourceResult listTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest)
Gets a list of tags associated with a specified resource. Indexes, FAQs, and data sources can have tags associated with them.
listTagsForResourceRequest
- ValidationException
ResourceUnavailableException
ThrottlingException
AccessDeniedException
InternalServerException
ListThesauriResult listThesauri(ListThesauriRequest listThesauriRequest)
Lists the Amazon Kendra thesauri associated with an index.
listThesauriRequest
- ValidationException
ResourceNotFoundException
ThrottlingException
AccessDeniedException
InternalServerException
PutPrincipalMappingResult putPrincipalMapping(PutPrincipalMappingRequest putPrincipalMappingRequest)
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.
You map users to their groups when you want to filter search results for different users based on their group’s access to documents. For more information on filtering search results for different users, see Filtering on user context.
If more than five PUT
actions for a group are currently processing, a validation exception is
thrown.
PutPrincipalMapping
is currently not supported in the Amazon Web Services GovCloud (US-West) region.
putPrincipalMappingRequest
- ValidationException
ConflictException
ResourceNotFoundException
ThrottlingException
AccessDeniedException
ServiceQuotaExceededException
InternalServerException
QueryResult query(QueryRequest queryRequest)
Searches an active index. Use this API to search your documents using query. The Query
API enables
to do faceted search and to filter results based on document attributes.
It also enables you to provide user context that Amazon Kendra uses to enforce document access control in the search results.
Amazon Kendra searches your index for text content and question and answer (FAQ) content. By default the response contains three types of results.
Relevant passages
Matching FAQs
Relevant documents
You can specify that the query return only one type of result using the QueryResultTypeConfig
parameter.
Each query returns the 100 most relevant results.
queryRequest
- ValidationException
ConflictException
ResourceNotFoundException
ThrottlingException
AccessDeniedException
ServiceQuotaExceededException
InternalServerException
StartDataSourceSyncJobResult startDataSourceSyncJob(StartDataSourceSyncJobRequest startDataSourceSyncJobRequest)
Starts a synchronization job for a data source. If a synchronization job is already in progress, Amazon Kendra
returns a ResourceInUseException
exception.
startDataSourceSyncJobRequest
- ValidationException
ResourceNotFoundException
ResourceInUseException
ThrottlingException
AccessDeniedException
ConflictException
InternalServerException
StopDataSourceSyncJobResult stopDataSourceSyncJob(StopDataSourceSyncJobRequest stopDataSourceSyncJobRequest)
Stops a synchronization job that is currently running. You can't stop a scheduled synchronization job.
stopDataSourceSyncJobRequest
- ValidationException
ResourceNotFoundException
ThrottlingException
AccessDeniedException
InternalServerException
SubmitFeedbackResult submitFeedback(SubmitFeedbackRequest submitFeedbackRequest)
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.
submitFeedbackRequest
- ValidationException
ResourceUnavailableException
ResourceNotFoundException
ThrottlingException
AccessDeniedException
InternalServerException
TagResourceResult tagResource(TagResourceRequest tagResourceRequest)
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.
tagResourceRequest
- ValidationException
ResourceUnavailableException
ThrottlingException
AccessDeniedException
InternalServerException
UntagResourceResult untagResource(UntagResourceRequest untagResourceRequest)
Removes a tag from an index, FAQ, or a data source.
untagResourceRequest
- ValidationException
ResourceUnavailableException
ThrottlingException
AccessDeniedException
InternalServerException
UpdateDataSourceResult updateDataSource(UpdateDataSourceRequest updateDataSourceRequest)
Updates an existing Amazon Kendra data source.
updateDataSourceRequest
- ValidationException
ConflictException
ResourceNotFoundException
ThrottlingException
AccessDeniedException
InternalServerException
UpdateExperienceResult updateExperience(UpdateExperienceRequest updateExperienceRequest)
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.
updateExperienceRequest
- ValidationException
ConflictException
ResourceNotFoundException
ThrottlingException
AccessDeniedException
InternalServerException
UpdateIndexResult updateIndex(UpdateIndexRequest updateIndexRequest)
Updates an existing Amazon Kendra index.
updateIndexRequest
- ValidationException
ConflictException
ResourceNotFoundException
ThrottlingException
AccessDeniedException
ServiceQuotaExceededException
InternalServerException
UpdateQuerySuggestionsBlockListResult updateQuerySuggestionsBlockList(UpdateQuerySuggestionsBlockListRequest updateQuerySuggestionsBlockListRequest)
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.
updateQuerySuggestionsBlockListRequest
- ValidationException
ResourceNotFoundException
ThrottlingException
AccessDeniedException
ConflictException
InternalServerException
UpdateQuerySuggestionsConfigResult updateQuerySuggestionsConfig(UpdateQuerySuggestionsConfigRequest updateQuerySuggestionsConfigRequest)
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 (i.e. 'happening'), 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.
updateQuerySuggestionsConfigRequest
- ValidationException
ConflictException
ResourceNotFoundException
ThrottlingException
AccessDeniedException
InternalServerException
UpdateThesaurusResult updateThesaurus(UpdateThesaurusRequest updateThesaurusRequest)
Updates a thesaurus file associated with an index.
updateThesaurusRequest
- ValidationException
ResourceNotFoundException
ThrottlingException
AccessDeniedException
ConflictException
InternalServerException
void shutdown()
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 a request.
request
- The originally executed request.