@aws-sdk/client-accessanalyzer 3.454.0 → 3.460.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (52) hide show
  1. package/README.md +84 -37
  2. package/dist-cjs/AccessAnalyzer.js +8 -0
  3. package/dist-cjs/commands/CheckAccessNotGrantedCommand.js +52 -0
  4. package/dist-cjs/commands/CheckNoNewAccessCommand.js +52 -0
  5. package/dist-cjs/commands/GetFindingV2Command.js +51 -0
  6. package/dist-cjs/commands/ListFindingsV2Command.js +51 -0
  7. package/dist-cjs/commands/index.js +4 -0
  8. package/dist-cjs/models/models_0.js +83 -1
  9. package/dist-cjs/pagination/GetFindingV2Paginator.js +29 -0
  10. package/dist-cjs/pagination/ListFindingsV2Paginator.js +29 -0
  11. package/dist-cjs/pagination/index.js +2 -0
  12. package/dist-cjs/protocols/Aws_restJson1.js +426 -2
  13. package/dist-es/AccessAnalyzer.js +8 -0
  14. package/dist-es/commands/CheckAccessNotGrantedCommand.js +48 -0
  15. package/dist-es/commands/CheckNoNewAccessCommand.js +48 -0
  16. package/dist-es/commands/GetFindingV2Command.js +47 -0
  17. package/dist-es/commands/ListFindingsV2Command.js +47 -0
  18. package/dist-es/commands/index.js +4 -0
  19. package/dist-es/models/models_0.js +78 -0
  20. package/dist-es/pagination/GetFindingV2Paginator.js +25 -0
  21. package/dist-es/pagination/ListFindingsV2Paginator.js +25 -0
  22. package/dist-es/pagination/index.js +2 -0
  23. package/dist-es/protocols/Aws_restJson1.js +417 -1
  24. package/dist-types/AccessAnalyzer.d.ts +52 -9
  25. package/dist-types/AccessAnalyzerClient.d.ts +30 -11
  26. package/dist-types/commands/CheckAccessNotGrantedCommand.d.ts +107 -0
  27. package/dist-types/commands/CheckNoNewAccessCommand.d.ts +106 -0
  28. package/dist-types/commands/CreateAnalyzerCommand.d.ts +5 -0
  29. package/dist-types/commands/GetAnalyzerCommand.d.ts +5 -0
  30. package/dist-types/commands/GetFindingV2Command.d.ts +146 -0
  31. package/dist-types/commands/ListAnalyzersCommand.d.ts +5 -0
  32. package/dist-types/commands/ListFindingsV2Command.d.ts +123 -0
  33. package/dist-types/commands/index.d.ts +4 -0
  34. package/dist-types/index.d.ts +24 -9
  35. package/dist-types/models/models_0.d.ts +705 -11
  36. package/dist-types/pagination/GetFindingV2Paginator.d.ts +7 -0
  37. package/dist-types/pagination/ListFindingsV2Paginator.d.ts +7 -0
  38. package/dist-types/pagination/index.d.ts +2 -0
  39. package/dist-types/protocols/Aws_restJson1.d.ts +36 -0
  40. package/dist-types/ts3.4/AccessAnalyzer.d.ts +68 -0
  41. package/dist-types/ts3.4/AccessAnalyzerClient.d.ts +24 -0
  42. package/dist-types/ts3.4/commands/CheckAccessNotGrantedCommand.d.ts +42 -0
  43. package/dist-types/ts3.4/commands/CheckNoNewAccessCommand.d.ts +38 -0
  44. package/dist-types/ts3.4/commands/GetFindingV2Command.d.ts +35 -0
  45. package/dist-types/ts3.4/commands/ListFindingsV2Command.d.ts +38 -0
  46. package/dist-types/ts3.4/commands/index.d.ts +4 -0
  47. package/dist-types/ts3.4/models/models_0.d.ts +238 -1
  48. package/dist-types/ts3.4/pagination/GetFindingV2Paginator.d.ts +11 -0
  49. package/dist-types/ts3.4/pagination/ListFindingsV2Paginator.d.ts +11 -0
  50. package/dist-types/ts3.4/pagination/index.d.ts +2 -0
  51. package/dist-types/ts3.4/protocols/Aws_restJson1.d.ts +48 -0
  52. package/package.json +12 -12
