@aws-sdk/client-securityhub 3.326.0 → 3.327.0

package/README.md

@@ -546,6 +546,14 @@ GetFindingAggregator
 
 [Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-securityhub/classes/getfindingaggregatorcommand.html) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-securityhub/interfaces/getfindingaggregatorcommandinput.html) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-securityhub/interfaces/getfindingaggregatorcommandoutput.html)
 
+</details>
+<details>
+<summary>
+GetFindingHistory
+</summary>
+
+[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-securityhub/classes/getfindinghistorycommand.html) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-securityhub/interfaces/getfindinghistorycommandinput.html) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-securityhub/interfaces/getfindinghistorycommandoutput.html)
+
 </details>
 <details>
 <summary>

package/dist-cjs/SecurityHub.js

@@ -39,6 +39,7 @@ const EnableSecurityHubCommand_1 = require("./commands/EnableSecurityHubCommand"
 const GetAdministratorAccountCommand_1 = require("./commands/GetAdministratorAccountCommand");
 const GetEnabledStandardsCommand_1 = require("./commands/GetEnabledStandardsCommand");
 const GetFindingAggregatorCommand_1 = require("./commands/GetFindingAggregatorCommand");
+const GetFindingHistoryCommand_1 = require("./commands/GetFindingHistoryCommand");
 const GetFindingsCommand_1 = require("./commands/GetFindingsCommand");
 const GetInsightResultsCommand_1 = require("./commands/GetInsightResultsCommand");
 const GetInsightsCommand_1 = require("./commands/GetInsightsCommand");
@@ -102,6 +103,7 @@ const commands = {
     GetAdministratorAccountCommand: GetAdministratorAccountCommand_1.GetAdministratorAccountCommand,
     GetEnabledStandardsCommand: GetEnabledStandardsCommand_1.GetEnabledStandardsCommand,
     GetFindingAggregatorCommand: GetFindingAggregatorCommand_1.GetFindingAggregatorCommand,
+    GetFindingHistoryCommand: GetFindingHistoryCommand_1.GetFindingHistoryCommand,
     GetFindingsCommand: GetFindingsCommand_1.GetFindingsCommand,
     GetInsightResultsCommand: GetInsightResultsCommand_1.GetInsightResultsCommand,
     GetInsightsCommand: GetInsightsCommand_1.GetInsightsCommand,

package/dist-cjs/commands/GetFindingHistoryCommand.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetFindingHistoryCommand = 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");
+const Aws_restJson1_1 = require("../protocols/Aws_restJson1");
+class GetFindingHistoryCommand 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, GetFindingHistoryCommand.getEndpointParameterInstructions()));
+        const stack = clientStack.concat(this.middlewareStack);
+        const { logger } = configuration;
+        const clientName = "SecurityHubClient";
+        const commandName = "GetFindingHistoryCommand";
+        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_restJson1_1.se_GetFindingHistoryCommand)(input, context);
+    }
+    deserialize(output, context) {
+        return (0, Aws_restJson1_1.de_GetFindingHistoryCommand)(output, context);
+    }
+}
+exports.GetFindingHistoryCommand = GetFindingHistoryCommand;

package/dist-cjs/commands/index.js

@@ -38,6 +38,7 @@ tslib_1.__exportStar(require("./EnableSecurityHubCommand"), exports);
 tslib_1.__exportStar(require("./GetAdministratorAccountCommand"), exports);
 tslib_1.__exportStar(require("./GetEnabledStandardsCommand"), exports);
 tslib_1.__exportStar(require("./GetFindingAggregatorCommand"), exports);
+tslib_1.__exportStar(require("./GetFindingHistoryCommand"), exports);
 tslib_1.__exportStar(require("./GetFindingsCommand"), exports);
 tslib_1.__exportStar(require("./GetInsightResultsCommand"), exports);
 tslib_1.__exportStar(require("./GetInsightsCommand"), exports);

package/dist-cjs/models/models_2.js

@@ -1,11 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RegionAvailabilityStatus = exports.SortOrder = exports.IntegrationType = void 0;
+exports.RegionAvailabilityStatus = exports.SortOrder = exports.FindingHistoryUpdateSourceType = exports.IntegrationType = void 0;
 exports.IntegrationType = {
     RECEIVE_FINDINGS_FROM_SECURITY_HUB: "RECEIVE_FINDINGS_FROM_SECURITY_HUB",
     SEND_FINDINGS_TO_SECURITY_HUB: "SEND_FINDINGS_TO_SECURITY_HUB",
     UPDATE_FINDINGS_IN_SECURITY_HUB: "UPDATE_FINDINGS_IN_SECURITY_HUB",
 };
