@aws-sdk/client-kendra 3.357.0 → 3.358.0

package/README.md

@@ -618,6 +618,14 @@ Query
 
 [Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-kendra/classes/querycommand.html) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-kendra/interfaces/querycommandinput.html) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-kendra/interfaces/querycommandoutput.html)
 
+</details>
+<details>
+<summary>
+Retrieve
+</summary>
+
+[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-kendra/classes/retrievecommand.html) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-kendra/interfaces/retrievecommandinput.html) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-kendra/interfaces/retrievecommandoutput.html)
+
 </details>
 <details>
 <summary>

package/dist-cjs/Kendra.js

@@ -54,6 +54,7 @@ const ListTagsForResourceCommand_1 = require("./commands/ListTagsForResourceComm
 const ListThesauriCommand_1 = require("./commands/ListThesauriCommand");
 const PutPrincipalMappingCommand_1 = require("./commands/PutPrincipalMappingCommand");
 const QueryCommand_1 = require("./commands/QueryCommand");
+const RetrieveCommand_1 = require("./commands/RetrieveCommand");
 const StartDataSourceSyncJobCommand_1 = require("./commands/StartDataSourceSyncJobCommand");
 const StopDataSourceSyncJobCommand_1 = require("./commands/StopDataSourceSyncJobCommand");
 const SubmitFeedbackCommand_1 = require("./commands/SubmitFeedbackCommand");
@@ -121,6 +122,7 @@ const commands = {
     ListThesauriCommand: ListThesauriCommand_1.ListThesauriCommand,
     PutPrincipalMappingCommand: PutPrincipalMappingCommand_1.PutPrincipalMappingCommand,
     QueryCommand: QueryCommand_1.QueryCommand,
+    RetrieveCommand: RetrieveCommand_1.RetrieveCommand,
     StartDataSourceSyncJobCommand: StartDataSourceSyncJobCommand_1.StartDataSourceSyncJobCommand,
     StopDataSourceSyncJobCommand: StopDataSourceSyncJobCommand_1.StopDataSourceSyncJobCommand,
     SubmitFeedbackCommand: SubmitFeedbackCommand_1.SubmitFeedbackCommand,

package/dist-cjs/commands/RetrieveCommand.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RetrieveCommand = exports.$Command = void 0;
+const middleware_endpoint_1 = require("@aws-sdk/middleware-endpoint");
+const middleware_serde_1 = require("@aws-sdk/middleware-serde");
+const smithy_client_1 = require("@aws-sdk/smithy-client");
+Object.defineProperty(exports, "$Command", { enumerable: true, get: function () { return smithy_client_1.Command; } });
+const Aws_json1_1_1 = require("../protocols/Aws_json1_1");
+class RetrieveCommand extends smithy_client_1.Command {
+    static getEndpointParameterInstructions() {
+        return {
+            UseFIPS: { type: "builtInParams", name: "useFipsEndpoint" },
+            Endpoint: { type: "builtInParams", name: "endpoint" },
+            Region: { type: "builtInParams", name: "region" },
+            UseDualStack: { type: "builtInParams", name: "useDualstackEndpoint" },
+        };
+    }
+    constructor(input) {
+        super();
+        this.input = input;
+    }
+    resolveMiddleware(clientStack, configuration, options) {
+        this.middlewareStack.use((0, middleware_serde_1.getSerdePlugin)(configuration, this.serialize, this.deserialize));
+        this.middlewareStack.use((0, middleware_endpoint_1.getEndpointPlugin)(configuration, RetrieveCommand.getEndpointParameterInstructions()));
+        const stack = clientStack.concat(this.middlewareStack);
+        const { logger } = configuration;
+        const clientName = "KendraClient";
+        const commandName = "RetrieveCommand";
+        const handlerExecutionContext = {
+            logger,
+            clientName,
+            commandName,
+            inputFilterSensitiveLog: (_) => _,
+            outputFilterSensitiveLog: (_) => _,
+        };
+        const { requestHandler } = configuration;
+        return stack.resolve((request) => requestHandler.handle(request.request, options || {}), handlerExecutionContext);
+    }
+    serialize(input, context) {
+        return (0, Aws_json1_1_1.se_RetrieveCommand)(input, context);
+    }
+    deserialize(output, context) {
+        return (0, Aws_json1_1_1.de_RetrieveCommand)(output, context);
+    }
+}
+exports.RetrieveCommand = RetrieveCommand;

package/dist-cjs/commands/index.js

@@ -53,6 +53,7 @@ tslib_1.__exportStar(require("./ListTagsForResourceCommand"), exports);
 tslib_1.__exportStar(require("./ListThesauriCommand"), exports);
 tslib_1.__exportStar(require("./PutPrincipalMappingCommand"), exports);
 tslib_1.__exportStar(require("./QueryCommand"), exports);
+tslib_1.__exportStar(require("./RetrieveCommand"), exports);
 tslib_1.__exportStar(require("./StartDataSourceSyncJobCommand"), exports);
 tslib_1.__exportStar(require("./StopDataSourceSyncJobCommand"), exports);
 tslib_1.__exportStar(require("./SubmitFeedbackCommand"), exports);

package/dist-cjs/protocols/Aws_json1_1.js

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.se_ListThesauriCommand = exports.se_ListTagsForResourceCommand = exports.se_ListQuerySuggestionsBlockListsCommand = exports.se_ListIndicesCommand = exports.se_ListGroupsOlderThanOrderingIdCommand = exports.se_ListFeaturedResultsSetsCommand = exports.se_ListFaqsCommand = exports.se_ListExperiencesCommand = exports.se_ListExperienceEntitiesCommand = exports.se_ListEntityPersonasCommand = exports.se_ListDataSourceSyncJobsCommand = exports.se_ListDataSourcesCommand = exports.se_ListAccessControlConfigurationsCommand = exports.se_GetSnapshotsCommand = exports.se_GetQuerySuggestionsCommand = exports.se_DisassociatePersonasFromEntitiesCommand = exports.se_DisassociateEntitiesFromExperienceCommand = exports.se_DescribeThesaurusCommand = exports.se_DescribeQuerySuggestionsConfigCommand = exports.se_DescribeQuerySuggestionsBlockListCommand = exports.se_DescribePrincipalMappingCommand = exports.se_DescribeIndexCommand = exports.se_DescribeFeaturedResultsSetCommand = exports.se_DescribeFaqCommand = exports.se_DescribeExperienceCommand = exports.se_DescribeDataSourceCommand = exports.se_DescribeAccessControlConfigurationCommand = exports.se_DeleteThesaurusCommand = exports.se_DeleteQuerySuggestionsBlockListCommand = exports.se_DeletePrincipalMappingCommand = exports.se_DeleteIndexCommand = exports.se_DeleteFaqCommand = exports.se_DeleteExperienceCommand = exports.se_DeleteDataSourceCommand = exports.se_DeleteAccessControlConfigurationCommand = exports.se_CreateThesaurusCommand = exports.se_CreateQuerySuggestionsBlockListCommand = exports.se_CreateIndexCommand = exports.se_CreateFeaturedResultsSetCommand = exports.se_CreateFaqCommand = exports.se_CreateExperienceCommand = exports.se_CreateDataSourceCommand = exports.se_CreateAccessControlConfigurationCommand = exports.se_ClearQuerySuggestionsCommand = exports.se_BatchPutDocumentCommand = exports.se_BatchGetDocumentStatusCommand = exports.se_BatchDeleteFeaturedResultsSetCommand = exports.se_BatchDeleteDocumentCommand = exports.se_AssociatePersonasToEntitiesCommand = exports.se_AssociateEntitiesToExperienceCommand = void 0;
-exports.de_DisassociatePersonasFromEntitiesCommand = exports.de_DisassociateEntitiesFromExperienceCommand = exports.de_DescribeThesaurusCommand = exports.de_DescribeQuerySuggestionsConfigCommand = exports.de_DescribeQuerySuggestionsBlockListCommand = exports.de_DescribePrincipalMappingCommand = exports.de_DescribeIndexCommand = exports.de_DescribeFeaturedResultsSetCommand = exports.de_DescribeFaqCommand = exports.de_DescribeExperienceCommand = exports.de_DescribeDataSourceCommand = exports.de_DescribeAccessControlConfigurationCommand = exports.de_DeleteThesaurusCommand = exports.de_DeleteQuerySuggestionsBlockListCommand = exports.de_DeletePrincipalMappingCommand = exports.de_DeleteIndexCommand = exports.de_DeleteFaqCommand = exports.de_DeleteExperienceCommand = exports.de_DeleteDataSourceCommand = exports.de_DeleteAccessControlConfigurationCommand = exports.de_CreateThesaurusCommand = exports.de_CreateQuerySuggestionsBlockListCommand = exports.de_CreateIndexCommand = exports.de_CreateFeaturedResultsSetCommand = exports.de_CreateFaqCommand = exports.de_CreateExperienceCommand = exports.de_CreateDataSourceCommand = exports.de_CreateAccessControlConfigurationCommand = exports.de_ClearQuerySuggestionsCommand = exports.de_BatchPutDocumentCommand = exports.de_BatchGetDocumentStatusCommand = exports.de_BatchDeleteFeaturedResultsSetCommand = exports.de_BatchDeleteDocumentCommand = exports.de_AssociatePersonasToEntitiesCommand = exports.de_AssociateEntitiesToExperienceCommand = exports.se_UpdateThesaurusCommand = exports.se_UpdateQuerySuggestionsConfigCommand = exports.se_UpdateQuerySuggestionsBlockListCommand = exports.se_UpdateIndexCommand = exports.se_UpdateFeaturedResultsSetCommand = exports.se_UpdateExperienceCommand = exports.se_UpdateDataSourceCommand = exports.se_UpdateAccessControlConfigurationCommand = exports.se_UntagResourceCommand = exports.se_TagResourceCommand = exports.se_SubmitFeedbackCommand = exports.se_StopDataSourceSyncJobCommand = exports.se_StartDataSourceSyncJobCommand = exports.se_QueryCommand = exports.se_PutPrincipalMappingCommand = void 0;
-exports.de_UpdateThesaurusCommand = exports.de_UpdateQuerySuggestionsConfigCommand = exports.de_UpdateQuerySuggestionsBlockListCommand = exports.de_UpdateIndexCommand = exports.de_UpdateFeaturedResultsSetCommand = exports.de_UpdateExperienceCommand = exports.de_UpdateDataSourceCommand = exports.de_UpdateAccessControlConfigurationCommand = exports.de_UntagResourceCommand = exports.de_TagResourceCommand = exports.de_SubmitFeedbackCommand = exports.de_StopDataSourceSyncJobCommand = exports.de_StartDataSourceSyncJobCommand = exports.de_QueryCommand = exports.de_PutPrincipalMappingCommand = exports.de_ListThesauriCommand = exports.de_ListTagsForResourceCommand = exports.de_ListQuerySuggestionsBlockListsCommand = exports.de_ListIndicesCommand = exports.de_ListGroupsOlderThanOrderingIdCommand = exports.de_ListFeaturedResultsSetsCommand = exports.de_ListFaqsCommand = exports.de_ListExperiencesCommand = exports.de_ListExperienceEntitiesCommand = exports.de_ListEntityPersonasCommand = exports.de_ListDataSourceSyncJobsCommand = exports.de_ListDataSourcesCommand = exports.de_ListAccessControlConfigurationsCommand = exports.de_GetSnapshotsCommand = exports.de_GetQuerySuggestionsCommand = void 0;
+exports.de_DisassociateEntitiesFromExperienceCommand = exports.de_DescribeThesaurusCommand = exports.de_DescribeQuerySuggestionsConfigCommand = exports.de_DescribeQuerySuggestionsBlockListCommand = exports.de_DescribePrincipalMappingCommand = exports.de_DescribeIndexCommand = exports.de_DescribeFeaturedResultsSetCommand = exports.de_DescribeFaqCommand = exports.de_DescribeExperienceCommand = exports.de_DescribeDataSourceCommand = exports.de_DescribeAccessControlConfigurationCommand = exports.de_DeleteThesaurusCommand = exports.de_DeleteQuerySuggestionsBlockListCommand = exports.de_DeletePrincipalMappingCommand = exports.de_DeleteIndexCommand = exports.de_DeleteFaqCommand = exports.de_DeleteExperienceCommand = exports.de_DeleteDataSourceCommand = exports.de_DeleteAccessControlConfigurationCommand = exports.de_CreateThesaurusCommand = exports.de_CreateQuerySuggestionsBlockListCommand = exports.de_CreateIndexCommand = exports.de_CreateFeaturedResultsSetCommand = exports.de_CreateFaqCommand = exports.de_CreateExperienceCommand = exports.de_CreateDataSourceCommand = exports.de_CreateAccessControlConfigurationCommand = exports.de_ClearQuerySuggestionsCommand = exports.de_BatchPutDocumentCommand = exports.de_BatchGetDocumentStatusCommand = exports.de_BatchDeleteFeaturedResultsSetCommand = exports.de_BatchDeleteDocumentCommand = exports.de_AssociatePersonasToEntitiesCommand = exports.de_AssociateEntitiesToExperienceCommand = exports.se_UpdateThesaurusCommand = exports.se_UpdateQuerySuggestionsConfigCommand = exports.se_UpdateQuerySuggestionsBlockListCommand = exports.se_UpdateIndexCommand = exports.se_UpdateFeaturedResultsSetCommand = exports.se_UpdateExperienceCommand = exports.se_UpdateDataSourceCommand = exports.se_UpdateAccessControlConfigurationCommand = exports.se_UntagResourceCommand = exports.se_TagResourceCommand = exports.se_SubmitFeedbackCommand = exports.se_StopDataSourceSyncJobCommand = exports.se_StartDataSourceSyncJobCommand = exports.se_RetrieveCommand = exports.se_QueryCommand = exports.se_PutPrincipalMappingCommand = void 0;
+exports.de_UpdateThesaurusCommand = exports.de_UpdateQuerySuggestionsConfigCommand = exports.de_UpdateQuerySuggestionsBlockListCommand = exports.de_UpdateIndexCommand = exports.de_UpdateFeaturedResultsSetCommand = exports.de_UpdateExperienceCommand = exports.de_UpdateDataSourceCommand = exports.de_UpdateAccessControlConfigurationCommand = exports.de_UntagResourceCommand = exports.de_TagResourceCommand = exports.de_SubmitFeedbackCommand = exports.de_StopDataSourceSyncJobCommand = exports.de_StartDataSourceSyncJobCommand = exports.de_RetrieveCommand = exports.de_QueryCommand = exports.de_PutPrincipalMappingCommand = exports.de_ListThesauriCommand = exports.de_ListTagsForResourceCommand = exports.de_ListQuerySuggestionsBlockListsCommand = exports.de_ListIndicesCommand = exports.de_ListGroupsOlderThanOrderingIdCommand = exports.de_ListFeaturedResultsSetsCommand = exports.de_ListFaqsCommand = exports.de_ListExperiencesCommand = exports.de_ListExperienceEntitiesCommand = exports.de_ListEntityPersonasCommand = exports.de_ListDataSourceSyncJobsCommand = exports.de_ListDataSourcesCommand = exports.de_ListAccessControlConfigurationsCommand = exports.de_GetSnapshotsCommand = exports.de_GetQuerySuggestionsCommand = exports.de_DisassociatePersonasFromEntitiesCommand = void 0;
 const smithy_client_1 = require("@aws-sdk/smithy-client");
 const protocol_http_1 = require("@smithy/protocol-http");
 const uuid_1 = require("uuid");
@@ -373,6 +373,13 @@ const se_QueryCommand = async (input, context) => {
     return buildHttpRpcRequest(context, headers, "/", undefined, body);
 };
 exports.se_QueryCommand = se_QueryCommand;
+const se_RetrieveCommand = async (input, context) => {
+    const headers = sharedHeaders("Retrieve");
+    let body;
+    body = JSON.stringify(se_RetrieveRequest(input, context));
+    return buildHttpRpcRequest(context, headers, "/", undefined, body);
+};
+exports.se_RetrieveCommand = se_RetrieveCommand;
 const se_StartDataSourceSyncJobCommand = async (input, context) => {
     const headers = sharedHeaders("StartDataSourceSyncJob");
     let body;
@@ -2894,6 +2901,57 @@ const de_QueryCommandError = async (output, context) => {
             });
     }
 };