@@ -10,6 +10,8 @@ import { Client as __Client, DefaultsMode as __DefaultsMode, SmithyConfiguration
10
10
  import { BodyLengthCalculator as __BodyLengthCalculator, CheckOptionalClientConfig as __CheckOptionalClientConfig, ChecksumConstructor as __ChecksumConstructor, Decoder as __Decoder, Encoder as __Encoder, HashConstructor as __HashConstructor, HttpHandlerOptions as __HttpHandlerOptions, Logger as __Logger, Provider as __Provider, Provider, StreamCollector as __StreamCollector, UrlParser as __UrlParser, UserAgent as __UserAgent } from "@smithy/types";
11
11
  import { ApplyArchiveRuleCommandInput, ApplyArchiveRuleCommandOutput } from "./commands/ApplyArchiveRuleCommand";
12
12
  import { CancelPolicyGenerationCommandInput, CancelPolicyGenerationCommandOutput } from "./commands/CancelPolicyGenerationCommand";
13
+ import { CheckAccessNotGrantedCommandInput, CheckAccessNotGrantedCommandOutput } from "./commands/CheckAccessNotGrantedCommand";
14
+ import { CheckNoNewAccessCommandInput, CheckNoNewAccessCommandOutput } from "./commands/CheckNoNewAccessCommand";
13
15
  import { CreateAccessPreviewCommandInput, CreateAccessPreviewCommandOutput } from "./commands/CreateAccessPreviewCommand";
14
16
  import { CreateAnalyzerCommandInput, CreateAnalyzerCommandOutput } from "./commands/CreateAnalyzerCommand";
15
17
  import { CreateArchiveRuleCommandInput, CreateArchiveRuleCommandOutput } from "./commands/CreateArchiveRuleCommand";
@@ -20,6 +22,7 @@ import { GetAnalyzedResourceCommandInput, GetAnalyzedResourceCommandOutput } fro
20
22
  import { GetAnalyzerCommandInput, GetAnalyzerCommandOutput } from "./commands/GetAnalyzerCommand";
21
23
  import { GetArchiveRuleCommandInput, GetArchiveRuleCommandOutput } from "./commands/GetArchiveRuleCommand";
22
24
  import { GetFindingCommandInput, GetFindingCommandOutput } from "./commands/GetFindingCommand";
25
+ import { GetFindingV2CommandInput, GetFindingV2CommandOutput } from "./commands/GetFindingV2Command";
23
26
  import { GetGeneratedPolicyCommandInput, GetGeneratedPolicyCommandOutput } from "./commands/GetGeneratedPolicyCommand";
24
27
  import { ListAccessPreviewFindingsCommandInput, ListAccessPreviewFindingsCommandOutput } from "./commands/ListAccessPreviewFindingsCommand";
25
28
  import { ListAccessPreviewsCommandInput, ListAccessPreviewsCommandOutput } from "./commands/ListAccessPreviewsCommand";
@@ -27,6 +30,7 @@ import { ListAnalyzedResourcesCommandInput, ListAnalyzedResourcesCommandOutput }
27
30
  import { ListAnalyzersCommandInput, ListAnalyzersCommandOutput } from "./commands/ListAnalyzersCommand";
28
31
  import { ListArchiveRulesCommandInput, ListArchiveRulesCommandOutput } from "./commands/ListArchiveRulesCommand";
29
32
  import { ListFindingsCommandInput, ListFindingsCommandOutput } from "./commands/ListFindingsCommand";
33
+ import { ListFindingsV2CommandInput, ListFindingsV2CommandOutput } from "./commands/ListFindingsV2Command";
30
34
  import { ListPolicyGenerationsCommandInput, ListPolicyGenerationsCommandOutput } from "./commands/ListPolicyGenerationsCommand";
31
35
  import { ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput } from "./commands/ListTagsForResourceCommand";
32
36
  import { StartPolicyGenerationCommandInput, StartPolicyGenerationCommandOutput } from "./commands/StartPolicyGenerationCommand";
@@ -42,11 +46,11 @@ export { __Client };
42
46
  /**
43
47
  * @public
44
48
  */
45
- export type ServiceInputTypes = ApplyArchiveRuleCommandInput | CancelPolicyGenerationCommandInput | CreateAccessPreviewCommandInput | CreateAnalyzerCommandInput | CreateArchiveRuleCommandInput | DeleteAnalyzerCommandInput | DeleteArchiveRuleCommandInput | GetAccessPreviewCommandInput | GetAnalyzedResourceCommandInput | GetAnalyzerCommandInput | GetArchiveRuleCommandInput | GetFindingCommandInput | GetGeneratedPolicyCommandInput | ListAccessPreviewFindingsCommandInput | ListAccessPreviewsCommandInput | ListAnalyzedResourcesCommandInput | ListAnalyzersCommandInput | ListArchiveRulesCommandInput | ListFindingsCommandInput | ListPolicyGenerationsCommandInput | ListTagsForResourceCommandInput | StartPolicyGenerationCommandInput | StartResourceScanCommandInput | TagResourceCommandInput | UntagResourceCommandInput | UpdateArchiveRuleCommandInput | UpdateFindingsCommandInput | ValidatePolicyCommandInput;
49
+ export type ServiceInputTypes = ApplyArchiveRuleCommandInput | CancelPolicyGenerationCommandInput | CheckAccessNotGrantedCommandInput | CheckNoNewAccessCommandInput | CreateAccessPreviewCommandInput | CreateAnalyzerCommandInput | CreateArchiveRuleCommandInput | DeleteAnalyzerCommandInput | DeleteArchiveRuleCommandInput | GetAccessPreviewCommandInput | GetAnalyzedResourceCommandInput | GetAnalyzerCommandInput | GetArchiveRuleCommandInput | GetFindingCommandInput | GetFindingV2CommandInput | GetGeneratedPolicyCommandInput | ListAccessPreviewFindingsCommandInput | ListAccessPreviewsCommandInput | ListAnalyzedResourcesCommandInput | ListAnalyzersCommandInput | ListArchiveRulesCommandInput | ListFindingsCommandInput | ListFindingsV2CommandInput | ListPolicyGenerationsCommandInput | ListTagsForResourceCommandInput | StartPolicyGenerationCommandInput | StartResourceScanCommandInput | TagResourceCommandInput | UntagResourceCommandInput | UpdateArchiveRuleCommandInput | UpdateFindingsCommandInput | ValidatePolicyCommandInput;
46
50
  /**
47
51
  * @public
48
52
  */
49
- export type ServiceOutputTypes = ApplyArchiveRuleCommandOutput | CancelPolicyGenerationCommandOutput | CreateAccessPreviewCommandOutput | CreateAnalyzerCommandOutput | CreateArchiveRuleCommandOutput | DeleteAnalyzerCommandOutput | DeleteArchiveRuleCommandOutput | GetAccessPreviewCommandOutput | GetAnalyzedResourceCommandOutput | GetAnalyzerCommandOutput | GetArchiveRuleCommandOutput | GetFindingCommandOutput | GetGeneratedPolicyCommandOutput | ListAccessPreviewFindingsCommandOutput | ListAccessPreviewsCommandOutput | ListAnalyzedResourcesCommandOutput | ListAnalyzersCommandOutput | ListArchiveRulesCommandOutput | ListFindingsCommandOutput | ListPolicyGenerationsCommandOutput | ListTagsForResourceCommandOutput | StartPolicyGenerationCommandOutput | StartResourceScanCommandOutput | TagResourceCommandOutput | UntagResourceCommandOutput | UpdateArchiveRuleCommandOutput | UpdateFindingsCommandOutput | ValidatePolicyCommandOutput;
53
+ export type ServiceOutputTypes = ApplyArchiveRuleCommandOutput | CancelPolicyGenerationCommandOutput | CheckAccessNotGrantedCommandOutput | CheckNoNewAccessCommandOutput | CreateAccessPreviewCommandOutput | CreateAnalyzerCommandOutput | CreateArchiveRuleCommandOutput | DeleteAnalyzerCommandOutput | DeleteArchiveRuleCommandOutput | GetAccessPreviewCommandOutput | GetAnalyzedResourceCommandOutput | GetAnalyzerCommandOutput | GetArchiveRuleCommandOutput | GetFindingCommandOutput | GetFindingV2CommandOutput | GetGeneratedPolicyCommandOutput | ListAccessPreviewFindingsCommandOutput | ListAccessPreviewsCommandOutput | ListAnalyzedResourcesCommandOutput | ListAnalyzersCommandOutput | ListArchiveRulesCommandOutput | ListFindingsCommandOutput | ListFindingsV2CommandOutput | ListPolicyGenerationsCommandOutput | ListTagsForResourceCommandOutput | StartPolicyGenerationCommandOutput | StartResourceScanCommandOutput | TagResourceCommandOutput | UntagResourceCommandOutput | UpdateArchiveRuleCommandOutput | UpdateFindingsCommandOutput | ValidatePolicyCommandOutput;
50
54
  /**
51
55
  * @public
52
56
  */
@@ -180,15 +184,30 @@ export interface AccessAnalyzerClientResolvedConfig extends AccessAnalyzerClient
180
184
  }