+exports.FindingHistoryUpdateSourceType = {
+    BATCH_IMPORT_FINDINGS: "BATCH_IMPORT_FINDINGS",
+    BATCH_UPDATE_FINDINGS: "BATCH_UPDATE_FINDINGS",
+};
 exports.SortOrder = {
     ASCENDING: "asc",
     DESCENDING: "desc",

package/dist-cjs/pagination/GetFindingHistoryPaginator.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.paginateGetFindingHistory = void 0;
+const GetFindingHistoryCommand_1 = require("../commands/GetFindingHistoryCommand");
+const SecurityHubClient_1 = require("../SecurityHubClient");
+const makePagedClientRequest = async (client, input, ...args) => {
+    return await client.send(new GetFindingHistoryCommand_1.GetFindingHistoryCommand(input), ...args);
+};
+async function* paginateGetFindingHistory(config, input, ...additionalArguments) {
+    let token = config.startingToken || undefined;
+    let hasNext = true;
+    let page;
+    while (hasNext) {
+        input.NextToken = token;
+        input["MaxResults"] = config.pageSize;
+        if (config.client instanceof SecurityHubClient_1.SecurityHubClient) {
+            page = await makePagedClientRequest(config.client, input, ...additionalArguments);
+        }
+        else {
+            throw new Error("Invalid client, expected SecurityHub | SecurityHubClient");
+        }
+        yield page;
+        const prevToken = token;
+        token = page.NextToken;
+        hasNext = !!(token && (!config.stopOnSameToken || token !== prevToken));
+    }
+    return undefined;
+}
+exports.paginateGetFindingHistory = paginateGetFindingHistory;

package/dist-cjs/pagination/index.js

@@ -6,6 +6,7 @@ tslib_1.__exportStar(require("./DescribeProductsPaginator"), exports);
 tslib_1.__exportStar(require("./DescribeStandardsControlsPaginator"), exports);
 tslib_1.__exportStar(require("./DescribeStandardsPaginator"), exports);
 tslib_1.__exportStar(require("./GetEnabledStandardsPaginator"), exports);
+tslib_1.__exportStar(require("./GetFindingHistoryPaginator"), exports);
 tslib_1.__exportStar(require("./GetFindingsPaginator"), exports);
 tslib_1.__exportStar(require("./GetInsightsPaginator"), exports);
 tslib_1.__exportStar(require("./Interfaces"), exports);

package/dist-cjs/protocols/Aws_restJson1.js

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.se_ListSecurityControlDefinitionsCommand = exports.se_ListOrganizationAdminAccountsCommand = exports.se_ListMembersCommand = exports.se_ListInvitationsCommand = exports.se_ListFindingAggregatorsCommand = exports.se_ListEnabledProductsForImportCommand = exports.se_InviteMembersCommand = exports.se_GetMembersCommand = exports.se_GetMasterAccountCommand = exports.se_GetInvitationsCountCommand = exports.se_GetInsightsCommand = exports.se_GetInsightResultsCommand = exports.se_GetFindingsCommand = exports.se_GetFindingAggregatorCommand = exports.se_GetEnabledStandardsCommand = exports.se_GetAdministratorAccountCommand = exports.se_EnableSecurityHubCommand = exports.se_EnableOrganizationAdminAccountCommand = exports.se_EnableImportFindingsForProductCommand = exports.se_DisassociateMembersCommand = exports.se_DisassociateFromMasterAccountCommand = exports.se_DisassociateFromAdministratorAccountCommand = exports.se_DisableSecurityHubCommand = exports.se_DisableOrganizationAdminAccountCommand = exports.se_DisableImportFindingsForProductCommand = exports.se_DescribeStandardsControlsCommand = exports.se_DescribeStandardsCommand = exports.se_DescribeProductsCommand = exports.se_DescribeOrganizationConfigurationCommand = exports.se_DescribeHubCommand = exports.se_DescribeActionTargetsCommand = exports.se_DeleteMembersCommand = exports.se_DeleteInvitationsCommand = exports.se_DeleteInsightCommand = exports.se_DeleteFindingAggregatorCommand = exports.se_DeleteActionTargetCommand = exports.se_DeclineInvitationsCommand = exports.se_CreateMembersCommand = exports.se_CreateInsightCommand = exports.se_CreateFindingAggregatorCommand = exports.se_CreateActionTargetCommand = exports.se_BatchUpdateStandardsControlAssociationsCommand = exports.se_BatchUpdateFindingsCommand = exports.se_BatchImportFindingsCommand = exports.se_BatchGetStandardsControlAssociationsCommand = exports.se_BatchGetSecurityControlsCommand = exports.se_BatchEnableStandardsCommand = exports.se_BatchDisableStandardsCommand = exports.se_AcceptInvitationCommand = exports.se_AcceptAdministratorInvitationCommand = void 0;
-exports.de_GetInsightResultsCommand = exports.de_GetFindingsCommand = exports.de_GetFindingAggregatorCommand = exports.de_GetEnabledStandardsCommand = exports.de_GetAdministratorAccountCommand = exports.de_EnableSecurityHubCommand = exports.de_EnableOrganizationAdminAccountCommand = exports.de_EnableImportFindingsForProductCommand = exports.de_DisassociateMembersCommand = exports.de_DisassociateFromMasterAccountCommand = exports.de_DisassociateFromAdministratorAccountCommand = exports.de_DisableSecurityHubCommand = exports.de_DisableOrganizationAdminAccountCommand = exports.de_DisableImportFindingsForProductCommand = exports.de_DescribeStandardsControlsCommand = exports.de_DescribeStandardsCommand = exports.de_DescribeProductsCommand = exports.de_DescribeOrganizationConfigurationCommand = exports.de_DescribeHubCommand = exports.de_DescribeActionTargetsCommand = exports.de_DeleteMembersCommand = exports.de_DeleteInvitationsCommand = exports.de_DeleteInsightCommand = exports.de_DeleteFindingAggregatorCommand = exports.de_DeleteActionTargetCommand = exports.de_DeclineInvitationsCommand = exports.de_CreateMembersCommand = exports.de_CreateInsightCommand = exports.de_CreateFindingAggregatorCommand = exports.de_CreateActionTargetCommand = exports.de_BatchUpdateStandardsControlAssociationsCommand = exports.de_BatchUpdateFindingsCommand = exports.de_BatchImportFindingsCommand = exports.de_BatchGetStandardsControlAssociationsCommand = exports.de_BatchGetSecurityControlsCommand = exports.de_BatchEnableStandardsCommand = exports.de_BatchDisableStandardsCommand = exports.de_AcceptInvitationCommand = exports.de_AcceptAdministratorInvitationCommand = exports.se_UpdateStandardsControlCommand = exports.se_UpdateSecurityHubConfigurationCommand = exports.se_UpdateOrganizationConfigurationCommand = exports.se_UpdateInsightCommand = exports.se_UpdateFindingsCommand = exports.se_UpdateFindingAggregatorCommand = exports.se_UpdateActionTargetCommand = exports.se_UntagResourceCommand = exports.se_TagResourceCommand = exports.se_ListTagsForResourceCommand = exports.se_ListStandardsControlAssociationsCommand = void 0;
-exports.de_UpdateStandardsControlCommand = exports.de_UpdateSecurityHubConfigurationCommand = exports.de_UpdateOrganizationConfigurationCommand = exports.de_UpdateInsightCommand = exports.de_UpdateFindingsCommand = exports.de_UpdateFindingAggregatorCommand = exports.de_UpdateActionTargetCommand = exports.de_UntagResourceCommand = exports.de_TagResourceCommand = exports.de_ListTagsForResourceCommand = exports.de_ListStandardsControlAssociationsCommand = exports.de_ListSecurityControlDefinitionsCommand = exports.de_ListOrganizationAdminAccountsCommand = exports.de_ListMembersCommand = exports.de_ListInvitationsCommand = exports.de_ListFindingAggregatorsCommand = exports.de_ListEnabledProductsForImportCommand = exports.de_InviteMembersCommand = exports.de_GetMembersCommand = exports.de_GetMasterAccountCommand = exports.de_GetInvitationsCountCommand = exports.de_GetInsightsCommand = void 0;
+exports.se_ListOrganizationAdminAccountsCommand = exports.se_ListMembersCommand = exports.se_ListInvitationsCommand = exports.se_ListFindingAggregatorsCommand = exports.se_ListEnabledProductsForImportCommand = exports.se_InviteMembersCommand = exports.se_GetMembersCommand = exports.se_GetMasterAccountCommand = exports.se_GetInvitationsCountCommand = exports.se_GetInsightsCommand = exports.se_GetInsightResultsCommand = exports.se_GetFindingsCommand = exports.se_GetFindingHistoryCommand = exports.se_GetFindingAggregatorCommand = exports.se_GetEnabledStandardsCommand = exports.se_GetAdministratorAccountCommand = exports.se_EnableSecurityHubCommand = exports.se_EnableOrganizationAdminAccountCommand = exports.se_EnableImportFindingsForProductCommand = exports.se_DisassociateMembersCommand = exports.se_DisassociateFromMasterAccountCommand = exports.se_DisassociateFromAdministratorAccountCommand = exports.se_DisableSecurityHubCommand = exports.se_DisableOrganizationAdminAccountCommand = exports.se_DisableImportFindingsForProductCommand = exports.se_DescribeStandardsControlsCommand = exports.se_DescribeStandardsCommand = exports.se_DescribeProductsCommand = exports.se_DescribeOrganizationConfigurationCommand = exports.se_DescribeHubCommand = exports.se_DescribeActionTargetsCommand = exports.se_DeleteMembersCommand = exports.se_DeleteInvitationsCommand = exports.se_DeleteInsightCommand = exports.se_DeleteFindingAggregatorCommand = exports.se_DeleteActionTargetCommand = exports.se_DeclineInvitationsCommand = exports.se_CreateMembersCommand = exports.se_CreateInsightCommand = exports.se_CreateFindingAggregatorCommand = exports.se_CreateActionTargetCommand = exports.se_BatchUpdateStandardsControlAssociationsCommand = exports.se_BatchUpdateFindingsCommand = exports.se_BatchImportFindingsCommand = exports.se_BatchGetStandardsControlAssociationsCommand = exports.se_BatchGetSecurityControlsCommand = exports.se_BatchEnableStandardsCommand = exports.se_BatchDisableStandardsCommand = exports.se_AcceptInvitationCommand = exports.se_AcceptAdministratorInvitationCommand = void 0;
+exports.de_GetFindingHistoryCommand = exports.de_GetFindingAggregatorCommand = exports.de_GetEnabledStandardsCommand = exports.de_GetAdministratorAccountCommand = exports.de_EnableSecurityHubCommand = exports.de_EnableOrganizationAdminAccountCommand = exports.de_EnableImportFindingsForProductCommand = exports.de_DisassociateMembersCommand = exports.de_DisassociateFromMasterAccountCommand = exports.de_DisassociateFromAdministratorAccountCommand = exports.de_DisableSecurityHubCommand = exports.de_DisableOrganizationAdminAccountCommand = exports.de_DisableImportFindingsForProductCommand = exports.de_DescribeStandardsControlsCommand = exports.de_DescribeStandardsCommand = exports.de_DescribeProductsCommand = exports.de_DescribeOrganizationConfigurationCommand = exports.de_DescribeHubCommand = exports.de_DescribeActionTargetsCommand = exports.de_DeleteMembersCommand = exports.de_DeleteInvitationsCommand = exports.de_DeleteInsightCommand = exports.de_DeleteFindingAggregatorCommand = exports.de_DeleteActionTargetCommand = exports.de_DeclineInvitationsCommand = exports.de_CreateMembersCommand = exports.de_CreateInsightCommand = exports.de_CreateFindingAggregatorCommand = exports.de_CreateActionTargetCommand = exports.de_BatchUpdateStandardsControlAssociationsCommand = exports.de_BatchUpdateFindingsCommand = exports.de_BatchImportFindingsCommand = exports.de_BatchGetStandardsControlAssociationsCommand = exports.de_BatchGetSecurityControlsCommand = exports.de_BatchEnableStandardsCommand = exports.de_BatchDisableStandardsCommand = exports.de_AcceptInvitationCommand = exports.de_AcceptAdministratorInvitationCommand = exports.se_UpdateStandardsControlCommand = exports.se_UpdateSecurityHubConfigurationCommand = exports.se_UpdateOrganizationConfigurationCommand = exports.se_UpdateInsightCommand = exports.se_UpdateFindingsCommand = exports.se_UpdateFindingAggregatorCommand = exports.se_UpdateActionTargetCommand = exports.se_UntagResourceCommand = exports.se_TagResourceCommand = exports.se_ListTagsForResourceCommand = exports.se_ListStandardsControlAssociationsCommand = exports.se_ListSecurityControlDefinitionsCommand = void 0;
+exports.de_UpdateStandardsControlCommand = exports.de_UpdateSecurityHubConfigurationCommand = exports.de_UpdateOrganizationConfigurationCommand = exports.de_UpdateInsightCommand = exports.de_UpdateFindingsCommand = exports.de_UpdateFindingAggregatorCommand = exports.de_UpdateActionTargetCommand = exports.de_UntagResourceCommand = exports.de_TagResourceCommand = exports.de_ListTagsForResourceCommand = exports.de_ListStandardsControlAssociationsCommand = exports.de_ListSecurityControlDefinitionsCommand = exports.de_ListOrganizationAdminAccountsCommand = exports.de_ListMembersCommand = exports.de_ListInvitationsCommand = exports.de_ListFindingAggregatorsCommand = exports.de_ListEnabledProductsForImportCommand = exports.de_InviteMembersCommand = exports.de_GetMembersCommand = exports.de_GetMasterAccountCommand = exports.de_GetInvitationsCountCommand = exports.de_GetInsightsCommand = exports.de_GetInsightResultsCommand = exports.de_GetFindingsCommand = void 0;
 const protocol_http_1 = require("@aws-sdk/protocol-http");
 const smithy_client_1 = require("@aws-sdk/smithy-client");
 const models_0_1 = require("../models/models_0");
@@ -782,6 +782,31 @@ const se_GetFindingAggregatorCommand = async (input, context) => {
     });
 };
 exports.se_GetFindingAggregatorCommand = se_GetFindingAggregatorCommand;
