feat(client-kendra): This release adds GenAI Index in Amazon Kendra for Retrieval Augmented Generation (RAG) and intelligent search. With the Kendra GenAI Index, customers get high retrieval accuracy powered by the latest information retrieval technologies and semantic models.

awstools · awstools · commit 796599ece5e5 · 2024-12-04T19:16:20.000Z
diff --git a/clients/client-kendra/src/commands/BatchDeleteDocumentCommand.ts b/clients/client-kendra/src/commands/BatchDeleteDocumentCommand.ts
@@ -60,6 +60,7 @@ export interface BatchDeleteDocumentCommandOutput extends BatchDeleteDocumentRes
  * //   FailedDocuments: [ // BatchDeleteDocumentResponseFailedDocuments
  * //     { // BatchDeleteDocumentResponseFailedDocument
  * //       Id: "STRING_VALUE",
+ * //       DataSourceId: "STRING_VALUE",
  * //       ErrorCode: "InternalError" || "InvalidRequest",
  * //       ErrorMessage: "STRING_VALUE",
  * //     },
diff --git a/clients/client-kendra/src/commands/BatchGetDocumentStatusCommand.ts b/clients/client-kendra/src/commands/BatchGetDocumentStatusCommand.ts
@@ -70,6 +70,7 @@ export interface BatchGetDocumentStatusCommandOutput extends BatchGetDocumentSta
  * //   Errors: [ // BatchGetDocumentStatusResponseErrors
  * //     { // BatchGetDocumentStatusResponseError
  * //       DocumentId: "STRING_VALUE",
+ * //       DataSourceId: "STRING_VALUE",
  * //       ErrorCode: "InternalError" || "InvalidRequest",
  * //       ErrorMessage: "STRING_VALUE",
  * //     },
diff --git a/clients/client-kendra/src/commands/BatchPutDocumentCommand.ts b/clients/client-kendra/src/commands/BatchPutDocumentCommand.ts
@@ -167,6 +167,7 @@ export interface BatchPutDocumentCommandOutput extends BatchPutDocumentResponse,
  * //   FailedDocuments: [ // BatchPutDocumentResponseFailedDocuments
  * //     { // BatchPutDocumentResponseFailedDocument
  * //       Id: "STRING_VALUE",
+ * //       DataSourceId: "STRING_VALUE",
  * //       ErrorCode: "InternalError" || "InvalidRequest",
  * //       ErrorMessage: "STRING_VALUE",
  * //     },
diff --git a/clients/client-kendra/src/commands/CreateAccessControlConfigurationCommand.ts b/clients/client-kendra/src/commands/CreateAccessControlConfigurationCommand.ts
@@ -52,6 +52,12 @@ export interface CreateAccessControlConfigurationCommandOutput
  *             synchronize your data source. Amazon Kendra currently only supports access control
  *             configuration for S3 data sources and documents indexed using the
  *                 <code>BatchPutDocument</code> API.</p>