181
185
  /**
182
186
  * @public
183
- * <p>Identity and Access Management Access Analyzer helps identify potential resource-access risks by enabling you to
184
- * identify any policies that grant access to an external principal. It does this by using
185
- * logic-based reasoning to analyze resource-based policies in your Amazon Web Services environment. An
186
- * external principal can be another Amazon Web Services account, a root user, an IAM user or role, a
187
- * federated user, an Amazon Web Services service, or an anonymous user. You can also use IAM Access Analyzer to
188
- * preview and validate public and cross-account access to your resources before deploying
189
- * permissions changes. This guide describes the Identity and Access Management Access Analyzer operations that you can
190
- * call programmatically. For general information about IAM Access Analyzer, see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/what-is-access-analyzer.html">Identity and Access Management Access Analyzer</a> in the <b>IAM User Guide</b>.</p>
191
- * <p>To start using IAM Access Analyzer, you first need to create an analyzer.</p>
187
+ * <p>Identity and Access Management Access Analyzer helps you to set, verify, and refine your IAM policies by providing
188
+ * a suite of capabilities. Its features include findings for external and unused access,
189
+ * basic and custom policy checks for validating policies, and policy generation to generate
190
+ * fine-grained policies. To start using IAM Access Analyzer to identify external or unused access,
191
+ * you first need to create an analyzer.</p>
192
+ * <p>
193
+ * <b>External access analyzers</b> help identify potential risks
194
+ * of accessing resources by enabling you to identify any resource policies that grant access
195
+ * to an external principal. It does this by using logic-based reasoning to analyze
196
+ * resource-based policies in your Amazon Web Services environment. An external principal can be another
197
+ * Amazon Web Services account, a root user, an IAM user or role, a federated user, an Amazon Web Services service, or an
198
+ * anonymous user. You can also use IAM Access Analyzer to preview public and cross-account access
199
+ * to your resources before deploying permissions changes.</p>
200
+ * <p>
201
+ * <b>Unused access analyzers</b> help identify potential
202
+ * identity access risks by enabling you to identify unused IAM roles, unused access keys,
203
+ * unused console passwords, and IAM principals with unused service and action-level
204
+ * permissions.</p>
205
+ * <p>Beyond findings, IAM Access Analyzer provides basic and custom policy checks to validate IAM
206
+ * policies before deploying permissions changes. You can use policy generation to refine
207
+ * permissions by attaching a policy generated using access activity logged in CloudTrail logs. </p>
208
+ * <p>This guide describes the IAM Access Analyzer operations that you can call programmatically.
209
+ * For general information about IAM Access Analyzer, see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/what-is-access-analyzer.html">Identity and Access Management Access Analyzer</a> in the
210
+ * <b>IAM User Guide</b>.</p>
192
211
  */
