Skip to content

Commit 340955b

Browse files
author
awstools
committed
feat(client-kendra): Amazon Kendra now supports preview of table information from HTML tables in the search results. The most relevant cells with their corresponding rows, columns are displayed as a preview in the search result. The most relevant table cell or cells are also highlighted in table preview.
1 parent cf73137 commit 340955b

29 files changed

+1572
-1358
lines changed

clients/client-kendra/src/Kendra.ts

Lines changed: 64 additions & 68 deletions
Large diffs are not rendered by default.

clients/client-kendra/src/commands/BatchGetDocumentStatusCommand.ts

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -32,12 +32,12 @@ export interface BatchGetDocumentStatusCommandOutput extends BatchGetDocumentSta
3232
* <p>Returns the indexing status for one or more documents submitted
3333
* with the <a href="https://docs.aws.amazon.com/kendra/latest/dg/API_BatchPutDocument.html">
3434
* BatchPutDocument</a> API.</p>
35-
* <p>When you use the <code>BatchPutDocument</code> API,
35+
* <p>When you use the <code>BatchPutDocument</code> API,
3636
* documents are indexed asynchronously. You can use the
3737
* <code>BatchGetDocumentStatus</code> API to get the current
3838
* status of a list of documents so that you can determine if they have
3939
* been successfully indexed.</p>
40-
* <p>You can also use the <code>BatchGetDocumentStatus</code> API
40+
* <p>You can also use the <code>BatchGetDocumentStatus</code> API
4141
* to check the status of the <a href="https://docs.aws.amazon.com/kendra/latest/dg/API_BatchDeleteDocument.html">
4242
* BatchDeleteDocument</a> API. When a document is
4343
* deleted from the index, Amazon Kendra returns <code>NOT_FOUND</code> as the

clients/client-kendra/src/commands/ClearQuerySuggestionsCommand.ts

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -25,13 +25,13 @@ export interface ClearQuerySuggestionsCommandOutput extends __MetadataBearer {}
2525

