@aws-sdk/client-securityhub 3.458.0 → 3.459.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 +128 -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 +189 -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 +98 -0
  53. package/dist-types/commands/DescribeOrganizationConfigurationCommand.d.ts +7 -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 +107 -0
  59. package/dist-types/commands/GetConfigurationPolicyCommand.d.ts +143 -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 +104 -0
  64. package/dist-types/commands/ListConfigurationPolicyAssociationsCommand.d.ts +110 -0
  65. package/dist-types/commands/ListSecurityControlDefinitionsCommand.d.ts +6 -0
  66. package/dist-types/commands/StartConfigurationPolicyAssociationCommand.d.ts +108 -0
  67. package/dist-types/commands/StartConfigurationPolicyDisassociationCommand.d.ts +102 -0
  68. package/dist-types/commands/UpdateConfigurationPolicyCommand.d.ts +191 -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 +1 -1
@@ -135,6 +135,41 @@ export interface GetSecurityControlDefinitionCommandOutput extends GetSecurityCo
135
135
  * @throws {@link SecurityHubServiceException}
136
136
  * <p>Base exception class for all service exceptions from SecurityHub service.</p>
137
137
  *
138
+ * @example To get the definition of a security control.
139
+ * ```javascript
140
+ * // The following example retrieves definition details for the specified security control.
141
+ * const input = {
142
+ * "SecurityControlId": "EC2.4"
143
+ * };
144
+ * const command = new GetSecurityControlDefinitionCommand(input);
145
+ * const response = await client.send(command);
146
+ * /* response ==
147
+ * {
148
+ * "SecurityControlDefinition": {
149
+ * "CurrentRegionAvailability": "AVAILABLE",
150
+ * "Description": "This control checks whether an Amazon EC2 instance has been stopped for longer than the allowed number of days. The control fails if an EC2 instance is stopped for longer than the maximum allowed time period. Unless you provide a custom parameter value for the maximum allowed time period, Security Hub uses a default value of 30 days.",
151
+ * "ParameterDefinitions": {
152
+ * "AllowedDays": {
153
+ * "ConfigurationOptions": {
154
+ * "Integer": {
155
+ * "DefaultValue": 30,
156
+ * "Max": 365,
157
+ * "Min": 1
158
+ * }
159
+ * },
160
+ * "Description": "Number of days the EC2 instance is allowed to be in a stopped state before generating a failed finding"
161
+ * }
162
+ * },
163
+ * "RemediationUrl": "https://docs.aws.amazon.com/console/securityhub/EC2.4/remediation",
164
+ * "SecurityControlId": "EC2.4",
165
+ * "SeverityRating": "MEDIUM",
166
+ * "Title": "Stopped Amazon EC2 instances should be removed after a specified time period"
167
+ * }
168
+ * }
169
+ * *\/
170
+ * // example id: to-get-the-definition-of-a-security-control-1699283789356
171
+ * ```
172
+ *
138
173
  */