+const de_RetrieveCommand = async (output, context) => {
+    if (output.statusCode >= 300) {
+        return de_RetrieveCommandError(output, context);
+    }
+    const data = await parseBody(output.body, context);
+    let contents = {};
+    contents = de_RetrieveResult(data, context);
+    const response = {
+        $metadata: deserializeMetadata(output),
+        ...contents,
+    };
+    return response;
+};
+exports.de_RetrieveCommand = de_RetrieveCommand;
+const de_RetrieveCommandError = async (output, context) => {
+    const parsedOutput = {
+        ...output,
+        body: await parseErrorBody(output.body, context),
+    };
+    const errorCode = loadRestJsonErrorCode(output, parsedOutput.body);
+    switch (errorCode) {
+        case "AccessDeniedException":
+        case "com.amazonaws.kendra#AccessDeniedException":
+            throw await de_AccessDeniedExceptionRes(parsedOutput, context);
+        case "ConflictException":
+        case "com.amazonaws.kendra#ConflictException":
+            throw await de_ConflictExceptionRes(parsedOutput, context);
+        case "InternalServerException":
+        case "com.amazonaws.kendra#InternalServerException":
+            throw await de_InternalServerExceptionRes(parsedOutput, context);
+        case "ResourceNotFoundException":
+        case "com.amazonaws.kendra#ResourceNotFoundException":
+            throw await de_ResourceNotFoundExceptionRes(parsedOutput, context);
+        case "ServiceQuotaExceededException":
+        case "com.amazonaws.kendra#ServiceQuotaExceededException":
+            throw await de_ServiceQuotaExceededExceptionRes(parsedOutput, context);
+        case "ThrottlingException":
+        case "com.amazonaws.kendra#ThrottlingException":
+            throw await de_ThrottlingExceptionRes(parsedOutput, context);
+        case "ValidationException":
+        case "com.amazonaws.kendra#ValidationException":
+            throw await de_ValidationExceptionRes(parsedOutput, context);
+        default:
+            const parsedBody = parsedOutput.body;
+            return throwDefaultError({
+                output,
+                parsedBody,
+                errorCode,
+            });
+    }
+};
 const de_StartDataSourceSyncJobCommand = async (output, context) => {
     if (output.statusCode >= 300) {
         return de_StartDataSourceSyncJobCommandError(output, context);
@@ -3912,6 +3970,18 @@ const se_QueryRequest = (input, context) => {
         VisitorId: [],
     });
 };
