@aws-sdk/client-securityhub 3.321.1 → 3.326.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 (62) hide show
  1. package/dist-types/commands/AcceptAdministratorInvitationCommand.d.ts +4 -0
  2. package/dist-types/commands/AcceptInvitationCommand.d.ts +4 -0
  3. package/dist-types/commands/BatchDisableStandardsCommand.d.ts +18 -0
  4. package/dist-types/commands/BatchEnableStandardsCommand.d.ts +18 -0
  5. package/dist-types/commands/BatchGetSecurityControlsCommand.d.ts +23 -0
  6. package/dist-types/commands/BatchGetStandardsControlAssociationsCommand.d.ts +33 -0
  7. package/dist-types/commands/BatchImportFindingsCommand.d.ts +14 -0
  8. package/dist-types/commands/BatchUpdateFindingsCommand.d.ts +21 -0
  9. package/dist-types/commands/BatchUpdateStandardsControlAssociationsCommand.d.ts +17 -0
  10. package/dist-types/commands/CreateActionTargetCommand.d.ts +6 -0
  11. package/dist-types/commands/CreateFindingAggregatorCommand.d.ts +11 -0
  12. package/dist-types/commands/CreateInsightCommand.d.ts +6 -0
  13. package/dist-types/commands/CreateMembersCommand.d.ts +11 -0
  14. package/dist-types/commands/DeclineInvitationsCommand.d.ts +11 -0
  15. package/dist-types/commands/DeleteActionTargetCommand.d.ts +6 -0
  16. package/dist-types/commands/DeleteFindingAggregatorCommand.d.ts +4 -0
  17. package/dist-types/commands/DeleteInsightCommand.d.ts +6 -0
  18. package/dist-types/commands/DeleteInvitationsCommand.d.ts +11 -0
  19. package/dist-types/commands/DeleteMembersCommand.d.ts +11 -0
  20. package/dist-types/commands/DescribeActionTargetsCommand.d.ts +13 -0
  21. package/dist-types/commands/DescribeHubCommand.d.ts +9 -0
  22. package/dist-types/commands/DescribeOrganizationConfigurationCommand.d.ts +8 -0
  23. package/dist-types/commands/DescribeProductsCommand.d.ts +23 -0
  24. package/dist-types/commands/DescribeStandardsCommand.d.ts +18 -0
  25. package/dist-types/commands/DescribeStandardsControlsCommand.d.ts +22 -0
  26. package/dist-types/commands/DisableImportFindingsForProductCommand.d.ts +4 -0
  27. package/dist-types/commands/DisableOrganizationAdminAccountCommand.d.ts +4 -0
  28. package/dist-types/commands/DisableSecurityHubCommand.d.ts +4 -0
  29. package/dist-types/commands/DisassociateFromAdministratorAccountCommand.d.ts +4 -0
  30. package/dist-types/commands/DisassociateFromMasterAccountCommand.d.ts +4 -0
  31. package/dist-types/commands/DisassociateMembersCommand.d.ts +4 -0
  32. package/dist-types/commands/EnableImportFindingsForProductCommand.d.ts +6 -0
  33. package/dist-types/commands/EnableOrganizationAdminAccountCommand.d.ts +4 -0
  34. package/dist-types/commands/EnableSecurityHubCommand.d.ts +4 -0
  35. package/dist-types/commands/GetAdministratorAccountCommand.d.ts +11 -0
  36. package/dist-types/commands/GetEnabledStandardsCommand.d.ts +19 -0
  37. package/dist-types/commands/GetFindingAggregatorCommand.d.ts +11 -0
  38. package/dist-types/commands/GetFindingsCommand.d.ts +3760 -0
  39. package/dist-types/commands/GetInsightResultsCommand.d.ts +15 -0
  40. package/dist-types/commands/GetInsightsCommand.d.ts +264 -0
  41. package/dist-types/commands/GetInvitationsCountCommand.d.ts +6 -0
  42. package/dist-types/commands/GetMasterAccountCommand.d.ts +11 -0
  43. package/dist-types/commands/GetMembersCommand.d.ts +22 -0
  44. package/dist-types/commands/InviteMembersCommand.d.ts +11 -0
  45. package/dist-types/commands/ListEnabledProductsForImportCommand.d.ts +9 -0
  46. package/dist-types/commands/ListFindingAggregatorsCommand.d.ts +11 -0
  47. package/dist-types/commands/ListInvitationsCommand.d.ts +14 -0
  48. package/dist-types/commands/ListMembersCommand.d.ts +17 -0
  49. package/dist-types/commands/ListOrganizationAdminAccountsCommand.d.ts +12 -0
  50. package/dist-types/commands/ListSecurityControlDefinitionsCommand.d.ts +16 -0
  51. package/dist-types/commands/ListStandardsControlAssociationsCommand.d.ts +21 -0
  52. package/dist-types/commands/ListTagsForResourceCommand.d.ts +8 -0
  53. package/dist-types/commands/TagResourceCommand.d.ts +4 -0
  54. package/dist-types/commands/UntagResourceCommand.d.ts +4 -0
  55. package/dist-types/commands/UpdateActionTargetCommand.d.ts +4 -0
  56. package/dist-types/commands/UpdateFindingAggregatorCommand.d.ts +11 -0
  57. package/dist-types/commands/UpdateFindingsCommand.d.ts +4 -0
  58. package/dist-types/commands/UpdateInsightCommand.d.ts +4 -0
  59. package/dist-types/commands/UpdateOrganizationConfigurationCommand.d.ts +4 -0
  60. package/dist-types/commands/UpdateSecurityHubConfigurationCommand.d.ts +4 -0
  61. package/dist-types/commands/UpdateStandardsControlCommand.d.ts +4 -0
  62. package/package.json +16 -16