+const se_GetFindingHistoryCommand = async (input, context) => {
+    const { hostname, protocol = "https", port, path: basePath } = await context.endpoint();
+    const headers = {
+        "content-type": "application/json",
+    };
+    const resolvedPath = `${basePath?.endsWith("/") ? basePath.slice(0, -1) : basePath || ""}` + "/findingHistory/get";
+    let body;
+    body = JSON.stringify((0, smithy_client_1.take)(input, {
+        EndTime: (_) => _.toISOString().split(".")[0] + "Z",
+        FindingIdentifier: (_) => (0, smithy_client_1._json)(_),
+        MaxResults: [],
+        NextToken: [],
+        StartTime: (_) => _.toISOString().split(".")[0] + "Z",
+    }));
+    return new protocol_http_1.HttpRequest({
+        protocol,
+        hostname,
+        port,
+        method: "POST",
+        headers,
+        path: resolvedPath,
+        body,
+    });
+};
+exports.se_GetFindingHistoryCommand = se_GetFindingHistoryCommand;
 const se_GetFindingsCommand = async (input, context) => {
     const { hostname, protocol = "https", port, path: basePath } = await context.endpoint();
     const headers = {
@@ -2927,6 +2952,50 @@ const de_GetFindingAggregatorCommandError = async (output, context) => {
             });
     }
 };