+const se_RetrieveRequest = (input, context) => {
+    return (0, smithy_client_1.take)(input, {
+        AttributeFilter: (_) => se_AttributeFilter(_, context),
+        DocumentRelevanceOverrideConfigurations: smithy_client_1._json,
+        IndexId: [],
+        PageNumber: [],
+        PageSize: [],
+        QueryText: [],
+        RequestedDocumentAttributes: smithy_client_1._json,
+        UserContext: smithy_client_1._json,
+    });
+};
 const se_SubmitFeedbackRequest = (input, context) => {
     return (0, smithy_client_1.take)(input, {
         ClickFeedbackItems: (_) => se_ClickFeedbackList(_, context),
@@ -4466,6 +4536,30 @@ const de_QuerySuggestionsBlockListSummaryItems = (output, context) => {
     });
     return retVal;
 };
+const de_RetrieveResult = (output, context) => {
+    return (0, smithy_client_1.take)(output, {
+        QueryId: smithy_client_1.expectString,
+        ResultItems: (_) => de_RetrieveResultItemList(_, context),
+    });
+};
+const de_RetrieveResultItem = (output, context) => {
+    return (0, smithy_client_1.take)(output, {
+        Content: smithy_client_1.expectString,
+        DocumentAttributes: (_) => de_DocumentAttributeList(_, context),
+        DocumentId: smithy_client_1.expectString,
+        DocumentTitle: smithy_client_1.expectString,
+        DocumentURI: smithy_client_1.expectString,
+        Id: smithy_client_1.expectString,
+    });
+};
+const de_RetrieveResultItemList = (output, context) => {
+    const retVal = (output || [])
+        .filter((e) => e != null)
+        .map((entry) => {
+        return de_RetrieveResultItem(entry, context);
+    });
+    return retVal;
+};
 const de_SourceDocument = (output, context) => {
     return (0, smithy_client_1.take)(output, {
         AdditionalAttributes: (_) => de_DocumentAttributeList(_, context),

package/dist-es/Kendra.js

@@ -51,6 +51,7 @@ import { ListTagsForResourceCommand, } from "./commands/ListTagsForResourceComma
 import { ListThesauriCommand, } from "./commands/ListThesauriCommand";
 import { PutPrincipalMappingCommand, } from "./commands/PutPrincipalMappingCommand";
 import { QueryCommand } from "./commands/QueryCommand";
+import { RetrieveCommand } from "./commands/RetrieveCommand";
 import { StartDataSourceSyncJobCommand, } from "./commands/StartDataSourceSyncJobCommand";
 import { StopDataSourceSyncJobCommand, } from "./commands/StopDataSourceSyncJobCommand";
 import { SubmitFeedbackCommand, } from "./commands/SubmitFeedbackCommand";
@@ -118,6 +119,7 @@ const commands = {
     ListThesauriCommand,
     PutPrincipalMappingCommand,
     QueryCommand,
+    RetrieveCommand,
     StartDataSourceSyncJobCommand,
     StopDataSourceSyncJobCommand,
     SubmitFeedbackCommand,

package/dist-es/commands/RetrieveCommand.js

@@ -0,0 +1,42 @@
+import { getEndpointPlugin } from "@aws-sdk/middleware-endpoint";
+import { getSerdePlugin } from "@aws-sdk/middleware-serde";
+import { Command as $Command } from "@aws-sdk/smithy-client";
+import { de_RetrieveCommand, se_RetrieveCommand } from "../protocols/Aws_json1_1";
+export { $Command };
+export class RetrieveCommand extends $Command {
+    static getEndpointParameterInstructions() {
+        return {
+            UseFIPS: { type: "builtInParams", name: "useFipsEndpoint" },
+            Endpoint: { type: "builtInParams", name: "endpoint" },
+            Region: { type: "builtInParams", name: "region" },
+            UseDualStack: { type: "builtInParams", name: "useDualstackEndpoint" },
+        };
+    }
+    constructor(input) {
+        super();
+        this.input = input;
+    }
+    resolveMiddleware(clientStack, configuration, options) {
+        this.middlewareStack.use(getSerdePlugin(configuration, this.serialize, this.deserialize));
+        this.middlewareStack.use(getEndpointPlugin(configuration, RetrieveCommand.getEndpointParameterInstructions()));
+        const stack = clientStack.concat(this.middlewareStack);
+        const { logger } = configuration;
+        const clientName = "KendraClient";
+        const commandName = "RetrieveCommand";
+        const handlerExecutionContext = {
+            logger,
+            clientName,
+            commandName,
+            inputFilterSensitiveLog: (_) => _,
+            outputFilterSensitiveLog: (_) => _,
+        };
+        const { requestHandler } = configuration;
+        return stack.resolve((request) => requestHandler.handle(request.request, options || {}), handlerExecutionContext);
+    }
+    serialize(input, context) {
+        return se_RetrieveCommand(input, context);
+    }
+    deserialize(output, context) {
+        return de_RetrieveCommand(output, context);
+    }
+}

package/dist-es/commands/index.js

@@ -50,6 +50,7 @@ export * from "./ListTagsForResourceCommand";
 export * from "./ListThesauriCommand";
 export * from "./PutPrincipalMappingCommand";
 export * from "./QueryCommand";
+export * from "./RetrieveCommand";
 export * from "./StartDataSourceSyncJobCommand";
 export * from "./StopDataSourceSyncJobCommand";
 export * from "./SubmitFeedbackCommand";

package/dist-es/protocols/Aws_json1_1.js

@@ -316,6 +316,12 @@ export const se_QueryCommand = async (input, context) => {
     body = JSON.stringify(se_QueryRequest(input, context));
     return buildHttpRpcRequest(context, headers, "/", undefined, body);
 };
+export const se_RetrieveCommand = async (input, context) => {
+    const headers = sharedHeaders("Retrieve");
+    let body;
+    body = JSON.stringify(se_RetrieveRequest(input, context));
+    return buildHttpRpcRequest(context, headers, "/", undefined, body);
+};
 export const se_StartDataSourceSyncJobCommand = async (input, context) => {
     const headers = sharedHeaders("StartDataSourceSyncJob");
     let body;
@@ -2772,6 +2778,56 @@ const de_QueryCommandError = async (output, context) => {
             });
     }
 };
+export const de_RetrieveCommand = async (output, context) => {
+    if (output.statusCode >= 300) {
+        return de_RetrieveCommandError(output, context);
+    }
+    const data = await parseBody(output.body, context);
+    let contents = {};
+    contents = de_RetrieveResult(data, context);
+    const response = {
+        $metadata: deserializeMetadata(output),
+        ...contents,
+    };
+    return response;
+};
+const de_RetrieveCommandError = async (output, context) => {
+    const parsedOutput = {
+        ...output,
+        body: await parseErrorBody(output.body, context),
+    };
+    const errorCode = loadRestJsonErrorCode(output, parsedOutput.body);
+    switch (errorCode) {
+        case "AccessDeniedException":
+        case "com.amazonaws.kendra#AccessDeniedException":
+            throw await de_AccessDeniedExceptionRes(parsedOutput, context);
+        case "ConflictException":
+        case "com.amazonaws.kendra#ConflictException":
+            throw await de_ConflictExceptionRes(parsedOutput, context);
+        case "InternalServerException":
+        case "com.amazonaws.kendra#InternalServerException":
+            throw await de_InternalServerExceptionRes(parsedOutput, context);
+        case "ResourceNotFoundException":
+        case "com.amazonaws.kendra#ResourceNotFoundException":
+            throw await de_ResourceNotFoundExceptionRes(parsedOutput, context);
+        case "ServiceQuotaExceededException":
+        case "com.amazonaws.kendra#ServiceQuotaExceededException":
+            throw await de_ServiceQuotaExceededExceptionRes(parsedOutput, context);
+        case "ThrottlingException":
+        case "com.amazonaws.kendra#ThrottlingException":
+            throw await de_ThrottlingExceptionRes(parsedOutput, context);
+        case "ValidationException":
+        case "com.amazonaws.kendra#ValidationException":
+            throw await de_ValidationExceptionRes(parsedOutput, context);
+        default:
+            const parsedBody = parsedOutput.body;
+            return throwDefaultError({
+                output,
+                parsedBody,
+                errorCode,
+            });
+    }
+};
 export const de_StartDataSourceSyncJobCommand = async (output, context) => {
     if (output.statusCode >= 300) {
         return de_StartDataSourceSyncJobCommandError(output, context);
@@ -3777,6 +3833,18 @@ const se_QueryRequest = (input, context) => {
         VisitorId: [],
     });
 };
+const se_RetrieveRequest = (input, context) => {
+    return take(input, {
+        AttributeFilter: (_) => se_AttributeFilter(_, context),
+        DocumentRelevanceOverrideConfigurations: _json,
+        IndexId: [],
+        PageNumber: [],
+        PageSize: [],
+        QueryText: [],
+        RequestedDocumentAttributes: _json,
+        UserContext: _json,
+    });
+};
 const se_SubmitFeedbackRequest = (input, context) => {
     return take(input, {
         ClickFeedbackItems: (_) => se_ClickFeedbackList(_, context),
@@ -4331,6 +4399,30 @@ const de_QuerySuggestionsBlockListSummaryItems = (output, context) => {
     });
     return retVal;
 };
+const de_RetrieveResult = (output, context) => {
+    return take(output, {
+        QueryId: __expectString,
+        ResultItems: (_) => de_RetrieveResultItemList(_, context),
+    });
+};
+const de_RetrieveResultItem = (output, context) => {
+    return take(output, {
+        Content: __expectString,
+        DocumentAttributes: (_) => de_DocumentAttributeList(_, context),
+        DocumentId: __expectString,
+        DocumentTitle: __expectString,
+        DocumentURI: __expectString,
+        Id: __expectString,
+    });
+};
+const de_RetrieveResultItemList = (output, context) => {
+    const retVal = (output || [])
+        .filter((e) => e != null)
+        .map((entry) => {
+        return de_RetrieveResultItem(entry, context);
+    });
+    return retVal;
+};
 const de_SourceDocument = (output, context) => {
     return take(output, {
         AdditionalAttributes: (_) => de_DocumentAttributeList(_, context),

package/dist-types/Kendra.d.ts

@@ -51,6 +51,7 @@ import { ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput } fro
 import { ListThesauriCommandInput, ListThesauriCommandOutput } from "./commands/ListThesauriCommand";
 import { PutPrincipalMappingCommandInput, PutPrincipalMappingCommandOutput } from "./commands/PutPrincipalMappingCommand";
 import { QueryCommandInput, QueryCommandOutput } from "./commands/QueryCommand";
+import { RetrieveCommandInput, RetrieveCommandOutput } from "./commands/RetrieveCommand";
 import { StartDataSourceSyncJobCommandInput, StartDataSourceSyncJobCommandOutput } from "./commands/StartDataSourceSyncJobCommand";
 import { StopDataSourceSyncJobCommandInput, StopDataSourceSyncJobCommandOutput } from "./commands/StopDataSourceSyncJobCommand";
 import { SubmitFeedbackCommandInput, SubmitFeedbackCommandOutput } from "./commands/SubmitFeedbackCommand";
@@ -378,6 +379,12 @@ export interface Kendra {
     query(args: QueryCommandInput, options?: __HttpHandlerOptions): Promise<QueryCommandOutput>;
     query(args: QueryCommandInput, cb: (err: any, data?: QueryCommandOutput) => void): void;
     query(args: QueryCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: QueryCommandOutput) => void): void;
+    /**
+     * @see {@link RetrieveCommand}
+     */
+    retrieve(args: RetrieveCommandInput, options?: __HttpHandlerOptions): Promise<RetrieveCommandOutput>;
+    retrieve(args: RetrieveCommandInput, cb: (err: any, data?: RetrieveCommandOutput) => void): void;
+    retrieve(args: RetrieveCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: RetrieveCommandOutput) => void): void;
     /**
      * @see {@link StartDataSourceSyncJobCommand}
      */

package/dist-types/KendraClient.d.ts

@@ -60,6 +60,7 @@ import { ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput } fro
 import { ListThesauriCommandInput, ListThesauriCommandOutput } from "./commands/ListThesauriCommand";
 import { PutPrincipalMappingCommandInput, PutPrincipalMappingCommandOutput } from "./commands/PutPrincipalMappingCommand";
 import { QueryCommandInput, QueryCommandOutput } from "./commands/QueryCommand";
+import { RetrieveCommandInput, RetrieveCommandOutput } from "./commands/RetrieveCommand";
 import { StartDataSourceSyncJobCommandInput, StartDataSourceSyncJobCommandOutput } from "./commands/StartDataSourceSyncJobCommand";
 import { StopDataSourceSyncJobCommandInput, StopDataSourceSyncJobCommandOutput } from "./commands/StopDataSourceSyncJobCommand";
 import { SubmitFeedbackCommandInput, SubmitFeedbackCommandOutput } from "./commands/SubmitFeedbackCommand";
@@ -78,11 +79,11 @@ export { __Client };
 /**
  * @public
  */
-export type ServiceInputTypes = AssociateEntitiesToExperienceCommandInput | AssociatePersonasToEntitiesCommandInput | BatchDeleteDocumentCommandInput | BatchDeleteFeaturedResultsSetCommandInput | BatchGetDocumentStatusCommandInput | BatchPutDocumentCommandInput | ClearQuerySuggestionsCommandInput | CreateAccessControlConfigurationCommandInput | CreateDataSourceCommandInput | CreateExperienceCommandInput | CreateFaqCommandInput | CreateFeaturedResultsSetCommandInput | CreateIndexCommandInput | CreateQuerySuggestionsBlockListCommandInput | CreateThesaurusCommandInput | DeleteAccessControlConfigurationCommandInput | DeleteDataSourceCommandInput | DeleteExperienceCommandInput | DeleteFaqCommandInput | DeleteIndexCommandInput | DeletePrincipalMappingCommandInput | DeleteQuerySuggestionsBlockListCommandInput | DeleteThesaurusCommandInput | DescribeAccessControlConfigurationCommandInput | DescribeDataSourceCommandInput | DescribeExperienceCommandInput | DescribeFaqCommandInput | DescribeFeaturedResultsSetCommandInput | DescribeIndexCommandInput | DescribePrincipalMappingCommandInput | DescribeQuerySuggestionsBlockListCommandInput | DescribeQuerySuggestionsConfigCommandInput | DescribeThesaurusCommandInput | DisassociateEntitiesFromExperienceCommandInput | DisassociatePersonasFromEntitiesCommandInput | GetQuerySuggestionsCommandInput | GetSnapshotsCommandInput | ListAccessControlConfigurationsCommandInput | ListDataSourceSyncJobsCommandInput | ListDataSourcesCommandInput | ListEntityPersonasCommandInput | ListExperienceEntitiesCommandInput | ListExperiencesCommandInput | ListFaqsCommandInput | ListFeaturedResultsSetsCommandInput | ListGroupsOlderThanOrderingIdCommandInput | ListIndicesCommandInput | ListQuerySuggestionsBlockListsCommandInput | ListTagsForResourceCommandInput | ListThesauriCommandInput | PutPrincipalMappingCommandInput | QueryCommandInput | StartDataSourceSyncJobCommandInput | StopDataSourceSyncJobCommandInput | SubmitFeedbackCommandInput | TagResourceCommandInput | UntagResourceCommandInput | UpdateAccessControlConfigurationCommandInput | UpdateDataSourceCommandInput | UpdateExperienceCommandInput | UpdateFeaturedResultsSetCommandInput | UpdateIndexCommandInput | UpdateQuerySuggestionsBlockListCommandInput | UpdateQuerySuggestionsConfigCommandInput | UpdateThesaurusCommandInput;
+export type ServiceInputTypes = AssociateEntitiesToExperienceCommandInput | AssociatePersonasToEntitiesCommandInput | BatchDeleteDocumentCommandInput | BatchDeleteFeaturedResultsSetCommandInput | BatchGetDocumentStatusCommandInput | BatchPutDocumentCommandInput | ClearQuerySuggestionsCommandInput | CreateAccessControlConfigurationCommandInput | CreateDataSourceCommandInput | CreateExperienceCommandInput | CreateFaqCommandInput | CreateFeaturedResultsSetCommandInput | CreateIndexCommandInput | CreateQuerySuggestionsBlockListCommandInput | CreateThesaurusCommandInput | DeleteAccessControlConfigurationCommandInput | DeleteDataSourceCommandInput | DeleteExperienceCommandInput | DeleteFaqCommandInput | DeleteIndexCommandInput | DeletePrincipalMappingCommandInput | DeleteQuerySuggestionsBlockListCommandInput | DeleteThesaurusCommandInput | DescribeAccessControlConfigurationCommandInput | DescribeDataSourceCommandInput | DescribeExperienceCommandInput | DescribeFaqCommandInput | DescribeFeaturedResultsSetCommandInput | DescribeIndexCommandInput | DescribePrincipalMappingCommandInput | DescribeQuerySuggestionsBlockListCommandInput | DescribeQuerySuggestionsConfigCommandInput | DescribeThesaurusCommandInput | DisassociateEntitiesFromExperienceCommandInput | DisassociatePersonasFromEntitiesCommandInput | GetQuerySuggestionsCommandInput | GetSnapshotsCommandInput | ListAccessControlConfigurationsCommandInput | ListDataSourceSyncJobsCommandInput | ListDataSourcesCommandInput | ListEntityPersonasCommandInput | ListExperienceEntitiesCommandInput | ListExperiencesCommandInput | ListFaqsCommandInput | ListFeaturedResultsSetsCommandInput | ListGroupsOlderThanOrderingIdCommandInput | ListIndicesCommandInput | ListQuerySuggestionsBlockListsCommandInput | ListTagsForResourceCommandInput | ListThesauriCommandInput | PutPrincipalMappingCommandInput | QueryCommandInput | RetrieveCommandInput | StartDataSourceSyncJobCommandInput | StopDataSourceSyncJobCommandInput | SubmitFeedbackCommandInput | TagResourceCommandInput | UntagResourceCommandInput | UpdateAccessControlConfigurationCommandInput | UpdateDataSourceCommandInput | UpdateExperienceCommandInput | UpdateFeaturedResultsSetCommandInput | UpdateIndexCommandInput | UpdateQuerySuggestionsBlockListCommandInput | UpdateQuerySuggestionsConfigCommandInput | UpdateThesaurusCommandInput;
 /**
  * @public
  */
-export type ServiceOutputTypes = AssociateEntitiesToExperienceCommandOutput | AssociatePersonasToEntitiesCommandOutput | BatchDeleteDocumentCommandOutput | BatchDeleteFeaturedResultsSetCommandOutput | BatchGetDocumentStatusCommandOutput | BatchPutDocumentCommandOutput | ClearQuerySuggestionsCommandOutput | CreateAccessControlConfigurationCommandOutput | CreateDataSourceCommandOutput | CreateExperienceCommandOutput | CreateFaqCommandOutput | CreateFeaturedResultsSetCommandOutput | CreateIndexCommandOutput | CreateQuerySuggestionsBlockListCommandOutput | CreateThesaurusCommandOutput | DeleteAccessControlConfigurationCommandOutput | DeleteDataSourceCommandOutput | DeleteExperienceCommandOutput | DeleteFaqCommandOutput | DeleteIndexCommandOutput | DeletePrincipalMappingCommandOutput | DeleteQuerySuggestionsBlockListCommandOutput | DeleteThesaurusCommandOutput | DescribeAccessControlConfigurationCommandOutput | DescribeDataSourceCommandOutput | DescribeExperienceCommandOutput | DescribeFaqCommandOutput | DescribeFeaturedResultsSetCommandOutput | DescribeIndexCommandOutput | DescribePrincipalMappingCommandOutput | DescribeQuerySuggestionsBlockListCommandOutput | DescribeQuerySuggestionsConfigCommandOutput | DescribeThesaurusCommandOutput | DisassociateEntitiesFromExperienceCommandOutput | DisassociatePersonasFromEntitiesCommandOutput | GetQuerySuggestionsCommandOutput | GetSnapshotsCommandOutput | ListAccessControlConfigurationsCommandOutput | ListDataSourceSyncJobsCommandOutput | ListDataSourcesCommandOutput | ListEntityPersonasCommandOutput | ListExperienceEntitiesCommandOutput | ListExperiencesCommandOutput | ListFaqsCommandOutput | ListFeaturedResultsSetsCommandOutput | ListGroupsOlderThanOrderingIdCommandOutput | ListIndicesCommandOutput | ListQuerySuggestionsBlockListsCommandOutput | ListTagsForResourceCommandOutput | ListThesauriCommandOutput | PutPrincipalMappingCommandOutput | QueryCommandOutput | StartDataSourceSyncJobCommandOutput | StopDataSourceSyncJobCommandOutput | SubmitFeedbackCommandOutput | TagResourceCommandOutput | UntagResourceCommandOutput | UpdateAccessControlConfigurationCommandOutput | UpdateDataSourceCommandOutput | UpdateExperienceCommandOutput | UpdateFeaturedResultsSetCommandOutput | UpdateIndexCommandOutput | UpdateQuerySuggestionsBlockListCommandOutput | UpdateQuerySuggestionsConfigCommandOutput | UpdateThesaurusCommandOutput;
+export type ServiceOutputTypes = AssociateEntitiesToExperienceCommandOutput | AssociatePersonasToEntitiesCommandOutput | BatchDeleteDocumentCommandOutput | BatchDeleteFeaturedResultsSetCommandOutput | BatchGetDocumentStatusCommandOutput | BatchPutDocumentCommandOutput | ClearQuerySuggestionsCommandOutput | CreateAccessControlConfigurationCommandOutput | CreateDataSourceCommandOutput | CreateExperienceCommandOutput | CreateFaqCommandOutput | CreateFeaturedResultsSetCommandOutput | CreateIndexCommandOutput | CreateQuerySuggestionsBlockListCommandOutput | CreateThesaurusCommandOutput | DeleteAccessControlConfigurationCommandOutput | DeleteDataSourceCommandOutput | DeleteExperienceCommandOutput | DeleteFaqCommandOutput | DeleteIndexCommandOutput | DeletePrincipalMappingCommandOutput | DeleteQuerySuggestionsBlockListCommandOutput | DeleteThesaurusCommandOutput | DescribeAccessControlConfigurationCommandOutput | DescribeDataSourceCommandOutput | DescribeExperienceCommandOutput | DescribeFaqCommandOutput | DescribeFeaturedResultsSetCommandOutput | DescribeIndexCommandOutput | DescribePrincipalMappingCommandOutput | DescribeQuerySuggestionsBlockListCommandOutput | DescribeQuerySuggestionsConfigCommandOutput | DescribeThesaurusCommandOutput | DisassociateEntitiesFromExperienceCommandOutput | DisassociatePersonasFromEntitiesCommandOutput | GetQuerySuggestionsCommandOutput | GetSnapshotsCommandOutput | ListAccessControlConfigurationsCommandOutput | ListDataSourceSyncJobsCommandOutput | ListDataSourcesCommandOutput | ListEntityPersonasCommandOutput | ListExperienceEntitiesCommandOutput | ListExperiencesCommandOutput | ListFaqsCommandOutput | ListFeaturedResultsSetsCommandOutput | ListGroupsOlderThanOrderingIdCommandOutput | ListIndicesCommandOutput | ListQuerySuggestionsBlockListsCommandOutput | ListTagsForResourceCommandOutput | ListThesauriCommandOutput | PutPrincipalMappingCommandOutput | QueryCommandOutput | RetrieveCommandOutput | StartDataSourceSyncJobCommandOutput | StopDataSourceSyncJobCommandOutput | SubmitFeedbackCommandOutput | TagResourceCommandOutput | UntagResourceCommandOutput | UpdateAccessControlConfigurationCommandOutput | UpdateDataSourceCommandOutput | UpdateExperienceCommandOutput | UpdateFeaturedResultsSetCommandOutput | UpdateIndexCommandOutput | UpdateQuerySuggestionsBlockListCommandOutput | UpdateQuerySuggestionsConfigCommandOutput | UpdateThesaurusCommandOutput;
 /**
  * @public
  */

package/dist-types/commands/QueryCommand.d.ts

@@ -23,27 +23,30 @@ export interface QueryCommandOutput extends QueryResult, __MetadataBearer {
 }
 /**
  * @public
- * <p>Searches an active index. Use this API to search your documents using query. The
- *             <code>Query</code> API enables to do faceted search and to filter results based on
- *          document attributes.</p>
- *          <p>It also enables you to provide user context that Amazon Kendra uses to enforce
- *          document access control in the search results.</p>
- *          <p>Amazon Kendra searches your index for text content and question and answer (FAQ)
- *          content. By default the response contains three types of results.</p>
+ * <p>Searches an index given an input query.</p>
+ *          <p>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.</p>
+ *          <p>A query response contains three types of results.</p>
  *          <ul>
  *             <li>
- *                <p>Relevant passages</p>
+ *                <p>Relevant suggested answers. The answers can be either a text excerpt or table
+ *                excerpt. The answer can be highlighted in the excerpt.</p>
  *             </li>
  *             <li>
- *                <p>Matching FAQs</p>
+ *                <p>Matching FAQs or questions-answer from your FAQ file.</p>
  *             </li>
  *             <li>
- *                <p>Relevant documents</p>
+ *                <p>Relevant documents. This result type includes an excerpt of the document with
+ *                the document title. The searched terms can be highlighted in the excerpt.</p>
  *             </li>
  *          </ul>
  *          <p>You can specify that the query return only one type of result using the
- *             <code>QueryResultTypeFilter</code> parameter.</p>
- *          <p>Each query returns the 100 most relevant results. </p>
+ *          <code>QueryResultTypeFilter</code> 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.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript