@aws-sdk/client-securityhub 3.458.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 (103) hide show
  1. package/README.md +80 -0
  2. package/dist-cjs/SecurityHub.js +20 -0
  3. package/dist-cjs/commands/BatchGetConfigurationPolicyAssociationsCommand.js +51 -0
  4. package/dist-cjs/commands/CreateConfigurationPolicyCommand.js +51 -0
  5. package/dist-cjs/commands/DeleteConfigurationPolicyCommand.js +51 -0
  6. package/dist-cjs/commands/GetConfigurationPolicyAssociationCommand.js +51 -0
  7. package/dist-cjs/commands/GetConfigurationPolicyCommand.js +51 -0
  8. package/dist-cjs/commands/ListConfigurationPoliciesCommand.js +51 -0
  9. package/dist-cjs/commands/ListConfigurationPolicyAssociationsCommand.js +51 -0
  10. package/dist-cjs/commands/StartConfigurationPolicyAssociationCommand.js +51 -0
  11. package/dist-cjs/commands/StartConfigurationPolicyDisassociationCommand.js +51 -0
  12. package/dist-cjs/commands/UpdateConfigurationPolicyCommand.js +51 -0
  13. package/dist-cjs/commands/index.js +10 -0
  14. package/dist-cjs/models/models_0.js +10 -1
  15. package/dist-cjs/models/models_2.js +34 -1
  16. package/dist-cjs/pagination/ListConfigurationPoliciesPaginator.js +29 -0
  17. package/dist-cjs/pagination/ListConfigurationPolicyAssociationsPaginator.js +29 -0
  18. package/dist-cjs/pagination/index.js +2 -0
  19. package/dist-cjs/protocols/Aws_restJson1.js +943 -35
  20. package/dist-es/SecurityHub.js +20 -0
  21. package/dist-es/commands/BatchGetConfigurationPolicyAssociationsCommand.js +47 -0
  22. package/dist-es/commands/CreateConfigurationPolicyCommand.js +47 -0
  23. package/dist-es/commands/DeleteConfigurationPolicyCommand.js +47 -0
  24. package/dist-es/commands/GetConfigurationPolicyAssociationCommand.js +47 -0
  25. package/dist-es/commands/GetConfigurationPolicyCommand.js +47 -0
  26. package/dist-es/commands/ListConfigurationPoliciesCommand.js +47 -0
  27. package/dist-es/commands/ListConfigurationPolicyAssociationsCommand.js +47 -0
  28. package/dist-es/commands/StartConfigurationPolicyAssociationCommand.js +47 -0
  29. package/dist-es/commands/StartConfigurationPolicyDisassociationCommand.js +47 -0
  30. package/dist-es/commands/UpdateConfigurationPolicyCommand.js +47 -0
  31. package/dist-es/commands/index.js +10 -0
  32. package/dist-es/models/models_0.js +9 -0
  33. package/dist-es/models/models_2.js +33 -0
  34. package/dist-es/pagination/ListConfigurationPoliciesPaginator.js +25 -0
  35. package/dist-es/pagination/ListConfigurationPolicyAssociationsPaginator.js +25 -0
  36. package/dist-es/pagination/index.js +2 -0
  37. package/dist-es/protocols/Aws_restJson1.js +920 -33
  38. package/dist-types/SecurityHub.d.ts +70 -0
  39. package/dist-types/SecurityHubClient.d.ts +12 -2
  40. package/dist-types/commands/BatchDisableStandardsCommand.d.ts +3 -0
  41. package/dist-types/commands/BatchEnableStandardsCommand.d.ts +3 -0
  42. package/dist-types/commands/BatchGetAutomationRulesCommand.d.ts +3 -0
  43. package/dist-types/commands/BatchGetConfigurationPolicyAssociationsCommand.d.ts +176 -0
  44. package/dist-types/commands/BatchGetSecurityControlsCommand.d.ts +22 -2
  45. package/dist-types/commands/BatchImportFindingsCommand.d.ts +4 -0
  46. package/dist-types/commands/BatchUpdateAutomationRulesCommand.d.ts +3 -0
  47. package/dist-types/commands/BatchUpdateStandardsControlAssociationsCommand.d.ts +3 -0
  48. package/dist-types/commands/CreateAutomationRuleCommand.d.ts +3 -0
  49. package/dist-types/commands/CreateConfigurationPolicyCommand.d.ts +265 -0
  50. package/dist-types/commands/CreateInsightCommand.d.ts +3 -0
  51. package/dist-types/commands/CreateMembersCommand.d.ts +3 -0
  52. package/dist-types/commands/DeleteConfigurationPolicyCommand.d.ts +109 -0
  53. package/dist-types/commands/DescribeOrganizationConfigurationCommand.d.ts +27 -2
  54. package/dist-types/commands/DisableOrganizationAdminAccountCommand.d.ts +3 -0
  55. package/dist-types/commands/DisableSecurityHubCommand.d.ts +3 -0
  56. package/dist-types/commands/DisassociateMembersCommand.d.ts +3 -0
  57. package/dist-types/commands/EnableOrganizationAdminAccountCommand.d.ts +3 -0
  58. package/dist-types/commands/GetConfigurationPolicyAssociationCommand.d.ts +131 -0
  59. package/dist-types/commands/GetConfigurationPolicyCommand.d.ts +191 -0
  60. package/dist-types/commands/GetFindingsCommand.d.ts +7 -0
  61. package/dist-types/commands/GetInsightsCommand.d.ts +3 -0
  62. package/dist-types/commands/GetSecurityControlDefinitionCommand.d.ts +35 -0
  63. package/dist-types/commands/ListConfigurationPoliciesCommand.d.ts +131 -0
  64. package/dist-types/commands/ListConfigurationPolicyAssociationsCommand.d.ts +140 -0
  65. package/dist-types/commands/ListSecurityControlDefinitionsCommand.d.ts +6 -0
  66. package/dist-types/commands/StartConfigurationPolicyAssociationCommand.d.ts +133 -0
  67. package/dist-types/commands/StartConfigurationPolicyDisassociationCommand.d.ts +116 -0
  68. package/dist-types/commands/UpdateConfigurationPolicyCommand.d.ts +271 -0
  69. package/dist-types/commands/UpdateFindingsCommand.d.ts +3 -0
  70. package/dist-types/commands/UpdateInsightCommand.d.ts +3 -0
  71. package/dist-types/commands/UpdateOrganizationConfigurationCommand.d.ts +16 -2
  72. package/dist-types/commands/UpdateSecurityControlCommand.d.ts +23 -0
  73. package/dist-types/commands/UpdateSecurityHubConfigurationCommand.d.ts +3 -0
  74. package/dist-types/commands/UpdateStandardsControlCommand.d.ts +3 -0
  75. package/dist-types/commands/index.d.ts +10 -0
  76. package/dist-types/models/models_0.d.ts +86 -192
  77. package/dist-types/models/models_1.d.ts +192 -49
  78. package/dist-types/models/models_2.d.ts +1180 -37
  79. package/dist-types/pagination/ListConfigurationPoliciesPaginator.d.ts +7 -0
  80. package/dist-types/pagination/ListConfigurationPolicyAssociationsPaginator.d.ts +7 -0
  81. package/dist-types/pagination/index.d.ts +2 -0
  82. package/dist-types/protocols/Aws_restJson1.d.ts +90 -0
  83. package/dist-types/ts3.4/SecurityHub.d.ts +200 -0
  84. package/dist-types/ts3.4/SecurityHubClient.d.ts +60 -0
  85. package/dist-types/ts3.4/commands/BatchGetConfigurationPolicyAssociationsCommand.d.ts +42 -0
  86. package/dist-types/ts3.4/commands/CreateConfigurationPolicyCommand.d.ts +42 -0
  87. package/dist-types/ts3.4/commands/DeleteConfigurationPolicyCommand.d.ts +42 -0
  88. package/dist-types/ts3.4/commands/GetConfigurationPolicyAssociationCommand.d.ts +42 -0
  89. package/dist-types/ts3.4/commands/GetConfigurationPolicyCommand.d.ts +42 -0
  90. package/dist-types/ts3.4/commands/ListConfigurationPoliciesCommand.d.ts +42 -0
  91. package/dist-types/ts3.4/commands/ListConfigurationPolicyAssociationsCommand.d.ts +42 -0
  92. package/dist-types/ts3.4/commands/StartConfigurationPolicyAssociationCommand.d.ts +42 -0
  93. package/dist-types/ts3.4/commands/StartConfigurationPolicyDisassociationCommand.d.ts +42 -0
  94. package/dist-types/ts3.4/commands/UpdateConfigurationPolicyCommand.d.ts +42 -0
  95. package/dist-types/ts3.4/commands/index.d.ts +10 -0
  96. package/dist-types/ts3.4/models/models_0.d.ts +21 -26
  97. package/dist-types/ts3.4/models/models_1.d.ts +32 -9
  98. package/dist-types/ts3.4/models/models_2.d.ts +243 -4
  99. package/dist-types/ts3.4/pagination/ListConfigurationPoliciesPaginator.d.ts +11 -0
  100. package/dist-types/ts3.4/pagination/ListConfigurationPolicyAssociationsPaginator.d.ts +11 -0
  101. package/dist-types/ts3.4/pagination/index.d.ts +2 -0
  102. package/dist-types/ts3.4/protocols/Aws_restJson1.d.ts +120 -0
  103. package/package.json +12 -12