+const de_GetFindingHistoryCommand = async (output, context) => {
+    if (output.statusCode !== 200 && output.statusCode >= 300) {
+        return de_GetFindingHistoryCommandError(output, context);
+    }
+    const contents = (0, smithy_client_1.map)({
+        $metadata: deserializeMetadata(output),
+    });
+    const data = (0, smithy_client_1.expectNonNull)((0, smithy_client_1.expectObject)(await parseBody(output.body, context)), "body");
+    const doc = (0, smithy_client_1.take)(data, {
+        NextToken: smithy_client_1.expectString,
+        Records: (_) => de_FindingHistoryRecordList(_, context),
+    });
+    Object.assign(contents, doc);
+    return contents;
+};
+exports.de_GetFindingHistoryCommand = de_GetFindingHistoryCommand;
+const de_GetFindingHistoryCommandError = async (output, context) => {
+    const parsedOutput = {
+        ...output,
+        body: await parseErrorBody(output.body, context),
+    };
+    const errorCode = loadRestJsonErrorCode(output, parsedOutput.body);
+    switch (errorCode) {
+        case "InternalException":
+        case "com.amazonaws.securityhub#InternalException":
+            throw await de_InternalExceptionRes(parsedOutput, context);
+        case "InvalidAccessException":
+        case "com.amazonaws.securityhub#InvalidAccessException":
+            throw await de_InvalidAccessExceptionRes(parsedOutput, context);
+        case "InvalidInputException":
+        case "com.amazonaws.securityhub#InvalidInputException":
+            throw await de_InvalidInputExceptionRes(parsedOutput, context);
+        case "LimitExceededException":
+        case "com.amazonaws.securityhub#LimitExceededException":
+            throw await de_LimitExceededExceptionRes(parsedOutput, context);
+        default:
+            const parsedBody = parsedOutput.body;
+            return throwDefaultError({
+                output,
+                parsedBody,
+                errorCode,
+            });
+    }
+};
 const de_GetFindingsCommand = async (output, context) => {
     if (output.statusCode !== 200 && output.statusCode >= 300) {
         return de_GetFindingsCommandError(output, context);
@@ -5179,6 +5248,24 @@ const de_CvssList = (output, context) => {
     });
     return retVal;
 };