+ *          <important>
+ *             <p>You can't configure access control using
+ *                     <code>CreateAccessControlConfiguration</code> for an Amazon Kendra Gen AI Enterprise
+ *                 Edition index. Amazon Kendra will return a <code>ValidationException</code> error for a
+ *                     <code>Gen_AI_ENTERPRISE_EDITION</code> index.</p>
+ *          </important>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
diff --git a/clients/client-kendra/src/commands/CreateIndexCommand.ts b/clients/client-kendra/src/commands/CreateIndexCommand.ts
@@ -46,7 +46,7 @@ export interface CreateIndexCommandOutput extends CreateIndexResponse, __Metadat
  * const client = new KendraClient(config);
  * const input = { // CreateIndexRequest
  *   Name: "STRING_VALUE", // required
- *   Edition: "DEVELOPER_EDITION" || "ENTERPRISE_EDITION",
+ *   Edition: "DEVELOPER_EDITION" || "ENTERPRISE_EDITION" || "GEN_AI_ENTERPRISE_EDITION",
  *   RoleArn: "STRING_VALUE", // required
  *   ServerSideEncryptionConfiguration: { // ServerSideEncryptionConfiguration
  *     KmsKeyId: "STRING_VALUE",
diff --git a/clients/client-kendra/src/commands/DeleteFaqCommand.ts b/clients/client-kendra/src/commands/DeleteFaqCommand.ts
@@ -28,7 +28,7 @@ export interface DeleteFaqCommandInput extends DeleteFaqRequest {}
 export interface DeleteFaqCommandOutput extends __MetadataBearer {}
 
 /**
- * <p>Removes an FAQ from an index.</p>
+ * <p>Removes a FAQ from an index.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
diff --git a/clients/client-kendra/src/commands/DeleteIndexCommand.ts b/clients/client-kendra/src/commands/DeleteIndexCommand.ts
@@ -28,10 +28,9 @@ export interface DeleteIndexCommandInput extends DeleteIndexRequest {}
 export interface DeleteIndexCommandOutput extends __MetadataBearer {}
 
 /**
- * <p>Deletes an Amazon Kendra index. An exception is not thrown if the index is
- *       already being deleted. While the index is being deleted, the <code>Status</code> field
- *       returned by a call to the <code>DescribeIndex</code> API is set to
- *       <code>DELETING</code>.</p>
+ * <p>Deletes an Amazon Kendra index. An exception is not thrown if the index is already
+ *       being deleted. While the index is being deleted, the <code>Status</code> field returned by a
+ *       call to the <code>DescribeIndex</code> API is set to <code>DELETING</code>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
diff --git a/clients/client-kendra/src/commands/DeletePrincipalMappingCommand.ts b/clients/client-kendra/src/commands/DeletePrincipalMappingCommand.ts
@@ -28,7 +28,7 @@ export interface DeletePrincipalMappingCommandInput extends DeletePrincipalMappi
 export interface DeletePrincipalMappingCommandOutput extends __MetadataBearer {}
 
 /**
- * <p>Deletes a group so that all users and sub groups that belong to the group can no
+ * <p>Deletes a group so that all users that belong to the group can no
  *             longer access documents only available to that group.</p>
  *          <p>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.</p>
diff --git a/clients/client-kendra/src/commands/DescribeFaqCommand.ts b/clients/client-kendra/src/commands/DescribeFaqCommand.ts
@@ -28,7 +28,7 @@ export interface DescribeFaqCommandInput extends DescribeFaqRequest {}
 export interface DescribeFaqCommandOutput extends DescribeFaqResponse, __MetadataBearer {}
 
 /**
- * <p>Gets information about an FAQ list.</p>
+ * <p>Gets information about a FAQ.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
diff --git a/clients/client-kendra/src/commands/DescribeIndexCommand.ts b/clients/client-kendra/src/commands/DescribeIndexCommand.ts
@@ -47,7 +47,7 @@ export interface DescribeIndexCommandOutput extends DescribeIndexResponse, __Met
  * // { // DescribeIndexResponse
  * //   Name: "STRING_VALUE",
  * //   Id: "STRING_VALUE",
- * //   Edition: "DEVELOPER_EDITION" || "ENTERPRISE_EDITION",
+ * //   Edition: "DEVELOPER_EDITION" || "ENTERPRISE_EDITION" || "GEN_AI_ENTERPRISE_EDITION",
  * //   RoleArn: "STRING_VALUE",
  * //   ServerSideEncryptionConfiguration: { // ServerSideEncryptionConfiguration
  * //     KmsKeyId: "STRING_VALUE",
diff --git a/clients/client-kendra/src/commands/ListFaqsCommand.ts b/clients/client-kendra/src/commands/ListFaqsCommand.ts
@@ -28,7 +28,7 @@ export interface ListFaqsCommandInput extends ListFaqsRequest {}
 export interface ListFaqsCommandOutput extends ListFaqsResponse, __MetadataBearer {}
 
 /**
- * <p>Gets a list of FAQ lists associated with an index.</p>
+ * <p>Gets a list of FAQs associated with an index.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
diff --git a/clients/client-kendra/src/commands/ListIndicesCommand.ts b/clients/client-kendra/src/commands/ListIndicesCommand.ts
@@ -46,7 +46,7 @@ export interface ListIndicesCommandOutput extends ListIndicesResponse, __Metadat
  * //     { // IndexConfigurationSummary
  * //       Name: "STRING_VALUE",
  * //       Id: "STRING_VALUE",
- * //       Edition: "DEVELOPER_EDITION" || "ENTERPRISE_EDITION",
+ * //       Edition: "DEVELOPER_EDITION" || "ENTERPRISE_EDITION" || "GEN_AI_ENTERPRISE_EDITION",
  * //       CreatedAt: new Date("TIMESTAMP"), // required
  * //       UpdatedAt: new Date("TIMESTAMP"), // required
  * //       Status: "CREATING" || "ACTIVE" || "DELETING" || "FAILED" || "UPDATING" || "SYSTEM_UPDATING", // required
diff --git a/clients/client-kendra/src/commands/ListTagsForResourceCommand.ts b/clients/client-kendra/src/commands/ListTagsForResourceCommand.ts
@@ -28,8 +28,8 @@ export interface ListTagsForResourceCommandInput extends ListTagsForResourceRequ
 export interface ListTagsForResourceCommandOutput extends ListTagsForResourceResponse, __MetadataBearer {}
 
 /**
- * <p>Gets a list of tags associated with a specified resource. Indexes, FAQs, and data sources
- *       can have tags associated with them.</p>
+ * <p>Gets a list of tags associated with a resource. Indexes, FAQs, data sources, and
+ *       other resources can have tags associated with them.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
diff --git a/clients/client-kendra/src/commands/QueryCommand.ts b/clients/client-kendra/src/commands/QueryCommand.ts
@@ -58,6 +58,13 @@ export interface QueryCommandOutput extends QueryResult, __MetadataBearer {}
  *          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.</p>
+ *          <important>
+ *             <p>If you're using an Amazon Kendra Gen AI Enterprise Edition index, you can only use
+ *                <code>ATTRIBUTE_FILTER</code> to filter search results by user context. If you're
+ *             using an Amazon Kendra Gen AI Enterprise Edition index and you try to use
+ *                <code>USER_TOKEN</code> to configure user context policy, Amazon Kendra returns a
+ *                <code>ValidationException</code> error.</p>
+ *          </important>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
diff --git a/clients/client-kendra/src/commands/RetrieveCommand.ts b/clients/client-kendra/src/commands/RetrieveCommand.ts
@@ -64,6 +64,13 @@ export interface RetrieveCommandOutput extends RetrieveResult, __MetadataBearer
  *                 units</a> 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 <a href="https://docs.aws.amazon.com/kendra/latest/dg/adjusting-capacity.html">Adjusting
  *                 capacity</a>.</p>
+ *          <important>
+ *             <p>If you're using an Amazon Kendra Gen AI Enterprise Edition index, you can only use
+ *                     <code>ATTRIBUTE_FILTER</code> to filter search results by user context. If
+ *                 you're using an Amazon Kendra Gen AI Enterprise Edition index and you try to use
+ *                     <code>USER_TOKEN</code> to configure user context policy, Amazon Kendra returns a
+ *                     <code>ValidationException</code> error.</p>
+ *          </important>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
diff --git a/clients/client-kendra/src/commands/TagResourceCommand.ts b/clients/client-kendra/src/commands/TagResourceCommand.ts
@@ -28,8 +28,8 @@ export interface TagResourceCommandInput extends TagResourceRequest {}
 export interface TagResourceCommandOutput extends TagResourceResponse, __MetadataBearer {}
 
 /**
- * <p>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.</p>
+ * <p>Adds the specified tag to the specified index, FAQ, data source, or other resource. If
+ *       the tag already exists, the existing value is replaced with the new value.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
diff --git a/clients/client-kendra/src/commands/UntagResourceCommand.ts b/clients/client-kendra/src/commands/UntagResourceCommand.ts
@@ -28,7 +28,7 @@ export interface UntagResourceCommandInput extends UntagResourceRequest {}
 export interface UntagResourceCommandOutput extends UntagResourceResponse, __MetadataBearer {}
 
 /**
- * <p>Removes a tag from an index, FAQ, or a data source.</p>
+ * <p>Removes a tag from an index, FAQ, data source, or other resource.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
diff --git a/clients/client-kendra/src/commands/UpdateAccessControlConfigurationCommand.ts b/clients/client-kendra/src/commands/UpdateAccessControlConfigurationCommand.ts
@@ -52,6 +52,12 @@ export interface UpdateAccessControlConfigurationCommandOutput
  *             apply the <code>AccessControlConfigurationId</code> in the <code>.metadata.json</code>
  *             file. Amazon Kendra currently only supports access control configuration for S3
  *             data sources and documents indexed using the <code>BatchPutDocument</code> API.</p>
+ *          <important>
+ *             <p>You can't configure access control using
+ *                     <code>CreateAccessControlConfiguration</code> for an Amazon Kendra Gen AI Enterprise
+ *                 Edition index. Amazon Kendra will return a <code>ValidationException</code> error for a
+ *                     <code>Gen_AI_ENTERPRISE_EDITION</code> index.</p>
+ *          </important>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
diff --git a/clients/client-kendra/src/models/models_0.ts b/clients/client-kendra/src/models/models_0.ts
diff --git a/clients/client-kendra/src/models/models_1.ts b/clients/client-kendra/src/models/models_1.ts
diff --git a/codegen/sdk-codegen/aws-models/kendra.json b/codegen/sdk-codegen/aws-models/kendra.json