@@ -0,0 +1,133 @@
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 { StartConfigurationPolicyAssociationRequest, StartConfigurationPolicyAssociationResponse } from "../models/models_2";
5
+ import { SecurityHubClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../SecurityHubClient";
6
+ /**
7
+ * @public
8
+ */
9
+ export { __MetadataBearer, $Command };
10
+ /**
11
+ * @public
12
+ *
13
+ * The input for {@link StartConfigurationPolicyAssociationCommand}.
14
+ */
15
+ export interface StartConfigurationPolicyAssociationCommandInput extends StartConfigurationPolicyAssociationRequest {
16
+ }
17
+ /**
18
+ * @public
19
+ *
20
+ * The output of {@link StartConfigurationPolicyAssociationCommand}.
21
+ */
22
+ export interface StartConfigurationPolicyAssociationCommandOutput extends StartConfigurationPolicyAssociationResponse, __MetadataBearer {
23
+ }
24
+ /**
25
+ * @public
26
+ * <p>
27
+ * Associates a target account, organizational unit, or the root with a specified configuration. The target can be
28
+ * associated with a configuration policy or self-managed behavior. Only the Security Hub delegated administrator can
29
+ * invoke this operation from the home Region.
30
+ * </p>
31
+ * @example
32
+ * Use a bare-bones client and the command you need to make an API call.
33
+ * ```javascript
34
+ * import { SecurityHubClient, StartConfigurationPolicyAssociationCommand } from "@aws-sdk/client-securityhub"; // ES Modules import
35
+ * // const { SecurityHubClient, StartConfigurationPolicyAssociationCommand } = require("@aws-sdk/client-securityhub"); // CommonJS import
36
+ * const client = new SecurityHubClient(config);
37
+ * const input = { // StartConfigurationPolicyAssociationRequest
38
+ * ConfigurationPolicyIdentifier: "STRING_VALUE", // required
39
+ * Target: { // Target Union: only one key present
40
+ * AccountId: "STRING_VALUE",
41
+ * OrganizationalUnitId: "STRING_VALUE",
42
+ * RootId: "STRING_VALUE",
43
+ * },
44
+ * };
45
+ * const command = new StartConfigurationPolicyAssociationCommand(input);
46
+ * const response = await client.send(command);
47
+ * // { // StartConfigurationPolicyAssociationResponse
48
+ * // ConfigurationPolicyId: "STRING_VALUE",
49
+ * // TargetId: "STRING_VALUE",
50
+ * // TargetType: "ACCOUNT" || "ORGANIZATIONAL_UNIT",
51
+ * // AssociationType: "INHERITED" || "APPLIED",
52
+ * // UpdatedAt: new Date("TIMESTAMP"),
53
+ * // AssociationStatus: "PENDING" || "SUCCESS" || "FAILED",
54
+ * // AssociationStatusMessage: "STRING_VALUE",
55
+ * // };
56
+ *
57
+ * ```
58
+ *
59
+ * @param StartConfigurationPolicyAssociationCommandInput - {@link StartConfigurationPolicyAssociationCommandInput}
60
+ * @returns {@link StartConfigurationPolicyAssociationCommandOutput}
61
+ * @see {@link StartConfigurationPolicyAssociationCommandInput} for command's `input` shape.
62
+ * @see {@link StartConfigurationPolicyAssociationCommandOutput} for command's `response` shape.
63
+ * @see {@link SecurityHubClientResolvedConfig | config} for SecurityHubClient's `config` shape.
64
+ *
65
+ * @throws {@link AccessDeniedException} (client fault)
66
+ * <p>You don't have permission to perform the action specified in the request.</p>
67
+ *
68
+ * @throws {@link InternalException} (server fault)
69
+ * <p>Internal server error.</p>
70
+ *
71
+ * @throws {@link InvalidAccessException} (client fault)
72
+ * <p>The account doesn't have permission to perform this action.</p>
73
+ *
74
+ * @throws {@link InvalidInputException} (client fault)
75
+ * <p>The request was rejected because you supplied an invalid or out-of-range value for an
76
+ * input parameter.</p>
77
+ *
78
+ * @throws {@link LimitExceededException} (client fault)
79
+ * <p>The request was rejected because it attempted to create resources beyond the current Amazon Web Services
80
+ * account or throttling limits. The error code describes the limit exceeded.</p>
81
+ *
82
+ * @throws {@link ResourceNotFoundException} (client fault)
83
+ * <p>The request was rejected because we can't find the specified resource.</p>
84
+ *
85
+ * @throws {@link SecurityHubServiceException}
86
+ * <p>Base exception class for all service exceptions from SecurityHub service.</p>
87
+ *
88
+ * @example To associate a configuration with a target
89
+ * ```javascript
90
+ * // This operation associates a configuration policy or self-managed behavior with the target account, organizational unit, or the root.
91
+ * const input = {
92
+ * "ConfigurationPolicyIdentifier": "arn:aws:securityhub:us-east-1:123456789012:configuration-policy/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
93
+ * "Target": {
94
+ * "AccountId": "111122223333"
95
+ * }
96
+ * };
97
+ * const command = new StartConfigurationPolicyAssociationCommand(input);
98
+ * const response = await client.send(command);
99
+ * /* response ==
100
+ * {
101
+ * "AssociationStatus": "SUCCESS",
102
+ * "AssociationStatusMessage": "This field is populated only if the association fails",
103
+ * "AssociationType": "APPLIED",
104
+ * "ConfigurationPolicyId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
105
+ * "TargetId": "111122223333",
106
+ * "TargetType": "ACCOUNT",
107
+ * "UpdatedAt": "2023-01-11T06:17:17.154Z"
108
+ * }
109
+ * *\/
110
+ * // example id: to-associate-a-configuration-with-a-target-1695176455638
111
+ * ```
112
+ *
113
+ */
114
+ export declare class StartConfigurationPolicyAssociationCommand extends $Command<StartConfigurationPolicyAssociationCommandInput, StartConfigurationPolicyAssociationCommandOutput, SecurityHubClientResolvedConfig> {
115
+ readonly input: StartConfigurationPolicyAssociationCommandInput;
116
+ static getEndpointParameterInstructions(): EndpointParameterInstructions;
117
+ /**
118
+ * @public
119
+ */
120
+ constructor(input: StartConfigurationPolicyAssociationCommandInput);
121
+ /**
122
+ * @internal
123
+ */
124
+ resolveMiddleware(clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: SecurityHubClientResolvedConfig, options?: __HttpHandlerOptions): Handler<StartConfigurationPolicyAssociationCommandInput, StartConfigurationPolicyAssociationCommandOutput>;
125
+ /**
126
+ * @internal
127
+ */
128
+ private serialize;
129
+ /**
130
+ * @internal
131
+ */
132
+ private deserialize;
133
+ }
@@ -0,0 +1,116 @@
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 { StartConfigurationPolicyDisassociationRequest, StartConfigurationPolicyDisassociationResponse } from "../models/models_2";
5
+ import { SecurityHubClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../SecurityHubClient";
6
+ /**
7
+ * @public
8
+ */
9
+ export { __MetadataBearer, $Command };
10
+ /**
11
+ * @public
12
+ *
13
+ * The input for {@link StartConfigurationPolicyDisassociationCommand}.
14
+ */
15
+ export interface StartConfigurationPolicyDisassociationCommandInput extends StartConfigurationPolicyDisassociationRequest {
16
+ }
17
+ /**
18
+ * @public
19
+ *
20
+ * The output of {@link StartConfigurationPolicyDisassociationCommand}.
21
+ */
22
+ export interface StartConfigurationPolicyDisassociationCommandOutput extends StartConfigurationPolicyDisassociationResponse, __MetadataBearer {
23
+ }
24
+ /**
25
+ * @public
26
+ * <p>
27
+ * Disassociates a target account, organizational unit, or the root from a specified configuration. When you
28
+ * disassociate a configuration from its target, the target inherits the configuration of the closest parent. If there’s no
29
+ * configuration to inherit, the target retains its settings but becomes a self-managed account. A target can be disassociated from
30
+ * a configuration policy or self-managed behavior. Only the Security Hub delegated administrator can invoke this
31
+ * operation from the home Region.
32
+ * </p>
33
+ * @example
34
+ * Use a bare-bones client and the command you need to make an API call.
35
+ * ```javascript
36
+ * import { SecurityHubClient, StartConfigurationPolicyDisassociationCommand } from "@aws-sdk/client-securityhub"; // ES Modules import
37
+ * // const { SecurityHubClient, StartConfigurationPolicyDisassociationCommand } = require("@aws-sdk/client-securityhub"); // CommonJS import
38
+ * const client = new SecurityHubClient(config);
39
+ * const input = { // StartConfigurationPolicyDisassociationRequest
40
+ * Target: { // Target Union: only one key present
41
+ * AccountId: "STRING_VALUE",
42
+ * OrganizationalUnitId: "STRING_VALUE",
43
+ * RootId: "STRING_VALUE",
44
+ * },
45
+ * ConfigurationPolicyIdentifier: "STRING_VALUE", // required
46
+ * };
47
+ * const command = new StartConfigurationPolicyDisassociationCommand(input);
48
+ * const response = await client.send(command);
49
+ * // {};
50
+ *
51
+ * ```
52
+ *
53
+ * @param StartConfigurationPolicyDisassociationCommandInput - {@link StartConfigurationPolicyDisassociationCommandInput}
54
+ * @returns {@link StartConfigurationPolicyDisassociationCommandOutput}
55
+ * @see {@link StartConfigurationPolicyDisassociationCommandInput} for command's `input` shape.
56
+ * @see {@link StartConfigurationPolicyDisassociationCommandOutput} for command's `response` shape.
57
+ * @see {@link SecurityHubClientResolvedConfig | config} for SecurityHubClient's `config` shape.
58
+ *
59
+ * @throws {@link AccessDeniedException} (client fault)
60
+ * <p>You don't have permission to perform the action specified in the request.</p>
61
+ *
62
+ * @throws {@link InternalException} (server fault)
63
+ * <p>Internal server error.</p>
64
+ *
65
+ * @throws {@link InvalidAccessException} (client fault)
66
+ * <p>The account doesn't have permission to perform this action.</p>
67
+ *
68
+ * @throws {@link InvalidInputException} (client fault)
69
+ * <p>The request was rejected because you supplied an invalid or out-of-range value for an
70
+ * input parameter.</p>
71
+ *
72
+ * @throws {@link LimitExceededException} (client fault)
73
+ * <p>The request was rejected because it attempted to create resources beyond the current Amazon Web Services
74
+ * account or throttling limits. The error code describes the limit exceeded.</p>
75
+ *
76
+ * @throws {@link ResourceNotFoundException} (client fault)
77
+ * <p>The request was rejected because we can't find the specified resource.</p>
78
+ *
79
+ * @throws {@link SecurityHubServiceException}
80
+ * <p>Base exception class for all service exceptions from SecurityHub service.</p>
81
+ *
82
+ * @example To disassociate a configuration from a target
83
+ * ```javascript
84
+ * // This operation disassociates a configuration policy or self-managed behavior from the target account, organizational unit, or the root.
85
+ * const input = {
86
+ * "ConfigurationPolicyIdentifier": "SELF_MANAGED_SECURITY_HUB",
87
+ * "Target": {
88
+ * "RootId": "r-f6g7h8i9j0example"
89
+ * }
90
+ * };
91
+ * const command = new StartConfigurationPolicyDisassociationCommand(input);
92
+ * await client.send(command);
93
+ * // example id: to-disassociate-a-configuration-from-a-target-1695177176748
94
+ * ```
95
+ *
96
+ */
97
+ export declare class StartConfigurationPolicyDisassociationCommand extends $Command<StartConfigurationPolicyDisassociationCommandInput, StartConfigurationPolicyDisassociationCommandOutput, SecurityHubClientResolvedConfig> {
98
+ readonly input: StartConfigurationPolicyDisassociationCommandInput;
99
+ static getEndpointParameterInstructions(): EndpointParameterInstructions;
100
+ /**
101
+ * @public
102
+ */
103
+ constructor(input: StartConfigurationPolicyDisassociationCommandInput);
104
+ /**
105
+ * @internal
106
+ */
107
+ resolveMiddleware(clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: SecurityHubClientResolvedConfig, options?: __HttpHandlerOptions): Handler<StartConfigurationPolicyDisassociationCommandInput, StartConfigurationPolicyDisassociationCommandOutput>;
108
+ /**
109
+ * @internal
110
+ */
111
+ private serialize;
112
+ /**
113
+ * @internal
114
+ */
115
+ private deserialize;
116
+ }
@@ -0,0 +1,271 @@
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 { UpdateConfigurationPolicyRequest, UpdateConfigurationPolicyResponse } from "../models/models_2";
5
+ import { SecurityHubClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../SecurityHubClient";
6
+ /**
7
+ * @public
8
+ */
9
+ export { __MetadataBearer, $Command };
10
+ /**
11
+ * @public
12
+ *
13
+ * The input for {@link UpdateConfigurationPolicyCommand}.
14
+ */
15
+ export interface UpdateConfigurationPolicyCommandInput extends UpdateConfigurationPolicyRequest {
16
+ }
17
+ /**
18
+ * @public
19
+ *
20
+ * The output of {@link UpdateConfigurationPolicyCommand}.
21
+ */
22
+ export interface UpdateConfigurationPolicyCommandOutput extends UpdateConfigurationPolicyResponse, __MetadataBearer {
23
+ }
24
+ /**
25
+ * @public
26
+ * <p>
27
+ * Updates a configuration policy. Only the Security Hub delegated
28
+ * administrator can invoke this operation from the home Region.
29
+ * </p>
30
+ * @example
31
+ * Use a bare-bones client and the command you need to make an API call.
32
+ * ```javascript
33
+ * import { SecurityHubClient, UpdateConfigurationPolicyCommand } from "@aws-sdk/client-securityhub"; // ES Modules import
34
+ * // const { SecurityHubClient, UpdateConfigurationPolicyCommand } = require("@aws-sdk/client-securityhub"); // CommonJS import
35
+ * const client = new SecurityHubClient(config);
36
+ * const input = { // UpdateConfigurationPolicyRequest
37
+ * Identifier: "STRING_VALUE", // required
38
+ * Name: "STRING_VALUE",
39
+ * Description: "STRING_VALUE",
40
+ * UpdatedReason: "STRING_VALUE",
41
+ * ConfigurationPolicy: { // Policy Union: only one key present
42
+ * SecurityHub: { // SecurityHubPolicy
43
+ * ServiceEnabled: true || false,
44
+ * EnabledStandardIdentifiers: [ // EnabledStandardIdentifierList
45
+ * "STRING_VALUE",
46
+ * ],
47
+ * SecurityControlsConfiguration: { // SecurityControlsConfiguration
48
+ * EnabledSecurityControlIdentifiers: [ // EnabledSecurityControlIdentifierList
49
+ * "STRING_VALUE",
50
+ * ],
51
+ * DisabledSecurityControlIdentifiers: [ // DisabledSecurityControlIdentifierList
52
+ * "STRING_VALUE",
53
+ * ],
54
+ * SecurityControlCustomParameters: [ // SecurityControlCustomParametersList
55
+ * { // SecurityControlCustomParameter
56
+ * SecurityControlId: "STRING_VALUE",
57
+ * Parameters: { // Parameters
58
+ * "<keys>": { // ParameterConfiguration
59
+ * ValueType: "DEFAULT" || "CUSTOM", // required
60
+ * Value: { // ParameterValue Union: only one key present
61
+ * Integer: Number("int"),
62
+ * IntegerList: [ // IntegerList
63
+ * Number("int"),
64
+ * ],
65
+ * Double: Number("double"),
66
+ * String: "STRING_VALUE",
67
+ * StringList: [ // StringList
68
+ * "STRING_VALUE",
69
+ * ],
70
+ * Boolean: true || false,
71
+ * Enum: "STRING_VALUE",
72
+ * EnumList: [
73
+ * "STRING_VALUE",
74
+ * ],
75
+ * },
76
+ * },
77
+ * },
78
+ * },
79
+ * ],
80
+ * },
81
+ * },
82
+ * },
83
+ * };
84
+ * const command = new UpdateConfigurationPolicyCommand(input);
85
+ * const response = await client.send(command);
86
+ * // { // UpdateConfigurationPolicyResponse
87
+ * // Arn: "STRING_VALUE",
88
+ * // Id: "STRING_VALUE",
89
+ * // Name: "STRING_VALUE",
90
+ * // Description: "STRING_VALUE",
91
+ * // UpdatedAt: new Date("TIMESTAMP"),
92
+ * // CreatedAt: new Date("TIMESTAMP"),
93
+ * // ConfigurationPolicy: { // Policy Union: only one key present
94
+ * // SecurityHub: { // SecurityHubPolicy
95
+ * // ServiceEnabled: true || false,
96
+ * // EnabledStandardIdentifiers: [ // EnabledStandardIdentifierList
97
+ * // "STRING_VALUE",
98
+ * // ],
99
+ * // SecurityControlsConfiguration: { // SecurityControlsConfiguration
100
+ * // EnabledSecurityControlIdentifiers: [ // EnabledSecurityControlIdentifierList
101
+ * // "STRING_VALUE",
102
+ * // ],
103
+ * // DisabledSecurityControlIdentifiers: [ // DisabledSecurityControlIdentifierList
104
+ * // "STRING_VALUE",
105
+ * // ],
106
+ * // SecurityControlCustomParameters: [ // SecurityControlCustomParametersList
107
+ * // { // SecurityControlCustomParameter
108
+ * // SecurityControlId: "STRING_VALUE",
109
+ * // Parameters: { // Parameters
110
+ * // "<keys>": { // ParameterConfiguration
111
+ * // ValueType: "DEFAULT" || "CUSTOM", // required
112
+ * // Value: { // ParameterValue Union: only one key present
113
+ * // Integer: Number("int"),
114
+ * // IntegerList: [ // IntegerList
115
+ * // Number("int"),
116
+ * // ],
117
+ * // Double: Number("double"),
118
+ * // String: "STRING_VALUE",
119
+ * // StringList: [ // StringList
120
+ * // "STRING_VALUE",
121
+ * // ],
122
+ * // Boolean: true || false,
123
+ * // Enum: "STRING_VALUE",
124
+ * // EnumList: [
125
+ * // "STRING_VALUE",
126
+ * // ],
127
+ * // },
128
+ * // },
129
+ * // },
130
+ * // },
131
+ * // ],
132
+ * // },
133
+ * // },
134
+ * // },
135
+ * // };
136
+ *
137
+ * ```
138
+ *
139
+ * @param UpdateConfigurationPolicyCommandInput - {@link UpdateConfigurationPolicyCommandInput}
140
+ * @returns {@link UpdateConfigurationPolicyCommandOutput}
141
+ * @see {@link UpdateConfigurationPolicyCommandInput} for command's `input` shape.
142
+ * @see {@link UpdateConfigurationPolicyCommandOutput} for command's `response` shape.
143
+ * @see {@link SecurityHubClientResolvedConfig | config} for SecurityHubClient's `config` shape.
144
+ *
145
+ * @throws {@link AccessDeniedException} (client fault)
146
+ * <p>You don't have permission to perform the action specified in the request.</p>
147
+ *
148
+ * @throws {@link InternalException} (server fault)
149
+ * <p>Internal server error.</p>
150
+ *
151
+ * @throws {@link InvalidAccessException} (client fault)
152
+ * <p>The account doesn't have permission to perform this action.</p>
153
+ *
154
+ * @throws {@link InvalidInputException} (client fault)
155
+ * <p>The request was rejected because you supplied an invalid or out-of-range value for an
156
+ * input parameter.</p>
157
+ *
158
+ * @throws {@link LimitExceededException} (client fault)
159
+ * <p>The request was rejected because it attempted to create resources beyond the current Amazon Web Services
160
+ * account or throttling limits. The error code describes the limit exceeded.</p>
161
+ *
162
+ * @throws {@link ResourceConflictException} (client fault)
163
+ * <p>The resource specified in the request conflicts with an existing resource.</p>
164
+ *
165
+ * @throws {@link ResourceNotFoundException} (client fault)
166
+ * <p>The request was rejected because we can't find the specified resource.</p>
167
+ *
168
+ * @throws {@link SecurityHubServiceException}
169
+ * <p>Base exception class for all service exceptions from SecurityHub service.</p>
170
+ *
171
+ * @example To update a configuration policy
172
+ * ```javascript
173
+ * // This operation updates the specified configuration policy.
174
+ * const input = {
175
+ * "ConfigurationPolicy": {
176
+ * "SecurityHub": {
177
+ * "EnabledStandardIdentifiers": [
178
+ * "arn:aws:securityhub:us-east-1::standards/aws-foundational-security-best-practices/v/1.0.0",
179
+ * "arn:aws:securityhub:::ruleset/cis-aws-foundations-benchmark/v/1.2.0"
180
+ * ],
181
+ * "SecurityControlsConfiguration": {
182
+ * "DisabledSecurityControlIdentifiers": [
183
+ * "CloudWatch.1",
184
+ * "CloudWatch.2"
185
+ * ],
186
+ * "SecurityControlCustomParameters": [
187
+ * {
188
+ * "Parameters": {
189
+ * "daysToExpiration": {
190
+ * "Value": {
191
+ * "Integer": 21
192
+ * },
193
+ * "ValueType": "CUSTOM"
194
+ * }
195
+ * },
196
+ * "SecurityControlId": "ACM.1"
197
+ * }
198
+ * ]
199
+ * },
200
+ * "ServiceEnabled": true
201
+ * }
202
+ * },
203
+ * "Description": "Updated configuration policy for testing FSBP and CIS",
204
+ * "Identifier": "arn:aws:securityhub:us-east-1:123456789012:configuration-policy/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
205
+ * "Name": "TestConfigurationPolicy",
206
+ * "UpdatedReason": "Enabling ACM.2"
207
+ * };
208
+ * const command = new UpdateConfigurationPolicyCommand(input);
209
+ * const response = await client.send(command);
210
+ * /* response ==
211
+ * {
212
+ * "Arn": "arn:aws:securityhub:us-east-1:123456789012:configuration-policy/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
213
+ * "ConfigurationPolicy": {
214
+ * "SecurityHub": {
215
+ * "EnabledStandardIdentifiers": [
216
+ * "arn:aws:securityhub:us-east-1::standards/aws-foundational-security-best-practices/v/1.0.0",
217
+ * "arn:aws:securityhub:::ruleset/cis-aws-foundations-benchmark/v/1.2.0"
218
+ * ],
219
+ * "SecurityControlsConfiguration": {
220
+ * "DisabledSecurityControlIdentifiers": [
221
+ * "CloudWatch.1",
222
+ * "CloudWatch.2"
223
+ * ],
224
+ * "SecurityControlCustomParameters": [
225
+ * {
226
+ * "Parameters": {
227
+ * "daysToExpiration": {
228
+ * "Value": {
229
+ * "Integer": 21
230
+ * },
231
+ * "ValueType": "CUSTOM"
232
+ * }
233
+ * },
234
+ * "SecurityControlId": "ACM.1"
235
+ * }
236
+ * ]
237
+ * },
238
+ * "ServiceEnabled": true
239
+ * }
240
+ * },
241
+ * "CreatedAt": "2023-01-11T06:17:17.154Z",
242
+ * "Description": "Updated configuration policy for testing FSBP and CIS",
243
+ * "Id": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
244
+ * "Name": "TestConfigurationPolicy",
245
+ * "UpdatedAt": "2023-01-12T06:17:17.154Z"
246
+ * }
247
+ * *\/
248
+ * // example id: to-update-a-configuration-policy-1695174120555
249
+ * ```
250
+ *
251
+ */
252
+ export declare class UpdateConfigurationPolicyCommand extends $Command<UpdateConfigurationPolicyCommandInput, UpdateConfigurationPolicyCommandOutput, SecurityHubClientResolvedConfig> {
253
+ readonly input: UpdateConfigurationPolicyCommandInput;
254
+ static getEndpointParameterInstructions(): EndpointParameterInstructions;
255
+ /**
256
+ * @public
257
+ */
258
+ constructor(input: UpdateConfigurationPolicyCommandInput);
259
+ /**
260
+ * @internal
261
+ */
262
+ resolveMiddleware(clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: SecurityHubClientResolvedConfig, options?: __HttpHandlerOptions): Handler<UpdateConfigurationPolicyCommandInput, UpdateConfigurationPolicyCommandOutput>;
263
+ /**
264
+ * @internal
265
+ */
266
+ private serialize;
267
+ /**
268
+ * @internal
269
+ */
270
+ private deserialize;
271
+ }
@@ -300,6 +300,9 @@ export interface UpdateFindingsCommandOutput extends UpdateFindingsResponse, __M
300
300
  * VulnerabilitiesFixAvailable: "<StringFilterList>",
301
301
  * ComplianceSecurityControlParametersName: "<StringFilterList>",
302
302
  * ComplianceSecurityControlParametersValue: "<StringFilterList>",
303
+ * AwsAccountName: "<StringFilterList>",
304
+ * ResourceApplicationName: "<StringFilterList>",
305
+ * ResourceApplicationArn: "<StringFilterList>",
303
306
  * },
304
307
  * Note: { // NoteUpdate
305
308
  * Text: "STRING_VALUE", // required
@@ -297,6 +297,9 @@ export interface UpdateInsightCommandOutput extends UpdateInsightResponse, __Met
297
297
  * VulnerabilitiesFixAvailable: "<StringFilterList>",
298
298
  * ComplianceSecurityControlParametersName: "<StringFilterList>",
299
299
  * ComplianceSecurityControlParametersValue: "<StringFilterList>",
300
+ * AwsAccountName: "<StringFilterList>",
301
+ * ResourceApplicationName: "<StringFilterList>",
302
+ * ResourceApplicationArn: "<StringFilterList>",
300
303
  * },
301
304
  * GroupByAttribute: "STRING_VALUE",
302
305
  * };
@@ -23,8 +23,8 @@ export interface UpdateOrganizationConfigurationCommandOutput extends UpdateOrga
23
23
  }