+const de_FindingHistoryRecord = (output, context) => {
+    return (0, smithy_client_1.take)(output, {
+        FindingCreated: smithy_client_1.expectBoolean,
+        FindingIdentifier: smithy_client_1._json,
+        NextToken: smithy_client_1.expectString,
+        UpdateSource: smithy_client_1._json,
+        UpdateTime: (_) => (0, smithy_client_1.expectNonNull)((0, smithy_client_1.parseRfc3339DateTimeWithOffset)(_)),
+        Updates: smithy_client_1._json,
+    });
+};
+const de_FindingHistoryRecordList = (output, context) => {
+    const retVal = (output || [])
+        .filter((e) => e != null)
+        .map((entry) => {
+        return de_FindingHistoryRecord(entry, context);
+    });
+    return retVal;
+};
 const de_GeoLocation = (output, context) => {
     return (0, smithy_client_1.take)(output, {
         Lat: smithy_client_1.limitedParseDouble,

package/dist-es/SecurityHub.js

@@ -36,6 +36,7 @@ import { EnableSecurityHubCommand, } from "./commands/EnableSecurityHubCommand";
 import { GetAdministratorAccountCommand, } from "./commands/GetAdministratorAccountCommand";
 import { GetEnabledStandardsCommand, } from "./commands/GetEnabledStandardsCommand";
 import { GetFindingAggregatorCommand, } from "./commands/GetFindingAggregatorCommand";
+import { GetFindingHistoryCommand, } from "./commands/GetFindingHistoryCommand";
 import { GetFindingsCommand } from "./commands/GetFindingsCommand";
 import { GetInsightResultsCommand, } from "./commands/GetInsightResultsCommand";
 import { GetInsightsCommand } from "./commands/GetInsightsCommand";
@@ -99,6 +100,7 @@ const commands = {
     GetAdministratorAccountCommand,
     GetEnabledStandardsCommand,
     GetFindingAggregatorCommand,
+    GetFindingHistoryCommand,
     GetFindingsCommand,
     GetInsightResultsCommand,
     GetInsightsCommand,

package/dist-es/commands/GetFindingHistoryCommand.js

@@ -0,0 +1,41 @@
+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_GetFindingHistoryCommand, se_GetFindingHistoryCommand } from "../protocols/Aws_restJson1";
+export class GetFindingHistoryCommand 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, GetFindingHistoryCommand.getEndpointParameterInstructions()));
+        const stack = clientStack.concat(this.middlewareStack);
+        const { logger } = configuration;
+        const clientName = "SecurityHubClient";
+        const commandName = "GetFindingHistoryCommand";
+        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_GetFindingHistoryCommand(input, context);
+    }
+    deserialize(output, context) {
+        return de_GetFindingHistoryCommand(output, context);
+    }
+}

package/dist-es/commands/index.js

@@ -35,6 +35,7 @@ export * from "./EnableSecurityHubCommand";
 export * from "./GetAdministratorAccountCommand";
 export * from "./GetEnabledStandardsCommand";
 export * from "./GetFindingAggregatorCommand";
+export * from "./GetFindingHistoryCommand";
 export * from "./GetFindingsCommand";
 export * from "./GetInsightResultsCommand";
 export * from "./GetInsightsCommand";

package/dist-es/models/models_2.js

@@ -3,6 +3,10 @@ export const IntegrationType = {
     SEND_FINDINGS_TO_SECURITY_HUB: "SEND_FINDINGS_TO_SECURITY_HUB",
     UPDATE_FINDINGS_IN_SECURITY_HUB: "UPDATE_FINDINGS_IN_SECURITY_HUB",
 };
+export const FindingHistoryUpdateSourceType = {
+    BATCH_IMPORT_FINDINGS: "BATCH_IMPORT_FINDINGS",
+    BATCH_UPDATE_FINDINGS: "BATCH_UPDATE_FINDINGS",
+};
 export const SortOrder = {
     ASCENDING: "asc",
     DESCENDING: "desc",

package/dist-es/pagination/GetFindingHistoryPaginator.js

@@ -0,0 +1,25 @@
+import { GetFindingHistoryCommand, } from "../commands/GetFindingHistoryCommand";
+import { SecurityHubClient } from "../SecurityHubClient";
+const makePagedClientRequest = async (client, input, ...args) => {
+    return await client.send(new GetFindingHistoryCommand(input), ...args);
+};
+export async function* paginateGetFindingHistory(config, input, ...additionalArguments) {
+    let token = config.startingToken || undefined;
+    let hasNext = true;
+    let page;
+    while (hasNext) {
+        input.NextToken = token;
+        input["MaxResults"] = config.pageSize;
+        if (config.client instanceof SecurityHubClient) {
+            page = await makePagedClientRequest(config.client, input, ...additionalArguments);
+        }
+        else {
+            throw new Error("Invalid client, expected SecurityHub | SecurityHubClient");
+        }
+        yield page;
+        const prevToken = token;
+        token = page.NextToken;
+        hasNext = !!(token && (!config.stopOnSameToken || token !== prevToken));
+    }
+    return undefined;
+}

package/dist-es/pagination/index.js

@@ -3,6 +3,7 @@ export * from "./DescribeProductsPaginator";
 export * from "./DescribeStandardsControlsPaginator";
 export * from "./DescribeStandardsPaginator";
 export * from "./GetEnabledStandardsPaginator";
+export * from "./GetFindingHistoryPaginator";
 export * from "./GetFindingsPaginator";
 export * from "./GetInsightsPaginator";
 export * from "./Interfaces";

package/dist-es/protocols/Aws_restJson1.js

@@ -740,6 +740,30 @@ export const se_GetFindingAggregatorCommand = async (input, context) => {
         body,
     });
 };