@@ -35,6 +35,26 @@ export interface DescribeStandardsControlsCommandOutput extends DescribeStandard
35
35
  * };
36
36
  * const command = new DescribeStandardsControlsCommand(input);
37
37
  * const response = await client.send(command);
38
+ * // { // DescribeStandardsControlsResponse
39
+ * // Controls: [ // StandardsControls
40
+ * // { // StandardsControl
41
+ * // StandardsControlArn: "STRING_VALUE",
42
+ * // ControlStatus: "ENABLED" || "DISABLED",
43
+ * // DisabledReason: "STRING_VALUE",
44
+ * // ControlStatusUpdatedAt: new Date("TIMESTAMP"),
45
+ * // ControlId: "STRING_VALUE",
46
+ * // Title: "STRING_VALUE",
47
+ * // Description: "STRING_VALUE",
48
+ * // RemediationUrl: "STRING_VALUE",
49
+ * // SeverityRating: "LOW" || "MEDIUM" || "HIGH" || "CRITICAL",
50
+ * // RelatedRequirements: [ // RelatedRequirementsList
51
+ * // "STRING_VALUE",
52
+ * // ],
53
+ * // },
54
+ * // ],
55
+ * // NextToken: "STRING_VALUE",
56
+ * // };
57
+ *
38
58
  * ```
39
59
  *
40
60
  * @param DescribeStandardsControlsCommandInput - {@link DescribeStandardsControlsCommandInput}
@@ -56,6 +76,8 @@ export interface DescribeStandardsControlsCommandOutput extends DescribeStandard
56
76
  * @throws {@link ResourceNotFoundException} (client fault)
57
77
  * <p>The request was rejected because we can't find the specified resource.</p>
58
78
  *
79
+ * @throws {@link SecurityHubServiceException}
80
+ * <p>Base exception class for all service exceptions from SecurityHub service.</p>
59
81
  *
60
82
  * @example To get a list of controls for a security standard
61
83
  * ```javascript
@@ -32,6 +32,8 @@ export interface DisableImportFindingsForProductCommandOutput extends DisableImp
32
32
  * };
33
33
  * const command = new DisableImportFindingsForProductCommand(input);
34
34
  * const response = await client.send(command);
35
+ * // {};
36
+ *
35
37
  * ```
36
38
  *
37
39
  * @param DisableImportFindingsForProductCommandInput - {@link DisableImportFindingsForProductCommandInput}
@@ -57,6 +59,8 @@ export interface DisableImportFindingsForProductCommandOutput extends DisableImp
57
59
  * @throws {@link ResourceNotFoundException} (client fault)
58
60
  * <p>The request was rejected because we can't find the specified resource.</p>
59
61
  *
62
+ * @throws {@link SecurityHubServiceException}
63
+ * <p>Base exception class for all service exceptions from SecurityHub service.</p>
60
64
  *
61
65
  * @example To end a Security Hub integration
62
66
  * ```javascript