24
24
  /**
25
25
  * @public
26
- * <p>Used to update the configuration related to Organizations. Can only be called from a
27
- * Security Hub administrator account.</p>
26
+ * <p>Updates the configuration of your organization in Security Hub. Only the
27
+ * Security Hub administrator account can invoke this operation.</p>
28
28
  * @example
29
29
  * Use a bare-bones client and the command you need to make an API call.
30
30
  * ```javascript
@@ -34,6 +34,11 @@ export interface UpdateOrganizationConfigurationCommandOutput extends UpdateOrga
34
34
  * const input = { // UpdateOrganizationConfigurationRequest
35
35
  * AutoEnable: true || false, // required
36
36
  * AutoEnableStandards: "NONE" || "DEFAULT",
37
+ * OrganizationConfiguration: { // OrganizationConfiguration
38
+ * ConfigurationType: "CENTRAL" || "LOCAL",
39
+ * Status: "PENDING" || "ENABLED" || "FAILED",
40
+ * StatusMessage: "STRING_VALUE",
41
+ * },
37
42
  * };
38
43
  * const command = new UpdateOrganizationConfigurationCommand(input);
39
44
  * const response = await client.send(command);
@@ -47,6 +52,9 @@ export interface UpdateOrganizationConfigurationCommandOutput extends UpdateOrga
47
52
  * @see {@link UpdateOrganizationConfigurationCommandOutput} for command's `response` shape.
48
53
  * @see {@link SecurityHubClientResolvedConfig | config} for SecurityHubClient's `config` shape.
49
54
  *
55
+ * @throws {@link AccessDeniedException} (client fault)
56
+ * <p>You don't have permission to perform the action specified in the request.</p>
57
+ *
50
58
  * @throws {@link InternalException} (server fault)
51
59
  * <p>Internal server error.</p>
52
60
  *
@@ -61,6 +69,12 @@ export interface UpdateOrganizationConfigurationCommandOutput extends UpdateOrga
61
69
  * <p>The request was rejected because it attempted to create resources beyond the current Amazon Web Services
62
70
  * account or throttling limits. The error code describes the limit exceeded.</p>
63
71
  *
72
+ * @throws {@link ResourceConflictException} (client fault)
73
+ * <p>The resource specified in the request conflicts with an existing resource.</p>
74
+ *
75
+ * @throws {@link ResourceNotFoundException} (client fault)
76
+ * <p>The request was rejected because we can't find the specified resource.</p>
77
+ *
64
78
  * @throws {@link SecurityHubServiceException}
65
79
  * <p>Base exception class for all service exceptions from SecurityHub service.</p>
66
80
  *
@@ -69,6 +69,9 @@ export interface UpdateSecurityControlCommandOutput extends UpdateSecurityContro
69
69
  * @see {@link UpdateSecurityControlCommandOutput} for command's `response` shape.
70
70
  * @see {@link SecurityHubClientResolvedConfig | config} for SecurityHubClient's `config` shape.
71
71
  *
72
+ * @throws {@link AccessDeniedException} (client fault)
73
+ * <p>You don't have permission to perform the action specified in the request.</p>
74
+ *
72
75
  * @throws {@link InternalException} (server fault)
73
76
  * <p>Internal server error.</p>
74
77
  *
@@ -95,6 +98,26 @@ export interface UpdateSecurityControlCommandOutput extends UpdateSecurityContro
95
98
  * @throws {@link SecurityHubServiceException}
96
99
  * <p>Base exception class for all service exceptions from SecurityHub service.</p>
97
100
  *
101
+ * @example To update security control properties
102
+ * ```javascript
103
+ * // The following example updates the specified security control. Specifically, this example updates control parameters.
104
+ * const input = {
105
+ * "LastUpdateReason": "Comply with internal requirements",
106
+ * "Parameters": {
107
+ * "maxCredentialUsageAge": {
108
+ * "Value": {
109
+ * "Integer": 15
110
+ * },
111
+ * "ValueType": "CUSTOM"
112
+ * }
113
+ * },
114
+ * "SecurityControlId": "ACM.1"
115
+ * };
116
+ * const command = new UpdateSecurityControlCommand(input);
117
+ * await client.send(command);
118
+ * // example id: to-update-security-control-properties-1699282942434
119
+ * ```
120
+ *
98
121
  */