+export const se_GetFindingHistoryCommand = async (input, context) => {
+    const { hostname, protocol = "https", port, path: basePath } = await context.endpoint();
+    const headers = {
+        "content-type": "application/json",
+    };
+    const resolvedPath = `${basePath?.endsWith("/") ? basePath.slice(0, -1) : basePath || ""}` + "/findingHistory/get";
+    let body;
+    body = JSON.stringify(take(input, {
+        EndTime: (_) => _.toISOString().split(".")[0] + "Z",
+        FindingIdentifier: (_) => _json(_),
+        MaxResults: [],
+        NextToken: [],
+        StartTime: (_) => _.toISOString().split(".")[0] + "Z",
+    }));
+    return new __HttpRequest({
+        protocol,
+        hostname,
+        port,
+        method: "POST",
+        headers,
+        path: resolvedPath,
+        body,
+    });
+};
 export const se_GetFindingsCommand = async (input, context) => {
     const { hostname, protocol = "https", port, path: basePath } = await context.endpoint();
     const headers = {
@@ -2824,6 +2848,49 @@ const de_GetFindingAggregatorCommandError = async (output, context) => {
             });
     }
 };
+export const de_GetFindingHistoryCommand = async (output, context) => {
+    if (output.statusCode !== 200 && output.statusCode >= 300) {
+        return de_GetFindingHistoryCommandError(output, context);
+    }
+    const contents = map({
+        $metadata: deserializeMetadata(output),
+    });
+    const data = __expectNonNull(__expectObject(await parseBody(output.body, context)), "body");
+    const doc = take(data, {
+        NextToken: __expectString,
+        Records: (_) => de_FindingHistoryRecordList(_, context),
+    });
+    Object.assign(contents, doc);
+    return contents;
+};
+const de_GetFindingHistoryCommandError = async (output, context) => {
+    const parsedOutput = {
+        ...output,
+        body: await parseErrorBody(output.body, context),
+    };
+    const errorCode = loadRestJsonErrorCode(output, parsedOutput.body);
+    switch (errorCode) {
+        case "InternalException":
+        case "com.amazonaws.securityhub#InternalException":
+            throw await de_InternalExceptionRes(parsedOutput, context);
+        case "InvalidAccessException":
+        case "com.amazonaws.securityhub#InvalidAccessException":
+            throw await de_InvalidAccessExceptionRes(parsedOutput, context);
+        case "InvalidInputException":
+        case "com.amazonaws.securityhub#InvalidInputException":
+            throw await de_InvalidInputExceptionRes(parsedOutput, context);
+        case "LimitExceededException":
+        case "com.amazonaws.securityhub#LimitExceededException":
+            throw await de_LimitExceededExceptionRes(parsedOutput, context);
+        default:
+            const parsedBody = parsedOutput.body;
+            return throwDefaultError({
+                output,
+                parsedBody,
+                errorCode,
+            });
+    }
+};
 export const de_GetFindingsCommand = async (output, context) => {
     if (output.statusCode !== 200 && output.statusCode >= 300) {
         return de_GetFindingsCommandError(output, context);
@@ -5052,6 +5119,24 @@ const de_CvssList = (output, context) => {
     });
     return retVal;
 };