@@ -32,6 +32,8 @@ export interface DisableOrganizationAdminAccountCommandOutput extends DisableOrg
32
32
  * };
33
33
  * const command = new DisableOrganizationAdminAccountCommand(input);
34
34
  * const response = await client.send(command);
35
+ * // {};
36
+ *
35
37
  * ```
36
38
  *
37
39
  * @param DisableOrganizationAdminAccountCommandInput - {@link DisableOrganizationAdminAccountCommandInput}
@@ -54,6 +56,8 @@ export interface DisableOrganizationAdminAccountCommandOutput extends DisableOrg
54
56
  * <p>The request was rejected because it attempted to create resources beyond the current Amazon Web Services
55
57
  * account or throttling limits. The error code describes the limit exceeded.</p>
56
58
  *
59
+ * @throws {@link SecurityHubServiceException}
60
+ * <p>Base exception class for all service exceptions from SecurityHub service.</p>
57
61
  *
58
62
  * @example To remove a Security Hub administrator account
59
63
  * ```javascript
@@ -37,6 +37,8 @@ export interface DisableSecurityHubCommandOutput extends DisableSecurityHubRespo
37
37
  * const input = {};
38
38
  * const command = new DisableSecurityHubCommand(input);
39
39
  * const response = await client.send(command);
40
+ * // {};
41
+ *
40
42
  * ```
41
43
  *
42
44
  * @param DisableSecurityHubCommandInput - {@link DisableSecurityHubCommandInput}
@@ -58,6 +60,8 @@ export interface DisableSecurityHubCommandOutput extends DisableSecurityHubRespo
58
60
  * @throws {@link ResourceNotFoundException} (client fault)
59
61
  * <p>The request was rejected because we can't find the specified resource.</p>
60
62
  *
63
+ * @throws {@link SecurityHubServiceException}
64
+ * <p>Base exception class for all service exceptions from SecurityHub service.</p>
61
65
  *
62
66
  * @example To deactivate Security Hub
63
67
  * ```javascript
@@ -33,6 +33,8 @@ export interface DisassociateFromAdministratorAccountCommandOutput extends Disas
33
33
  * const input = {};
34
34
  * const command = new DisassociateFromAdministratorAccountCommand(input);
35
35
  * const response = await client.send(command);
36
+ * // {};
37
+ *
36
38
  * ```
37
39
  *
38
40
  * @param DisassociateFromAdministratorAccountCommandInput - {@link DisassociateFromAdministratorAccountCommandInput}
@@ -58,6 +60,8 @@ export interface DisassociateFromAdministratorAccountCommandOutput extends Disas
58
60
  * @throws {@link ResourceNotFoundException} (client fault)
59
61
  * <p>The request was rejected because we can't find the specified resource.</p>
60
62
  *
63
+ * @throws {@link SecurityHubServiceException}
64
+ * <p>Base exception class for all service exceptions from SecurityHub service.</p>
61
65
  *
62
66
  * @example To disassociate requesting account from administrator account
63
67
  * ```javascript
@@ -37,6 +37,8 @@ export interface DisassociateFromMasterAccountCommandOutput extends Disassociate
37
37
  * const input = {};
38
38
  * const command = new DisassociateFromMasterAccountCommand(input);
39
39
  * const response = await client.send(command);
40
+ * // {};
41
+ *
40
42
  * ```
41
43
  *
42
44
  * @param DisassociateFromMasterAccountCommandInput - {@link DisassociateFromMasterAccountCommandInput}
@@ -62,6 +64,8 @@ export interface DisassociateFromMasterAccountCommandOutput extends Disassociate
62
64
  * @throws {@link ResourceNotFoundException} (client fault)
63
65
  * <p>The request was rejected because we can't find the specified resource.</p>
64
66
  *
67
+ * @throws {@link SecurityHubServiceException}
68
+ * <p>Base exception class for all service exceptions from SecurityHub service.</p>
65
69
  *
66
70
  */
67
71
  export declare class DisassociateFromMasterAccountCommand extends $Command<DisassociateFromMasterAccountCommandInput, DisassociateFromMasterAccountCommandOutput, SecurityHubClientResolvedConfig> {
@@ -35,6 +35,8 @@ export interface DisassociateMembersCommandOutput extends DisassociateMembersRes
35
35
  * };
36
36
  * const command = new DisassociateMembersCommand(input);
37
37
  * const response = await client.send(command);
38
+ * // {};
39
+ *
38
40
  * ```