99
122
  export declare class UpdateSecurityControlCommand extends $Command<UpdateSecurityControlCommandInput, UpdateSecurityControlCommandOutput, SecurityHubClientResolvedConfig> {
100
123
  readonly input: UpdateSecurityControlCommandInput;
@@ -46,6 +46,9 @@ export interface UpdateSecurityHubConfigurationCommandOutput extends UpdateSecur
46
46
  * @see {@link UpdateSecurityHubConfigurationCommandOutput} for command's `response` shape.
47
47
  * @see {@link SecurityHubClientResolvedConfig | config} for SecurityHubClient's `config` shape.
48
48
  *
49
+ * @throws {@link AccessDeniedException} (client fault)
50
+ * <p>You don't have permission to perform the action specified in the request.</p>
51
+ *
49
52
  * @throws {@link InternalException} (server fault)
50
53
  * <p>Internal server error.</p>
51
54
  *
@@ -48,6 +48,9 @@ export interface UpdateStandardsControlCommandOutput extends UpdateStandardsCont
48
48
  * @see {@link UpdateStandardsControlCommandOutput} for command's `response` shape.
49
49
  * @see {@link SecurityHubClientResolvedConfig | config} for SecurityHubClient's `config` shape.
50
50
  *
51
+ * @throws {@link AccessDeniedException} (client fault)
52
+ * <p>You don't have permission to perform the action specified in the request.</p>
53
+ *
51
54
  * @throws {@link InternalException} (server fault)
52
55
  * <p>Internal server error.</p>
53
56
  *