193
212
  export declare class AccessAnalyzerClient extends __Client<__HttpHandlerOptions, ServiceInputTypes, ServiceOutputTypes, AccessAnalyzerClientResolvedConfig> {
194
213
  /**
@@ -0,0 +1,107 @@
1
+ import { EndpointParameterInstructions } from "@smithy/middleware-endpoint";
2
+ import { Command as $Command } from "@smithy/smithy-client";
3
+ import { Handler, HttpHandlerOptions as __HttpHandlerOptions, MetadataBearer as __MetadataBearer, MiddlewareStack } from "@smithy/types";
4
+ import { AccessAnalyzerClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../AccessAnalyzerClient";
5
+ import { CheckAccessNotGrantedRequest, CheckAccessNotGrantedResponse } from "../models/models_0";
6
+ /**
7
+ * @public
8
+ */
9
+ export { __MetadataBearer, $Command };
10
+ /**
11
+ * @public
12
+ *
13
+ * The input for {@link CheckAccessNotGrantedCommand}.
14
+ */
15
+ export interface CheckAccessNotGrantedCommandInput extends CheckAccessNotGrantedRequest {
16
+ }
17
+ /**
18
+ * @public
19
+ *
20
+ * The output of {@link CheckAccessNotGrantedCommand}.
21
+ */
22
+ export interface CheckAccessNotGrantedCommandOutput extends CheckAccessNotGrantedResponse, __MetadataBearer {
23
+ }
24
+ /**
25
+ * @public
26
+ * <p>Checks whether the specified access isn't allowed by a policy.</p>
27
+ * @example
28
+ * Use a bare-bones client and the command you need to make an API call.
29
+ * ```javascript
30
+ * import { AccessAnalyzerClient, CheckAccessNotGrantedCommand } from "@aws-sdk/client-accessanalyzer"; // ES Modules import
31
+ * // const { AccessAnalyzerClient, CheckAccessNotGrantedCommand } = require("@aws-sdk/client-accessanalyzer"); // CommonJS import
32
+ * const client = new AccessAnalyzerClient(config);
33
+ * const input = { // CheckAccessNotGrantedRequest
34
+ * policyDocument: "STRING_VALUE", // required
35
+ * access: [ // AccessList // required
36
+ * { // Access
37
+ * actions: [ // ActionsList // required
38
+ * "STRING_VALUE",
39
+ * ],
40
+ * },
41
+ * ],
42
+ * policyType: "STRING_VALUE", // required
43
+ * };
44
+ * const command = new CheckAccessNotGrantedCommand(input);
45
+ * const response = await client.send(command);
46
+ * // { // CheckAccessNotGrantedResponse
47
+ * // result: "STRING_VALUE",
48
+ * // message: "STRING_VALUE",
49
+ * // reasons: [ // ReasonSummaryList
50
+ * // { // ReasonSummary
51
+ * // description: "STRING_VALUE",
52
+ * // statementIndex: Number("int"),
53
+ * // statementId: "STRING_VALUE",
54
+ * // },
55
+ * // ],
56
+ * // };
57
+ *
58
+ * ```
59
+ *
60
+ * @param CheckAccessNotGrantedCommandInput - {@link CheckAccessNotGrantedCommandInput}
61
+ * @returns {@link CheckAccessNotGrantedCommandOutput}
62
+ * @see {@link CheckAccessNotGrantedCommandInput} for command's `input` shape.
63
+ * @see {@link CheckAccessNotGrantedCommandOutput} for command's `response` shape.
64
+ * @see {@link AccessAnalyzerClientResolvedConfig | config} for AccessAnalyzerClient's `config` shape.
65
+ *
66
+ * @throws {@link AccessDeniedException} (client fault)
67
+ * <p>You do not have sufficient access to perform this action.</p>
68
+ *
69
+ * @throws {@link InternalServerException} (server fault)
70
+ * <p>Internal server error.</p>
71
+ *
72
+ * @throws {@link InvalidParameterException} (client fault)
73
+ * <p>The specified parameter is invalid.</p>
74
+ *
75
+ * @throws {@link ThrottlingException} (client fault)
76
+ * <p>Throttling limit exceeded error.</p>
77
+ *
78
+ * @throws {@link UnprocessableEntityException} (client fault)
79
+ * <p>The specified entity could not be processed.</p>
80
+ *
81
+ * @throws {@link ValidationException} (client fault)
82
+ * <p>Validation exception error.</p>
83
+ *
84
+ * @throws {@link AccessAnalyzerServiceException}
85
+ * <p>Base exception class for all service exceptions from AccessAnalyzer service.</p>
86
+ *
87
+ */
88
+ export declare class CheckAccessNotGrantedCommand extends $Command<CheckAccessNotGrantedCommandInput, CheckAccessNotGrantedCommandOutput, AccessAnalyzerClientResolvedConfig> {
89
+ readonly input: CheckAccessNotGrantedCommandInput;
90
+ static getEndpointParameterInstructions(): EndpointParameterInstructions;
91
+ /**
92
+ * @public
93
+ */
94
+ constructor(input: CheckAccessNotGrantedCommandInput);
95
+ /**
96
+ * @internal
97
+ */
98
+ resolveMiddleware(clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: AccessAnalyzerClientResolvedConfig, options?: __HttpHandlerOptions): Handler<CheckAccessNotGrantedCommandInput, CheckAccessNotGrantedCommandOutput>;
99
+ /**
100
+ * @internal
101
+ */
102
+ private serialize;
103
+ /**
104
+ * @internal
105
+ */
106
+ private deserialize;
107
+ }
@@ -0,0 +1,106 @@
1
+ import { EndpointParameterInstructions } from "@smithy/middleware-endpoint";
2
+ import { Command as $Command } from "@smithy/smithy-client";
3
+ import { Handler, HttpHandlerOptions as __HttpHandlerOptions, MetadataBearer as __MetadataBearer, MiddlewareStack } from "@smithy/types";
4
+ import { AccessAnalyzerClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../AccessAnalyzerClient";
5
+ import { CheckNoNewAccessRequest, CheckNoNewAccessResponse } from "../models/models_0";
6
+ /**
7
+ * @public
8
+ */
9
+ export { __MetadataBearer, $Command };
10
+ /**
11
+ * @public
12
+ *
13
+ * The input for {@link CheckNoNewAccessCommand}.
14
+ */
15
+ export interface CheckNoNewAccessCommandInput extends CheckNoNewAccessRequest {
16
+ }
17
+ /**
18
+ * @public
19
+ *
20
+ * The output of {@link CheckNoNewAccessCommand}.
21
+ */
22
+ export interface CheckNoNewAccessCommandOutput extends CheckNoNewAccessResponse, __MetadataBearer {
23
+ }
24
+ /**
25
+ * @public
26
+ * <p>Checks whether new access is allowed for an updated policy when compared to the existing
27
+ * policy.</p>
28
+ * <p>You can find examples for reference policies and learn how to set up and run a custom
29
+ * policy check for new access in the <a href="https://github.com/aws-samples/iam-access-analyzer-custom-policy-check-samples">IAM Access Analyzer custom policy checks samples</a> repository on GitHub. The reference
30
+ * policies in this repository are meant to be passed to the
31
+ * <code>existingPolicyDocument</code> request parameter.</p>
32
+ * @example
33
+ * Use a bare-bones client and the command you need to make an API call.
34
+ * ```javascript
35
+ * import { AccessAnalyzerClient, CheckNoNewAccessCommand } from "@aws-sdk/client-accessanalyzer"; // ES Modules import
36
+ * // const { AccessAnalyzerClient, CheckNoNewAccessCommand } = require("@aws-sdk/client-accessanalyzer"); // CommonJS import
37
+ * const client = new AccessAnalyzerClient(config);
38
+ * const input = { // CheckNoNewAccessRequest
39
+ * newPolicyDocument: "STRING_VALUE", // required
40
+ * existingPolicyDocument: "STRING_VALUE", // required
41
+ * policyType: "STRING_VALUE", // required
42
+ * };
43
+ * const command = new CheckNoNewAccessCommand(input);
44
+ * const response = await client.send(command);
45
+ * // { // CheckNoNewAccessResponse
46
+ * // result: "STRING_VALUE",
47
+ * // message: "STRING_VALUE",
48
+ * // reasons: [ // ReasonSummaryList
49
+ * // { // ReasonSummary
50
+ * // description: "STRING_VALUE",
51
+ * // statementIndex: Number("int"),
52
+ * // statementId: "STRING_VALUE",
53
+ * // },
54
+ * // ],
55
+ * // };
56
+ *
57
+ * ```
58
+ *
59
+ * @param CheckNoNewAccessCommandInput - {@link CheckNoNewAccessCommandInput}
60
+ * @returns {@link CheckNoNewAccessCommandOutput}
61
+ * @see {@link CheckNoNewAccessCommandInput} for command's `input` shape.
62
+ * @see {@link CheckNoNewAccessCommandOutput} for command's `response` shape.
63
+ * @see {@link AccessAnalyzerClientResolvedConfig | config} for AccessAnalyzerClient's `config` shape.
64
+ *
65
+ * @throws {@link AccessDeniedException} (client fault)
66
+ * <p>You do not have sufficient access to perform this action.</p>
67
+ *
68
+ * @throws {@link InternalServerException} (server fault)
69
+ * <p>Internal server error.</p>
70
+ *
71
+ * @throws {@link InvalidParameterException} (client fault)
72
+ * <p>The specified parameter is invalid.</p>
73
+ *
74
+ * @throws {@link ThrottlingException} (client fault)
75
+ * <p>Throttling limit exceeded error.</p>
76
+ *
77
+ * @throws {@link UnprocessableEntityException} (client fault)
78
+ * <p>The specified entity could not be processed.</p>
79
+ *
80
+ * @throws {@link ValidationException} (client fault)
81
+ * <p>Validation exception error.</p>
82
+ *
83
+ * @throws {@link AccessAnalyzerServiceException}
84
+ * <p>Base exception class for all service exceptions from AccessAnalyzer service.</p>
85
+ *
86
+ */
87
+ export declare class CheckNoNewAccessCommand extends $Command<CheckNoNewAccessCommandInput, CheckNoNewAccessCommandOutput, AccessAnalyzerClientResolvedConfig> {
88
+ readonly input: CheckNoNewAccessCommandInput;
89
+ static getEndpointParameterInstructions(): EndpointParameterInstructions;
90
+ /**
91
+ * @public
92
+ */
93
+ constructor(input: CheckNoNewAccessCommandInput);
94
+ /**
95
+ * @internal
96
+ */
97
+ resolveMiddleware(clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: AccessAnalyzerClientResolvedConfig, options?: __HttpHandlerOptions): Handler<CheckNoNewAccessCommandInput, CheckNoNewAccessCommandOutput>;
98
+ /**
99
+ * @internal
100
+ */
101
+ private serialize;
102
+ /**
103
+ * @internal
104
+ */
105
+ private deserialize;
106
+ }
@@ -56,6 +56,11 @@ export interface CreateAnalyzerCommandOutput extends CreateAnalyzerResponse, __M
56
56
  * "<keys>": "STRING_VALUE",
57
57
  * },
58
58
  * clientToken: "STRING_VALUE",
59
+ * configuration: { // AnalyzerConfiguration Union: only one key present
60
+ * unusedAccess: { // UnusedAccessConfiguration
61
+ * unusedAccessAge: Number("int"),
62
+ * },
63
+ * },
59
64
  * };