+const de_FindingHistoryRecord = (output, context) => {
+    return take(output, {
+        FindingCreated: __expectBoolean,
+        FindingIdentifier: _json,
+        NextToken: __expectString,
+        UpdateSource: _json,
+        UpdateTime: (_) => __expectNonNull(__parseRfc3339DateTimeWithOffset(_)),
+        Updates: _json,
+    });
+};
+const de_FindingHistoryRecordList = (output, context) => {
+    const retVal = (output || [])
+        .filter((e) => e != null)
+        .map((entry) => {
+        return de_FindingHistoryRecord(entry, context);
+    });
+    return retVal;
+};
 const de_GeoLocation = (output, context) => {
     return take(output, {
         Lat: __limitedParseDouble,

package/dist-types/SecurityHub.d.ts

@@ -36,6 +36,7 @@ import { EnableSecurityHubCommandInput, EnableSecurityHubCommandOutput } from ".
 import { GetAdministratorAccountCommandInput, GetAdministratorAccountCommandOutput } from "./commands/GetAdministratorAccountCommand";
 import { GetEnabledStandardsCommandInput, GetEnabledStandardsCommandOutput } from "./commands/GetEnabledStandardsCommand";
 import { GetFindingAggregatorCommandInput, GetFindingAggregatorCommandOutput } from "./commands/GetFindingAggregatorCommand";
+import { GetFindingHistoryCommandInput, GetFindingHistoryCommandOutput } from "./commands/GetFindingHistoryCommand";
 import { GetFindingsCommandInput, GetFindingsCommandOutput } from "./commands/GetFindingsCommand";
 import { GetInsightResultsCommandInput, GetInsightResultsCommandOutput } from "./commands/GetInsightResultsCommand";
 import { GetInsightsCommandInput, GetInsightsCommandOutput } from "./commands/GetInsightsCommand";
@@ -284,6 +285,12 @@ export interface SecurityHub {
     getFindingAggregator(args: GetFindingAggregatorCommandInput, options?: __HttpHandlerOptions): Promise<GetFindingAggregatorCommandOutput>;
     getFindingAggregator(args: GetFindingAggregatorCommandInput, cb: (err: any, data?: GetFindingAggregatorCommandOutput) => void): void;
     getFindingAggregator(args: GetFindingAggregatorCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: GetFindingAggregatorCommandOutput) => void): void;
+    /**
+     * @see {@link GetFindingHistoryCommand}
+     */
+    getFindingHistory(args: GetFindingHistoryCommandInput, options?: __HttpHandlerOptions): Promise<GetFindingHistoryCommandOutput>;
+    getFindingHistory(args: GetFindingHistoryCommandInput, cb: (err: any, data?: GetFindingHistoryCommandOutput) => void): void;
+    getFindingHistory(args: GetFindingHistoryCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: GetFindingHistoryCommandOutput) => void): void;
     /**
      * @see {@link GetFindingsCommand}
      */

package/dist-types/SecurityHubClient.d.ts

@@ -44,6 +44,7 @@ import { EnableSecurityHubCommandInput, EnableSecurityHubCommandOutput } from ".
 import { GetAdministratorAccountCommandInput, GetAdministratorAccountCommandOutput } from "./commands/GetAdministratorAccountCommand";
 import { GetEnabledStandardsCommandInput, GetEnabledStandardsCommandOutput } from "./commands/GetEnabledStandardsCommand";
 import { GetFindingAggregatorCommandInput, GetFindingAggregatorCommandOutput } from "./commands/GetFindingAggregatorCommand";
+import { GetFindingHistoryCommandInput, GetFindingHistoryCommandOutput } from "./commands/GetFindingHistoryCommand";
 import { GetFindingsCommandInput, GetFindingsCommandOutput } from "./commands/GetFindingsCommand";
 import { GetInsightResultsCommandInput, GetInsightResultsCommandOutput } from "./commands/GetInsightResultsCommand";
 import { GetInsightsCommandInput, GetInsightsCommandOutput } from "./commands/GetInsightsCommand";
@@ -72,11 +73,11 @@ import { ClientInputEndpointParameters, ClientResolvedEndpointParameters, Endpoi
 /**
  * @public
  */
-export type ServiceInputTypes = AcceptAdministratorInvitationCommandInput | AcceptInvitationCommandInput | BatchDisableStandardsCommandInput | BatchEnableStandardsCommandInput | BatchGetSecurityControlsCommandInput | BatchGetStandardsControlAssociationsCommandInput | BatchImportFindingsCommandInput | BatchUpdateFindingsCommandInput | BatchUpdateStandardsControlAssociationsCommandInput | CreateActionTargetCommandInput | CreateFindingAggregatorCommandInput | CreateInsightCommandInput | CreateMembersCommandInput | DeclineInvitationsCommandInput | DeleteActionTargetCommandInput | DeleteFindingAggregatorCommandInput | DeleteInsightCommandInput | DeleteInvitationsCommandInput | DeleteMembersCommandInput | DescribeActionTargetsCommandInput | DescribeHubCommandInput | DescribeOrganizationConfigurationCommandInput | DescribeProductsCommandInput | DescribeStandardsCommandInput | DescribeStandardsControlsCommandInput | DisableImportFindingsForProductCommandInput | DisableOrganizationAdminAccountCommandInput | DisableSecurityHubCommandInput | DisassociateFromAdministratorAccountCommandInput | DisassociateFromMasterAccountCommandInput | DisassociateMembersCommandInput | EnableImportFindingsForProductCommandInput | EnableOrganizationAdminAccountCommandInput | EnableSecurityHubCommandInput | GetAdministratorAccountCommandInput | GetEnabledStandardsCommandInput | GetFindingAggregatorCommandInput | GetFindingsCommandInput | GetInsightResultsCommandInput | GetInsightsCommandInput | GetInvitationsCountCommandInput | GetMasterAccountCommandInput | GetMembersCommandInput | InviteMembersCommandInput | ListEnabledProductsForImportCommandInput | ListFindingAggregatorsCommandInput | ListInvitationsCommandInput | ListMembersCommandInput | ListOrganizationAdminAccountsCommandInput | ListSecurityControlDefinitionsCommandInput | ListStandardsControlAssociationsCommandInput | ListTagsForResourceCommandInput | TagResourceCommandInput | UntagResourceCommandInput | UpdateActionTargetCommandInput | UpdateFindingAggregatorCommandInput | UpdateFindingsCommandInput | UpdateInsightCommandInput | UpdateOrganizationConfigurationCommandInput | UpdateSecurityHubConfigurationCommandInput | UpdateStandardsControlCommandInput;
+export type ServiceInputTypes = AcceptAdministratorInvitationCommandInput | AcceptInvitationCommandInput | BatchDisableStandardsCommandInput | BatchEnableStandardsCommandInput | BatchGetSecurityControlsCommandInput | BatchGetStandardsControlAssociationsCommandInput | BatchImportFindingsCommandInput | BatchUpdateFindingsCommandInput | BatchUpdateStandardsControlAssociationsCommandInput | CreateActionTargetCommandInput | CreateFindingAggregatorCommandInput | CreateInsightCommandInput | CreateMembersCommandInput | DeclineInvitationsCommandInput | DeleteActionTargetCommandInput | DeleteFindingAggregatorCommandInput | DeleteInsightCommandInput | DeleteInvitationsCommandInput | DeleteMembersCommandInput | DescribeActionTargetsCommandInput | DescribeHubCommandInput | DescribeOrganizationConfigurationCommandInput | DescribeProductsCommandInput | DescribeStandardsCommandInput | DescribeStandardsControlsCommandInput | DisableImportFindingsForProductCommandInput | DisableOrganizationAdminAccountCommandInput | DisableSecurityHubCommandInput | DisassociateFromAdministratorAccountCommandInput | DisassociateFromMasterAccountCommandInput | DisassociateMembersCommandInput | EnableImportFindingsForProductCommandInput | EnableOrganizationAdminAccountCommandInput | EnableSecurityHubCommandInput | GetAdministratorAccountCommandInput | GetEnabledStandardsCommandInput | GetFindingAggregatorCommandInput | GetFindingHistoryCommandInput | GetFindingsCommandInput | GetInsightResultsCommandInput | GetInsightsCommandInput | GetInvitationsCountCommandInput | GetMasterAccountCommandInput | GetMembersCommandInput | InviteMembersCommandInput | ListEnabledProductsForImportCommandInput | ListFindingAggregatorsCommandInput | ListInvitationsCommandInput | ListMembersCommandInput | ListOrganizationAdminAccountsCommandInput | ListSecurityControlDefinitionsCommandInput | ListStandardsControlAssociationsCommandInput | ListTagsForResourceCommandInput | TagResourceCommandInput | UntagResourceCommandInput | UpdateActionTargetCommandInput | UpdateFindingAggregatorCommandInput | UpdateFindingsCommandInput | UpdateInsightCommandInput | UpdateOrganizationConfigurationCommandInput | UpdateSecurityHubConfigurationCommandInput | UpdateStandardsControlCommandInput;
 /**
  * @public
  */
-export type ServiceOutputTypes = AcceptAdministratorInvitationCommandOutput | AcceptInvitationCommandOutput | BatchDisableStandardsCommandOutput | BatchEnableStandardsCommandOutput | BatchGetSecurityControlsCommandOutput | BatchGetStandardsControlAssociationsCommandOutput | BatchImportFindingsCommandOutput | BatchUpdateFindingsCommandOutput | BatchUpdateStandardsControlAssociationsCommandOutput | CreateActionTargetCommandOutput | CreateFindingAggregatorCommandOutput | CreateInsightCommandOutput | CreateMembersCommandOutput | DeclineInvitationsCommandOutput | DeleteActionTargetCommandOutput | DeleteFindingAggregatorCommandOutput | DeleteInsightCommandOutput | DeleteInvitationsCommandOutput | DeleteMembersCommandOutput | DescribeActionTargetsCommandOutput | DescribeHubCommandOutput | DescribeOrganizationConfigurationCommandOutput | DescribeProductsCommandOutput | DescribeStandardsCommandOutput | DescribeStandardsControlsCommandOutput | DisableImportFindingsForProductCommandOutput | DisableOrganizationAdminAccountCommandOutput | DisableSecurityHubCommandOutput | DisassociateFromAdministratorAccountCommandOutput | DisassociateFromMasterAccountCommandOutput | DisassociateMembersCommandOutput | EnableImportFindingsForProductCommandOutput | EnableOrganizationAdminAccountCommandOutput | EnableSecurityHubCommandOutput | GetAdministratorAccountCommandOutput | GetEnabledStandardsCommandOutput | GetFindingAggregatorCommandOutput | GetFindingsCommandOutput | GetInsightResultsCommandOutput | GetInsightsCommandOutput | GetInvitationsCountCommandOutput | GetMasterAccountCommandOutput | GetMembersCommandOutput | InviteMembersCommandOutput | ListEnabledProductsForImportCommandOutput | ListFindingAggregatorsCommandOutput | ListInvitationsCommandOutput | ListMembersCommandOutput | ListOrganizationAdminAccountsCommandOutput | ListSecurityControlDefinitionsCommandOutput | ListStandardsControlAssociationsCommandOutput | ListTagsForResourceCommandOutput | TagResourceCommandOutput | UntagResourceCommandOutput | UpdateActionTargetCommandOutput | UpdateFindingAggregatorCommandOutput | UpdateFindingsCommandOutput | UpdateInsightCommandOutput | UpdateOrganizationConfigurationCommandOutput | UpdateSecurityHubConfigurationCommandOutput | UpdateStandardsControlCommandOutput;
+export type ServiceOutputTypes = AcceptAdministratorInvitationCommandOutput | AcceptInvitationCommandOutput | BatchDisableStandardsCommandOutput | BatchEnableStandardsCommandOutput | BatchGetSecurityControlsCommandOutput | BatchGetStandardsControlAssociationsCommandOutput | BatchImportFindingsCommandOutput | BatchUpdateFindingsCommandOutput | BatchUpdateStandardsControlAssociationsCommandOutput | CreateActionTargetCommandOutput | CreateFindingAggregatorCommandOutput | CreateInsightCommandOutput | CreateMembersCommandOutput | DeclineInvitationsCommandOutput | DeleteActionTargetCommandOutput | DeleteFindingAggregatorCommandOutput | DeleteInsightCommandOutput | DeleteInvitationsCommandOutput | DeleteMembersCommandOutput | DescribeActionTargetsCommandOutput | DescribeHubCommandOutput | DescribeOrganizationConfigurationCommandOutput | DescribeProductsCommandOutput | DescribeStandardsCommandOutput | DescribeStandardsControlsCommandOutput | DisableImportFindingsForProductCommandOutput | DisableOrganizationAdminAccountCommandOutput | DisableSecurityHubCommandOutput | DisassociateFromAdministratorAccountCommandOutput | DisassociateFromMasterAccountCommandOutput | DisassociateMembersCommandOutput | EnableImportFindingsForProductCommandOutput | EnableOrganizationAdminAccountCommandOutput | EnableSecurityHubCommandOutput | GetAdministratorAccountCommandOutput | GetEnabledStandardsCommandOutput | GetFindingAggregatorCommandOutput | GetFindingHistoryCommandOutput | GetFindingsCommandOutput | GetInsightResultsCommandOutput | GetInsightsCommandOutput | GetInvitationsCountCommandOutput | GetMasterAccountCommandOutput | GetMembersCommandOutput | InviteMembersCommandOutput | ListEnabledProductsForImportCommandOutput | ListFindingAggregatorsCommandOutput | ListInvitationsCommandOutput | ListMembersCommandOutput | ListOrganizationAdminAccountsCommandOutput | ListSecurityControlDefinitionsCommandOutput | ListStandardsControlAssociationsCommandOutput | ListTagsForResourceCommandOutput | TagResourceCommandOutput | UntagResourceCommandOutput | UpdateActionTargetCommandOutput | UpdateFindingAggregatorCommandOutput | UpdateFindingsCommandOutput | UpdateInsightCommandOutput | UpdateOrganizationConfigurationCommandOutput | UpdateSecurityHubConfigurationCommandOutput | UpdateStandardsControlCommandOutput;
 /**
  * @public
  */