39
41
  *
40
42
  * @param DisassociateMembersCommandInput - {@link DisassociateMembersCommandInput}
@@ -60,6 +62,8 @@ export interface DisassociateMembersCommandOutput extends DisassociateMembersRes
60
62
  * @throws {@link ResourceNotFoundException} (client fault)
61
63
  * <p>The request was rejected because we can't find the specified resource.</p>
62
64
  *
65
+ * @throws {@link SecurityHubServiceException}
66
+ * <p>Base exception class for all service exceptions from SecurityHub service.</p>
63
67
  *
64
68
  * @example To disassociate member accounts from administrator account
65
69
  * ```javascript
@@ -34,6 +34,10 @@ export interface EnableImportFindingsForProductCommandOutput extends EnableImpor
34
34
  * };
35
35
  * const command = new EnableImportFindingsForProductCommand(input);
36
36
  * const response = await client.send(command);
37
+ * // { // EnableImportFindingsForProductResponse
38
+ * // ProductSubscriptionArn: "STRING_VALUE",
39
+ * // };
40
+ *
37
41
  * ```
38
42
  *
39
43
  * @param EnableImportFindingsForProductCommandInput - {@link EnableImportFindingsForProductCommandInput}
@@ -59,6 +63,8 @@ export interface EnableImportFindingsForProductCommandOutput extends EnableImpor
59
63
  * @throws {@link ResourceConflictException} (client fault)
60
64
  * <p>The resource specified in the request conflicts with an existing resource.</p>
61
65
  *
66
+ * @throws {@link SecurityHubServiceException}
67
+ * <p>Base exception class for all service exceptions from SecurityHub service.</p>
62
68
  *
63
69
  * @example To activate an integration
64
70
  * ```javascript
@@ -32,6 +32,8 @@ export interface EnableOrganizationAdminAccountCommandOutput extends EnableOrgan
32
32
  * };
33
33
  * const command = new EnableOrganizationAdminAccountCommand(input);
34
34
  * const response = await client.send(command);
35
+ * // {};
36
+ *
35
37
  * ```
36
38
  *
37
39
  * @param EnableOrganizationAdminAccountCommandInput - {@link EnableOrganizationAdminAccountCommandInput}
@@ -54,6 +56,8 @@ export interface EnableOrganizationAdminAccountCommandOutput extends EnableOrgan
54
56
  * <p>The request was rejected because it attempted to create resources beyond the current Amazon Web Services
55
57
  * account or throttling limits. The error code describes the limit exceeded.</p>
56
58
  *
59
+ * @throws {@link SecurityHubServiceException}
60
+ * <p>Base exception class for all service exceptions from SecurityHub service.</p>
57
61
  *
58
62
  * @example To designate a Security Hub administrator
59
63
  * ```javascript
@@ -54,6 +54,8 @@ export interface EnableSecurityHubCommandOutput extends EnableSecurityHubRespons
54
54
  * };
55
55
  * const command = new EnableSecurityHubCommand(input);
56
56
  * const response = await client.send(command);
57
+ * // {};
58
+ *
57
59
  * ```
58
60
  *
59
61
  * @param EnableSecurityHubCommandInput - {@link EnableSecurityHubCommandInput}
@@ -78,6 +80,8 @@ export interface EnableSecurityHubCommandOutput extends EnableSecurityHubRespons
78
80
  * @throws {@link ResourceConflictException} (client fault)
79
81
  * <p>The resource specified in the request conflicts with an existing resource.</p>
80
82
  *
83
+ * @throws {@link SecurityHubServiceException}
84
+ * <p>Base exception class for all service exceptions from SecurityHub service.</p>
81
85
  *
82
86
  * @example To activate Security Hub
