@aws-sdk/client-accessanalyzer 3.744.0 → 3.748.0

package/README.md

@@ -361,6 +361,14 @@ GetFindingRecommendation
 
 [Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/accessanalyzer/command/GetFindingRecommendationCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-accessanalyzer/Interface/GetFindingRecommendationCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-accessanalyzer/Interface/GetFindingRecommendationCommandOutput/)
 
+</details>
+<details>
+<summary>
+GetFindingsStatistics
+</summary>
+
+[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/accessanalyzer/command/GetFindingsStatisticsCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-accessanalyzer/Interface/GetFindingsStatisticsCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-accessanalyzer/Interface/GetFindingsStatisticsCommandOutput/)
+
 </details>
 <details>
 <summary>

package/dist-cjs/index.js

@@ -53,6 +53,7 @@ __export(src_exports, {
   FindingChangeType: () => FindingChangeType,
   FindingDetails: () => FindingDetails,
   FindingType: () => FindingType,
+  FindingsStatistics: () => FindingsStatistics,
   GenerateFindingRecommendationCommand: () => GenerateFindingRecommendationCommand,
   GetAccessPreviewCommand: () => GetAccessPreviewCommand,
   GetAnalyzedResourceCommand: () => GetAnalyzedResourceCommand,
@@ -61,6 +62,7 @@ __export(src_exports, {
   GetFindingCommand: () => GetFindingCommand,
   GetFindingRecommendationCommand: () => GetFindingRecommendationCommand,
   GetFindingV2Command: () => GetFindingV2Command,
+  GetFindingsStatisticsCommand: () => GetFindingsStatisticsCommand,
   GetGeneratedPolicyCommand: () => GetGeneratedPolicyCommand,
   InternalServerException: () => InternalServerException,
   InvalidParameterException: () => InvalidParameterException,
@@ -696,6 +698,16 @@ var Status = {
   IN_PROGRESS: "IN_PROGRESS",
   SUCCEEDED: "SUCCEEDED"
 };
+var FindingsStatistics;
+((FindingsStatistics2) => {
+  FindingsStatistics2.visit = /* @__PURE__ */ __name((value, visitor) => {
+    if (value.externalAccessFindingsStatistics !== void 0)
+      return visitor.externalAccessFindingsStatistics(value.externalAccessFindingsStatistics);
+    if (value.unusedAccessFindingsStatistics !== void 0)
+      return visitor.unusedAccessFindingsStatistics(value.unusedAccessFindingsStatistics);
+    return visitor._(value.$unknown[0], value.$unknown[1]);
+  }, "visit");
+})(FindingsStatistics || (FindingsStatistics = {}));
 var FindingDetails;
 ((FindingDetails3) => {
   FindingDetails3.visit = /* @__PURE__ */ __name((value, visitor) => {
@@ -1034,6 +1046,21 @@ var se_GetFindingRecommendationCommand = /* @__PURE__ */ __name(async (input, co
   b.m("GET").h(headers).q(query).b(body);
   return b.build();
 }, "se_GetFindingRecommendationCommand");
+var se_GetFindingsStatisticsCommand = /* @__PURE__ */ __name(async (input, context) => {
+  const b = (0, import_core.requestBuilder)(input, context);
+  const headers = {
+    "content-type": "application/json"
+  };
+  b.bp("/analyzer/findings/statistics");
+  let body;
+  body = JSON.stringify(
+    (0, import_smithy_client.take)(input, {
+      analyzerArn: []
+    })
+  );
+  b.m("POST").h(headers).b(body);
+  return b.build();
+}, "se_GetFindingsStatisticsCommand");
 var se_GetFindingV2Command = /* @__PURE__ */ __name(async (input, context) => {
   const b = (0, import_core.requestBuilder)(input, context);
   const headers = {};
@@ -1561,6 +1588,21 @@ var de_GetFindingRecommendationCommand = /* @__PURE__ */ __name(async (output, c
   Object.assign(contents, doc);
   return contents;
 }, "de_GetFindingRecommendationCommand");
+var de_GetFindingsStatisticsCommand = /* @__PURE__ */ __name(async (output, context) => {
+  if (output.statusCode !== 200 && output.statusCode >= 300) {
+    return de_CommandError(output, context);
+  }
+  const contents = (0, import_smithy_client.map)({
+    $metadata: deserializeMetadata(output)
+  });
+  const data = (0, import_smithy_client.expectNonNull)((0, import_smithy_client.expectObject)(await (0, import_core2.parseJsonBody)(output.body, context)), "body");
+  const doc = (0, import_smithy_client.take)(data, {
+    findingsStatistics: import_smithy_client._json,
+    lastUpdatedAt: (_) => (0, import_smithy_client.expectNonNull)((0, import_smithy_client.parseRfc3339DateTimeWithOffset)(_))
+  });
+  Object.assign(contents, doc);
+  return contents;
+}, "de_GetFindingsStatisticsCommand");
 var de_GetFindingV2Command = /* @__PURE__ */ __name(async (output, context) => {
   if (output.statusCode !== 200 && output.statusCode >= 300) {
     return de_CommandError(output, context);
@@ -2582,6 +2624,21 @@ var GetFindingRecommendationCommand = class extends import_smithy_client.Command
   }
 };
 
+// src/commands/GetFindingsStatisticsCommand.ts
+
+
+
+var GetFindingsStatisticsCommand = class extends import_smithy_client.Command.classBuilder().ep(commonParams).m(function(Command, cs, config, o) {
+  return [
+    (0, import_middleware_serde.getSerdePlugin)(config, this.serialize, this.deserialize),
+    (0, import_middleware_endpoint.getEndpointPlugin)(config, Command.getEndpointParameterInstructions())
+  ];
+}).s("AccessAnalyzer", "GetFindingsStatistics", {}).n("AccessAnalyzerClient", "GetFindingsStatisticsCommand").f(void 0, void 0).ser(se_GetFindingsStatisticsCommand).de(de_GetFindingsStatisticsCommand).build() {
+  static {
+    __name(this, "GetFindingsStatisticsCommand");
+  }
+};
+
 // src/commands/GetFindingV2Command.ts
 
 
@@ -2886,6 +2943,7 @@ var commands = {
   GetArchiveRuleCommand,
   GetFindingCommand,
   GetFindingRecommendationCommand,
+  GetFindingsStatisticsCommand,
   GetFindingV2Command,
   GetGeneratedPolicyCommand,
   ListAccessPreviewFindingsCommand,
@@ -2982,6 +3040,7 @@ var paginateValidatePolicy = (0, import_core.createPaginator)(AccessAnalyzerClie
   GetFindingCommand,
   GetFindingRecommendationCommand,
   GetFindingV2Command,
+  GetFindingsStatisticsCommand,
   GetGeneratedPolicyCommand,
   ListAccessPreviewFindingsCommand,
   ListAccessPreviewsCommand,
@@ -3041,6 +3100,7 @@ var paginateValidatePolicy = (0, import_core.createPaginator)(AccessAnalyzerClie
   RecommendedRemediationAction,
   RecommendedStep,
   Status,
+  FindingsStatistics,
   FindingDetails,
   FindingType,
   JobErrorCode,

package/dist-es/AccessAnalyzer.js

@@ -17,6 +17,7 @@ import { GetAnalyzerCommand } from "./commands/GetAnalyzerCommand";
 import { GetArchiveRuleCommand, } from "./commands/GetArchiveRuleCommand";
 import { GetFindingCommand } from "./commands/GetFindingCommand";
 import { GetFindingRecommendationCommand, } from "./commands/GetFindingRecommendationCommand";
+import { GetFindingsStatisticsCommand, } from "./commands/GetFindingsStatisticsCommand";
 import { GetFindingV2Command, } from "./commands/GetFindingV2Command";
 import { GetGeneratedPolicyCommand, } from "./commands/GetGeneratedPolicyCommand";
 import { ListAccessPreviewFindingsCommand, } from "./commands/ListAccessPreviewFindingsCommand";
@@ -54,6 +55,7 @@ const commands = {
     GetArchiveRuleCommand,
     GetFindingCommand,
     GetFindingRecommendationCommand,
+    GetFindingsStatisticsCommand,
     GetFindingV2Command,
     GetGeneratedPolicyCommand,
     ListAccessPreviewFindingsCommand,

package/dist-es/commands/GetFindingsStatisticsCommand.js

@@ -0,0 +1,22 @@
+import { getEndpointPlugin } from "@smithy/middleware-endpoint";
+import { getSerdePlugin } from "@smithy/middleware-serde";
+import { Command as $Command } from "@smithy/smithy-client";
+import { commonParams } from "../endpoint/EndpointParameters";
+import { de_GetFindingsStatisticsCommand, se_GetFindingsStatisticsCommand } from "../protocols/Aws_restJson1";
+export { $Command };
+export class GetFindingsStatisticsCommand extends $Command
+    .classBuilder()
+    .ep(commonParams)
+    .m(function (Command, cs, config, o) {
+    return [
+        getSerdePlugin(config, this.serialize, this.deserialize),
+        getEndpointPlugin(config, Command.getEndpointParameterInstructions()),
+    ];
+})
+    .s("AccessAnalyzer", "GetFindingsStatistics", {})
+    .n("AccessAnalyzerClient", "GetFindingsStatisticsCommand")
+    .f(void 0, void 0)
+    .ser(se_GetFindingsStatisticsCommand)
+    .de(de_GetFindingsStatisticsCommand)
+    .build() {
+}

package/dist-es/commands/index.js

@@ -16,6 +16,7 @@ export * from "./GetArchiveRuleCommand";
 export * from "./GetFindingCommand";
 export * from "./GetFindingRecommendationCommand";
 export * from "./GetFindingV2Command";
+export * from "./GetFindingsStatisticsCommand";
 export * from "./GetGeneratedPolicyCommand";
 export * from "./ListAccessPreviewFindingsCommand";
 export * from "./ListAccessPreviewsCommand";

package/dist-es/models/models_0.js

@@ -311,6 +311,16 @@ export const Status = {
     IN_PROGRESS: "IN_PROGRESS",
     SUCCEEDED: "SUCCEEDED",
 };
+export var FindingsStatistics;
+(function (FindingsStatistics) {
+    FindingsStatistics.visit = (value, visitor) => {
+        if (value.externalAccessFindingsStatistics !== undefined)
+            return visitor.externalAccessFindingsStatistics(value.externalAccessFindingsStatistics);
+        if (value.unusedAccessFindingsStatistics !== undefined)
+            return visitor.unusedAccessFindingsStatistics(value.unusedAccessFindingsStatistics);
+        return visitor._(value.$unknown[0], value.$unknown[1]);
+    };
+})(FindingsStatistics || (FindingsStatistics = {}));
 export var FindingDetails;
 (function (FindingDetails) {
     FindingDetails.visit = (value, visitor) => {

package/dist-es/protocols/Aws_restJson1.js

@@ -227,6 +227,19 @@ export const se_GetFindingRecommendationCommand = async (input, context) => {
     b.m("GET").h(headers).q(query).b(body);
     return b.build();
 };
+export const se_GetFindingsStatisticsCommand = async (input, context) => {
+    const b = rb(input, context);
+    const headers = {
+        "content-type": "application/json",
+    };
+    b.bp("/analyzer/findings/statistics");
+    let body;
+    body = JSON.stringify(take(input, {
+        analyzerArn: [],
+    }));
+    b.m("POST").h(headers).b(body);
+    return b.build();
+};
 export const se_GetFindingV2Command = async (input, context) => {
     const b = rb(input, context);
     const headers = {};
@@ -732,6 +745,21 @@ export const de_GetFindingRecommendationCommand = async (output, context) => {
     Object.assign(contents, doc);
     return contents;
 };
+export const de_GetFindingsStatisticsCommand = async (output, context) => {
+    if (output.statusCode !== 200 && output.statusCode >= 300) {
+        return de_CommandError(output, context);
+    }
+    const contents = map({
+        $metadata: deserializeMetadata(output),
+    });
+    const data = __expectNonNull(__expectObject(await parseBody(output.body, context)), "body");
+    const doc = take(data, {
+        findingsStatistics: _json,
+        lastUpdatedAt: (_) => __expectNonNull(__parseRfc3339DateTimeWithOffset(_)),
+    });
+    Object.assign(contents, doc);
+    return contents;
+};
 export const de_GetFindingV2Command = async (output, context) => {
     if (output.statusCode !== 200 && output.statusCode >= 300) {
         return de_CommandError(output, context);

package/dist-types/AccessAnalyzer.d.ts

@@ -17,6 +17,7 @@ import { GetAnalyzerCommandInput, GetAnalyzerCommandOutput } from "./commands/Ge
 import { GetArchiveRuleCommandInput, GetArchiveRuleCommandOutput } from "./commands/GetArchiveRuleCommand";
 import { GetFindingCommandInput, GetFindingCommandOutput } from "./commands/GetFindingCommand";
 import { GetFindingRecommendationCommandInput, GetFindingRecommendationCommandOutput } from "./commands/GetFindingRecommendationCommand";
+import { GetFindingsStatisticsCommandInput, GetFindingsStatisticsCommandOutput } from "./commands/GetFindingsStatisticsCommand";
 import { GetFindingV2CommandInput, GetFindingV2CommandOutput } from "./commands/GetFindingV2Command";
 import { GetGeneratedPolicyCommandInput, GetGeneratedPolicyCommandOutput } from "./commands/GetGeneratedPolicyCommand";
 import { ListAccessPreviewFindingsCommandInput, ListAccessPreviewFindingsCommandOutput } from "./commands/ListAccessPreviewFindingsCommand";
@@ -139,6 +140,12 @@ export interface AccessAnalyzer {
     getFindingRecommendation(args: GetFindingRecommendationCommandInput, options?: __HttpHandlerOptions): Promise<GetFindingRecommendationCommandOutput>;
     getFindingRecommendation(args: GetFindingRecommendationCommandInput, cb: (err: any, data?: GetFindingRecommendationCommandOutput) => void): void;
     getFindingRecommendation(args: GetFindingRecommendationCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: GetFindingRecommendationCommandOutput) => void): void;
+    /**
+     * @see {@link GetFindingsStatisticsCommand}
+     */
+    getFindingsStatistics(args: GetFindingsStatisticsCommandInput, options?: __HttpHandlerOptions): Promise<GetFindingsStatisticsCommandOutput>;
+    getFindingsStatistics(args: GetFindingsStatisticsCommandInput, cb: (err: any, data?: GetFindingsStatisticsCommandOutput) => void): void;
+    getFindingsStatistics(args: GetFindingsStatisticsCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: GetFindingsStatisticsCommandOutput) => void): void;
     /**
      * @see {@link GetFindingV2Command}
      */

package/dist-types/AccessAnalyzerClient.d.ts

@@ -24,6 +24,7 @@ import { GetAnalyzerCommandInput, GetAnalyzerCommandOutput } from "./commands/Ge
 import { GetArchiveRuleCommandInput, GetArchiveRuleCommandOutput } from "./commands/GetArchiveRuleCommand";
 import { GetFindingCommandInput, GetFindingCommandOutput } from "./commands/GetFindingCommand";
 import { GetFindingRecommendationCommandInput, GetFindingRecommendationCommandOutput } from "./commands/GetFindingRecommendationCommand";
+import { GetFindingsStatisticsCommandInput, GetFindingsStatisticsCommandOutput } from "./commands/GetFindingsStatisticsCommand";
 import { GetFindingV2CommandInput, GetFindingV2CommandOutput } from "./commands/GetFindingV2Command";
 import { GetGeneratedPolicyCommandInput, GetGeneratedPolicyCommandOutput } from "./commands/GetGeneratedPolicyCommand";
 import { ListAccessPreviewFindingsCommandInput, ListAccessPreviewFindingsCommandOutput } from "./commands/ListAccessPreviewFindingsCommand";
@@ -49,11 +50,11 @@ export { __Client };
 /**
  * @public
  */
-export type ServiceInputTypes = ApplyArchiveRuleCommandInput | CancelPolicyGenerationCommandInput | CheckAccessNotGrantedCommandInput | CheckNoNewAccessCommandInput | CheckNoPublicAccessCommandInput | CreateAccessPreviewCommandInput | CreateAnalyzerCommandInput | CreateArchiveRuleCommandInput | DeleteAnalyzerCommandInput | DeleteArchiveRuleCommandInput | GenerateFindingRecommendationCommandInput | GetAccessPreviewCommandInput | GetAnalyzedResourceCommandInput | GetAnalyzerCommandInput | GetArchiveRuleCommandInput | GetFindingCommandInput | GetFindingRecommendationCommandInput | GetFindingV2CommandInput | GetGeneratedPolicyCommandInput | ListAccessPreviewFindingsCommandInput | ListAccessPreviewsCommandInput | ListAnalyzedResourcesCommandInput | ListAnalyzersCommandInput | ListArchiveRulesCommandInput | ListFindingsCommandInput | ListFindingsV2CommandInput | ListPolicyGenerationsCommandInput | ListTagsForResourceCommandInput | StartPolicyGenerationCommandInput | StartResourceScanCommandInput | TagResourceCommandInput | UntagResourceCommandInput | UpdateAnalyzerCommandInput | UpdateArchiveRuleCommandInput | UpdateFindingsCommandInput | ValidatePolicyCommandInput;
+export type ServiceInputTypes = ApplyArchiveRuleCommandInput | CancelPolicyGenerationCommandInput | CheckAccessNotGrantedCommandInput | CheckNoNewAccessCommandInput | CheckNoPublicAccessCommandInput | CreateAccessPreviewCommandInput | CreateAnalyzerCommandInput | CreateArchiveRuleCommandInput | DeleteAnalyzerCommandInput | DeleteArchiveRuleCommandInput | GenerateFindingRecommendationCommandInput | GetAccessPreviewCommandInput | GetAnalyzedResourceCommandInput | GetAnalyzerCommandInput | GetArchiveRuleCommandInput | GetFindingCommandInput | GetFindingRecommendationCommandInput | GetFindingV2CommandInput | GetFindingsStatisticsCommandInput | GetGeneratedPolicyCommandInput | ListAccessPreviewFindingsCommandInput | ListAccessPreviewsCommandInput | ListAnalyzedResourcesCommandInput | ListAnalyzersCommandInput | ListArchiveRulesCommandInput | ListFindingsCommandInput | ListFindingsV2CommandInput | ListPolicyGenerationsCommandInput | ListTagsForResourceCommandInput | StartPolicyGenerationCommandInput | StartResourceScanCommandInput | TagResourceCommandInput | UntagResourceCommandInput | UpdateAnalyzerCommandInput | UpdateArchiveRuleCommandInput | UpdateFindingsCommandInput | ValidatePolicyCommandInput;
 /**
  * @public
  */
-export type ServiceOutputTypes = ApplyArchiveRuleCommandOutput | CancelPolicyGenerationCommandOutput | CheckAccessNotGrantedCommandOutput | CheckNoNewAccessCommandOutput | CheckNoPublicAccessCommandOutput | CreateAccessPreviewCommandOutput | CreateAnalyzerCommandOutput | CreateArchiveRuleCommandOutput | DeleteAnalyzerCommandOutput | DeleteArchiveRuleCommandOutput | GenerateFindingRecommendationCommandOutput | GetAccessPreviewCommandOutput | GetAnalyzedResourceCommandOutput | GetAnalyzerCommandOutput | GetArchiveRuleCommandOutput | GetFindingCommandOutput | GetFindingRecommendationCommandOutput | GetFindingV2CommandOutput | GetGeneratedPolicyCommandOutput | ListAccessPreviewFindingsCommandOutput | ListAccessPreviewsCommandOutput | ListAnalyzedResourcesCommandOutput | ListAnalyzersCommandOutput | ListArchiveRulesCommandOutput | ListFindingsCommandOutput | ListFindingsV2CommandOutput | ListPolicyGenerationsCommandOutput | ListTagsForResourceCommandOutput | StartPolicyGenerationCommandOutput | StartResourceScanCommandOutput | TagResourceCommandOutput | UntagResourceCommandOutput | UpdateAnalyzerCommandOutput | UpdateArchiveRuleCommandOutput | UpdateFindingsCommandOutput | ValidatePolicyCommandOutput;
+export type ServiceOutputTypes = ApplyArchiveRuleCommandOutput | CancelPolicyGenerationCommandOutput | CheckAccessNotGrantedCommandOutput | CheckNoNewAccessCommandOutput | CheckNoPublicAccessCommandOutput | CreateAccessPreviewCommandOutput | CreateAnalyzerCommandOutput | CreateArchiveRuleCommandOutput | DeleteAnalyzerCommandOutput | DeleteArchiveRuleCommandOutput | GenerateFindingRecommendationCommandOutput | GetAccessPreviewCommandOutput | GetAnalyzedResourceCommandOutput | GetAnalyzerCommandOutput | GetArchiveRuleCommandOutput | GetFindingCommandOutput | GetFindingRecommendationCommandOutput | GetFindingV2CommandOutput | GetFindingsStatisticsCommandOutput | GetGeneratedPolicyCommandOutput | ListAccessPreviewFindingsCommandOutput | ListAccessPreviewsCommandOutput | ListAnalyzedResourcesCommandOutput | ListAnalyzersCommandOutput | ListArchiveRulesCommandOutput | ListFindingsCommandOutput | ListFindingsV2CommandOutput | ListPolicyGenerationsCommandOutput | ListTagsForResourceCommandOutput | StartPolicyGenerationCommandOutput | StartResourceScanCommandOutput | TagResourceCommandOutput | UntagResourceCommandOutput | UpdateAnalyzerCommandOutput | UpdateArchiveRuleCommandOutput | UpdateFindingsCommandOutput | ValidatePolicyCommandOutput;
 /**
  * @public
  */

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

@@ -0,0 +1,122 @@
+import { Command as $Command } from "@smithy/smithy-client";
+import { MetadataBearer as __MetadataBearer } from "@smithy/types";
+import { AccessAnalyzerClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../AccessAnalyzerClient";
+import { GetFindingsStatisticsRequest, GetFindingsStatisticsResponse } from "../models/models_0";
+/**
+ * @public
+ */
+export type { __MetadataBearer };
+export { $Command };
+/**
+ * @public
+ *
+ * The input for {@link GetFindingsStatisticsCommand}.
+ */
+export interface GetFindingsStatisticsCommandInput extends GetFindingsStatisticsRequest {
+}
+/**
+ * @public
+ *
+ * The output of {@link GetFindingsStatisticsCommand}.
+ */
+export interface GetFindingsStatisticsCommandOutput extends GetFindingsStatisticsResponse, __MetadataBearer {
+}
+declare const GetFindingsStatisticsCommand_base: {
+    new (input: GetFindingsStatisticsCommandInput): import("@smithy/smithy-client").CommandImpl<GetFindingsStatisticsCommandInput, GetFindingsStatisticsCommandOutput, AccessAnalyzerClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
+    new (__0_0: GetFindingsStatisticsCommandInput): import("@smithy/smithy-client").CommandImpl<GetFindingsStatisticsCommandInput, GetFindingsStatisticsCommandOutput, AccessAnalyzerClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
+    getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
+};
+/**
+ * <p>Retrieves a list of aggregated finding statistics for an external access or unused
+ *          access analyzer.</p>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { AccessAnalyzerClient, GetFindingsStatisticsCommand } from "@aws-sdk/client-accessanalyzer"; // ES Modules import
+ * // const { AccessAnalyzerClient, GetFindingsStatisticsCommand } = require("@aws-sdk/client-accessanalyzer"); // CommonJS import
+ * const client = new AccessAnalyzerClient(config);
+ * const input = { // GetFindingsStatisticsRequest
+ *   analyzerArn: "STRING_VALUE", // required
+ * };
+ * const command = new GetFindingsStatisticsCommand(input);
+ * const response = await client.send(command);
+ * // { // GetFindingsStatisticsResponse
+ * //   findingsStatistics: [ // FindingsStatisticsList
+ * //     { // FindingsStatistics Union: only one key present
+ * //       externalAccessFindingsStatistics: { // ExternalAccessFindingsStatistics
+ * //         resourceTypeStatistics: { // ResourceTypeStatisticsMap
+ * //           "<keys>": { // ResourceTypeDetails
+ * //             totalActivePublic: Number("int"),
+ * //             totalActiveCrossAccount: Number("int"),
+ * //           },
+ * //         },
+ * //         totalActiveFindings: Number("int"),
+ * //         totalArchivedFindings: Number("int"),
+ * //         totalResolvedFindings: Number("int"),
+ * //       },
+ * //       unusedAccessFindingsStatistics: { // UnusedAccessFindingsStatistics
+ * //         unusedAccessTypeStatistics: [ // UnusedAccessTypeStatisticsList
+ * //           { // UnusedAccessTypeStatistics
+ * //             unusedAccessType: "STRING_VALUE",
+ * //             total: Number("int"),
+ * //           },
+ * //         ],
+ * //         topAccounts: [ // AccountAggregations
+ * //           { // FindingAggregationAccountDetails
+ * //             account: "STRING_VALUE",
+ * //             numberOfActiveFindings: Number("int"),
+ * //             details: { // FindingAggregationAccountDetailsMap
+ * //               "<keys>": Number("int"),
+ * //             },
+ * //           },
+ * //         ],
+ * //         totalActiveFindings: Number("int"),
+ * //         totalArchivedFindings: Number("int"),
+ * //         totalResolvedFindings: Number("int"),
+ * //       },
+ * //     },
+ * //   ],
+ * //   lastUpdatedAt: new Date("TIMESTAMP"),
+ * // };
+ *
+ * ```
+ *
+ * @param GetFindingsStatisticsCommandInput - {@link GetFindingsStatisticsCommandInput}
+ * @returns {@link GetFindingsStatisticsCommandOutput}
+ * @see {@link GetFindingsStatisticsCommandInput} for command's `input` shape.
+ * @see {@link GetFindingsStatisticsCommandOutput} for command's `response` shape.
+ * @see {@link AccessAnalyzerClientResolvedConfig | config} for AccessAnalyzerClient's `config` shape.
+ *
+ * @throws {@link AccessDeniedException} (client fault)
+ *  <p>You do not have sufficient access to perform this action.</p>
+ *
+ * @throws {@link InternalServerException} (server fault)
+ *  <p>Internal server error.</p>
+ *
+ * @throws {@link ResourceNotFoundException} (client fault)
+ *  <p>The specified resource could not be found.</p>
+ *
+ * @throws {@link ThrottlingException} (client fault)
+ *  <p>Throttling limit exceeded error.</p>
+ *
+ * @throws {@link ValidationException} (client fault)
+ *  <p>Validation exception error.</p>
+ *
+ * @throws {@link AccessAnalyzerServiceException}
+ * <p>Base exception class for all service exceptions from AccessAnalyzer service.</p>
+ *
+ * @public
+ */
+export declare class GetFindingsStatisticsCommand extends GetFindingsStatisticsCommand_base {
+    /** @internal type navigation helper, not in runtime. */
+    protected static __types: {
+        api: {
+            input: GetFindingsStatisticsRequest;
+            output: GetFindingsStatisticsResponse;
+        };
+        sdk: {
+            input: GetFindingsStatisticsCommandInput;
+            output: GetFindingsStatisticsCommandOutput;
+        };
+    };
+}

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

@@ -16,6 +16,7 @@ export * from "./GetArchiveRuleCommand";
 export * from "./GetFindingCommand";
 export * from "./GetFindingRecommendationCommand";
 export * from "./GetFindingV2Command";
+export * from "./GetFindingsStatisticsCommand";
 export * from "./GetGeneratedPolicyCommand";
 export * from "./ListAccessPreviewFindingsCommand";
 export * from "./ListAccessPreviewsCommand";

package/dist-types/models/models_0.d.ts

@@ -2841,6 +2841,197 @@ export interface GetFindingRecommendationResponse {
      */
     status: Status | undefined;
 }
+/**
+ * @public
+ */
+export interface GetFindingsStatisticsRequest {
+    /**
+     * <p>The <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/access-analyzer-getting-started.html#permission-resources">ARN of
+     *             the analyzer</a> used to generate the statistics.</p>
+     * @public
+     */
+    analyzerArn: string | undefined;
+}
+/**
+ * <p>Contains information about the total number of active cross-account and public findings
+ *          for a resource type of an external access analyzer.</p>
+ * @public
+ */
+export interface ResourceTypeDetails {
+    /**
+     * <p>The total number of active public findings for the resource type.</p>
+     * @public
+     */
+    totalActivePublic?: number | undefined;
+    /**
+     * <p>The total number of active cross-account findings for the resource type.</p>
+     * @public
+     */
+    totalActiveCrossAccount?: number | undefined;
+}
+/**
+ * <p>Provides aggregate statistics about the findings for the specified external access
+ *          analyzer.</p>
+ * @public
+ */
+export interface ExternalAccessFindingsStatistics {
+    /**
+     * <p>The total number of active cross-account and public findings for each resource type of
+     *          the specified external access analyzer.</p>
+     * @public
+     */
+    resourceTypeStatistics?: Partial<Record<ResourceType, ResourceTypeDetails>> | undefined;
+    /**
+     * <p>The number of active findings for the specified external access analyzer.</p>
+     * @public
+     */
+    totalActiveFindings?: number | undefined;
+    /**
+     * <p>The number of archived findings for the specified external access analyzer.</p>
+     * @public
+     */
+    totalArchivedFindings?: number | undefined;
+    /**
+     * <p>The number of resolved findings for the specified external access analyzer.</p>
+     * @public
+     */
+    totalResolvedFindings?: number | undefined;
+}
+/**
+ * <p>Contains information about the findings for an Amazon Web Services account in an organization unused
+ *          access analyzer.</p>
+ * @public
+ */
+export interface FindingAggregationAccountDetails {
+    /**
+     * <p>The ID of the Amazon Web Services account for which unused access finding details are provided.</p>
+     * @public
+     */
+    account?: string | undefined;
+    /**
+     * <p>The number of active unused access findings for the specified Amazon Web Services account.</p>
+     * @public
+     */
+    numberOfActiveFindings?: number | undefined;
+    /**
+     * <p>Provides the number of active findings for each type of unused access for the specified
+     *          Amazon Web Services account.</p>
+     * @public
+     */
+    details?: Record<string, number> | undefined;
+}
+/**
+ * <p>Contains information about the total number of findings for a type of unused
+ *          access.</p>
+ * @public
+ */
+export interface UnusedAccessTypeStatistics {
+    /**
+     * <p>The type of unused access.</p>
+     * @public
+     */
+    unusedAccessType?: string | undefined;
+    /**
+     * <p>The total number of findings for the specified unused access type.</p>
+     * @public
+     */
+    total?: number | undefined;
+}
+/**
+ * <p>Provides aggregate statistics about the findings for the specified unused access
+ *          analyzer.</p>
+ * @public
+ */
+export interface UnusedAccessFindingsStatistics {
+    /**
+     * <p>A list of details about the total number of findings for each type of unused access for
+     *          the analyzer. </p>
+     * @public
+     */
+    unusedAccessTypeStatistics?: UnusedAccessTypeStatistics[] | undefined;
+    /**
+     * <p>A list of one to ten Amazon Web Services accounts that have the most active findings for the unused
+     *          access analyzer.</p>
+     * @public
+     */
+    topAccounts?: FindingAggregationAccountDetails[] | undefined;
+    /**
+     * <p>The total number of active findings for the unused access analyzer.</p>
+     * @public
+     */
+    totalActiveFindings?: number | undefined;
+    /**
+     * <p>The total number of archived findings for the unused access analyzer.</p>
+     * @public
+     */
+    totalArchivedFindings?: number | undefined;
+    /**
+     * <p>The total number of resolved findings for the unused access analyzer.</p>
+     * @public
+     */
+    totalResolvedFindings?: number | undefined;
+}
+/**
+ * <p>Contains information about the aggregate statistics for an external or unused access
+ *          analyzer. Only one parameter can be used in a <code>FindingsStatistics</code>
+ *          object.</p>
+ * @public
+ */
+export type FindingsStatistics = FindingsStatistics.ExternalAccessFindingsStatisticsMember | FindingsStatistics.UnusedAccessFindingsStatisticsMember | FindingsStatistics.$UnknownMember;
+/**
+ * @public
+ */
+export declare namespace FindingsStatistics {
+    /**
+     * <p>The aggregate statistics for an external access analyzer.</p>
+     * @public
+     */
+    interface ExternalAccessFindingsStatisticsMember {
+        externalAccessFindingsStatistics: ExternalAccessFindingsStatistics;
+        unusedAccessFindingsStatistics?: never;
+        $unknown?: never;
+    }
+    /**
+     * <p>The aggregate statistics for an unused access analyzer.</p>
+     * @public
+     */
+    interface UnusedAccessFindingsStatisticsMember {
+        externalAccessFindingsStatistics?: never;
+        unusedAccessFindingsStatistics: UnusedAccessFindingsStatistics;
+        $unknown?: never;
+    }
+    /**
+     * @public
+     */
+    interface $UnknownMember {
+        externalAccessFindingsStatistics?: never;
+        unusedAccessFindingsStatistics?: never;
+        $unknown: [string, any];
+    }
+    interface Visitor<T> {
+        externalAccessFindingsStatistics: (value: ExternalAccessFindingsStatistics) => T;
+        unusedAccessFindingsStatistics: (value: UnusedAccessFindingsStatistics) => T;
+        _: (name: string, value: any) => T;
+    }
+    const visit: <T>(value: FindingsStatistics, visitor: Visitor<T>) => T;
+}
+/**
+ * @public
+ */
+export interface GetFindingsStatisticsResponse {
+    /**
+     * <p>A group of external access or unused access findings statistics.</p>
+     * @public
+     */
+    findingsStatistics?: FindingsStatistics[] | undefined;
+    /**
+     * <p>The time at which the retrieval of the findings statistics was last updated. If the
+     *          findings statistics have not been previously retrieved for the specified analyzer, this
+     *          field will not be populated.</p>
+     * @public
+     */
+    lastUpdatedAt?: Date | undefined;
+}
 /**
  * @public
  */

package/dist-types/protocols/Aws_restJson1.d.ts

@@ -17,6 +17,7 @@ import { GetAnalyzerCommandInput, GetAnalyzerCommandOutput } from "../commands/G
 import { GetArchiveRuleCommandInput, GetArchiveRuleCommandOutput } from "../commands/GetArchiveRuleCommand";
 import { GetFindingCommandInput, GetFindingCommandOutput } from "../commands/GetFindingCommand";
 import { GetFindingRecommendationCommandInput, GetFindingRecommendationCommandOutput } from "../commands/GetFindingRecommendationCommand";
+import { GetFindingsStatisticsCommandInput, GetFindingsStatisticsCommandOutput } from "../commands/GetFindingsStatisticsCommand";
 import { GetFindingV2CommandInput, GetFindingV2CommandOutput } from "../commands/GetFindingV2Command";
 import { GetGeneratedPolicyCommandInput, GetGeneratedPolicyCommandOutput } from "../commands/GetGeneratedPolicyCommand";
 import { ListAccessPreviewFindingsCommandInput, ListAccessPreviewFindingsCommandOutput } from "../commands/ListAccessPreviewFindingsCommand";
@@ -104,6 +105,10 @@ export declare const se_GetFindingCommand: (input: GetFindingCommandInput, conte
  * serializeAws_restJson1GetFindingRecommendationCommand
  */
 export declare const se_GetFindingRecommendationCommand: (input: GetFindingRecommendationCommandInput, context: __SerdeContext) => Promise<__HttpRequest>;
+/**
+ * serializeAws_restJson1GetFindingsStatisticsCommand
+ */
+export declare const se_GetFindingsStatisticsCommand: (input: GetFindingsStatisticsCommandInput, context: __SerdeContext) => Promise<__HttpRequest>;
 /**
  * serializeAws_restJson1GetFindingV2Command
  */
@@ -248,6 +253,10 @@ export declare const de_GetFindingCommand: (output: __HttpResponse, context: __S
  * deserializeAws_restJson1GetFindingRecommendationCommand
  */
 export declare const de_GetFindingRecommendationCommand: (output: __HttpResponse, context: __SerdeContext) => Promise<GetFindingRecommendationCommandOutput>;
+/**
+ * deserializeAws_restJson1GetFindingsStatisticsCommand
+ */
+export declare const de_GetFindingsStatisticsCommand: (output: __HttpResponse, context: __SerdeContext) => Promise<GetFindingsStatisticsCommandOutput>;
 /**
  * deserializeAws_restJson1GetFindingV2Command
  */

package/dist-types/ts3.4/AccessAnalyzer.d.ts

@@ -68,6 +68,10 @@ import {
   GetFindingRecommendationCommandInput,
   GetFindingRecommendationCommandOutput,
 } from "./commands/GetFindingRecommendationCommand";
+import {
+  GetFindingsStatisticsCommandInput,
+  GetFindingsStatisticsCommandOutput,
+} from "./commands/GetFindingsStatisticsCommand";
 import {
   GetFindingV2CommandInput,
   GetFindingV2CommandOutput,
@@ -366,6 +370,19 @@ export interface AccessAnalyzer {
     options: __HttpHandlerOptions,
     cb: (err: any, data?: GetFindingRecommendationCommandOutput) => void
   ): void;
+  getFindingsStatistics(
+    args: GetFindingsStatisticsCommandInput,
+    options?: __HttpHandlerOptions
+  ): Promise<GetFindingsStatisticsCommandOutput>;
+  getFindingsStatistics(
+    args: GetFindingsStatisticsCommandInput,
+    cb: (err: any, data?: GetFindingsStatisticsCommandOutput) => void
+  ): void;
+  getFindingsStatistics(
+    args: GetFindingsStatisticsCommandInput,
+    options: __HttpHandlerOptions,
+    cb: (err: any, data?: GetFindingsStatisticsCommandOutput) => void
+  ): void;
   getFindingV2(
     args: GetFindingV2CommandInput,
     options?: __HttpHandlerOptions

package/dist-types/ts3.4/AccessAnalyzerClient.d.ts

@@ -113,6 +113,10 @@ import {
   GetFindingRecommendationCommandInput,
   GetFindingRecommendationCommandOutput,
 } from "./commands/GetFindingRecommendationCommand";
+import {
+  GetFindingsStatisticsCommandInput,
+  GetFindingsStatisticsCommandOutput,
+} from "./commands/GetFindingsStatisticsCommand";
 import {
   GetFindingV2CommandInput,
   GetFindingV2CommandOutput,
@@ -215,6 +219,7 @@ export type ServiceInputTypes =
   | GetFindingCommandInput
   | GetFindingRecommendationCommandInput
   | GetFindingV2CommandInput
+  | GetFindingsStatisticsCommandInput
   | GetGeneratedPolicyCommandInput
   | ListAccessPreviewFindingsCommandInput
   | ListAccessPreviewsCommandInput
@@ -252,6 +257,7 @@ export type ServiceOutputTypes =
   | GetFindingCommandOutput
   | GetFindingRecommendationCommandOutput
   | GetFindingV2CommandOutput
+  | GetFindingsStatisticsCommandOutput
   | GetGeneratedPolicyCommandOutput
   | ListAccessPreviewFindingsCommandOutput
   | ListAccessPreviewsCommandOutput

package/dist-types/ts3.4/commands/GetFindingsStatisticsCommand.d.ts

@@ -0,0 +1,51 @@
+import { Command as $Command } from "@smithy/smithy-client";
+import { MetadataBearer as __MetadataBearer } from "@smithy/types";
+import {
+  AccessAnalyzerClientResolvedConfig,
+  ServiceInputTypes,
+  ServiceOutputTypes,
+} from "../AccessAnalyzerClient";
+import {
+  GetFindingsStatisticsRequest,
+  GetFindingsStatisticsResponse,
+} from "../models/models_0";
+export { __MetadataBearer };
+export { $Command };
+export interface GetFindingsStatisticsCommandInput
+  extends GetFindingsStatisticsRequest {}
+export interface GetFindingsStatisticsCommandOutput
+  extends GetFindingsStatisticsResponse,
+    __MetadataBearer {}
+declare const GetFindingsStatisticsCommand_base: {
+  new (
+    input: GetFindingsStatisticsCommandInput
+  ): import("@smithy/smithy-client").CommandImpl<
+    GetFindingsStatisticsCommandInput,
+    GetFindingsStatisticsCommandOutput,
+    AccessAnalyzerClientResolvedConfig,
+    ServiceInputTypes,
+    ServiceOutputTypes
+  >;
+  new (
+    __0_0: GetFindingsStatisticsCommandInput
+  ): import("@smithy/smithy-client").CommandImpl<
+    GetFindingsStatisticsCommandInput,
+    GetFindingsStatisticsCommandOutput,
+    AccessAnalyzerClientResolvedConfig,
+    ServiceInputTypes,
+    ServiceOutputTypes
+  >;
+  getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
+};
+export declare class GetFindingsStatisticsCommand extends GetFindingsStatisticsCommand_base {
+  protected static __types: {
+    api: {
+      input: GetFindingsStatisticsRequest;
+      output: GetFindingsStatisticsResponse;
+    };
+    sdk: {
+      input: GetFindingsStatisticsCommandInput;
+      output: GetFindingsStatisticsCommandOutput;
+    };
+  };
+}

package/dist-types/ts3.4/commands/index.d.ts

@@ -16,6 +16,7 @@ export * from "./GetArchiveRuleCommand";
 export * from "./GetFindingCommand";
 export * from "./GetFindingRecommendationCommand";
 export * from "./GetFindingV2Command";
+export * from "./GetFindingsStatisticsCommand";
 export * from "./GetGeneratedPolicyCommand";
 export * from "./ListAccessPreviewFindingsCommand";
 export * from "./ListAccessPreviewsCommand";

package/dist-types/ts3.4/models/models_0.d.ts

@@ -1008,6 +1008,72 @@ export interface GetFindingRecommendationResponse {
   recommendationType: RecommendationType | undefined;
   status: Status | undefined;
 }
+export interface GetFindingsStatisticsRequest {
+  analyzerArn: string | undefined;
+}
+export interface ResourceTypeDetails {
+  totalActivePublic?: number | undefined;
+  totalActiveCrossAccount?: number | undefined;
+}
+export interface ExternalAccessFindingsStatistics {
+  resourceTypeStatistics?:
+    | Partial<Record<ResourceType, ResourceTypeDetails>>
+    | undefined;
+  totalActiveFindings?: number | undefined;
+  totalArchivedFindings?: number | undefined;
+  totalResolvedFindings?: number | undefined;
+}
+export interface FindingAggregationAccountDetails {
+  account?: string | undefined;
+  numberOfActiveFindings?: number | undefined;
+  details?: Record<string, number> | undefined;
+}
+export interface UnusedAccessTypeStatistics {
+  unusedAccessType?: string | undefined;
+  total?: number | undefined;
+}
+export interface UnusedAccessFindingsStatistics {
+  unusedAccessTypeStatistics?: UnusedAccessTypeStatistics[] | undefined;
+  topAccounts?: FindingAggregationAccountDetails[] | undefined;
+  totalActiveFindings?: number | undefined;
+  totalArchivedFindings?: number | undefined;
+  totalResolvedFindings?: number | undefined;
+}
+export type FindingsStatistics =
+  | FindingsStatistics.ExternalAccessFindingsStatisticsMember
+  | FindingsStatistics.UnusedAccessFindingsStatisticsMember
+  | FindingsStatistics.$UnknownMember;
+export declare namespace FindingsStatistics {
+  interface ExternalAccessFindingsStatisticsMember {
+    externalAccessFindingsStatistics: ExternalAccessFindingsStatistics;
+    unusedAccessFindingsStatistics?: never;
+    $unknown?: never;
+  }
+  interface UnusedAccessFindingsStatisticsMember {
+    externalAccessFindingsStatistics?: never;
+    unusedAccessFindingsStatistics: UnusedAccessFindingsStatistics;
+    $unknown?: never;
+  }
+  interface $UnknownMember {
+    externalAccessFindingsStatistics?: never;
+    unusedAccessFindingsStatistics?: never;
+    $unknown: [string, any];
+  }
+  interface Visitor<T> {
+    externalAccessFindingsStatistics: (
+      value: ExternalAccessFindingsStatistics
+    ) => T;
+    unusedAccessFindingsStatistics: (
+      value: UnusedAccessFindingsStatistics
+    ) => T;
+    _: (name: string, value: any) => T;
+  }
+  const visit: <T>(value: FindingsStatistics, visitor: Visitor<T>) => T;
+}
+export interface GetFindingsStatisticsResponse {
+  findingsStatistics?: FindingsStatistics[] | undefined;
+  lastUpdatedAt?: Date | undefined;
+}
 export interface GetFindingV2Request {
   analyzerArn: string | undefined;
   id: string | undefined;

package/dist-types/ts3.4/protocols/Aws_restJson1.d.ts

@@ -71,6 +71,10 @@ import {
   GetFindingRecommendationCommandInput,
   GetFindingRecommendationCommandOutput,
 } from "../commands/GetFindingRecommendationCommand";
+import {
+  GetFindingsStatisticsCommandInput,
+  GetFindingsStatisticsCommandOutput,
+} from "../commands/GetFindingsStatisticsCommand";
 import {
   GetFindingV2CommandInput,
   GetFindingV2CommandOutput,
@@ -215,6 +219,10 @@ export declare const se_GetFindingRecommendationCommand: (
   input: GetFindingRecommendationCommandInput,
   context: __SerdeContext
 ) => Promise<__HttpRequest>;
+export declare const se_GetFindingsStatisticsCommand: (
+  input: GetFindingsStatisticsCommandInput,
+  context: __SerdeContext
+) => Promise<__HttpRequest>;
 export declare const se_GetFindingV2Command: (
   input: GetFindingV2CommandInput,
   context: __SerdeContext
@@ -359,6 +367,10 @@ export declare const de_GetFindingRecommendationCommand: (
   output: __HttpResponse,
   context: __SerdeContext
 ) => Promise<GetFindingRecommendationCommandOutput>;
+export declare const de_GetFindingsStatisticsCommand: (
+  output: __HttpResponse,
+  context: __SerdeContext
+) => Promise<GetFindingsStatisticsCommandOutput>;
 export declare const de_GetFindingV2Command: (
   output: __HttpResponse,
   context: __SerdeContext

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@aws-sdk/client-accessanalyzer",
   "description": "AWS SDK for JavaScript Accessanalyzer Client for Node.js, Browser and React Native",
-  "version": "3.744.0",
+  "version": "3.748.0",
   "scripts": {
     "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
     "build:cjs": "node ../../scripts/compilation/inline client-accessanalyzer",