2626
/**
2727
* <p>Clears existing query suggestions from an index.</p>
28-
* <p>This deletes existing suggestions only, not the queries
28+
* <p>This deletes existing suggestions only, not the queries
2929
* in the query log. After you clear suggestions, Amazon Kendra learns
3030
* new suggestions based on new queries added to the query log
3131
* from the time you cleared suggestions. If you do not see any
3232
* new suggestions, then please allow Amazon Kendra to collect
3333
* enough queries to learn new suggestions.</p>
34-
* <p>
34+
* <p>
3535
* <code>ClearQuerySuggestions</code> is currently not supported in the
3636
* Amazon Web Services GovCloud (US-West) region.</p>
3737
* @example

clients/client-kendra/src/commands/CreateAccessControlConfigurationCommand.ts

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -35,7 +35,7 @@ export interface CreateAccessControlConfigurationCommandOutput
3535
* user and group access information for your documents. This is useful
3636
* for user context filtering, where search results are filtered based
3737
* on the user or their group access to documents.</p>
38-
* <p>You can use this to re-configure your existing document level access control without
38+
* <p>You can use this to re-configure your existing document level access control without
3939
* indexing all of your documents again. For example, your index contains top-secret
4040
* company documents that only certain employees or users should access. One of these users
4141
* leaves the company or switches to a team that should be blocked from accessing
@@ -45,7 +45,7 @@ export interface CreateAccessControlConfigurationCommandOutput
4545
* access. You can later update the access control configuration to allow access if the
4646
* user returns to the company and re-joins the 'top-secret' team. You can re-configure
4747
* access control for your documents as circumstances change.</p>
48-
* <p>To apply your access control configuration to certain documents, you call
48+
* <p>To apply your access control configuration to certain documents, you call
4949
* the <a href="https://docs.aws.amazon.com/kendra/latest/dg/API_BatchPutDocument.html">BatchPutDocument</a>
5050
* API with the <code>AccessControlConfigurationId</code> included in the
5151
* <a href="https://docs.aws.amazon.com/kendra/latest/dg/API_Document.html">Document</a>

clients/client-kendra/src/commands/CreateFaqCommand.ts

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -27,8 +27,8 @@ export interface CreateFaqCommandOutput extends CreateFaqResponse, __MetadataBea
2727

2828
/**
2929
* <p>Creates an new set of frequently asked question (FAQ) questions and answers.</p>
30-
* <p>Adding FAQs to an index is an asynchronous operation.</p>
31-
* <p>For an example of adding an FAQ to an index using Python and Java SDKs,
30+
* <p>Adding FAQs to an index is an asynchronous operation.</p>
31+
* <p>For an example of adding an FAQ to an index using Python and Java SDKs,
3232
* see <a href="https://docs.aws.amazon.com/kendra/latest/dg/in-creating-faq.html#using-faq-file">Using your
3333
* FAQ file</a>.</p>
3434
* @example

clients/client-kendra/src/commands/CreateIndexCommand.ts

Lines changed: 9 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -29,18 +29,16 @@ export interface CreateIndexCommandInput extends CreateIndexRequest {}
2929
export interface CreateIndexCommandOutput extends CreateIndexResponse, __MetadataBearer {}
3030

3131
/**
32-
* <p>Creates an Amazon Kendra index. Index creation is an asynchronous
33-
* API. To determine if index creation has completed, check the
34-
* <code>Status</code> field returned from a call to
35-
* <code>DescribeIndex</code>. The <code>Status</code> field is set to
36-
* <code>ACTIVE</code> when the index is ready to use.</p>
32+
* <p>Creates an Amazon Kendra index. Index creation is an asynchronous API. To determine
33+
* if index creation has completed, check the <code>Status</code> field returned from a call to
34+
* <code>DescribeIndex</code>. The <code>Status</code> field is set to <code>ACTIVE</code> when
35+
* the index is ready to use.</p>
3736
* <p>Once the index is active you can index your documents using the
38-
* <code>BatchPutDocument</code> API or using one of the supported
39-
* data sources.</p>
40-
* <p>For an example of creating an index and data source using the Python SDK,
41-
* see <a href="https://docs.aws.amazon.com/kendra/latest/dg/gs-python.html">Getting
42-
* started with Python SDK</a>. For an example of creating an index and data
43-
* source using the Java SDK, see <a href="https://docs.aws.amazon.com/kendra/latest/dg/gs-java.html">Getting started with Java SDK</a>.</p>
37+
* <code>BatchPutDocument</code> API or using one of the supported data sources.</p>
38+
* <p>For an example of creating an index and data source using the Python SDK, see <a href="https://docs.aws.amazon.com/kendra/latest/dg/gs-python.html">Getting started with Python
39+
* SDK</a>. For an example of creating an index and data source using the Java SDK, see
40+
* <a href="https://docs.aws.amazon.com/kendra/latest/dg/gs-java.html">Getting started with Java
41+
* SDK</a>.</p>
4442
* @example
4543
* Use a bare-bones client and the command you need to make an API call.
4644
* ```javascript

clients/client-kendra/src/commands/CreateQuerySuggestionsBlockListCommand.ts

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -32,18 +32,18 @@ export interface CreateQuerySuggestionsBlockListCommandOutput
3232

3333
/**
3434
* <p>Creates a block list to exlcude certain queries from suggestions.</p>
35-
* <p>Any query that contains words or phrases specified in the block
35+
* <p>Any query that contains words or phrases specified in the block
3636
* list is blocked or filtered out from being shown as a suggestion.</p>
37-
* <p>You need to provide the file location of your block list text file
37+
* <p>You need to provide the file location of your block list text file
3838
* in your S3 bucket. In your text file, enter each block word or phrase
3939
* on a separate line.</p>
40-
* <p>For information on the current quota limits for block lists, see
40+
* <p>For information on the current quota limits for block lists, see
4141
* <a href="https://docs.aws.amazon.com/kendra/latest/dg/quotas.html">Quotas
4242
* for Amazon Kendra</a>.</p>
43-
* <p>
43+
* <p>
4444
* <code>CreateQuerySuggestionsBlockList</code> is currently not supported in the
4545
* Amazon Web Services GovCloud (US-West) region.</p>
46-
* <p>For an example of creating a block list for query suggestions using the
46+
* <p>For an example of creating a block list for query suggestions using the
4747
* Python SDK, see <a href="https://docs.aws.amazon.com/kendra/latest/dg/query-suggestions.html#suggestions-block-list">Query
4848
* suggestions block list</a>.</p>
4949
* @example

clients/client-kendra/src/commands/DeleteIndexCommand.ts

Lines changed: 3 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -24,10 +24,9 @@ export interface DeleteIndexCommandInput extends DeleteIndexRequest {}
2424
export interface DeleteIndexCommandOutput extends __MetadataBearer {}
2525

2626
/**
27-
* <p>Deletes an existing Amazon Kendra index. An exception is not thrown if
28-
* the index is already being deleted. While the index is being deleted, the
29-
* <code>Status</code> field returned by a call to the
30-
* <code>DescribeIndex</code> API is set to
27+
* <p>Deletes an existing Amazon Kendra index. An exception is not thrown if the index is
28+
* already being deleted. While the index is being deleted, the <code>Status</code> field
29+
* returned by a call to the <code>DescribeIndex</code> API is set to
3130
* <code>DELETING</code>.</p>
3231
* @example
3332
* Use a bare-bones client and the command you need to make an API call.

clients/client-kendra/src/commands/DeletePrincipalMappingCommand.ts

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -26,17 +26,17 @@ export interface DeletePrincipalMappingCommandOutput extends __MetadataBearer {}
2626
/**
2727
* <p>Deletes a group so that all users and sub groups that belong to the group can
2828
* no longer access documents only available to that group.</p>
29-
* <p>For example, after deleting the group "Summer Interns", all interns who
29+
* <p>For example, after deleting the group "Summer Interns", all interns who
3030
* belonged to that group no longer see intern-only documents in their search
3131
* results.</p>
32-
* <p>If you want to delete or replace users or sub groups of a group, you need to
32+
* <p>If you want to delete or replace users or sub groups of a group, you need to
3333
* use the <code>PutPrincipalMapping</code> operation. For example, if a user in
3434
* the group "Engineering" leaves the engineering team and another user takes
3535
* their place, you provide an updated list of users or sub groups that belong
3636
* to the "Engineering" group when calling <code>PutPrincipalMapping</code>. You
3737
* can update your internal list of users or sub groups and input this list
3838
* when calling <code>PutPrincipalMapping</code>.</p>
39-
* <p>
39+
* <p>
4040
* <code>DeletePrincipalMapping</code> is currently not supported in the
4141
* Amazon Web Services GovCloud (US-West) region.</p>
4242
* @example

clients/client-kendra/src/commands/DeleteQuerySuggestionsBlockListCommand.ts

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -28,10 +28,10 @@ export interface DeleteQuerySuggestionsBlockListCommandOutput extends __Metadata
2828

2929
/**
3030
* <p>Deletes a block list used for query suggestions for an index.</p>
31-
* <p>A deleted block list might not take effect right away. Amazon Kendra
31+
* <p>A deleted block list might not take effect right away. Amazon Kendra
3232
* needs to refresh the entire suggestions list to add back the
3333
* queries that were previously blocked.</p>
34-
* <p>
34+
* <p>
3535
* <code>DeleteQuerySuggestionsBlockList</code> is currently not supported in the
3636
* Amazon Web Services GovCloud (US-West) region.</p>
3737
* @example

clients/client-kendra/src/commands/DescribePrincipalMappingCommand.ts

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -35,7 +35,7 @@ export interface DescribePrincipalMappingCommandOutput extends DescribePrincipal
3535
* when actions were received by Amazon Kendra, the latest action that should process
3636
* and apply after other actions, and useful error messages if an action could
3737
* not be processed.</p>
38-
* <p>
38+
* <p>
3939
* <code>DescribePrincipalMapping</code> is currently not supported in the
4040
* Amazon Web Services GovCloud (US-West) region.</p>
4141
* @example

clients/client-kendra/src/commands/DescribeQuerySuggestionsBlockListCommand.ts

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -33,9 +33,9 @@ export interface DescribeQuerySuggestionsBlockListCommandOutput
3333
/**
3434
* <p>Gets information about a block list used for query suggestions for
3535
* an index.</p>
36-
* <p>This is used to check the current settings that are applied to a
36+
* <p>This is used to check the current settings that are applied to a
3737
* block list.</p>
38-
* <p>
38+
* <p>
3939
* <code>DescribeQuerySuggestionsBlockList</code> is currently not supported in the
4040
* Amazon Web Services GovCloud (US-West) region.</p>
4141
* @example

clients/client-kendra/src/commands/DescribeQuerySuggestionsConfigCommand.ts

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -32,9 +32,9 @@ export interface DescribeQuerySuggestionsConfigCommandOutput
3232

3333
/**
3434
* <p>Gets information on the settings of query suggestions for an index.</p>
35-
* <p>This is used to check the current settings applied
35+
* <p>This is used to check the current settings applied
3636
* to query suggestions.</p>
37-
* <p>
37+
* <p>
3838
* <code>DescribeQuerySuggestionsConfig</code> is currently not supported in the
3939
* Amazon Web Services GovCloud (US-West) region.</p>
4040
* @example

clients/client-kendra/src/commands/GetQuerySuggestionsCommand.ts

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -30,7 +30,7 @@ export interface GetQuerySuggestionsCommandOutput extends GetQuerySuggestionsRes
3030

3131
/**
3232
* <p>Fetches the queries that are suggested to your users.</p>
33-
* <p>
33+
* <p>
3434
* <code>GetQuerySuggestions</code> is currently not supported in the
3535
* Amazon Web Services GovCloud (US-West) region.</p>
3636
* @example

clients/client-kendra/src/commands/ListGroupsOlderThanOrderingIdCommand.ts

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -33,7 +33,7 @@ export interface ListGroupsOlderThanOrderingIdCommandOutput
3333
/**
3434
* <p>Provides a list of groups that are mapped to users before a
3535
* given ordering or timestamp identifier.</p>
36-
* <p>
36+
* <p>
3737
* <code>ListGroupsOlderThanOrderingId</code> is currently not supported in the
3838
* Amazon Web Services GovCloud (US-West) region.</p>
3939
* @example

clients/client-kendra/src/commands/ListQuerySuggestionsBlockListsCommand.ts

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -32,10 +32,10 @@ export interface ListQuerySuggestionsBlockListsCommandOutput
3232

3333
/**
3434
* <p>Lists the block lists used for query suggestions for an index.</p>
35-
* <p>For information on the current quota limits for block lists, see
35+
* <p>For information on the current quota limits for block lists, see
3636
* <a href="https://docs.aws.amazon.com/kendra/latest/dg/quotas.html">Quotas
3737
* for Amazon Kendra</a>.</p>
38-
* <p>
38+
* <p>
3939
* <code>ListQuerySuggestionsBlockLists</code> is currently not supported in the
4040
* Amazon Web Services GovCloud (US-West) region.</p>
4141
* @example

clients/client-kendra/src/commands/PutPrincipalMappingCommand.ts

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -26,21 +26,21 @@ export interface PutPrincipalMappingCommandOutput extends __MetadataBearer {}
2626
/**
2727
* <p>Maps users to their groups so that you only need to provide
2828
* the user ID when you issue the query.</p>
29-
* <p>You can also map sub groups to groups.
29+
* <p>You can also map sub groups to groups.
3030
* For example, the group "Company Intellectual Property Teams" includes
3131
* sub groups "Research" and "Engineering". These sub groups include their
3232
* own list of users or people who work in these teams. Only users who work
3333
* in research and engineering, and therefore belong in the intellectual
3434
* property group, can see top-secret company documents in their search
3535
* results.</p>
36-
* <p>This is useful for user context filtering, where search results are
36+
* <p>This is useful for user context filtering, where search results are
3737
* filtered based on the user or their group access to documents. For more
3838
* information, see
3939
* <a href="https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html">Filtering
4040
* on user context</a>.</p>
41-
* <p>If more than five <code>PUT</code> actions for a group are currently
41+
* <p>If more than five <code>PUT</code> actions for a group are currently
4242
* processing, a validation exception is thrown.</p>
43-
* <p>
43+
* <p>
4444
* <code>PutPrincipalMapping</code> is currently not supported in the
4545
* Amazon Web Services GovCloud (US-West) region.</p>
4646
* @example

clients/client-kendra/src/commands/QueryCommand.ts

Lines changed: 9 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -26,14 +26,13 @@ export interface QueryCommandInput extends QueryRequest {}
2626
export interface QueryCommandOutput extends QueryResult, __MetadataBearer {}
2727

2828
/**
29-
* <p>Searches an active index. Use this API to search your documents
30-
* using query. The <code>Query</code> API enables to do faceted
31-
* search and to filter results based on document attributes.</p>
32-
* <p>It also enables you to provide user context that Amazon Kendra uses
33-
* to enforce document access control in the search results.</p>
34-
* <p>Amazon Kendra searches your index for text content and question and
35-
* answer (FAQ) content. By default the response contains three types of
36-
* results.</p>
29+
* <p>Searches an active index. Use this API to search your documents using query. The
30+
* <code>Query</code> API enables to do faceted search and to filter results based on
31+
* document attributes.</p>
32+
* <p>It also enables you to provide user context that Amazon Kendra uses to enforce
33+
* document access control in the search results.</p>
34+
* <p>Amazon Kendra searches your index for text content and question and answer (FAQ)
35+
* content. By default the response contains three types of results.</p>
3736
* <ul>
3837
* <li>
3938
* <p>Relevant passages</p>
@@ -45,8 +44,8 @@ export interface QueryCommandOutput extends QueryResult, __MetadataBearer {}
4544
* <p>Relevant documents</p>
4645
* </li>
4746
* </ul>
48-
* <p>You can specify that the query return only one type of result using
49-
* the <code>QueryResultTypeConfig</code> parameter.</p>
47+
* <p>You can specify that the query return only one type of result using the
48+
* <code>QueryResultTypeConfig</code> parameter.</p>
5049
* <p>Each query returns the 100 most relevant results. </p>
5150
* @example
5251
* Use a bare-bones client and the command you need to make an API call.

clients/client-kendra/src/commands/SubmitFeedbackCommand.ts

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ export interface SubmitFeedbackCommandOutput extends __MetadataBearer {}
2626
/**
2727
* <p>Enables you to provide feedback to Amazon Kendra to improve the
2828
* performance of your index.</p>
29-
* <p>
29+
* <p>
3030
* <code>SubmitFeedback</code> is currently not supported in the
3131
* Amazon Web Services GovCloud (US-West) region.</p>
3232
* @example

clients/client-kendra/src/commands/UpdateAccessControlConfigurationCommand.ts

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -35,15 +35,15 @@ export interface UpdateAccessControlConfigurationCommandOutput
3535
* includes user and group access information for your documents. This is useful
3636
* for user context filtering, where search results are filtered based on the user
3737
* or their group access to documents.</p>
38-
* <p>You can update an access control configuration you created without indexing all
38+
* <p>You can update an access control configuration you created without indexing all
3939
* of your documents again. For example, your index contains top-secret company
4040
* documents that only certain employees or users should access. You created an 'allow'
4141
* access control configuration for one user who recently joined the 'top-secret' team,
4242
* switching from a team with 'deny' access to top-secret documents. However, the user
4343
* suddenly returns to their previous team and should no longer have access to top secret
4444
* documents. You can update the access control configuration to re-configure access
4545
* control for your documents as circumstances change.</p>
46-
* <p>You call the <a href="https://docs.aws.amazon.com/kendra/latest/dg/API_BatchPutDocument.html">BatchPutDocument</a> API to
46+
* <p>You call the <a href="https://docs.aws.amazon.com/kendra/latest/dg/API_BatchPutDocument.html">BatchPutDocument</a> API to
4747
* apply the updated access control configuration, with the
4848
* <code>AccessControlConfigurationId</code> included in the
4949
* <a href="https://docs.aws.amazon.com/kendra/latest/dg/API_Document.html">Document</a>

0 commit comments

Comments
 (0)