83
87
  * ```javascript
@@ -31,6 +31,15 @@ export interface GetAdministratorAccountCommandOutput extends GetAdministratorAc
31
31
  * const input = {};
32
32
  * const command = new GetAdministratorAccountCommand(input);
33
33
  * const response = await client.send(command);
34
+ * // { // GetAdministratorAccountResponse
35
+ * // Administrator: { // Invitation
36
+ * // AccountId: "STRING_VALUE",
37
+ * // InvitationId: "STRING_VALUE",
38
+ * // InvitedAt: new Date("TIMESTAMP"),
39
+ * // MemberStatus: "STRING_VALUE",
40
+ * // },
41
+ * // };
42
+ *
34
43
  * ```
35
44
  *
36
45
  * @param GetAdministratorAccountCommandInput - {@link GetAdministratorAccountCommandInput}
@@ -56,6 +65,8 @@ export interface GetAdministratorAccountCommandOutput extends GetAdministratorAc
56
65
  * @throws {@link ResourceNotFoundException} (client fault)
57
66
  * <p>The request was rejected because we can't find the specified resource.</p>
58
67
  *
68
+ * @throws {@link SecurityHubServiceException}
69
+ * <p>Base exception class for all service exceptions from SecurityHub service.</p>
59
70
  *
60
71
  * @example To get details about the Security Hub administrator account
61
72
  * ```javascript
@@ -35,6 +35,23 @@ export interface GetEnabledStandardsCommandOutput extends GetEnabledStandardsRes
35
35
  * };
36
36
  * const command = new GetEnabledStandardsCommand(input);
37
37
  * const response = await client.send(command);
38
+ * // { // GetEnabledStandardsResponse
39
+ * // StandardsSubscriptions: [ // StandardsSubscriptions
40
+ * // { // StandardsSubscription
41
+ * // StandardsSubscriptionArn: "STRING_VALUE", // required
42
+ * // StandardsArn: "STRING_VALUE", // required
43
+ * // StandardsInput: { // StandardsInputParameterMap // required
44
+ * // "<keys>": "STRING_VALUE",
45
+ * // },
46
+ * // StandardsStatus: "PENDING" || "READY" || "FAILED" || "DELETING" || "INCOMPLETE", // required
47
+ * // StandardsStatusReason: { // StandardsStatusReason
48
+ * // StatusReasonCode: "NO_AVAILABLE_CONFIGURATION_RECORDER" || "INTERNAL_ERROR", // required
49
+ * // },
50
+ * // },
51
+ * // ],
52
+ * // NextToken: "STRING_VALUE",
53
+ * // };
54
+ *
38
55
  * ```
39
56
  *
40
57
  * @param GetEnabledStandardsCommandInput - {@link GetEnabledStandardsCommandInput}
@@ -57,6 +74,8 @@ export interface GetEnabledStandardsCommandOutput extends GetEnabledStandardsRes
57
74
  * <p>The request was rejected because it attempted to create resources beyond the current Amazon Web Services
58
75
  * account or throttling limits. The error code describes the limit exceeded.</p>
59
76
  *
77
+ * @throws {@link SecurityHubServiceException}
78
+ * <p>Base exception class for all service exceptions from SecurityHub service.</p>
60
79
  *
61
80
  * @example To return a list of enabled standards
62
81
  * ```javascript
@@ -31,6 +31,15 @@ export interface GetFindingAggregatorCommandOutput extends GetFindingAggregatorR
31
31
  * };
32
32
  * const command = new GetFindingAggregatorCommand(input);
33
33
  * const response = await client.send(command);
34
+ * // { // GetFindingAggregatorResponse
35
+ * // FindingAggregatorArn: "STRING_VALUE",
36
+ * // FindingAggregationRegion: "STRING_VALUE",
37
+ * // RegionLinkingMode: "STRING_VALUE",
38
+ * // Regions: [ // StringList
39
+ * // "STRING_VALUE",
40
+ * // ],
41
+ * // };
42
+ *
34
43
  * ```
35
44
  *
36
45
  * @param GetFindingAggregatorCommandInput - {@link GetFindingAggregatorCommandInput}
@@ -59,6 +68,8 @@ export interface GetFindingAggregatorCommandOutput extends GetFindingAggregatorR
59
68
  * @throws {@link ResourceNotFoundException} (client fault)
60
69
  * <p>The request was rejected because we can't find the specified resource.</p>
61
70
  *
71
+ * @throws {@link SecurityHubServiceException}
72
+ * <p>Base exception class for all service exceptions from SecurityHub service.</p>
62
73
  *
63
74
  * @example To get cross-Region aggregation details
64
75
  * ```javascript