60
65
  * const command = new CreateAnalyzerCommand(input);
61
66
  * const response = await client.send(command);
@@ -50,6 +50,11 @@ export interface GetAnalyzerCommandOutput extends GetAnalyzerResponse, __Metadat
50
50
  * // statusReason: { // StatusReason
51
51
  * // code: "STRING_VALUE", // required
52
52
  * // },
53
+ * // configuration: { // AnalyzerConfiguration Union: only one key present
54
+ * // unusedAccess: { // UnusedAccessConfiguration
55
+ * // unusedAccessAge: Number("int"),
56
+ * // },
57
+ * // },
53
58
  * // },
54
59
  * // };
55
60
  *
@@ -0,0 +1,146 @@
1
+ import { EndpointParameterInstructions } from "@smithy/middleware-endpoint";
2
+ import { Command as $Command } from "@smithy/smithy-client";
3
+ import { Handler, HttpHandlerOptions as __HttpHandlerOptions, MetadataBearer as __MetadataBearer, MiddlewareStack } from "@smithy/types";
4
+ import { AccessAnalyzerClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../AccessAnalyzerClient";
5
+ import { GetFindingV2Request, GetFindingV2Response } from "../models/models_0";
6
+ /**
7
+ * @public
8
+ */
9
+ export { __MetadataBearer, $Command };
10
+ /**
11
+ * @public
12
+ *
13
+ * The input for {@link GetFindingV2Command}.
14
+ */
15
+ export interface GetFindingV2CommandInput extends GetFindingV2Request {
16
+ }
17
+ /**
18
+ * @public
19
+ *
20
+ * The output of {@link GetFindingV2Command}.
21
+ */
22
+ export interface GetFindingV2CommandOutput extends GetFindingV2Response, __MetadataBearer {
23
+ }
24
+ /**
25
+ * @public
26
+ * <p>Retrieves information about the specified finding.</p>
27
+ * @example
28
+ * Use a bare-bones client and the command you need to make an API call.
29
+ * ```javascript
30
+ * import { AccessAnalyzerClient, GetFindingV2Command } from "@aws-sdk/client-accessanalyzer"; // ES Modules import
31
+ * // const { AccessAnalyzerClient, GetFindingV2Command } = require("@aws-sdk/client-accessanalyzer"); // CommonJS import
32
+ * const client = new AccessAnalyzerClient(config);
33
+ * const input = { // GetFindingV2Request
34
+ * analyzerArn: "STRING_VALUE", // required
35
+ * id: "STRING_VALUE", // required
36
+ * maxResults: Number("int"),
37
+ * nextToken: "STRING_VALUE",
38
+ * };
39
+ * const command = new GetFindingV2Command(input);
40
+ * const response = await client.send(command);
41
+ * // { // GetFindingV2Response
42
+ * // analyzedAt: new Date("TIMESTAMP"), // required
43
+ * // createdAt: new Date("TIMESTAMP"), // required
44
+ * // error: "STRING_VALUE",
45
+ * // id: "STRING_VALUE", // required
46
+ * // nextToken: "STRING_VALUE",
47
+ * // resource: "STRING_VALUE",
48
+ * // resourceType: "STRING_VALUE", // required
49
+ * // resourceOwnerAccount: "STRING_VALUE", // required
50
+ * // status: "STRING_VALUE", // required
51
+ * // updatedAt: new Date("TIMESTAMP"), // required
52
+ * // findingDetails: [ // FindingDetailsList // required
53
+ * // { // FindingDetails Union: only one key present
54
+ * // externalAccessDetails: { // ExternalAccessDetails
55
+ * // action: [ // ActionList
56
+ * // "STRING_VALUE",
57
+ * // ],
58
+ * // condition: { // ConditionKeyMap // required
59
+ * // "<keys>": "STRING_VALUE",
60
+ * // },
61
+ * // isPublic: true || false,
62
+ * // principal: { // PrincipalMap
63
+ * // "<keys>": "STRING_VALUE",
64
+ * // },
65
+ * // sources: [ // FindingSourceList
66
+ * // { // FindingSource
67
+ * // type: "STRING_VALUE", // required
68
+ * // detail: { // FindingSourceDetail
69
+ * // accessPointArn: "STRING_VALUE",
70
+ * // accessPointAccount: "STRING_VALUE",
71
+ * // },
72
+ * // },
73
+ * // ],
74
+ * // },
75
+ * // unusedPermissionDetails: { // UnusedPermissionDetails
76
+ * // actions: [ // UnusedActionList
77
+ * // { // UnusedAction
78
+ * // action: "STRING_VALUE", // required
79
+ * // lastAccessed: new Date("TIMESTAMP"),
80
+ * // },
81
+ * // ],
82
+ * // serviceNamespace: "STRING_VALUE", // required
83
+ * // lastAccessed: new Date("TIMESTAMP"),
84
+ * // },
85
+ * // unusedIamUserAccessKeyDetails: { // UnusedIamUserAccessKeyDetails
86
+ * // accessKeyId: "STRING_VALUE", // required
87
+ * // lastAccessed: new Date("TIMESTAMP"),
88
+ * // },
89
+ * // unusedIamRoleDetails: { // UnusedIamRoleDetails
90
+ * // lastAccessed: new Date("TIMESTAMP"),
91
+ * // },
92
+ * // unusedIamUserPasswordDetails: { // UnusedIamUserPasswordDetails
93
+ * // lastAccessed: new Date("TIMESTAMP"),
94
+ * // },
95
+ * // },
96
+ * // ],
97
+ * // findingType: "STRING_VALUE",
98
+ * // };
99
+ *
100
+ * ```
101
+ *
102
+ * @param GetFindingV2CommandInput - {@link GetFindingV2CommandInput}
103
+ * @returns {@link GetFindingV2CommandOutput}
104
+ * @see {@link GetFindingV2CommandInput} for command's `input` shape.
105
+ * @see {@link GetFindingV2CommandOutput} for command's `response` shape.
106
+ * @see {@link AccessAnalyzerClientResolvedConfig | config} for AccessAnalyzerClient's `config` shape.
107
+ *
108
+ * @throws {@link AccessDeniedException} (client fault)
109
+ * <p>You do not have sufficient access to perform this action.</p>
110
+ *
111
+ * @throws {@link InternalServerException} (server fault)
112
+ * <p>Internal server error.</p>
113
+ *
114
+ * @throws {@link ResourceNotFoundException} (client fault)
115
+ * <p>The specified resource could not be found.</p>
116
+ *
117
+ * @throws {@link ThrottlingException} (client fault)
118
+ * <p>Throttling limit exceeded error.</p>
119
+ *
120
+ * @throws {@link ValidationException} (client fault)
121
+ * <p>Validation exception error.</p>
122
+ *
123
+ * @throws {@link AccessAnalyzerServiceException}
124
+ * <p>Base exception class for all service exceptions from AccessAnalyzer service.</p>
125
+ *
126
+ */
127
+ export declare class GetFindingV2Command extends $Command<GetFindingV2CommandInput, GetFindingV2CommandOutput, AccessAnalyzerClientResolvedConfig> {
128
+ readonly input: GetFindingV2CommandInput;
129
+ static getEndpointParameterInstructions(): EndpointParameterInstructions;
130
+ /**
131
+ * @public
132
+ */
133
+ constructor(input: GetFindingV2CommandInput);
134
+ /**
135
+ * @internal
136
+ */
137
+ resolveMiddleware(clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: AccessAnalyzerClientResolvedConfig, options?: __HttpHandlerOptions): Handler<GetFindingV2CommandInput, GetFindingV2CommandOutput>;
138
+ /**
139
+ * @internal
140
+ */
141
+ private serialize;
142
+ /**
143
+ * @internal
144
+ */
145
+ private deserialize;
146
+ }
@@ -53,6 +53,11 @@ export interface ListAnalyzersCommandOutput extends ListAnalyzersResponse, __Met
53
53
  * // statusReason: { // StatusReason
54
54
  * // code: "STRING_VALUE", // required
55
55
  * // },
56
+ * // configuration: { // AnalyzerConfiguration Union: only one key present
57
+ * // unusedAccess: { // UnusedAccessConfiguration
58
+ * // unusedAccessAge: Number("int"),
59
+ * // },
60
+ * // },
56
61
  * // },
57
62
  * // ],
58
63
  * // nextToken: "STRING_VALUE",
@@ -0,0 +1,123 @@
1
+ import { EndpointParameterInstructions } from "@smithy/middleware-endpoint";
2
+ import { Command as $Command } from "@smithy/smithy-client";
3
+ import { Handler, HttpHandlerOptions as __HttpHandlerOptions, MetadataBearer as __MetadataBearer, MiddlewareStack } from "@smithy/types";
4
+ import { AccessAnalyzerClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../AccessAnalyzerClient";
5
+ import { ListFindingsV2Request, ListFindingsV2Response } from "../models/models_0";
6
+ /**
7
+ * @public
8
+ */
9
+ export { __MetadataBearer, $Command };
10
+ /**
11
+ * @public
12
+ *
13
+ * The input for {@link ListFindingsV2Command}.
14
+ */
15
+ export interface ListFindingsV2CommandInput extends ListFindingsV2Request {
16
+ }
17
+ /**
18
+ * @public
19
+ *
20
+ * The output of {@link ListFindingsV2Command}.
21
+ */
22
+ export interface ListFindingsV2CommandOutput extends ListFindingsV2Response, __MetadataBearer {
23
+ }
24
+ /**
25
+ * @public
26
+ * <p>Retrieves a list of findings generated by the specified analyzer.</p>
27
+ * <p>To learn about filter keys that you can use to retrieve a list of findings, see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/access-analyzer-reference-filter-keys.html">IAM Access Analyzer filter keys</a> in the <b>IAM User Guide</b>.</p>
28
+ * @example
29
+ * Use a bare-bones client and the command you need to make an API call.
30
+ * ```javascript
31
+ * import { AccessAnalyzerClient, ListFindingsV2Command } from "@aws-sdk/client-accessanalyzer"; // ES Modules import
32
+ * // const { AccessAnalyzerClient, ListFindingsV2Command } = require("@aws-sdk/client-accessanalyzer"); // CommonJS import
33
+ * const client = new AccessAnalyzerClient(config);
34
+ * const input = { // ListFindingsV2Request
35
+ * analyzerArn: "STRING_VALUE", // required
36
+ * filter: { // FilterCriteriaMap
37
+ * "<keys>": { // Criterion
38
+ * eq: [ // ValueList
39
+ * "STRING_VALUE",
40
+ * ],
41
+ * neq: [
42
+ * "STRING_VALUE",
43
+ * ],
44
+ * contains: [
45
+ * "STRING_VALUE",
46
+ * ],
47
+ * exists: true || false,
48
+ * },
49
+ * },
50
+ * maxResults: Number("int"),
51
+ * nextToken: "STRING_VALUE",
52
+ * sort: { // SortCriteria
53
+ * attributeName: "STRING_VALUE",
54
+ * orderBy: "STRING_VALUE",
55
+ * },
56
+ * };
57
+ * const command = new ListFindingsV2Command(input);
58
+ * const response = await client.send(command);
59
+ * // { // ListFindingsV2Response
60
+ * // findings: [ // FindingsListV2 // required
61
+ * // { // FindingSummaryV2
62
+ * // analyzedAt: new Date("TIMESTAMP"), // required
63
+ * // createdAt: new Date("TIMESTAMP"), // required
64
+ * // error: "STRING_VALUE",
65
+ * // id: "STRING_VALUE", // required
66
+ * // resource: "STRING_VALUE",
67
+ * // resourceType: "STRING_VALUE", // required
68
+ * // resourceOwnerAccount: "STRING_VALUE", // required
69
+ * // status: "STRING_VALUE", // required
70
+ * // updatedAt: new Date("TIMESTAMP"), // required
71
+ * // findingType: "STRING_VALUE",
72
+ * // },
73
+ * // ],
74
+ * // nextToken: "STRING_VALUE",
75
+ * // };
76
+ *
77
+ * ```
78
+ *
79
+ * @param ListFindingsV2CommandInput - {@link ListFindingsV2CommandInput}
80
+ * @returns {@link ListFindingsV2CommandOutput}
81
+ * @see {@link ListFindingsV2CommandInput} for command's `input` shape.
82
+ * @see {@link ListFindingsV2CommandOutput} for command's `response` shape.
83
+ * @see {@link AccessAnalyzerClientResolvedConfig | config} for AccessAnalyzerClient's `config` shape.
84
+ *
85
+ * @throws {@link AccessDeniedException} (client fault)
86
+ * <p>You do not have sufficient access to perform this action.</p>
87
+ *
88
+ * @throws {@link InternalServerException} (server fault)
89
+ * <p>Internal server error.</p>
90
+ *
91
+ * @throws {@link ResourceNotFoundException} (client fault)
92
+ * <p>The specified resource could not be found.</p>
93
+ *
94
+ * @throws {@link ThrottlingException} (client fault)
95
+ * <p>Throttling limit exceeded error.</p>
96
+ *
97
+ * @throws {@link ValidationException} (client fault)
98
+ * <p>Validation exception error.</p>
99
+ *
100
+ * @throws {@link AccessAnalyzerServiceException}
101
+ * <p>Base exception class for all service exceptions from AccessAnalyzer service.</p>
102
+ *
103
+ */
104
+ export declare class ListFindingsV2Command extends $Command<ListFindingsV2CommandInput, ListFindingsV2CommandOutput, AccessAnalyzerClientResolvedConfig> {
105
+ readonly input: ListFindingsV2CommandInput;
106
+ static getEndpointParameterInstructions(): EndpointParameterInstructions;
107
+ /**
108
+ * @public
109
+ */
110
+ constructor(input: ListFindingsV2CommandInput);
111
+ /**
112
+ * @internal
113
+ */
114
+ resolveMiddleware(clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: AccessAnalyzerClientResolvedConfig, options?: __HttpHandlerOptions): Handler<ListFindingsV2CommandInput, ListFindingsV2CommandOutput>;
115
+ /**
116
+ * @internal
117
+ */
118
+ private serialize;
119
+ /**
120
+ * @internal
121
+ */
122
+ private deserialize;
123
+ }
@@ -1,5 +1,7 @@
1
1
  export * from "./ApplyArchiveRuleCommand";
2
2
  export * from "./CancelPolicyGenerationCommand";
3
+ export * from "./CheckAccessNotGrantedCommand";
4
+ export * from "./CheckNoNewAccessCommand";
3
5
  export * from "./CreateAccessPreviewCommand";
4
6
  export * from "./CreateAnalyzerCommand";
5
7
  export * from "./CreateArchiveRuleCommand";
@@ -10,6 +12,7 @@ export * from "./GetAnalyzedResourceCommand";
10
12
  export * from "./GetAnalyzerCommand";
11
13
  export * from "./GetArchiveRuleCommand";
12
14
  export * from "./GetFindingCommand";
15
+ export * from "./GetFindingV2Command";
13
16
  export * from "./GetGeneratedPolicyCommand";
14
17
  export * from "./ListAccessPreviewFindingsCommand";
15
18
  export * from "./ListAccessPreviewsCommand";
@@ -17,6 +20,7 @@ export * from "./ListAnalyzedResourcesCommand";
17
20
  export * from "./ListAnalyzersCommand";
18
21
  export * from "./ListArchiveRulesCommand";
19
22
  export * from "./ListFindingsCommand";
23
+ export * from "./ListFindingsV2Command";
20
24
  export * from "./ListPolicyGenerationsCommand";
21
25
  export * from "./ListTagsForResourceCommand";
22
26
  export * from "./StartPolicyGenerationCommand";