139
174
  export declare class GetSecurityControlDefinitionCommand extends $Command<GetSecurityControlDefinitionCommandInput, GetSecurityControlDefinitionCommandOutput, SecurityHubClientResolvedConfig> {
140
175
  readonly input: GetSecurityControlDefinitionCommandInput;
@@ -0,0 +1,104 @@
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 { ListConfigurationPoliciesRequest, ListConfigurationPoliciesResponse } 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 ListConfigurationPoliciesCommand}.
14
+ */
15
+ export interface ListConfigurationPoliciesCommandInput extends ListConfigurationPoliciesRequest {
16
+ }
17
+ /**
18
+ * @public
19
+ *
20
+ * The output of {@link ListConfigurationPoliciesCommand}.
21
+ */
22
+ export interface ListConfigurationPoliciesCommandOutput extends ListConfigurationPoliciesResponse, __MetadataBearer {
23
+ }
24
+ /**
25
+ * @public
26
+ * <p>
27
+ * Lists the configuration policies that the Security Hub delegated administrator has created for your
28
+ * organization. Only the delegated 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, ListConfigurationPoliciesCommand } from "@aws-sdk/client-securityhub"; // ES Modules import
34
+ * // const { SecurityHubClient, ListConfigurationPoliciesCommand } = require("@aws-sdk/client-securityhub"); // CommonJS import
35
+ * const client = new SecurityHubClient(config);
36
+ * const input = { // ListConfigurationPoliciesRequest
37
+ * NextToken: "STRING_VALUE",
38
+ * MaxResults: Number("int"),
39
+ * };
40
+ * const command = new ListConfigurationPoliciesCommand(input);
41
+ * const response = await client.send(command);
42
+ * // { // ListConfigurationPoliciesResponse
43
+ * // ConfigurationPolicySummaries: [ // ConfigurationPolicySummaryList
44
+ * // { // ConfigurationPolicySummary
45
+ * // Arn: "STRING_VALUE",
46
+ * // Id: "STRING_VALUE",
47
+ * // Name: "STRING_VALUE",
48
+ * // Description: "STRING_VALUE",
49
+ * // UpdatedAt: new Date("TIMESTAMP"),
50
+ * // ServiceEnabled: true || false,
51
+ * // },
52
+ * // ],
53
+ * // NextToken: "STRING_VALUE",
54
+ * // };
55
+ *
56
+ * ```
57
+ *
58
+ * @param ListConfigurationPoliciesCommandInput - {@link ListConfigurationPoliciesCommandInput}
59
+ * @returns {@link ListConfigurationPoliciesCommandOutput}
60
+ * @see {@link ListConfigurationPoliciesCommandInput} for command's `input` shape.
61
+ * @see {@link ListConfigurationPoliciesCommandOutput} for command's `response` shape.
62
+ * @see {@link SecurityHubClientResolvedConfig | config} for SecurityHubClient's `config` shape.
63
+ *
64
+ * @throws {@link AccessDeniedException} (client fault)
65
+ * <p>You don't have permission to perform the action specified in the request.</p>
66
+ *
67
+ * @throws {@link InternalException} (server fault)
68
+ * <p>Internal server error.</p>
69
+ *
70
+ * @throws {@link InvalidAccessException} (client fault)
71
+ * <p>The account doesn't have permission to perform this action.</p>
72
+ *
73
+ * @throws {@link InvalidInputException} (client fault)
74
+ * <p>The request was rejected because you supplied an invalid or out-of-range value for an
75
+ * input parameter.</p>
76
+ *
77
+ * @throws {@link LimitExceededException} (client fault)
78
+ * <p>The request was rejected because it attempted to create resources beyond the current Amazon Web Services
79
+ * account or throttling limits. The error code describes the limit exceeded.</p>
80
+ *
81
+ * @throws {@link SecurityHubServiceException}
82
+ * <p>Base exception class for all service exceptions from SecurityHub service.</p>
83
+ *
84
+ */
85
+ export declare class ListConfigurationPoliciesCommand extends $Command<ListConfigurationPoliciesCommandInput, ListConfigurationPoliciesCommandOutput, SecurityHubClientResolvedConfig> {
86
+ readonly input: ListConfigurationPoliciesCommandInput;
87
+ static getEndpointParameterInstructions(): EndpointParameterInstructions;
88
+ /**
89
+ * @public
90
+ */
91
+ constructor(input: ListConfigurationPoliciesCommandInput);
92
+ /**
93
+ * @internal
94
+ */
95
+ resolveMiddleware(clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: SecurityHubClientResolvedConfig, options?: __HttpHandlerOptions): Handler<ListConfigurationPoliciesCommandInput, ListConfigurationPoliciesCommandOutput>;
96
+ /**
97
+ * @internal
98
+ */
99
+ private serialize;
100
+ /**
101
+ * @internal
102
+ */
103
+ private deserialize;
104
+ }
@@ -0,0 +1,110 @@
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 { ListConfigurationPolicyAssociationsRequest, ListConfigurationPolicyAssociationsResponse } 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 ListConfigurationPolicyAssociationsCommand}.
14
+ */
15
+ export interface ListConfigurationPolicyAssociationsCommandInput extends ListConfigurationPolicyAssociationsRequest {
16
+ }
17
+ /**
18
+ * @public
19
+ *
20
+ * The output of {@link ListConfigurationPolicyAssociationsCommand}.
21
+ */
22
+ export interface ListConfigurationPolicyAssociationsCommandOutput extends ListConfigurationPolicyAssociationsResponse, __MetadataBearer {
23
+ }
24
+ /**
25
+ * @public
26
+ * <p>
27
+ * Provides information about the associations for your configuration policies and self-managed behavior. Only the
28
+ * Security Hub delegated 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, ListConfigurationPolicyAssociationsCommand } from "@aws-sdk/client-securityhub"; // ES Modules import
34
+ * // const { SecurityHubClient, ListConfigurationPolicyAssociationsCommand } = require("@aws-sdk/client-securityhub"); // CommonJS import
35
+ * const client = new SecurityHubClient(config);
36
+ * const input = { // ListConfigurationPolicyAssociationsRequest
37
+ * NextToken: "STRING_VALUE",
38
+ * MaxResults: Number("int"),
39
+ * Filters: { // AssociationFilters
40
+ * ConfigurationPolicyId: "STRING_VALUE",
41
+ * AssociationType: "INHERITED" || "APPLIED",
42
+ * AssociationStatus: "PENDING" || "SUCCESS" || "FAILED",
43
+ * },
44
+ * };
45
+ * const command = new ListConfigurationPolicyAssociationsCommand(input);
46
+ * const response = await client.send(command);
47
+ * // { // ListConfigurationPolicyAssociationsResponse
48
+ * // ConfigurationPolicyAssociationSummaries: [ // ConfigurationPolicyAssociationSummaryList
49
+ * // { // ConfigurationPolicyAssociationSummary
50
+ * // ConfigurationPolicyId: "STRING_VALUE",
51
+ * // TargetId: "STRING_VALUE",
52
+ * // TargetType: "ACCOUNT" || "ORGANIZATIONAL_UNIT",
53
+ * // AssociationType: "INHERITED" || "APPLIED",
54
+ * // UpdatedAt: new Date("TIMESTAMP"),
55
+ * // AssociationStatus: "PENDING" || "SUCCESS" || "FAILED",
56
+ * // AssociationStatusMessage: "STRING_VALUE",
57
+ * // },
58
+ * // ],
59
+ * // NextToken: "STRING_VALUE",
60
+ * // };
61
+ *
62
+ * ```
63
+ *
64
+ * @param ListConfigurationPolicyAssociationsCommandInput - {@link ListConfigurationPolicyAssociationsCommandInput}
65
+ * @returns {@link ListConfigurationPolicyAssociationsCommandOutput}
66
+ * @see {@link ListConfigurationPolicyAssociationsCommandInput} for command's `input` shape.
67
+ * @see {@link ListConfigurationPolicyAssociationsCommandOutput} for command's `response` shape.
68
+ * @see {@link SecurityHubClientResolvedConfig | config} for SecurityHubClient's `config` shape.
69
+ *
70
+ * @throws {@link AccessDeniedException} (client fault)
71
+ * <p>You don't have permission to perform the action specified in the request.</p>
72
+ *
73
+ * @throws {@link InternalException} (server fault)
74
+ * <p>Internal server error.</p>
75
+ *
76
+ * @throws {@link InvalidAccessException} (client fault)
77
+ * <p>The account doesn't have permission to perform this action.</p>
78
+ *
79
+ * @throws {@link InvalidInputException} (client fault)
80
+ * <p>The request was rejected because you supplied an invalid or out-of-range value for an
81
+ * input parameter.</p>
82
+ *
83
+ * @throws {@link LimitExceededException} (client fault)
84
+ * <p>The request was rejected because it attempted to create resources beyond the current Amazon Web Services
85
+ * account or throttling limits. The error code describes the limit exceeded.</p>
86
+ *
87
+ * @throws {@link SecurityHubServiceException}
88
+ * <p>Base exception class for all service exceptions from SecurityHub service.</p>
89
+ *
90
+ */
91
+ export declare class ListConfigurationPolicyAssociationsCommand extends $Command<ListConfigurationPolicyAssociationsCommandInput, ListConfigurationPolicyAssociationsCommandOutput, SecurityHubClientResolvedConfig> {
92
+ readonly input: ListConfigurationPolicyAssociationsCommandInput;
93
+ static getEndpointParameterInstructions(): EndpointParameterInstructions;
94
+ /**
95
+ * @public
96
+ */
97
+ constructor(input: ListConfigurationPolicyAssociationsCommandInput);
98
+ /**
99
+ * @internal
100
+ */
101
+ resolveMiddleware(clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: SecurityHubClientResolvedConfig, options?: __HttpHandlerOptions): Handler<ListConfigurationPolicyAssociationsCommandInput, ListConfigurationPolicyAssociationsCommandOutput>;
102
+ /**
103
+ * @internal
104
+ */
105
+ private serialize;
106
+ /**
107
+ * @internal
108
+ */
109
+ private deserialize;
110
+ }
@@ -153,6 +153,9 @@ export interface ListSecurityControlDefinitionsCommandOutput extends ListSecurit
153
153
  * "SecurityControlDefinitions": [
154
154
  * {
155
155
  * "CurrentRegionAvailability": "AVAILABLE",
156
+ * "CustomizableProperties": [
157
+ * "Parameters"
158
+ * ],
156
159
  * "Description": "This AWS control checks whether ACM Certificates in your account are marked for expiration within a specified time period. Certificates provided by ACM are automatically renewed. ACM does not automatically renew certificates that you import.",
157
160
  * "RemediationUrl": "https://docs.aws.amazon.com/console/securityhub/ACM.1/remediation",
158
161
  * "SecurityControlId": "ACM.1",
@@ -161,6 +164,9 @@ export interface ListSecurityControlDefinitionsCommandOutput extends ListSecurit
161
164
  * },
162
165
  * {
163
166
  * "CurrentRegionAvailability": "AVAILABLE",
167
+ * "CustomizableProperties": [
168
+ * "Parameters"
169
+ * ],
164
170
  * "Description": "This control checks whether all stages of Amazon API Gateway REST and WebSocket APIs have logging enabled. The control fails if logging is not enabled for all methods of a stage or if loggingLevel is neither ERROR nor INFO.",
165
171
  * "RemediationUrl": "https://docs.aws.amazon.com/console/securityhub/APIGateway.1/remediation",
166
172
  * "SecurityControlId": "APIGateway.1",
@@ -0,0 +1,108 @@
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
+ */
89
+ export declare class StartConfigurationPolicyAssociationCommand extends $Command<StartConfigurationPolicyAssociationCommandInput, StartConfigurationPolicyAssociationCommandOutput, SecurityHubClientResolvedConfig> {
90
+ readonly input: StartConfigurationPolicyAssociationCommandInput;
91
+ static getEndpointParameterInstructions(): EndpointParameterInstructions;
92
+ /**
93
+ * @public
94
+ */
95
+ constructor(input: StartConfigurationPolicyAssociationCommandInput);
96
+ /**
97
+ * @internal
98
+ */
99
+ resolveMiddleware(clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: SecurityHubClientResolvedConfig, options?: __HttpHandlerOptions): Handler<StartConfigurationPolicyAssociationCommandInput, StartConfigurationPolicyAssociationCommandOutput>;
100
+ /**
101
+ * @internal
102
+ */
103
+ private serialize;
104
+ /**
105
+ * @internal
106
+ */
107
+ private deserialize;
108
+ }
@@ -0,0 +1,102 @@
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
+ */
83
+ export declare class StartConfigurationPolicyDisassociationCommand extends $Command<StartConfigurationPolicyDisassociationCommandInput, StartConfigurationPolicyDisassociationCommandOutput, SecurityHubClientResolvedConfig> {
84
+ readonly input: StartConfigurationPolicyDisassociationCommandInput;
85
+ static getEndpointParameterInstructions(): EndpointParameterInstructions;
86
+ /**
87
+ * @public
88
+ */
89
+ constructor(input: StartConfigurationPolicyDisassociationCommandInput);
90
+ /**
91
+ * @internal
92
+ */
93
+ resolveMiddleware(clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: SecurityHubClientResolvedConfig, options?: __HttpHandlerOptions): Handler<StartConfigurationPolicyDisassociationCommandInput, StartConfigurationPolicyDisassociationCommandOutput>;
94
+ /**
95
+ * @internal
96
+ */
97
+ private serialize;
98
+ /**
99
+ * @internal
100
+ */
101
+ private deserialize;
102
+ }