@cdk8s/awscdk-resolver 0.0.242 → 0.0.243
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.
- package/.jsii +3 -3
- package/lib/resolve.js +1 -1
- package/node_modules/@aws-sdk/client-cloudformation/README.md +40 -0
- package/node_modules/@aws-sdk/client-cloudformation/dist-cjs/index.js +782 -33
- package/node_modules/@aws-sdk/client-cloudformation/dist-es/CloudFormation.js +10 -0
- package/node_modules/@aws-sdk/client-cloudformation/dist-es/commands/CreateStackRefactorCommand.js +22 -0
- package/node_modules/@aws-sdk/client-cloudformation/dist-es/commands/DescribeStackRefactorCommand.js +22 -0
- package/node_modules/@aws-sdk/client-cloudformation/dist-es/commands/ExecuteStackRefactorCommand.js +22 -0
- package/node_modules/@aws-sdk/client-cloudformation/dist-es/commands/ListStackRefactorActionsCommand.js +22 -0
- package/node_modules/@aws-sdk/client-cloudformation/dist-es/commands/ListStackRefactorsCommand.js +22 -0
- package/node_modules/@aws-sdk/client-cloudformation/dist-es/commands/index.js +5 -0
- package/node_modules/@aws-sdk/client-cloudformation/dist-es/models/models_0.js +51 -55
- package/node_modules/@aws-sdk/client-cloudformation/dist-es/models/models_1.js +55 -0
- package/node_modules/@aws-sdk/client-cloudformation/dist-es/pagination/ListStackRefactorActionsPaginator.js +4 -0
- package/node_modules/@aws-sdk/client-cloudformation/dist-es/pagination/ListStackRefactorsPaginator.js +4 -0
- package/node_modules/@aws-sdk/client-cloudformation/dist-es/pagination/index.js +2 -0
- package/node_modules/@aws-sdk/client-cloudformation/dist-es/protocols/Aws_query.js +514 -24
- package/node_modules/@aws-sdk/client-cloudformation/dist-es/waiters/index.js +2 -0
- package/node_modules/@aws-sdk/client-cloudformation/dist-es/waiters/waitForStackRefactorCreateComplete.js +43 -0
- package/node_modules/@aws-sdk/client-cloudformation/dist-es/waiters/waitForStackRefactorExecuteComplete.js +52 -0
- package/node_modules/@aws-sdk/client-cloudformation/dist-types/CloudFormation.d.ts +36 -0
- package/node_modules/@aws-sdk/client-cloudformation/dist-types/CloudFormationClient.d.ts +7 -2
- package/node_modules/@aws-sdk/client-cloudformation/dist-types/commands/CreateStackRefactorCommand.d.ts +91 -0
- package/node_modules/@aws-sdk/client-cloudformation/dist-types/commands/DescribeStackEventsCommand.d.ts +1 -1
- package/node_modules/@aws-sdk/client-cloudformation/dist-types/commands/DescribeStackRefactorCommand.d.ts +82 -0
- package/node_modules/@aws-sdk/client-cloudformation/dist-types/commands/DescribeStackResourceCommand.d.ts +1 -1
- package/node_modules/@aws-sdk/client-cloudformation/dist-types/commands/DescribeStackResourcesCommand.d.ts +1 -1
- package/node_modules/@aws-sdk/client-cloudformation/dist-types/commands/DetectStackSetDriftCommand.d.ts +2 -4
- package/node_modules/@aws-sdk/client-cloudformation/dist-types/commands/ExecuteStackRefactorCommand.d.ts +69 -0
- package/node_modules/@aws-sdk/client-cloudformation/dist-types/commands/ListStackRefactorActionsCommand.d.ts +103 -0
- package/node_modules/@aws-sdk/client-cloudformation/dist-types/commands/ListStackRefactorsCommand.d.ts +85 -0
- package/node_modules/@aws-sdk/client-cloudformation/dist-types/commands/ListStackResourcesCommand.d.ts +1 -1
- package/node_modules/@aws-sdk/client-cloudformation/dist-types/commands/ListStackSetsCommand.d.ts +2 -1
- package/node_modules/@aws-sdk/client-cloudformation/dist-types/commands/ListTypeRegistrationsCommand.d.ts +1 -1
- package/node_modules/@aws-sdk/client-cloudformation/dist-types/commands/ListTypeVersionsCommand.d.ts +1 -1
- package/node_modules/@aws-sdk/client-cloudformation/dist-types/commands/ListTypesCommand.d.ts +1 -1
- package/node_modules/@aws-sdk/client-cloudformation/dist-types/commands/PublishTypeCommand.d.ts +1 -1
- package/node_modules/@aws-sdk/client-cloudformation/dist-types/commands/RecordHandlerProgressCommand.d.ts +1 -1
- package/node_modules/@aws-sdk/client-cloudformation/dist-types/commands/RegisterPublisherCommand.d.ts +1 -1
- package/node_modules/@aws-sdk/client-cloudformation/dist-types/commands/StopStackSetOperationCommand.d.ts +3 -2
- package/node_modules/@aws-sdk/client-cloudformation/dist-types/commands/index.d.ts +5 -0
- package/node_modules/@aws-sdk/client-cloudformation/dist-types/models/models_0.d.ts +968 -1147
- package/node_modules/@aws-sdk/client-cloudformation/dist-types/models/models_1.d.ts +770 -32
- package/node_modules/@aws-sdk/client-cloudformation/dist-types/pagination/ListStackRefactorActionsPaginator.d.ts +7 -0
- package/node_modules/@aws-sdk/client-cloudformation/dist-types/pagination/ListStackRefactorsPaginator.d.ts +7 -0
- package/node_modules/@aws-sdk/client-cloudformation/dist-types/pagination/index.d.ts +2 -0
- package/node_modules/@aws-sdk/client-cloudformation/dist-types/protocols/Aws_query.d.ts +45 -0
- package/node_modules/@aws-sdk/client-cloudformation/dist-types/ts3.4/CloudFormation.d.ts +86 -0
- package/node_modules/@aws-sdk/client-cloudformation/dist-types/ts3.4/CloudFormationClient.d.ts +30 -0
- package/node_modules/@aws-sdk/client-cloudformation/dist-types/ts3.4/commands/CreateStackRefactorCommand.d.ts +51 -0
- package/node_modules/@aws-sdk/client-cloudformation/dist-types/ts3.4/commands/DescribeStackRefactorCommand.d.ts +51 -0
- package/node_modules/@aws-sdk/client-cloudformation/dist-types/ts3.4/commands/ExecuteStackRefactorCommand.d.ts +46 -0
- package/node_modules/@aws-sdk/client-cloudformation/dist-types/ts3.4/commands/ListStackRefactorActionsCommand.d.ts +51 -0
- package/node_modules/@aws-sdk/client-cloudformation/dist-types/ts3.4/commands/ListStackRefactorsCommand.d.ts +51 -0
- package/node_modules/@aws-sdk/client-cloudformation/dist-types/ts3.4/commands/ListStackSetsCommand.d.ts +2 -1
- package/node_modules/@aws-sdk/client-cloudformation/dist-types/ts3.4/commands/ListTypeRegistrationsCommand.d.ts +1 -1
- package/node_modules/@aws-sdk/client-cloudformation/dist-types/ts3.4/commands/ListTypeVersionsCommand.d.ts +1 -1
- package/node_modules/@aws-sdk/client-cloudformation/dist-types/ts3.4/commands/ListTypesCommand.d.ts +1 -1
- package/node_modules/@aws-sdk/client-cloudformation/dist-types/ts3.4/commands/PublishTypeCommand.d.ts +1 -1
- package/node_modules/@aws-sdk/client-cloudformation/dist-types/ts3.4/commands/RecordHandlerProgressCommand.d.ts +1 -1
- package/node_modules/@aws-sdk/client-cloudformation/dist-types/ts3.4/commands/RegisterPublisherCommand.d.ts +1 -1
- package/node_modules/@aws-sdk/client-cloudformation/dist-types/ts3.4/commands/index.d.ts +5 -0
- package/node_modules/@aws-sdk/client-cloudformation/dist-types/ts3.4/models/models_0.d.ts +130 -151
- package/node_modules/@aws-sdk/client-cloudformation/dist-types/ts3.4/models/models_1.d.ts +158 -0
- package/node_modules/@aws-sdk/client-cloudformation/dist-types/ts3.4/pagination/ListStackRefactorActionsPaginator.d.ts +11 -0
- package/node_modules/@aws-sdk/client-cloudformation/dist-types/ts3.4/pagination/ListStackRefactorsPaginator.d.ts +11 -0
- package/node_modules/@aws-sdk/client-cloudformation/dist-types/ts3.4/pagination/index.d.ts +2 -0
- package/node_modules/@aws-sdk/client-cloudformation/dist-types/ts3.4/protocols/Aws_query.d.ts +60 -0
- package/node_modules/@aws-sdk/client-cloudformation/dist-types/ts3.4/waiters/index.d.ts +2 -0
- package/node_modules/@aws-sdk/client-cloudformation/dist-types/ts3.4/waiters/waitForStackRefactorCreateComplete.d.ts +11 -0
- package/node_modules/@aws-sdk/client-cloudformation/dist-types/ts3.4/waiters/waitForStackRefactorExecuteComplete.d.ts +11 -0
- package/node_modules/@aws-sdk/client-cloudformation/dist-types/waiters/index.d.ts +2 -0
- package/node_modules/@aws-sdk/client-cloudformation/dist-types/waiters/waitForStackRefactorCreateComplete.d.ts +14 -0
- package/node_modules/@aws-sdk/client-cloudformation/dist-types/waiters/waitForStackRefactorExecuteComplete.d.ts +14 -0
- package/node_modules/@aws-sdk/client-cloudformation/package.json +5 -5
- package/node_modules/@aws-sdk/client-sso/package.json +4 -4
- package/node_modules/@aws-sdk/credential-provider-ini/package.json +4 -4
- package/node_modules/@aws-sdk/credential-provider-node/package.json +4 -4
- package/node_modules/@aws-sdk/credential-provider-sso/package.json +3 -3
- package/node_modules/@aws-sdk/credential-provider-web-identity/package.json +2 -2
- package/node_modules/@aws-sdk/middleware-user-agent/package.json +2 -2
- package/node_modules/@aws-sdk/nested-clients/package.json +4 -4
- package/node_modules/@aws-sdk/token-providers/package.json +2 -2
- package/node_modules/@aws-sdk/util-endpoints/dist-cjs/index.js +11 -1
- package/node_modules/@aws-sdk/util-endpoints/dist-cjs/lib/aws/partitions.json +11 -1
- package/node_modules/@aws-sdk/util-endpoints/dist-es/lib/aws/partitions.json +11 -1
- package/node_modules/@aws-sdk/util-endpoints/package.json +1 -1
- package/node_modules/@aws-sdk/util-user-agent-node/package.json +2 -2
- package/package.json +5 -5
@@ -28,15 +28,16 @@ export declare const AccountGateStatus: {
|
|
28
28
|
*/
|
29
29
|
export type AccountGateStatus = (typeof AccountGateStatus)[keyof typeof AccountGateStatus];
|
30
30
|
/**
|
31
|
-
* <p>Structure that contains the results of the account gate function which CloudFormation invokes,
|
32
|
-
* proceeding with a stack set operation in an account and Region.</p>
|
33
|
-
* <p>For each account and Region, CloudFormation lets you specify a Lambda function that encapsulates
|
34
|
-
* requirements that must be met before CloudFormation can proceed with a stack set operation in
|
35
|
-
* CloudFormation invokes the function each time a stack set operation is
|
36
|
-
* function returns <code>FAILED</code>, CloudFormation
|
37
|
-
*
|
38
|
-
*
|
39
|
-
*
|
31
|
+
* <p>Structure that contains the results of the account gate function which CloudFormation invokes,
|
32
|
+
* if present, before proceeding with a stack set operation in an account and Region.</p>
|
33
|
+
* <p>For each account and Region, CloudFormation lets you specify a Lambda function that encapsulates
|
34
|
+
* any requirements that must be met before CloudFormation can proceed with a stack set operation in
|
35
|
+
* that account and Region. CloudFormation invokes the function each time a stack set operation is
|
36
|
+
* requested for that account and Region; if the function returns <code>FAILED</code>, CloudFormation
|
37
|
+
* cancels the operation in that account and Region, and sets the stack set operation result status
|
38
|
+
* for that account and Region to <code>FAILED</code>.</p>
|
39
|
+
* <p>For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-account-gating.html">Configuring a target
|
40
|
+
* account gate in StackSets</a> in the <i>CloudFormation User Guide</i>.</p>
|
40
41
|
* @public
|
41
42
|
*/
|
42
43
|
export interface AccountGateResult {
|
@@ -45,33 +46,34 @@ export interface AccountGateResult {
|
|
45
46
|
* <ul>
|
46
47
|
* <li>
|
47
48
|
* <p>
|
48
|
-
* <code>SUCCEEDED</code>: The account gate function has determined that the account and
|
49
|
-
* requirements for a stack set operation to occur. CloudFormation proceeds with the
|
50
|
-
* Region.</p>
|
49
|
+
* <code>SUCCEEDED</code>: The account gate function has determined that the account and
|
50
|
+
* Region passes any requirements for a stack set operation to occur. CloudFormation proceeds with the
|
51
|
+
* stack operation in that account and Region.</p>
|
51
52
|
* </li>
|
52
53
|
* <li>
|
53
54
|
* <p>
|
54
|
-
* <code>FAILED</code>: The account gate function has determined that the account and Region
|
55
|
-
* requirements for a stack set operation to occur. CloudFormation cancels the stack
|
56
|
-
* and sets the stack set operation result status for
|
55
|
+
* <code>FAILED</code>: The account gate function has determined that the account and Region
|
56
|
+
* doesn't meet the requirements for a stack set operation to occur. CloudFormation cancels the stack
|
57
|
+
* set operation in that account and Region, and sets the stack set operation result status for
|
58
|
+
* that account and Region to <code>FAILED</code>.</p>
|
57
59
|
* </li>
|
58
60
|
* <li>
|
59
61
|
* <p>
|
60
|
-
* <code>SKIPPED</code>: CloudFormation has skipped calling the account gate function for this
|
61
|
-
* of the following reasons:</p>
|
62
|
+
* <code>SKIPPED</code>: CloudFormation has skipped calling the account gate function for this
|
63
|
+
* account and Region, for one of the following reasons:</p>
|
62
64
|
* <ul>
|
63
65
|
* <li>
|
64
|
-
* <p>An account gate function hasn't been specified for the account and Region. CloudFormation
|
65
|
-
* operation in this account and Region.</p>
|
66
|
+
* <p>An account gate function hasn't been specified for the account and Region. CloudFormation
|
67
|
+
* proceeds with the stack set operation in this account and Region.</p>
|
66
68
|
* </li>
|
67
69
|
* <li>
|
68
|
-
* <p>The <code>AWSCloudFormationStackSetExecutionRole</code> of the stack set administration
|
69
|
-
* permissions to invoke the function. CloudFormation proceeds with the stack set
|
70
|
-
* Region.</p>
|
70
|
+
* <p>The <code>AWSCloudFormationStackSetExecutionRole</code> of the stack set administration
|
71
|
+
* account lacks permissions to invoke the function. CloudFormation proceeds with the stack set
|
72
|
+
* operation in this account and Region.</p>
|
71
73
|
* </li>
|
72
74
|
* <li>
|
73
|
-
* <p>Either no action is necessary, or no action is possible, on the stack. CloudFormation skips
|
74
|
-
* in this account and Region.</p>
|
75
|
+
* <p>Either no action is necessary, or no action is possible, on the stack. CloudFormation skips
|
76
|
+
* the stack set operation in this account and Region.</p>
|
75
77
|
* </li>
|
76
78
|
* </ul>
|
77
79
|
* </li>
|
@@ -80,7 +82,8 @@ export interface AccountGateResult {
|
|
80
82
|
*/
|
81
83
|
Status?: AccountGateStatus | undefined;
|
82
84
|
/**
|
83
|
-
* <p>The reason for the account gate status assigned to this account and Region for the stack set
|
85
|
+
* <p>The reason for the account gate status assigned to this account and Region for the stack set
|
86
|
+
* operation.</p>
|
84
87
|
* @public
|
85
88
|
*/
|
86
89
|
StatusReason?: string | undefined;
|
@@ -358,23 +361,23 @@ export declare const AttributeChangeType: {
|
|
358
361
|
*/
|
359
362
|
export type AttributeChangeType = (typeof AttributeChangeType)[keyof typeof AttributeChangeType];
|
360
363
|
/**
|
361
|
-
* <p>[Service-managed permissions] Describes whether StackSets automatically deploys to Organizations
|
362
|
-
*
|
364
|
+
* <p>[Service-managed permissions] Describes whether StackSets automatically deploys to Organizations accounts that are added to a target organization or organizational unit
|
365
|
+
* (OU).</p>
|
363
366
|
* @public
|
364
367
|
*/
|
365
368
|
export interface AutoDeployment {
|
366
369
|
/**
|
367
|
-
* <p>If set to <code>true</code>, StackSets automatically deploys additional stack instances to
|
368
|
-
*
|
369
|
-
* is removed from a target organization or OU,
|
370
|
-
* Regions.</p>
|
370
|
+
* <p>If set to <code>true</code>, StackSets automatically deploys additional stack instances to
|
371
|
+
* Organizations accounts that are added to a target organization or organizational unit
|
372
|
+
* (OU) in the specified Regions. If an account is removed from a target organization or OU,
|
373
|
+
* StackSets deletes stack instances from the account in the specified Regions.</p>
|
371
374
|
* @public
|
372
375
|
*/
|
373
376
|
Enabled?: boolean | undefined;
|
374
377
|
/**
|
375
|
-
* <p>If set to <code>true</code>, stack resources are retained when an account is removed from a
|
376
|
-
* or OU. If set to <code>false</code>, stack resources are deleted. Specify
|
377
|
-
*
|
378
|
+
* <p>If set to <code>true</code>, stack resources are retained when an account is removed from a
|
379
|
+
* target organization or OU. If set to <code>false</code>, stack resources are deleted. Specify
|
380
|
+
* only if <code>Enabled</code> is set to <code>True</code>.</p>
|
378
381
|
* @public
|
379
382
|
*/
|
380
383
|
RetainStacksOnAccountRemoval?: boolean | undefined;
|
@@ -1046,8 +1049,8 @@ export interface Change {
|
|
1046
1049
|
*/
|
1047
1050
|
Type?: ChangeType | undefined;
|
1048
1051
|
/**
|
1049
|
-
* <p>Is either <code>null</code>, if no
|
1050
|
-
*
|
1052
|
+
* <p>Is either <code>null</code>, if no Hooks invoke for the resource, or contains the number
|
1053
|
+
* of Hooks that will invoke for the resource.</p>
|
1051
1054
|
* @public
|
1052
1055
|
*/
|
1053
1056
|
HookInvocationCount?: number | undefined;
|
@@ -1082,7 +1085,7 @@ export declare const HookInvocationPoint: {
|
|
1082
1085
|
*/
|
1083
1086
|
export type HookInvocationPoint = (typeof HookInvocationPoint)[keyof typeof HookInvocationPoint];
|
1084
1087
|
/**
|
1085
|
-
* <p>Specifies <code>RESOURCE</code> type target details for activated
|
1088
|
+
* <p>Specifies <code>RESOURCE</code> type target details for activated Hooks.</p>
|
1086
1089
|
* @public
|
1087
1090
|
*/
|
1088
1091
|
export interface ChangeSetHookResourceTargetDetails {
|
@@ -1313,7 +1316,7 @@ export interface ChangeSetSummary {
|
|
1313
1316
|
*/
|
1314
1317
|
ExecutionStatus?: ExecutionStatus | undefined;
|
1315
1318
|
/**
|
1316
|
-
* <p>The state of the change set, such as <code>
|
1319
|
+
* <p>The state of the change set, such as <code>CREATE_PENDING</code>,
|
1317
1320
|
* <code>CREATE_COMPLETE</code>, or <code>FAILED</code>.</p>
|
1318
1321
|
* @public
|
1319
1322
|
*/
|
@@ -1481,8 +1484,9 @@ export interface Parameter {
|
|
1481
1484
|
UsePreviousValue?: boolean | undefined;
|
1482
1485
|
/**
|
1483
1486
|
* <p>Read-only. The value that corresponds to a Systems Manager parameter key. This field is returned only
|
1484
|
-
* for Systems Manager parameter types in the template. For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cloudformation-supplied-parameter-types.html">
|
1485
|
-
* CloudFormation-supplied parameter types</a> in the
|
1487
|
+
* for Systems Manager parameter types in the template. For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cloudformation-supplied-parameter-types.html">Specify
|
1488
|
+
* existing resources at runtime with CloudFormation-supplied parameter types</a> in the
|
1489
|
+
* <i>CloudFormation User Guide</i>.</p>
|
1486
1490
|
* @public
|
1487
1491
|
*/
|
1488
1492
|
ResolvedValue?: string | undefined;
|
@@ -1628,8 +1632,8 @@ export interface CreateChangeSetInput {
|
|
1628
1632
|
*/
|
1629
1633
|
TemplateBody?: string | undefined;
|
1630
1634
|
/**
|
1631
|
-
* <p>The
|
1632
|
-
* template (max size:
|
1635
|
+
* <p>The URL of the file that contains the revised template. The URL must point to a
|
1636
|
+
* template (max size: 1 MB) that's located in an Amazon S3 bucket or a Systems Manager
|
1633
1637
|
* document. CloudFormation generates the change set by comparing this template with the stack that
|
1634
1638
|
* you specified. The location for an Amazon S3 bucket must start with <code>https://</code>.</p>
|
1635
1639
|
* <p>Conditional: You must specify only <code>TemplateBody</code> or
|
@@ -1697,6 +1701,12 @@ export interface CreateChangeSetInput {
|
|
1697
1701
|
* </li>
|
1698
1702
|
* <li>
|
1699
1703
|
* <p>
|
1704
|
+
* <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-managedpolicy.html">
|
1705
|
+
* AWS::IAM::ManagedPolicy</a>
|
1706
|
+
* </p>
|
1707
|
+
* </li>
|
1708
|
+
* <li>
|
1709
|
+
* <p>
|
1700
1710
|
* <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-policy.html">
|
1701
1711
|
* AWS::IAM::Policy</a>
|
1702
1712
|
* </p>
|
@@ -1719,7 +1729,7 @@ export interface CreateChangeSetInput {
|
|
1719
1729
|
* </p>
|
1720
1730
|
* </li>
|
1721
1731
|
* </ul>
|
1722
|
-
* <p>For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/
|
1732
|
+
* <p>For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/control-access-with-iam.html#using-iam-capabilities">Acknowledging IAM resources in CloudFormation templates</a>.</p>
|
1723
1733
|
* </li>
|
1724
1734
|
* <li>
|
1725
1735
|
* <p>
|
@@ -1732,7 +1742,7 @@ export interface CreateChangeSetInput {
|
|
1732
1742
|
* before actually creating the stack. If your stack template contains one or more macros,
|
1733
1743
|
* and you choose to create a stack directly from the processed template, without first
|
1734
1744
|
* reviewing the resulting changes in a change set, you must acknowledge this capability.
|
1735
|
-
* This includes the <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/
|
1745
|
+
* This includes the <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/transform-aws-include.html">AWS::Include</a> and <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/transform-aws-serverless.html">AWS::Serverless</a> transforms, which are macros hosted by CloudFormation.</p>
|
1736
1746
|
* <note>
|
1737
1747
|
* <p>This capacity doesn't apply to creating change sets, and specifying it when creating
|
1738
1748
|
* change sets has no effect.</p>
|
@@ -1758,7 +1768,7 @@ export interface CreateChangeSetInput {
|
|
1758
1768
|
* <p>If the list of resource types doesn't include a resource type that you're updating, the
|
1759
1769
|
* stack update fails. By default, CloudFormation grants permissions to all resource types. IAM
|
1760
1770
|
* uses this parameter for condition keys in IAM policies for CloudFormation. For more information,
|
1761
|
-
* see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/
|
1771
|
+
* see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/control-access-with-iam.html">Control access with
|
1762
1772
|
* Identity and Access Management</a> in the <i>CloudFormation User Guide</i>.</p>
|
1763
1773
|
* <note>
|
1764
1774
|
* <p>Only one of the <code>Capabilities</code> and <code>ResourceType</code> parameters can
|
@@ -2124,8 +2134,8 @@ export interface CreateStackInput {
|
|
2124
2134
|
*/
|
2125
2135
|
TemplateBody?: string | undefined;
|
2126
2136
|
/**
|
2127
|
-
* <p>
|
2128
|
-
*
|
2137
|
+
* <p>The URL of a file containing the template body. The URL must point to a template (max size:
|
2138
|
+
* 1 MB) that's located in an Amazon S3 bucket or a Systems Manager document. The location
|
2129
2139
|
* for an Amazon S3 bucket must start with <code>https://</code>.</p>
|
2130
2140
|
* <p>Conditional: You must specify either the <code>TemplateBody</code> or the
|
2131
2141
|
* <code>TemplateURL</code> parameter, but not both.</p>
|
@@ -2213,6 +2223,12 @@ export interface CreateStackInput {
|
|
2213
2223
|
* </li>
|
2214
2224
|
* <li>
|
2215
2225
|
* <p>
|
2226
|
+
* <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-managedpolicy.html">
|
2227
|
+
* AWS::IAM::ManagedPolicy</a>
|
2228
|
+
* </p>
|
2229
|
+
* </li>
|
2230
|
+
* <li>
|
2231
|
+
* <p>
|
2216
2232
|
* <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-policy.html">AWS::IAM::Policy</a>
|
2217
2233
|
* </p>
|
2218
2234
|
* </li>
|
@@ -2232,7 +2248,7 @@ export interface CreateStackInput {
|
|
2232
2248
|
* </p>
|
2233
2249
|
* </li>
|
2234
2250
|
* </ul>
|
2235
|
-
* <p>For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/
|
2251
|
+
* <p>For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/control-access-with-iam.html#using-iam-capabilities">Acknowledging IAM resources in CloudFormation templates</a>.</p>
|
2236
2252
|
* </li>
|
2237
2253
|
* <li>
|
2238
2254
|
* <p>
|
@@ -2245,7 +2261,7 @@ export interface CreateStackInput {
|
|
2245
2261
|
* before actually creating the stack. If your stack template contains one or more macros,
|
2246
2262
|
* and you choose to create a stack directly from the processed template, without first
|
2247
2263
|
* reviewing the resulting changes in a change set, you must acknowledge this capability.
|
2248
|
-
* This includes the <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/
|
2264
|
+
* This includes the <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/transform-aws-include.html">AWS::Include</a> and <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/transform-aws-serverless.html">AWS::Serverless</a> transforms, which are macros hosted by CloudFormation.</p>
|
2249
2265
|
* <p>If you want to create a stack from a stack template that contains macros
|
2250
2266
|
* <i>and</i> nested stacks, you must create the stack directly from the
|
2251
2267
|
* template using this capability.</p>
|
@@ -2281,7 +2297,7 @@ export interface CreateStackInput {
|
|
2281
2297
|
* <p>If the list of resource types doesn't include a resource that you're creating, the stack
|
2282
2298
|
* creation fails. By default, CloudFormation grants permissions to all resource types. IAM uses
|
2283
2299
|
* this parameter for CloudFormation-specific condition keys in IAM policies. For more information,
|
2284
|
-
* see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/
|
2300
|
+
* see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/control-access-with-iam.html">Control access with
|
2285
2301
|
* Identity and Access Management</a>.</p>
|
2286
2302
|
* <note>
|
2287
2303
|
* <p>Only one of the <code>Capabilities</code> and <code>ResourceType</code> parameters can
|
@@ -2386,52 +2402,62 @@ export interface CreateStackOutput {
|
|
2386
2402
|
StackId?: string | undefined;
|
2387
2403
|
}
|
2388
2404
|
/**
|
2389
|
-
* <p>[Service-managed permissions] The Organizations accounts to which StackSets deploys.
|
2390
|
-
* deploy stack instances to the organization management account, even
|
2391
|
-
*
|
2392
|
-
*
|
2405
|
+
* <p>[Service-managed permissions] The Organizations accounts to which StackSets deploys.
|
2406
|
+
* StackSets doesn't deploy stack instances to the organization management account, even
|
2407
|
+
* if the organization management account is in your organization or in an OU in your
|
2408
|
+
* organization.</p>
|
2409
|
+
* <p>For update operations, you can specify either <code>Accounts</code> or
|
2410
|
+
* <code>OrganizationalUnitIds</code>. For create and delete operations, specify
|
2411
|
+
* <code>OrganizationalUnitIds</code>.</p>
|
2393
2412
|
* @public
|
2394
2413
|
*/
|
2395
2414
|
export interface DeploymentTargets {
|
2396
2415
|
/**
|
2397
|
-
* <p>The
|
2416
|
+
* <p>The account IDs of the Amazon Web Services accounts. If you have many account numbers, you can provide those accounts using the <code>AccountsUrl</code> property instead.</p>
|
2398
2417
|
* @public
|
2399
2418
|
*/
|
2400
2419
|
Accounts?: string[] | undefined;
|
2401
2420
|
/**
|
2402
|
-
* <p>
|
2421
|
+
* <p>The Amazon S3 URL path to a file that contains a list of Amazon Web Services account IDs. The file format must be either <code>.csv</code>
|
2422
|
+
* or <code>.txt</code>, and the data can be comma-separated or new-line-separated. There is currently a 10MB
|
2423
|
+
* limit for the data (approximately 800,000 accounts).</p>
|
2424
|
+
* <p></p>
|
2403
2425
|
* @public
|
2404
2426
|
*/
|
2405
2427
|
AccountsUrl?: string | undefined;
|
2406
2428
|
/**
|
2407
|
-
* <p>The organization root ID or organizational unit (OU) IDs
|
2429
|
+
* <p>The organization root ID or organizational unit (OU) IDs.</p>
|
2408
2430
|
* @public
|
2409
2431
|
*/
|
2410
2432
|
OrganizationalUnitIds?: string[] | undefined;
|
2411
2433
|
/**
|
2412
|
-
* <p>Limit deployment targets to individual accounts or include additional accounts with provided
|
2413
|
-
*
|
2434
|
+
* <p>Limit deployment targets to individual accounts or include additional accounts with provided
|
2435
|
+
* OUs.</p>
|
2436
|
+
* <p>The following is a list of possible values for the <code>AccountFilterType</code>
|
2437
|
+
* operation.</p>
|
2414
2438
|
* <ul>
|
2415
2439
|
* <li>
|
2416
2440
|
* <p>
|
2417
|
-
* <code>INTERSECTION</code>: StackSets deploys to the accounts specified in
|
2418
|
-
*
|
2441
|
+
* <code>INTERSECTION</code>: StackSets deploys to the accounts specified in
|
2442
|
+
* <code>Accounts</code> parameter. </p>
|
2419
2443
|
* </li>
|
2420
2444
|
* <li>
|
2421
2445
|
* <p>
|
2422
|
-
* <code>DIFFERENCE</code>: StackSets excludes the accounts specified in
|
2423
|
-
*
|
2446
|
+
* <code>DIFFERENCE</code>: StackSets excludes the accounts specified in
|
2447
|
+
* <code>Accounts</code> parameter. This enables user to avoid certain accounts within an OU such
|
2448
|
+
* as suspended accounts.</p>
|
2424
2449
|
* </li>
|
2425
2450
|
* <li>
|
2426
2451
|
* <p>
|
2427
2452
|
* <code>UNION</code>: StackSets includes additional accounts deployment targets. </p>
|
2428
|
-
* <p>This is the default value if <code>AccountFilterType</code> is not provided. This enables
|
2429
|
-
* entire OU and individual accounts from a different OU in one request, which
|
2430
|
-
* requests.</p>
|
2453
|
+
* <p>This is the default value if <code>AccountFilterType</code> is not provided. This enables
|
2454
|
+
* user to update an entire OU and individual accounts from a different OU in one request, which
|
2455
|
+
* used to be two separate requests.</p>
|
2431
2456
|
* </li>
|
2432
2457
|
* <li>
|
2433
2458
|
* <p>
|
2434
|
-
* <code>NONE</code>: Deploys to all the accounts in specified organizational units
|
2459
|
+
* <code>NONE</code>: Deploys to all the accounts in specified organizational units
|
2460
|
+
* (OU).</p>
|
2435
2461
|
* </li>
|
2436
2462
|
* </ul>
|
2437
2463
|
* @public
|
@@ -2464,14 +2490,14 @@ export declare const RegionConcurrencyType: {
|
|
2464
2490
|
export type RegionConcurrencyType = (typeof RegionConcurrencyType)[keyof typeof RegionConcurrencyType];
|
2465
2491
|
/**
|
2466
2492
|
* <p>The user-specified preferences for how CloudFormation performs a stack set operation.</p>
|
2467
|
-
* <p>For more information about maximum concurrent accounts and failure tolerance, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/what-is-cfnstacksets.html#stackset-ops-options">Stack
|
2468
|
-
* options</a>.</p>
|
2493
|
+
* <p>For more information about maximum concurrent accounts and failure tolerance, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/what-is-cfnstacksets.html#stackset-ops-options">Stack
|
2494
|
+
* set operation options</a>.</p>
|
2469
2495
|
* @public
|
2470
2496
|
*/
|
2471
2497
|
export interface StackSetOperationPreferences {
|
2472
2498
|
/**
|
2473
|
-
* <p>The concurrency type of deploying StackSets operations in Regions, could be in parallel or
|
2474
|
-
* time.</p>
|
2499
|
+
* <p>The concurrency type of deploying StackSets operations in Regions, could be in parallel or
|
2500
|
+
* one Region at a time.</p>
|
2475
2501
|
* @public
|
2476
2502
|
*/
|
2477
2503
|
RegionConcurrencyType?: RegionConcurrencyType | undefined;
|
@@ -2485,9 +2511,9 @@ export interface StackSetOperationPreferences {
|
|
2485
2511
|
*/
|
2486
2512
|
RegionOrder?: string[] | undefined;
|
2487
2513
|
/**
|
2488
|
-
* <p>The number of accounts, per Region, for which this operation can fail before CloudFormation
|
2489
|
-
* that Region. If the operation is stopped in a Region, CloudFormation doesn't
|
2490
|
-
* Regions.</p>
|
2514
|
+
* <p>The number of accounts, per Region, for which this operation can fail before CloudFormation
|
2515
|
+
* stops the operation in that Region. If the operation is stopped in a Region, CloudFormation doesn't
|
2516
|
+
* attempt the operation in any subsequent Regions.</p>
|
2491
2517
|
* <p>Conditional: You must specify either <code>FailureToleranceCount</code> or
|
2492
2518
|
* <code>FailureTolerancePercentage</code> (but not both).</p>
|
2493
2519
|
* <p>By default, <code>0</code> is specified.</p>
|
@@ -2495,9 +2521,9 @@ export interface StackSetOperationPreferences {
|
|
2495
2521
|
*/
|
2496
2522
|
FailureToleranceCount?: number | undefined;
|
2497
2523
|
/**
|
2498
|
-
* <p>The percentage of accounts, per Region, for which this stack operation can fail before
|
2499
|
-
* in that Region. If the operation is stopped in a Region,
|
2500
|
-
* Regions.</p>
|
2524
|
+
* <p>The percentage of accounts, per Region, for which this stack operation can fail before
|
2525
|
+
* CloudFormation stops the operation in that Region. If the operation is stopped in a Region,
|
2526
|
+
* CloudFormation doesn't attempt the operation in any subsequent Regions.</p>
|
2501
2527
|
* <p>When calculating the number of accounts based on the specified percentage, CloudFormation rounds
|
2502
2528
|
* <i>down</i> to the next whole number.</p>
|
2503
2529
|
* <p>Conditional: You must specify either <code>FailureToleranceCount</code> or
|
@@ -2507,28 +2533,29 @@ export interface StackSetOperationPreferences {
|
|
2507
2533
|
*/
|
2508
2534
|
FailureTolerancePercentage?: number | undefined;
|
2509
2535
|
/**
|
2510
|
-
* <p>The maximum number of accounts in which to perform this operation at one time. This can
|
2511
|
-
*
|
2512
|
-
*
|
2513
|
-
*
|
2514
|
-
* <p>Note that this setting lets you specify the <i>maximum</i> for operations. For
|
2515
|
-
* under certain circumstances the actual number of accounts acted upon
|
2516
|
-
* throttling.</p>
|
2517
|
-
* <p>Conditional: You must specify either <code>MaxConcurrentCount</code> or
|
2518
|
-
*
|
2536
|
+
* <p>The maximum number of accounts in which to perform this operation at one time. This can
|
2537
|
+
* depend on the value of <code>FailureToleranceCount</code> depending on your
|
2538
|
+
* <code>ConcurrencyMode</code>. <code>MaxConcurrentCount</code> is at most one more than the
|
2539
|
+
* <code>FailureToleranceCount</code> if you're using <code>STRICT_FAILURE_TOLERANCE</code>.</p>
|
2540
|
+
* <p>Note that this setting lets you specify the <i>maximum</i> for operations. For
|
2541
|
+
* large deployments, under certain circumstances the actual number of accounts acted upon
|
2542
|
+
* concurrently may be lower due to service throttling.</p>
|
2543
|
+
* <p>Conditional: You must specify either <code>MaxConcurrentCount</code> or
|
2544
|
+
* <code>MaxConcurrentPercentage</code>, but not both.</p>
|
2519
2545
|
* <p>By default, <code>1</code> is specified.</p>
|
2520
2546
|
* @public
|
2521
2547
|
*/
|
2522
2548
|
MaxConcurrentCount?: number | undefined;
|
2523
2549
|
/**
|
2524
2550
|
* <p>The maximum percentage of accounts in which to perform this operation at one time.</p>
|
2525
|
-
* <p>When calculating the number of accounts based on the specified percentage, CloudFormation rounds
|
2526
|
-
* whole number. This is true except in cases where rounding down would result is
|
2527
|
-
*
|
2528
|
-
*
|
2529
|
-
*
|
2530
|
-
*
|
2531
|
-
*
|
2551
|
+
* <p>When calculating the number of accounts based on the specified percentage, CloudFormation rounds
|
2552
|
+
* down to the next whole number. This is true except in cases where rounding down would result is
|
2553
|
+
* zero. In this case, CloudFormation sets the number as one instead.</p>
|
2554
|
+
* <p>Note that this setting lets you specify the <i>maximum</i> for operations. For
|
2555
|
+
* large deployments, under certain circumstances the actual number of accounts acted upon
|
2556
|
+
* concurrently may be lower due to service throttling.</p>
|
2557
|
+
* <p>Conditional: You must specify either <code>MaxConcurrentCount</code> or
|
2558
|
+
* <code>MaxConcurrentPercentage</code>, but not both.</p>
|
2532
2559
|
* <p>By default, <code>1</code> is specified.</p>
|
2533
2560
|
* @public
|
2534
2561
|
*/
|
@@ -2538,19 +2565,21 @@ export interface StackSetOperationPreferences {
|
|
2538
2565
|
* <ul>
|
2539
2566
|
* <li>
|
2540
2567
|
* <p>
|
2541
|
-
* <code>STRICT_FAILURE_TOLERANCE</code>: This option dynamically lowers the concurrency
|
2542
|
-
* number of failed accounts never exceeds the value of
|
2543
|
-
*
|
2544
|
-
* <code>
|
2545
|
-
*
|
2546
|
-
*
|
2568
|
+
* <code>STRICT_FAILURE_TOLERANCE</code>: This option dynamically lowers the concurrency
|
2569
|
+
* level to ensure the number of failed accounts never exceeds the value of
|
2570
|
+
* <code>FailureToleranceCount</code> +1. The initial actual concurrency is set to the lower of
|
2571
|
+
* either the value of the <code>MaxConcurrentCount</code>, or the value of
|
2572
|
+
* <code>FailureToleranceCount</code> +1. The actual concurrency is then reduced proportionally
|
2573
|
+
* by the number of failures. This is the default behavior.</p>
|
2574
|
+
* <p>If failure tolerance or Maximum concurrent accounts are set to percentages, the behavior
|
2575
|
+
* is similar.</p>
|
2547
2576
|
* </li>
|
2548
2577
|
* <li>
|
2549
2578
|
* <p>
|
2550
|
-
* <code>SOFT_FAILURE_TOLERANCE</code>: This option decouples
|
2551
|
-
*
|
2552
|
-
*
|
2553
|
-
*
|
2579
|
+
* <code>SOFT_FAILURE_TOLERANCE</code>: This option decouples
|
2580
|
+
* <code>FailureToleranceCount</code> from the actual concurrency. This allows stack set
|
2581
|
+
* operations to run at the concurrency level set by the <code>MaxConcurrentCount</code> value, or
|
2582
|
+
* <code>MaxConcurrentPercentage</code>, regardless of the number of failures.</p>
|
2554
2583
|
* </li>
|
2555
2584
|
* </ul>
|
2556
2585
|
* @public
|
@@ -2568,8 +2597,8 @@ export interface CreateStackInstancesInput {
|
|
2568
2597
|
*/
|
2569
2598
|
StackSetName: string | undefined;
|
2570
2599
|
/**
|
2571
|
-
* <p>[Self-managed permissions] The
|
2572
|
-
* stack instances in the specified Region(s) for.</p>
|
2600
|
+
* <p>[Self-managed permissions] The account IDs of one or more Amazon Web Services accounts that you want to
|
2601
|
+
* create stack instances in the specified Region(s) for.</p>
|
2573
2602
|
* <p>You can specify <code>Accounts</code> or <code>DeploymentTargets</code>, but not
|
2574
2603
|
* both.</p>
|
2575
2604
|
* @public
|
@@ -2725,6 +2754,94 @@ export declare class StaleRequestException extends __BaseException {
|
|
2725
2754
|
*/
|
2726
2755
|
constructor(opts: __ExceptionOptionType<StaleRequestException, __BaseException>);
|
2727
2756
|
}
|
2757
|
+
/**
|
2758
|
+
* <p>The location of the resource in a stack template.</p>
|
2759
|
+
* @public
|
2760
|
+
*/
|
2761
|
+
export interface ResourceLocation {
|
2762
|
+
/**
|
2763
|
+
* <p>The name associated with the stack.</p>
|
2764
|
+
* @public
|
2765
|
+
*/
|
2766
|
+
StackName: string | undefined;
|
2767
|
+
/**
|
2768
|
+
* <p>The logical name of the resource specified in the template.</p>
|
2769
|
+
* @public
|
2770
|
+
*/
|
2771
|
+
LogicalResourceId: string | undefined;
|
2772
|
+
}
|
2773
|
+
/**
|
2774
|
+
* <p>Specifies the current source of the resource and the destination of where it will be moved to.</p>
|
2775
|
+
* @public
|
2776
|
+
*/
|
2777
|
+
export interface ResourceMapping {
|
2778
|
+
/**
|
2779
|
+
* <p>The source stack <code>StackName</code> and <code>LogicalResourceId</code> for the resource being refactored.</p>
|
2780
|
+
* @public
|
2781
|
+
*/
|
2782
|
+
Source: ResourceLocation | undefined;
|
2783
|
+
/**
|
2784
|
+
* <p>The destination stack <code>StackName</code> and <code>LogicalResourceId</code> for the resource being refactored.</p>
|
2785
|
+
* @public
|
2786
|
+
*/
|
2787
|
+
Destination: ResourceLocation | undefined;
|
2788
|
+
}
|
2789
|
+
/**
|
2790
|
+
* <p>Describes the stack and the template used by the stack.</p>
|
2791
|
+
* @public
|
2792
|
+
*/
|
2793
|
+
export interface StackDefinition {
|
2794
|
+
/**
|
2795
|
+
* <p>The name associated with the stack.</p>
|
2796
|
+
* @public
|
2797
|
+
*/
|
2798
|
+
StackName?: string | undefined;
|
2799
|
+
/**
|
2800
|
+
* <p>The file path for the stack template file.</p>
|
2801
|
+
* @public
|
2802
|
+
*/
|
2803
|
+
TemplateBody?: string | undefined;
|
2804
|
+
/**
|
2805
|
+
* <p>The desired final state of the stack template.</p>
|
2806
|
+
* @public
|
2807
|
+
*/
|
2808
|
+
TemplateURL?: string | undefined;
|
2809
|
+
}
|
2810
|
+
/**
|
2811
|
+
* @public
|
2812
|
+
*/
|
2813
|
+
export interface CreateStackRefactorInput {
|
2814
|
+
/**
|
2815
|
+
* <p>A description to help you identify the stack refactor.</p>
|
2816
|
+
* @public
|
2817
|
+
*/
|
2818
|
+
Description?: string | undefined;
|
2819
|
+
/**
|
2820
|
+
* <p>Determines if a new stack is created with the refactor.</p>
|
2821
|
+
* @public
|
2822
|
+
*/
|
2823
|
+
EnableStackCreation?: boolean | undefined;
|
2824
|
+
/**
|
2825
|
+
* <p>The mappings for the stack resource <code>Source</code> and stack resource <code>Destination</code>.</p>
|
2826
|
+
* @public
|
2827
|
+
*/
|
2828
|
+
ResourceMappings?: ResourceMapping[] | undefined;
|
2829
|
+
/**
|
2830
|
+
* <p>The stacks being refactored.</p>
|
2831
|
+
* @public
|
2832
|
+
*/
|
2833
|
+
StackDefinitions: StackDefinition[] | undefined;
|
2834
|
+
}
|
2835
|
+
/**
|
2836
|
+
* @public
|
2837
|
+
*/
|
2838
|
+
export interface CreateStackRefactorOutput {
|
2839
|
+
/**
|
2840
|
+
* <p>The ID associated with the stack refactor created from the <a>CreateStackRefactor</a> action.</p>
|
2841
|
+
* @public
|
2842
|
+
*/
|
2843
|
+
StackRefactorId: string | undefined;
|
2844
|
+
}
|
2728
2845
|
/**
|
2729
2846
|
* <p>The specified resource exists, but has been changed.</p>
|
2730
2847
|
* @public
|
@@ -2739,21 +2856,23 @@ export declare class CreatedButModifiedException extends __BaseException {
|
|
2739
2856
|
constructor(opts: __ExceptionOptionType<CreatedButModifiedException, __BaseException>);
|
2740
2857
|
}
|
2741
2858
|
/**
|
2742
|
-
* <p>Describes whether StackSets performs non-conflicting operations concurrently and queues
|
2743
|
-
* operations.</p>
|
2859
|
+
* <p>Describes whether StackSets performs non-conflicting operations concurrently and queues
|
2860
|
+
* conflicting operations.</p>
|
2744
2861
|
* @public
|
2745
2862
|
*/
|
2746
2863
|
export interface ManagedExecution {
|
2747
2864
|
/**
|
2748
|
-
* <p>When <code>true</code>, StackSets performs non-conflicting operations concurrently and
|
2749
|
-
* operations. After conflicting operations finish, StackSets starts queued
|
2865
|
+
* <p>When <code>true</code>, StackSets performs non-conflicting operations concurrently and
|
2866
|
+
* queues conflicting operations. After conflicting operations finish, StackSets starts queued
|
2867
|
+
* operations in request order.</p>
|
2750
2868
|
* <note>
|
2751
|
-
* <p>If there are already running or queued operations, StackSets queues all incoming operations
|
2752
|
-
* non-conflicting.</p>
|
2753
|
-
* <p>You can't modify your stack set's execution configuration while there are running or queued
|
2754
|
-
* stack set.</p>
|
2869
|
+
* <p>If there are already running or queued operations, StackSets queues all incoming operations
|
2870
|
+
* even if they are non-conflicting.</p>
|
2871
|
+
* <p>You can't modify your stack set's execution configuration while there are running or queued
|
2872
|
+
* operations for that stack set.</p>
|
2755
2873
|
* </note>
|
2756
|
-
* <p>When <code>false</code> (default), StackSets performs one operation at a time in request
|
2874
|
+
* <p>When <code>false</code> (default), StackSets performs one operation at a time in request
|
2875
|
+
* order.</p>
|
2757
2876
|
* @public
|
2758
2877
|
*/
|
2759
2878
|
Active?: boolean | undefined;
|
@@ -2799,9 +2918,9 @@ export interface CreateStackSetInput {
|
|
2799
2918
|
*/
|
2800
2919
|
TemplateBody?: string | undefined;
|
2801
2920
|
/**
|
2802
|
-
* <p>The
|
2803
|
-
* (maximum size:
|
2804
|
-
*
|
2921
|
+
* <p>The URL of a file that contains the template body. The URL must point to a template
|
2922
|
+
* (maximum size: 1 MB) that's located in an Amazon S3 bucket or a Systems Manager document.
|
2923
|
+
* The location for an Amazon S3 bucket must start with <code>https://</code>.</p>
|
2805
2924
|
* <p>Conditional: You must specify either the TemplateBody or the TemplateURL parameter, but
|
2806
2925
|
* not both.</p>
|
2807
2926
|
* @public
|
@@ -2884,7 +3003,7 @@ export interface CreateStackSetInput {
|
|
2884
3003
|
* </p>
|
2885
3004
|
* </li>
|
2886
3005
|
* </ul>
|
2887
|
-
* <p>For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/
|
3006
|
+
* <p>For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/control-access-with-iam.html#using-iam-capabilities">Acknowledging IAM resources in CloudFormation templates</a>.</p>
|
2888
3007
|
* </li>
|
2889
3008
|
* <li>
|
2890
3009
|
* <p>
|
@@ -2893,11 +3012,11 @@ export interface CreateStackSetInput {
|
|
2893
3012
|
* <p>Some templates reference macros. If your stack set template references one or more
|
2894
3013
|
* macros, you must create the stack set directly from the processed template, without first
|
2895
3014
|
* reviewing the resulting changes in a change set. To create the stack set directly, you
|
2896
|
-
* must acknowledge this capability. For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-macros.html">
|
2897
|
-
*
|
3015
|
+
* must acknowledge this capability. For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-macros.html">Perform custom processing
|
3016
|
+
* on CloudFormation templates with template macros</a>.</p>
|
2898
3017
|
* <important>
|
2899
3018
|
* <p>Stack sets with service-managed permissions don't currently support the use of
|
2900
|
-
* macros in templates. (This includes the <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/
|
3019
|
+
* macros in templates. (This includes the <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/transform-aws-include.html">AWS::Include</a> and <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/transform-aws-serverless.html">AWS::Serverless</a> transforms, which are macros hosted by CloudFormation.) Even if
|
2901
3020
|
* you specify this capability for a stack set with service-managed permissions, if you
|
2902
3021
|
* reference a macro in your template the stack set operation will fail.</p>
|
2903
3022
|
* </important>
|
@@ -2921,9 +3040,8 @@ export interface CreateStackSetInput {
|
|
2921
3040
|
* <p>The Amazon Resource Name (ARN) of the IAM role to use to create this stack set.</p>
|
2922
3041
|
* <p>Specify an IAM role only if you are using customized administrator roles to control
|
2923
3042
|
* which users or groups can manage specific stack sets within the same administrator account.
|
2924
|
-
* For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-prereqs.html">Prerequisites
|
2925
|
-
*
|
2926
|
-
* <i>CloudFormation User Guide</i>.</p>
|
3043
|
+
* For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-prereqs.html">Prerequisites for using
|
3044
|
+
* StackSets</a> in the <i>CloudFormation User Guide</i>.</p>
|
2927
3045
|
* @public
|
2928
3046
|
*/
|
2929
3047
|
AdministrationRoleARN?: string | undefined;
|
@@ -2943,13 +3061,12 @@ export interface CreateStackSetInput {
|
|
2943
3061
|
* <li>
|
2944
3062
|
* <p>With <code>self-managed</code> permissions, you must create the administrator and
|
2945
3063
|
* execution roles required to deploy to target accounts. For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-prereqs-self-managed.html">Grant
|
2946
|
-
*
|
3064
|
+
* self-managed permissions</a>.</p>
|
2947
3065
|
* </li>
|
2948
3066
|
* <li>
|
2949
3067
|
* <p>With <code>service-managed</code> permissions, StackSets automatically creates the
|
2950
3068
|
* IAM roles required to deploy to accounts managed by Organizations. For more
|
2951
|
-
* information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-
|
2952
|
-
* Service-Managed Stack Set Permissions</a>.</p>
|
3069
|
+
* information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-orgs-activate-trusted-access.html">Activate trusted access for stack sets with Organizations</a>.</p>
|
2953
3070
|
* </li>
|
2954
3071
|
* </ul>
|
2955
3072
|
* @public
|
@@ -3213,8 +3330,8 @@ export interface DeleteStackInstancesInput {
|
|
3213
3330
|
*/
|
3214
3331
|
StackSetName: string | undefined;
|
3215
3332
|
/**
|
3216
|
-
* <p>[Self-managed permissions] The
|
3217
|
-
* instances for.</p>
|
3333
|
+
* <p>[Self-managed permissions] The account IDs of the Amazon Web Services accounts that you want to delete
|
3334
|
+
* stack instances for.</p>
|
3218
3335
|
* <p>You can specify <code>Accounts</code> or <code>DeploymentTargets</code>, but not
|
3219
3336
|
* both.</p>
|
3220
3337
|
* @public
|
@@ -3500,7 +3617,7 @@ export interface DescribeChangeSetOutput {
|
|
3500
3617
|
*/
|
3501
3618
|
ExecutionStatus?: ExecutionStatus | undefined;
|
3502
3619
|
/**
|
3503
|
-
* <p>The current status of the change set, such as <code>
|
3620
|
+
* <p>The current status of the change set, such as <code>CREATE_PENDING</code>,
|
3504
3621
|
* <code>CREATE_COMPLETE</code>, or <code>FAILED</code>.</p>
|
3505
3622
|
* @public
|
3506
3623
|
*/
|
@@ -3624,7 +3741,7 @@ export interface DescribeChangeSetHooksInput {
|
|
3624
3741
|
*/
|
3625
3742
|
NextToken?: string | undefined;
|
3626
3743
|
/**
|
3627
|
-
* <p>If specified, lists only the
|
3744
|
+
* <p>If specified, lists only the Hooks related to the specified
|
3628
3745
|
* <code>LogicalResourceId</code>.</p>
|
3629
3746
|
* @public
|
3630
3747
|
*/
|
@@ -4439,6 +4556,12 @@ export declare const ResourceStatus: {
|
|
4439
4556
|
readonly DELETE_FAILED: "DELETE_FAILED";
|
4440
4557
|
readonly DELETE_IN_PROGRESS: "DELETE_IN_PROGRESS";
|
4441
4558
|
readonly DELETE_SKIPPED: "DELETE_SKIPPED";
|
4559
|
+
readonly EXPORT_COMPLETE: "EXPORT_COMPLETE";
|
4560
|
+
readonly EXPORT_FAILED: "EXPORT_FAILED";
|
4561
|
+
readonly EXPORT_IN_PROGRESS: "EXPORT_IN_PROGRESS";
|
4562
|
+
readonly EXPORT_ROLLBACK_COMPLETE: "EXPORT_ROLLBACK_COMPLETE";
|
4563
|
+
readonly EXPORT_ROLLBACK_FAILED: "EXPORT_ROLLBACK_FAILED";
|
4564
|
+
readonly EXPORT_ROLLBACK_IN_PROGRESS: "EXPORT_ROLLBACK_IN_PROGRESS";
|
4442
4565
|
readonly IMPORT_COMPLETE: "IMPORT_COMPLETE";
|
4443
4566
|
readonly IMPORT_FAILED: "IMPORT_FAILED";
|
4444
4567
|
readonly IMPORT_IN_PROGRESS: "IMPORT_IN_PROGRESS";
|
@@ -4546,7 +4669,7 @@ export interface StackEvent {
|
|
4546
4669
|
*/
|
4547
4670
|
HookStatusReason?: string | undefined;
|
4548
4671
|
/**
|
4549
|
-
* <p>Invocation points are points in provisioning logic where
|
4672
|
+
* <p>Invocation points are points in provisioning logic where Hooks are initiated.</p>
|
4550
4673
|
* @public
|
4551
4674
|
*/
|
4552
4675
|
HookInvocationPoint?: HookInvocationPoint | undefined;
|
@@ -4674,46 +4797,51 @@ export interface StackInstanceComprehensiveStatus {
|
|
4674
4797
|
* <ul>
|
4675
4798
|
* <li>
|
4676
4799
|
* <p>
|
4677
|
-
* <code>CANCELLED</code>: The operation in the specified account and Region has been
|
4678
|
-
* because a user has stopped the stack set operation, or because the
|
4679
|
-
* been exceeded.</p>
|
4800
|
+
* <code>CANCELLED</code>: The operation in the specified account and Region has been
|
4801
|
+
* canceled. This is either because a user has stopped the stack set operation, or because the
|
4802
|
+
* failure tolerance of the stack set operation has been exceeded.</p>
|
4680
4803
|
* </li>
|
4681
4804
|
* <li>
|
4682
4805
|
* <p>
|
4683
|
-
* <code>FAILED</code>: The operation in the specified account and Region failed. If the
|
4684
|
-
* fails in enough accounts within a Region, the failure tolerance for the
|
4685
|
-
* exceeded.</p>
|
4806
|
+
* <code>FAILED</code>: The operation in the specified account and Region failed. If the
|
4807
|
+
* stack set operation fails in enough accounts within a Region, the failure tolerance for the
|
4808
|
+
* stack set operation as a whole might be exceeded.</p>
|
4686
4809
|
* </li>
|
4687
4810
|
* <li>
|
4688
4811
|
* <p>
|
4689
|
-
* <code>FAILED_IMPORT</code>: The import of the stack instance in the specified account and
|
4690
|
-
* left the stack in an unstable state. Once the issues causing the failure are
|
4691
|
-
* retried. If enough stack set operations fail in enough
|
4692
|
-
* stack set operation as a whole might be
|
4812
|
+
* <code>FAILED_IMPORT</code>: The import of the stack instance in the specified account and
|
4813
|
+
* Region failed and left the stack in an unstable state. Once the issues causing the failure are
|
4814
|
+
* fixed, the import operation can be retried. If enough stack set operations fail in enough
|
4815
|
+
* accounts within a Region, the failure tolerance for the stack set operation as a whole might be
|
4816
|
+
* exceeded.</p>
|
4693
4817
|
* </li>
|
4694
4818
|
* <li>
|
4695
4819
|
* <p>
|
4696
|
-
* <code>INOPERABLE</code>: A <code>DeleteStackInstances</code> operation has failed and left
|
4697
|
-
* unstable state. Stacks in this state are excluded from further
|
4698
|
-
*
|
4820
|
+
* <code>INOPERABLE</code>: A <code>DeleteStackInstances</code> operation has failed and left
|
4821
|
+
* the stack in an unstable state. Stacks in this state are excluded from further
|
4822
|
+
* <code>UpdateStackSet</code> operations. You might need to perform a
|
4823
|
+
* <code>DeleteStackInstances</code> operation, with <code>RetainStacks</code> set to
|
4699
4824
|
* <code>true</code>, to delete the stack instance, and then delete the stack manually.</p>
|
4700
4825
|
* </li>
|
4701
4826
|
* <li>
|
4702
4827
|
* <p>
|
4703
|
-
* <code>PENDING</code>: The operation in the specified account and Region has yet to
|
4828
|
+
* <code>PENDING</code>: The operation in the specified account and Region has yet to
|
4829
|
+
* start.</p>
|
4704
4830
|
* </li>
|
4705
4831
|
* <li>
|
4706
4832
|
* <p>
|
4707
|
-
* <code>RUNNING</code>: The operation in the specified account and Region is currently in
|
4833
|
+
* <code>RUNNING</code>: The operation in the specified account and Region is currently in
|
4834
|
+
* progress.</p>
|
4708
4835
|
* </li>
|
4709
4836
|
* <li>
|
4710
4837
|
* <p>
|
4711
|
-
* <code>SKIPPED_SUSPENDED_ACCOUNT</code>: The operation in the specified account and Region
|
4712
|
-
* because the account was suspended at the time of the operation.</p>
|
4838
|
+
* <code>SKIPPED_SUSPENDED_ACCOUNT</code>: The operation in the specified account and Region
|
4839
|
+
* has been skipped because the account was suspended at the time of the operation.</p>
|
4713
4840
|
* </li>
|
4714
4841
|
* <li>
|
4715
4842
|
* <p>
|
4716
|
-
* <code>SUCCEEDED</code>: The operation in the specified account and Region completed
|
4843
|
+
* <code>SUCCEEDED</code>: The operation in the specified account and Region completed
|
4844
|
+
* successfully.</p>
|
4717
4845
|
* </li>
|
4718
4846
|
* </ul>
|
4719
4847
|
* @public
|
@@ -4734,11 +4862,12 @@ export declare const StackInstanceStatus: {
|
|
4734
4862
|
*/
|
4735
4863
|
export type StackInstanceStatus = (typeof StackInstanceStatus)[keyof typeof StackInstanceStatus];
|
4736
4864
|
/**
|
4737
|
-
* <p>A CloudFormation stack, in a specific account and Region, that's part of a stack set operation.
|
4738
|
-
* reference to an attempted or actual stack in a given account within a given
|
4739
|
-
* without a stack—for example, if the stack couldn't be created
|
4740
|
-
*
|
4741
|
-
*
|
4865
|
+
* <p>A CloudFormation stack, in a specific account and Region, that's part of a stack set operation.
|
4866
|
+
* A stack instance is a reference to an attempted or actual stack in a given account within a given
|
4867
|
+
* Region. A stack instance can exist without a stack—for example, if the stack couldn't be created
|
4868
|
+
* for some reason. A stack instance is associated with only one stack set. Each stack instance
|
4869
|
+
* contains the ID of its associated stack set, in addition to the ID of the actual stack and the
|
4870
|
+
* stack status.</p>
|
4742
4871
|
* @public
|
4743
4872
|
*/
|
4744
4873
|
export interface StackInstance {
|
@@ -4753,8 +4882,8 @@ export interface StackInstance {
|
|
4753
4882
|
*/
|
4754
4883
|
Region?: string | undefined;
|
4755
4884
|
/**
|
4756
|
-
* <p>[Self-managed permissions] The name of the Amazon Web Services account that the stack instance is
|
4757
|
-
* with.</p>
|
4885
|
+
* <p>[Self-managed permissions] The name of the Amazon Web Services account that the stack instance is
|
4886
|
+
* associated with.</p>
|
4758
4887
|
* @public
|
4759
4888
|
*/
|
4760
4889
|
Account?: string | undefined;
|
@@ -4764,36 +4893,40 @@ export interface StackInstance {
|
|
4764
4893
|
*/
|
4765
4894
|
StackId?: string | undefined;
|
4766
4895
|
/**
|
4767
|
-
* <p>A list of parameters from the stack set template whose values have been overridden in this
|
4768
|
-
* instance.</p>
|
4896
|
+
* <p>A list of parameters from the stack set template whose values have been overridden in this
|
4897
|
+
* stack instance.</p>
|
4769
4898
|
* @public
|
4770
4899
|
*/
|
4771
4900
|
ParameterOverrides?: Parameter[] | undefined;
|
4772
4901
|
/**
|
4773
|
-
* <p>The status of the stack instance, in terms of its synchronization with its associated stack
|
4902
|
+
* <p>The status of the stack instance, in terms of its synchronization with its associated stack
|
4903
|
+
* set.</p>
|
4774
4904
|
* <ul>
|
4775
4905
|
* <li>
|
4776
4906
|
* <p>
|
4777
|
-
* <code>INOPERABLE</code>: A <code>DeleteStackInstances</code> operation has failed and left
|
4778
|
-
* unstable state. Stacks in this state are excluded from further
|
4779
|
-
*
|
4907
|
+
* <code>INOPERABLE</code>: A <code>DeleteStackInstances</code> operation has failed and left
|
4908
|
+
* the stack in an unstable state. Stacks in this state are excluded from further
|
4909
|
+
* <code>UpdateStackSet</code> operations. You might need to perform a
|
4910
|
+
* <code>DeleteStackInstances</code> operation, with <code>RetainStacks</code> set to
|
4780
4911
|
* <code>true</code>, to delete the stack instance, and then delete the stack manually.
|
4781
|
-
* <code>INOPERABLE</code> can be returned here when the cause is a failed import. If it's due to
|
4782
|
-
* operation can be retried once the failures are fixed. To see if this is
|
4783
|
-
*
|
4784
|
-
* <code>
|
4912
|
+
* <code>INOPERABLE</code> can be returned here when the cause is a failed import. If it's due to
|
4913
|
+
* a failed import, the operation can be retried once the failures are fixed. To see if this is
|
4914
|
+
* due to a failed import, look at the <code>DetailedStatus</code> member in the
|
4915
|
+
* <code>StackInstanceSummary</code> member that is a peer to this <code>Status</code>
|
4916
|
+
* member.</p>
|
4785
4917
|
* </li>
|
4786
4918
|
* <li>
|
4787
4919
|
* <p>
|
4788
|
-
* <code>OUTDATED</code>: The stack isn't currently up to date with the stack set
|
4920
|
+
* <code>OUTDATED</code>: The stack isn't currently up to date with the stack set
|
4921
|
+
* because:</p>
|
4789
4922
|
* <ul>
|
4790
4923
|
* <li>
|
4791
|
-
* <p>The associated stack failed during a <code>CreateStackSet</code> or
|
4792
|
-
*
|
4924
|
+
* <p>The associated stack failed during a <code>CreateStackSet</code> or
|
4925
|
+
* <code>UpdateStackSet</code> operation.</p>
|
4793
4926
|
* </li>
|
4794
4927
|
* <li>
|
4795
|
-
* <p>The stack was part of a <code>CreateStackSet</code> or <code>UpdateStackSet</code>
|
4796
|
-
* was stopped before the stack was created or updated.</p>
|
4928
|
+
* <p>The stack was part of a <code>CreateStackSet</code> or <code>UpdateStackSet</code>
|
4929
|
+
* operation that failed or was stopped before the stack was created or updated.</p>
|
4797
4930
|
* </li>
|
4798
4931
|
* </ul>
|
4799
4932
|
* </li>
|
@@ -4816,30 +4949,30 @@ export interface StackInstance {
|
|
4816
4949
|
*/
|
4817
4950
|
StatusReason?: string | undefined;
|
4818
4951
|
/**
|
4819
|
-
* <p>[Service-managed permissions] The organization root ID or organizational unit (OU) IDs that
|
4820
|
-
* <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_DeploymentTargets.html">DeploymentTargets</a>.</p>
|
4952
|
+
* <p>[Service-managed permissions] The organization root ID or organizational unit (OU) IDs that
|
4953
|
+
* you specified for <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_DeploymentTargets.html">DeploymentTargets</a>.</p>
|
4821
4954
|
* @public
|
4822
4955
|
*/
|
4823
4956
|
OrganizationalUnitId?: string | undefined;
|
4824
4957
|
/**
|
4825
|
-
* <p>Status of the stack instance's actual configuration compared to the expected template and
|
4826
|
-
* configuration of the stack set to which it belongs.</p>
|
4958
|
+
* <p>Status of the stack instance's actual configuration compared to the expected template and
|
4959
|
+
* parameter configuration of the stack set to which it belongs.</p>
|
4827
4960
|
* <ul>
|
4828
4961
|
* <li>
|
4829
4962
|
* <p>
|
4830
|
-
* <code>DRIFTED</code>: The stack differs from the expected template and parameter
|
4831
|
-
* set to which it belongs. A stack instance is considered to have
|
4832
|
-
* associated stack have drifted.</p>
|
4963
|
+
* <code>DRIFTED</code>: The stack differs from the expected template and parameter
|
4964
|
+
* configuration of the stack set to which it belongs. A stack instance is considered to have
|
4965
|
+
* drifted if one or more of the resources in the associated stack have drifted.</p>
|
4833
4966
|
* </li>
|
4834
4967
|
* <li>
|
4835
4968
|
* <p>
|
4836
|
-
* <code>NOT_CHECKED</code>: CloudFormation hasn't checked if the stack instance differs from its
|
4837
|
-
* configuration.</p>
|
4969
|
+
* <code>NOT_CHECKED</code>: CloudFormation hasn't checked if the stack instance differs from its
|
4970
|
+
* expected stack set configuration.</p>
|
4838
4971
|
* </li>
|
4839
4972
|
* <li>
|
4840
4973
|
* <p>
|
4841
|
-
* <code>IN_SYNC</code>: The stack instance's actual configuration matches its expected stack
|
4842
|
-
* configuration.</p>
|
4974
|
+
* <code>IN_SYNC</code>: The stack instance's actual configuration matches its expected stack
|
4975
|
+
* set configuration.</p>
|
4843
4976
|
* </li>
|
4844
4977
|
* <li>
|
4845
4978
|
* <p>
|
@@ -4850,8 +4983,9 @@ export interface StackInstance {
|
|
4850
4983
|
*/
|
4851
4984
|
DriftStatus?: StackDriftStatus | undefined;
|
4852
4985
|
/**
|
4853
|
-
* <p>Most recent time when CloudFormation performed a drift detection operation on the stack
|
4854
|
-
*
|
4986
|
+
* <p>Most recent time when CloudFormation performed a drift detection operation on the stack
|
4987
|
+
* instance. This value will be <code>NULL</code> for any stack instance on which drift detection
|
4988
|
+
* hasn't yet been performed.</p>
|
4855
4989
|
* @public
|
4856
4990
|
*/
|
4857
4991
|
LastDriftCheckTimestamp?: Date | undefined;
|
@@ -4884,6 +5018,104 @@ export declare class StackInstanceNotFoundException extends __BaseException {
|
|
4884
5018
|
*/
|
4885
5019
|
constructor(opts: __ExceptionOptionType<StackInstanceNotFoundException, __BaseException>);
|
4886
5020
|
}
|
5021
|
+
/**
|
5022
|
+
* @public
|
5023
|
+
*/
|
5024
|
+
export interface DescribeStackRefactorInput {
|
5025
|
+
/**
|
5026
|
+
* <p>The ID associated with the stack refactor created from the <a>CreateStackRefactor</a> action.</p>
|
5027
|
+
* @public
|
5028
|
+
*/
|
5029
|
+
StackRefactorId: string | undefined;
|
5030
|
+
}
|
5031
|
+
/**
|
5032
|
+
* @public
|
5033
|
+
* @enum
|
5034
|
+
*/
|
5035
|
+
export declare const StackRefactorExecutionStatus: {
|
5036
|
+
readonly AVAILABLE: "AVAILABLE";
|
5037
|
+
readonly EXECUTE_COMPLETE: "EXECUTE_COMPLETE";
|
5038
|
+
readonly EXECUTE_FAILED: "EXECUTE_FAILED";
|
5039
|
+
readonly EXECUTE_IN_PROGRESS: "EXECUTE_IN_PROGRESS";
|
5040
|
+
readonly OBSOLETE: "OBSOLETE";
|
5041
|
+
readonly ROLLBACK_COMPLETE: "ROLLBACK_COMPLETE";
|
5042
|
+
readonly ROLLBACK_FAILED: "ROLLBACK_FAILED";
|
5043
|
+
readonly ROLLBACK_IN_PROGRESS: "ROLLBACK_IN_PROGRESS";
|
5044
|
+
readonly UNAVAILABLE: "UNAVAILABLE";
|
5045
|
+
};
|
5046
|
+
/**
|
5047
|
+
* @public
|
5048
|
+
*/
|
5049
|
+
export type StackRefactorExecutionStatus = (typeof StackRefactorExecutionStatus)[keyof typeof StackRefactorExecutionStatus];
|
5050
|
+
/**
|
5051
|
+
* @public
|
5052
|
+
* @enum
|
5053
|
+
*/
|
5054
|
+
export declare const StackRefactorStatus: {
|
5055
|
+
readonly CREATE_COMPLETE: "CREATE_COMPLETE";
|
5056
|
+
readonly CREATE_FAILED: "CREATE_FAILED";
|
5057
|
+
readonly CREATE_IN_PROGRESS: "CREATE_IN_PROGRESS";
|
5058
|
+
readonly DELETE_COMPLETE: "DELETE_COMPLETE";
|
5059
|
+
readonly DELETE_FAILED: "DELETE_FAILED";
|
5060
|
+
readonly DELETE_IN_PROGRESS: "DELETE_IN_PROGRESS";
|
5061
|
+
};
|
5062
|
+
/**
|
5063
|
+
* @public
|
5064
|
+
*/
|
5065
|
+
export type StackRefactorStatus = (typeof StackRefactorStatus)[keyof typeof StackRefactorStatus];
|
5066
|
+
/**
|
5067
|
+
* @public
|
5068
|
+
*/
|
5069
|
+
export interface DescribeStackRefactorOutput {
|
5070
|
+
/**
|
5071
|
+
* <p>A description to help you identify the refactor.</p>
|
5072
|
+
* @public
|
5073
|
+
*/
|
5074
|
+
Description?: string | undefined;
|
5075
|
+
/**
|
5076
|
+
* <p>The ID associated with the stack refactor created from the <a>CreateStackRefactor</a> action.</p>
|
5077
|
+
* @public
|
5078
|
+
*/
|
5079
|
+
StackRefactorId?: string | undefined;
|
5080
|
+
/**
|
5081
|
+
* <p>The unique ID for each stack.</p>
|
5082
|
+
* @public
|
5083
|
+
*/
|
5084
|
+
StackIds?: string[] | undefined;
|
5085
|
+
/**
|
5086
|
+
* <p>The stack refactor execution operation status that's provided after calling the <a>ExecuteStackRefactor</a> action.</p>
|
5087
|
+
* @public
|
5088
|
+
*/
|
5089
|
+
ExecutionStatus?: StackRefactorExecutionStatus | undefined;
|
5090
|
+
/**
|
5091
|
+
* <p>A detailed explanation for the stack refactor <code>ExecutionStatus</code>.</p>
|
5092
|
+
* @public
|
5093
|
+
*/
|
5094
|
+
ExecutionStatusReason?: string | undefined;
|
5095
|
+
/**
|
5096
|
+
* <p>The stack refactor operation status that's provided after calling the <a>CreateStackRefactor</a> action.</p>
|
5097
|
+
* @public
|
5098
|
+
*/
|
5099
|
+
Status?: StackRefactorStatus | undefined;
|
5100
|
+
/**
|
5101
|
+
* <p>A detailed explanation for the stack refactor operation <code>Status</code>.</p>
|
5102
|
+
* @public
|
5103
|
+
*/
|
5104
|
+
StatusReason?: string | undefined;
|
5105
|
+
}
|
5106
|
+
/**
|
5107
|
+
* <p>The specified stack refactor can't be found.</p>
|
5108
|
+
* @public
|
5109
|
+
*/
|
5110
|
+
export declare class StackRefactorNotFoundException extends __BaseException {
|
5111
|
+
readonly name: "StackRefactorNotFoundException";
|
5112
|
+
readonly $fault: "client";
|
5113
|
+
Message?: string | undefined;
|
5114
|
+
/**
|
5115
|
+
* @internal
|
5116
|
+
*/
|
5117
|
+
constructor(opts: __ExceptionOptionType<StackRefactorNotFoundException, __BaseException>);
|
5118
|
+
}
|
4887
5119
|
/**
|
4888
5120
|
* <p>The input for <a>DescribeStackResource</a> action.</p>
|
4889
5121
|
* @public
|
@@ -5828,25 +6060,26 @@ export declare const StackSetDriftStatus: {
|
|
5828
6060
|
export type StackSetDriftStatus = (typeof StackSetDriftStatus)[keyof typeof StackSetDriftStatus];
|
5829
6061
|
/**
|
5830
6062
|
* <p>Detailed information about the drift status of the stack set.</p>
|
5831
|
-
* <p>For stack sets, contains information about the last <i>completed</i> drift
|
5832
|
-
* the stack set. Information about drift operations in-progress isn't
|
5833
|
-
*
|
5834
|
-
*
|
5835
|
-
*
|
5836
|
-
*
|
6063
|
+
* <p>For stack sets, contains information about the last <i>completed</i> drift
|
6064
|
+
* operation performed on the stack set. Information about drift operations in-progress isn't
|
6065
|
+
* included.</p>
|
6066
|
+
* <p>For stack set operations, includes information about drift operations currently being
|
6067
|
+
* performed on the stack set.</p>
|
6068
|
+
* <p>For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-drift.html">Performing drift detection on
|
6069
|
+
* CloudFormation StackSets</a> in the <i>CloudFormation User Guide</i>.</p>
|
5837
6070
|
* @public
|
5838
6071
|
*/
|
5839
6072
|
export interface StackSetDriftDetectionDetails {
|
5840
6073
|
/**
|
5841
|
-
* <p>Status of the stack set's actual configuration compared to its expected template and
|
5842
|
-
* stack set is considered to have drifted if one or more of its stack
|
5843
|
-
* template and parameter configuration.</p>
|
6074
|
+
* <p>Status of the stack set's actual configuration compared to its expected template and
|
6075
|
+
* parameter configuration. A stack set is considered to have drifted if one or more of its stack
|
6076
|
+
* instances have drifted from their expected template and parameter configuration.</p>
|
5844
6077
|
* <ul>
|
5845
6078
|
* <li>
|
5846
6079
|
* <p>
|
5847
|
-
* <code>DRIFTED</code>: One or more of the stack instances belonging to the stack set stack
|
5848
|
-
* expected template and parameter configuration. A stack instance is considered
|
5849
|
-
* resources in the associated stack have drifted.</p>
|
6080
|
+
* <code>DRIFTED</code>: One or more of the stack instances belonging to the stack set stack
|
6081
|
+
* differs from the expected template and parameter configuration. A stack instance is considered
|
6082
|
+
* to have drifted if one or more of the resources in the associated stack have drifted.</p>
|
5850
6083
|
* </li>
|
5851
6084
|
* <li>
|
5852
6085
|
* <p>
|
@@ -5854,8 +6087,8 @@ export interface StackSetDriftDetectionDetails {
|
|
5854
6087
|
* </li>
|
5855
6088
|
* <li>
|
5856
6089
|
* <p>
|
5857
|
-
* <code>IN_SYNC</code>: All of the stack instances belonging to the stack set stack match
|
5858
|
-
* template and parameter configuration.</p>
|
6090
|
+
* <code>IN_SYNC</code>: All of the stack instances belonging to the stack set stack match
|
6091
|
+
* from the expected template and parameter configuration.</p>
|
5859
6092
|
* </li>
|
5860
6093
|
* </ul>
|
5861
6094
|
* @public
|
@@ -5866,20 +6099,23 @@ export interface StackSetDriftDetectionDetails {
|
|
5866
6099
|
* <ul>
|
5867
6100
|
* <li>
|
5868
6101
|
* <p>
|
5869
|
-
* <code>COMPLETED</code>: The drift detection operation completed without failing on any
|
6102
|
+
* <code>COMPLETED</code>: The drift detection operation completed without failing on any
|
6103
|
+
* stack instances.</p>
|
5870
6104
|
* </li>
|
5871
6105
|
* <li>
|
5872
6106
|
* <p>
|
5873
|
-
* <code>FAILED</code>: The drift detection operation exceeded the specified failure
|
6107
|
+
* <code>FAILED</code>: The drift detection operation exceeded the specified failure
|
6108
|
+
* tolerance.</p>
|
5874
6109
|
* </li>
|
5875
6110
|
* <li>
|
5876
6111
|
* <p>
|
5877
|
-
* <code>PARTIAL_SUCCESS</code>: The drift detection operation completed without exceeding
|
5878
|
-
* for the operation.</p>
|
6112
|
+
* <code>PARTIAL_SUCCESS</code>: The drift detection operation completed without exceeding
|
6113
|
+
* the failure tolerance for the operation.</p>
|
5879
6114
|
* </li>
|
5880
6115
|
* <li>
|
5881
6116
|
* <p>
|
5882
|
-
* <code>IN_PROGRESS</code>: The drift detection operation is currently being
|
6117
|
+
* <code>IN_PROGRESS</code>: The drift detection operation is currently being
|
6118
|
+
* performed.</p>
|
5883
6119
|
* </li>
|
5884
6120
|
* <li>
|
5885
6121
|
* <p>
|
@@ -5890,8 +6126,9 @@ export interface StackSetDriftDetectionDetails {
|
|
5890
6126
|
*/
|
5891
6127
|
DriftDetectionStatus?: StackSetDriftDetectionStatus | undefined;
|
5892
6128
|
/**
|
5893
|
-
* <p>Most recent time when CloudFormation performed a drift detection operation on the stack set.
|
5894
|
-
*
|
6129
|
+
* <p>Most recent time when CloudFormation performed a drift detection operation on the stack set.
|
6130
|
+
* This value will be <code>NULL</code> for any stack set on which drift detection hasn't yet been
|
6131
|
+
* performed.</p>
|
5895
6132
|
* @public
|
5896
6133
|
*/
|
5897
6134
|
LastDriftCheckTimestamp?: Date | undefined;
|
@@ -5916,15 +6153,15 @@ export interface StackSetDriftDetectionDetails {
|
|
5916
6153
|
*/
|
5917
6154
|
TotalStackInstancesCount?: number | undefined;
|
5918
6155
|
/**
|
5919
|
-
* <p>The number of stack instances that have drifted from the expected template and parameter
|
5920
|
-
* stack set. A stack instance is considered to have drifted if one or more of
|
5921
|
-
* don't match their expected configuration.</p>
|
6156
|
+
* <p>The number of stack instances that have drifted from the expected template and parameter
|
6157
|
+
* configuration of the stack set. A stack instance is considered to have drifted if one or more of
|
6158
|
+
* the resources in the associated stack don't match their expected configuration.</p>
|
5922
6159
|
* @public
|
5923
6160
|
*/
|
5924
6161
|
DriftedStackInstancesCount?: number | undefined;
|
5925
6162
|
/**
|
5926
|
-
* <p>The number of stack instances which match the expected template and parameter configuration
|
5927
|
-
* set.</p>
|
6163
|
+
* <p>The number of stack instances which match the expected template and parameter configuration
|
6164
|
+
* of the stack set.</p>
|
5928
6165
|
* @public
|
5929
6166
|
*/
|
5930
6167
|
InSyncStackInstancesCount?: number | undefined;
|
@@ -5952,9 +6189,10 @@ export declare const StackSetStatus: {
|
|
5952
6189
|
*/
|
5953
6190
|
export type StackSetStatus = (typeof StackSetStatus)[keyof typeof StackSetStatus];
|
5954
6191
|
/**
|
5955
|
-
* <p>A structure that contains information about a stack set. A stack set enables you to
|
5956
|
-
*
|
5957
|
-
* the template to use, in addition to any parameters and capabilities
|
6192
|
+
* <p>A structure that contains information about a stack set. A stack set enables you to
|
6193
|
+
* provision stacks into Amazon Web Services accounts and across Regions by using a single CloudFormation template. In
|
6194
|
+
* the stack set, you specify the template to use, in addition to any parameters and capabilities
|
6195
|
+
* that the template requires.</p>
|
5958
6196
|
* @public
|
5959
6197
|
*/
|
5960
6198
|
export interface StackSet {
|
@@ -5969,7 +6207,8 @@ export interface StackSet {
|
|
5969
6207
|
*/
|
5970
6208
|
StackSetId?: string | undefined;
|
5971
6209
|
/**
|
5972
|
-
* <p>A description of the stack set that you specify when the stack set is created or
|
6210
|
+
* <p>A description of the stack set that you specify when the stack set is created or
|
6211
|
+
* updated.</p>
|
5973
6212
|
* @public
|
5974
6213
|
*/
|
5975
6214
|
Description?: string | undefined;
|
@@ -5979,7 +6218,8 @@ export interface StackSet {
|
|
5979
6218
|
*/
|
5980
6219
|
Status?: StackSetStatus | undefined;
|
5981
6220
|
/**
|
5982
|
-
* <p>The structure that contains the body of the template that was used to create or update the
|
6221
|
+
* <p>The structure that contains the body of the template that was used to create or update the
|
6222
|
+
* stack set.</p>
|
5983
6223
|
* @public
|
5984
6224
|
*/
|
5985
6225
|
TemplateBody?: string | undefined;
|
@@ -5989,15 +6229,15 @@ export interface StackSet {
|
|
5989
6229
|
*/
|
5990
6230
|
Parameters?: Parameter[] | undefined;
|
5991
6231
|
/**
|
5992
|
-
* <p>The capabilities that are allowed in the stack set. Some stack set templates might include
|
5993
|
-
* affect permissions in your Amazon Web Services account—for example, by creating new
|
5994
|
-
*
|
6232
|
+
* <p>The capabilities that are allowed in the stack set. Some stack set templates might include
|
6233
|
+
* resources that can affect permissions in your Amazon Web Services account—for example, by creating new
|
6234
|
+
* Identity and Access Management (IAM) users. For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/control-access-with-iam.html#using-iam-capabilities">Acknowledging IAM resources in CloudFormation templates</a>.</p>
|
5995
6235
|
* @public
|
5996
6236
|
*/
|
5997
6237
|
Capabilities?: Capability[] | undefined;
|
5998
6238
|
/**
|
5999
|
-
* <p>A list of tags that specify information about the stack set. A maximum number of 50 tags can
|
6000
|
-
* specified.</p>
|
6239
|
+
* <p>A list of tags that specify information about the stack set. A maximum number of 50 tags can
|
6240
|
+
* be specified.</p>
|
6001
6241
|
* @public
|
6002
6242
|
*/
|
6003
6243
|
Tags?: Tag[] | undefined;
|
@@ -6007,30 +6247,32 @@ export interface StackSet {
|
|
6007
6247
|
*/
|
6008
6248
|
StackSetARN?: string | undefined;
|
6009
6249
|
/**
|
6010
|
-
* <p>The Amazon Resource Name (ARN) of the IAM role used to create or update the stack
|
6011
|
-
*
|
6012
|
-
*
|
6013
|
-
*
|
6250
|
+
* <p>The Amazon Resource Name (ARN) of the IAM role used to create or update the stack
|
6251
|
+
* set.</p>
|
6252
|
+
* <p>Use customized administrator roles to control which users or groups can manage specific
|
6253
|
+
* stack sets within the same administrator account. For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-prereqs.html">Prerequisites for using CloudFormation StackSets</a> in the
|
6254
|
+
* <i>CloudFormation User Guide</i>.</p>
|
6014
6255
|
* @public
|
6015
6256
|
*/
|
6016
6257
|
AdministrationRoleARN?: string | undefined;
|
6017
6258
|
/**
|
6018
6259
|
* <p>The name of the IAM execution role used to create or update the stack set.</p>
|
6019
|
-
* <p>Use customized execution roles to control which stack resources users and groups can include
|
6020
|
-
* sets.</p>
|
6260
|
+
* <p>Use customized execution roles to control which stack resources users and groups can include
|
6261
|
+
* in their stack sets.</p>
|
6021
6262
|
* @public
|
6022
6263
|
*/
|
6023
6264
|
ExecutionRoleName?: string | undefined;
|
6024
6265
|
/**
|
6025
6266
|
* <p>Detailed information about the drift status of the stack set.</p>
|
6026
|
-
* <p>For stack sets, contains information about the last <i>completed</i> drift
|
6027
|
-
* the stack set. Information about drift operations currently in progress
|
6267
|
+
* <p>For stack sets, contains information about the last <i>completed</i> drift
|
6268
|
+
* operation performed on the stack set. Information about drift operations currently in progress
|
6269
|
+
* isn't included.</p>
|
6028
6270
|
* @public
|
6029
6271
|
*/
|
6030
6272
|
StackSetDriftDetectionDetails?: StackSetDriftDetectionDetails | undefined;
|
6031
6273
|
/**
|
6032
|
-
* <p>[Service-managed permissions] Describes whether StackSets automatically deploys to Organizations
|
6033
|
-
*
|
6274
|
+
* <p>[Service-managed permissions] Describes whether StackSets automatically deploys to Organizations accounts that are added to a target organization or organizational unit
|
6275
|
+
* (OU).</p>
|
6034
6276
|
* @public
|
6035
6277
|
*/
|
6036
6278
|
AutoDeployment?: AutoDeployment | undefined;
|
@@ -6038,33 +6280,35 @@ export interface StackSet {
|
|
6038
6280
|
* <p>Describes how the IAM roles required for stack set operations are created.</p>
|
6039
6281
|
* <ul>
|
6040
6282
|
* <li>
|
6041
|
-
* <p>With <code>self-managed</code> permissions, you must create the administrator and
|
6042
|
-
* deploy to target accounts. For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-prereqs-self-managed.html">Grant
|
6043
|
-
*
|
6283
|
+
* <p>With <code>self-managed</code> permissions, you must create the administrator and
|
6284
|
+
* execution roles required to deploy to target accounts. For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-prereqs-self-managed.html">Grant
|
6285
|
+
* self-managed permissions</a>.</p>
|
6044
6286
|
* </li>
|
6045
6287
|
* <li>
|
6046
|
-
* <p>With <code>service-managed</code> permissions, StackSets automatically creates the IAM
|
6047
|
-
* deploy to accounts managed by Organizations. For more information,
|
6048
|
-
*
|
6288
|
+
* <p>With <code>service-managed</code> permissions, StackSets automatically creates the IAM
|
6289
|
+
* roles required to deploy to accounts managed by Organizations. For more information,
|
6290
|
+
* see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-orgs-activate-trusted-access.html">Activate
|
6291
|
+
* trusted access for stack sets with Organizations</a>.</p>
|
6049
6292
|
* </li>
|
6050
6293
|
* </ul>
|
6051
6294
|
* @public
|
6052
6295
|
*/
|
6053
6296
|
PermissionModel?: PermissionModels | undefined;
|
6054
6297
|
/**
|
6055
|
-
* <p>[Service-managed permissions] The organization root ID or organizational unit (OU) IDs that
|
6056
|
-
* <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_DeploymentTargets.html">DeploymentTargets</a>.</p>
|
6298
|
+
* <p>[Service-managed permissions] The organization root ID or organizational unit (OU) IDs that
|
6299
|
+
* you specified for <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_DeploymentTargets.html">DeploymentTargets</a>.</p>
|
6057
6300
|
* @public
|
6058
6301
|
*/
|
6059
6302
|
OrganizationalUnitIds?: string[] | undefined;
|
6060
6303
|
/**
|
6061
|
-
* <p>Describes whether StackSets performs non-conflicting operations concurrently and queues
|
6062
|
-
* operations.</p>
|
6304
|
+
* <p>Describes whether StackSets performs non-conflicting operations concurrently and queues
|
6305
|
+
* conflicting operations.</p>
|
6063
6306
|
* @public
|
6064
6307
|
*/
|
6065
6308
|
ManagedExecution?: ManagedExecution | undefined;
|
6066
6309
|
/**
|
6067
|
-
* <p>Returns a list of all Amazon Web Services Regions the given StackSet has stack instances deployed in. The
|
6310
|
+
* <p>Returns a list of all Amazon Web Services Regions the given StackSet has stack instances deployed in. The
|
6311
|
+
* Amazon Web Services Regions list output is in no particular order.</p>
|
6068
6312
|
* @public
|
6069
6313
|
*/
|
6070
6314
|
Regions?: string[] | undefined;
|
@@ -6172,10 +6416,10 @@ export interface StackSetOperation {
|
|
6172
6416
|
*/
|
6173
6417
|
StackSetId?: string | undefined;
|
6174
6418
|
/**
|
6175
|
-
* <p>The type of stack set operation: <code>CREATE</code>, <code>UPDATE</code>, or
|
6176
|
-
*
|
6177
|
-
*
|
6178
|
-
* instances.</p>
|
6419
|
+
* <p>The type of stack set operation: <code>CREATE</code>, <code>UPDATE</code>, or
|
6420
|
+
* <code>DELETE</code>. Create and delete operations affect only the specified stack set instances
|
6421
|
+
* that are associated with the specified stack set. Update operations affect both the stack set
|
6422
|
+
* itself, in addition to <i>all</i> associated stack set instances.</p>
|
6179
6423
|
* @public
|
6180
6424
|
*/
|
6181
6425
|
Action?: StackSetOperationAction | undefined;
|
@@ -6184,16 +6428,18 @@ export interface StackSetOperation {
|
|
6184
6428
|
* <ul>
|
6185
6429
|
* <li>
|
6186
6430
|
* <p>
|
6187
|
-
* <code>FAILED</code>: The operation exceeded the specified failure tolerance. The failure
|
6188
|
-
* you've set for an operation is applied for each Region during stack create
|
6189
|
-
*
|
6190
|
-
*
|
6431
|
+
* <code>FAILED</code>: The operation exceeded the specified failure tolerance. The failure
|
6432
|
+
* tolerance value that you've set for an operation is applied for each Region during stack create
|
6433
|
+
* and update operations. If the number of failed stacks within a Region exceeds the failure
|
6434
|
+
* tolerance, the status of the operation in the Region is set to <code>FAILED</code>. This in
|
6435
|
+
* turn sets the status of the operation as a whole to <code>FAILED</code>, and CloudFormation cancels
|
6436
|
+
* the operation in any remaining Regions.</p>
|
6191
6437
|
* </li>
|
6192
6438
|
* <li>
|
6193
6439
|
* <p>
|
6194
|
-
* <code>QUEUED</code>: [Service-managed permissions] For automatic deployments that require
|
6195
|
-
* operations, the operation is queued to be performed. For more information, see
|
6196
|
-
*
|
6440
|
+
* <code>QUEUED</code>: [Service-managed permissions] For automatic deployments that require
|
6441
|
+
* a sequence of operations, the operation is queued to be performed. For more information, see
|
6442
|
+
* the <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/what-is-cfnstacksets.html#stackset-status-codes">StackSets status codes</a> in the <i>CloudFormation User Guide</i>.</p>
|
6197
6443
|
* </li>
|
6198
6444
|
* <li>
|
6199
6445
|
* <p>
|
@@ -6205,12 +6451,13 @@ export interface StackSetOperation {
|
|
6205
6451
|
* </li>
|
6206
6452
|
* <li>
|
6207
6453
|
* <p>
|
6208
|
-
* <code>STOPPING</code>: The operation is in the process of stopping, at user
|
6454
|
+
* <code>STOPPING</code>: The operation is in the process of stopping, at user
|
6455
|
+
* request.</p>
|
6209
6456
|
* </li>
|
6210
6457
|
* <li>
|
6211
6458
|
* <p>
|
6212
|
-
* <code>SUCCEEDED</code>: The operation completed creating or updating all the specified
|
6213
|
-
* exceeding the failure tolerance for the operation.</p>
|
6459
|
+
* <code>SUCCEEDED</code>: The operation completed creating or updating all the specified
|
6460
|
+
* stacks without exceeding the failure tolerance for the operation.</p>
|
6214
6461
|
* </li>
|
6215
6462
|
* </ul>
|
6216
6463
|
* @public
|
@@ -6222,54 +6469,56 @@ export interface StackSetOperation {
|
|
6222
6469
|
*/
|
6223
6470
|
OperationPreferences?: StackSetOperationPreferences | undefined;
|
6224
6471
|
/**
|
6225
|
-
* <p>For stack set operations of action type <code>DELETE</code>, specifies whether to remove the
|
6226
|
-
* from the specified stack set, but doesn't delete the stacks. You can't
|
6227
|
-
* existing, saved stack to a new stack set.</p>
|
6472
|
+
* <p>For stack set operations of action type <code>DELETE</code>, specifies whether to remove the
|
6473
|
+
* stack instances from the specified stack set, but doesn't delete the stacks. You can't
|
6474
|
+
* re-associate a retained stack, or add an existing, saved stack to a new stack set.</p>
|
6228
6475
|
* @public
|
6229
6476
|
*/
|
6230
6477
|
RetainStacks?: boolean | undefined;
|
6231
6478
|
/**
|
6232
|
-
* <p>The Amazon Resource Name (ARN) of the IAM role used to perform this stack set
|
6233
|
-
*
|
6234
|
-
*
|
6235
|
-
*
|
6479
|
+
* <p>The Amazon Resource Name (ARN) of the IAM role used to perform this stack set
|
6480
|
+
* operation.</p>
|
6481
|
+
* <p>Use customized administrator roles to control which users or groups can manage specific
|
6482
|
+
* stack sets within the same administrator account. For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-prereqs-self-managed.html">Grant self-managed
|
6483
|
+
* permissions</a> in the <i>CloudFormation User Guide</i>.</p>
|
6236
6484
|
* @public
|
6237
6485
|
*/
|
6238
6486
|
AdministrationRoleARN?: string | undefined;
|
6239
6487
|
/**
|
6240
6488
|
* <p>The name of the IAM execution role used to create or update the stack set.</p>
|
6241
|
-
* <p>Use customized execution roles to control which stack resources users and groups can include
|
6242
|
-
* sets.</p>
|
6489
|
+
* <p>Use customized execution roles to control which stack resources users and groups can include
|
6490
|
+
* in their stack sets.</p>
|
6243
6491
|
* @public
|
6244
6492
|
*/
|
6245
6493
|
ExecutionRoleName?: string | undefined;
|
6246
6494
|
/**
|
6247
|
-
* <p>The time at which the operation was initiated. Note that the creation times for the stack
|
6248
|
-
* differ from the creation time of the individual stacks themselves. This is
|
6249
|
-
*
|
6250
|
-
* stacks.</p>
|
6495
|
+
* <p>The time at which the operation was initiated. Note that the creation times for the stack
|
6496
|
+
* set operation might differ from the creation time of the individual stacks themselves. This is
|
6497
|
+
* because CloudFormation needs to perform preparatory work for the operation, such as dispatching the
|
6498
|
+
* work to the requested Regions, before actually creating the first stacks.</p>
|
6251
6499
|
* @public
|
6252
6500
|
*/
|
6253
6501
|
CreationTimestamp?: Date | undefined;
|
6254
6502
|
/**
|
6255
|
-
* <p>The time at which the stack set operation ended, across all accounts and Regions specified.
|
6256
|
-
* doesn't necessarily mean that the stack set operation was successful, or even
|
6257
|
-
* Region.</p>
|
6503
|
+
* <p>The time at which the stack set operation ended, across all accounts and Regions specified.
|
6504
|
+
* Note that this doesn't necessarily mean that the stack set operation was successful, or even
|
6505
|
+
* attempted, in each account or Region.</p>
|
6258
6506
|
* @public
|
6259
6507
|
*/
|
6260
6508
|
EndTimestamp?: Date | undefined;
|
6261
6509
|
/**
|
6262
|
-
* <p>[Service-managed permissions] The Organizations accounts affected by the stack
|
6510
|
+
* <p>[Service-managed permissions] The Organizations accounts affected by the stack
|
6511
|
+
* operation.</p>
|
6263
6512
|
* @public
|
6264
6513
|
*/
|
6265
6514
|
DeploymentTargets?: DeploymentTargets | undefined;
|
6266
6515
|
/**
|
6267
|
-
* <p>Detailed information about the drift status of the stack set. This includes information
|
6268
|
-
* currently being performed on the stack set.</p>
|
6269
|
-
* <p>This information will only be present for stack set operations whose <code>Action</code>
|
6270
|
-
*
|
6271
|
-
* <p>For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-drift.html">
|
6272
|
-
*
|
6516
|
+
* <p>Detailed information about the drift status of the stack set. This includes information
|
6517
|
+
* about drift operations currently being performed on the stack set.</p>
|
6518
|
+
* <p>This information will only be present for stack set operations whose <code>Action</code>
|
6519
|
+
* type is <code>DETECT_DRIFT</code>.</p>
|
6520
|
+
* <p>For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-drift.html">Performing drift detection on
|
6521
|
+
* CloudFormation StackSets</a> in the <i>CloudFormation User Guide</i>.</p>
|
6273
6522
|
* @public
|
6274
6523
|
*/
|
6275
6524
|
StackSetDriftDetectionDetails?: StackSetDriftDetectionDetails | undefined;
|
@@ -6894,7 +7143,7 @@ export interface EstimateTemplateCostInput {
|
|
6894
7143
|
*/
|
6895
7144
|
TemplateBody?: string | undefined;
|
6896
7145
|
/**
|
6897
|
-
* <p>
|
7146
|
+
* <p>The URL of a file containing the template body. The URL must point to a template that's
|
6898
7147
|
* located in an Amazon S3 bucket or a Systems Manager document. The location for an Amazon S3 bucket must
|
6899
7148
|
* start with <code>https://</code>.</p>
|
6900
7149
|
* <p>Conditional: You must pass <code>TemplateURL</code> or <code>TemplateBody</code>. If both
|
@@ -6983,6 +7232,16 @@ export interface ExecuteChangeSetInput {
|
|
6983
7232
|
*/
|
6984
7233
|
export interface ExecuteChangeSetOutput {
|
6985
7234
|
}
|
7235
|
+
/**
|
7236
|
+
* @public
|
7237
|
+
*/
|
7238
|
+
export interface ExecuteStackRefactorInput {
|
7239
|
+
/**
|
7240
|
+
* <p>The ID associated with the stack refactor created from the <a>CreateStackRefactor</a> action.</p>
|
7241
|
+
* @public
|
7242
|
+
*/
|
7243
|
+
StackRefactorId: string | undefined;
|
7244
|
+
}
|
6986
7245
|
/**
|
6987
7246
|
* @public
|
6988
7247
|
* @enum
|
@@ -7198,8 +7457,8 @@ export interface GetTemplateSummaryInput {
|
|
7198
7457
|
*/
|
7199
7458
|
TemplateBody?: string | undefined;
|
7200
7459
|
/**
|
7201
|
-
* <p>
|
7202
|
-
*
|
7460
|
+
* <p>The URL of a file containing the template body. The URL must point to a template (max size:
|
7461
|
+
* 1 MB) that's located in an Amazon S3 bucket or a Systems Manager document. The location
|
7203
7462
|
* for an Amazon S3 bucket must start with <code>https://</code>.</p>
|
7204
7463
|
* <p>Conditional: You must specify only one of the following parameters:
|
7205
7464
|
* <code>StackName</code>, <code>StackSetName</code>, <code>TemplateBody</code>, or
|
@@ -7365,7 +7624,7 @@ export interface GetTemplateSummaryOutput {
|
|
7365
7624
|
* this parameter when you use the <a>CreateStack</a> or <a>UpdateStack</a>
|
7366
7625
|
* actions with your template; otherwise, those actions return an
|
7367
7626
|
* <code>InsufficientCapabilities</code> error.</p>
|
7368
|
-
* <p>For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/
|
7627
|
+
* <p>For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/control-access-with-iam.html#using-iam-capabilities">Acknowledging IAM resources in CloudFormation templates</a>.</p>
|
7369
7628
|
* @public
|
7370
7629
|
*/
|
7371
7630
|
Capabilities?: Capability[] | undefined;
|
@@ -7760,11 +8019,13 @@ export interface HookResultSummary {
|
|
7760
8019
|
* <ul>
|
7761
8020
|
* <li>
|
7762
8021
|
* <p>
|
7763
|
-
* <code>FAIL</code>: If the hook invocation returns a failure, then the requested target
|
8022
|
+
* <code>FAIL</code>: If the hook invocation returns a failure, then the requested target
|
8023
|
+
* operation should fail.</p>
|
7764
8024
|
* </li>
|
7765
8025
|
* <li>
|
7766
8026
|
* <p>
|
7767
|
-
* <code>WARN</code>: If the hook invocation returns a failure, then the requested target
|
8027
|
+
* <code>WARN</code>: If the hook invocation returns a failure, then the requested target
|
8028
|
+
* operation should warn.</p>
|
7768
8029
|
* </li>
|
7769
8030
|
* </ul>
|
7770
8031
|
* @public
|
@@ -7791,8 +8052,9 @@ export interface HookResultSummary {
|
|
7791
8052
|
*/
|
7792
8053
|
Status?: HookStatus | undefined;
|
7793
8054
|
/**
|
7794
|
-
* <p>A description of the Hook results status. For example, if the Hook
|
7795
|
-
*
|
8055
|
+
* <p>A description of the Hook results status. For example, if the Hook
|
8056
|
+
* result is in a <code>FAILED</code> state, this may contain additional information for the
|
8057
|
+
* <code>FAILED</code> state.</p>
|
7796
8058
|
* @public
|
7797
8059
|
*/
|
7798
8060
|
HookStatusReason?: string | undefined;
|
@@ -8238,7 +8500,8 @@ export interface ListStackInstanceResourceDriftsInput {
|
|
8238
8500
|
CallAs?: CallAs | undefined;
|
8239
8501
|
}
|
8240
8502
|
/**
|
8241
|
-
* <p>The structure containing summary information about resource drifts for a stack
|
8503
|
+
* <p>The structure containing summary information about resource drifts for a stack
|
8504
|
+
* instance.</p>
|
8242
8505
|
* @public
|
8243
8506
|
*/
|
8244
8507
|
export interface StackInstanceResourceDriftsSummary {
|
@@ -8253,26 +8516,29 @@ export interface StackInstanceResourceDriftsSummary {
|
|
8253
8516
|
*/
|
8254
8517
|
LogicalResourceId: string | undefined;
|
8255
8518
|
/**
|
8256
|
-
* <p>The name or unique identifier that corresponds to a physical instance ID of a resource
|
8519
|
+
* <p>The name or unique identifier that corresponds to a physical instance ID of a resource
|
8520
|
+
* supported by CloudFormation.</p>
|
8257
8521
|
* @public
|
8258
8522
|
*/
|
8259
8523
|
PhysicalResourceId?: string | undefined;
|
8260
8524
|
/**
|
8261
|
-
* <p>Context information that enables CloudFormation to uniquely identify a resource. CloudFormation uses
|
8262
|
-
* cases where a resource's logical and physical IDs aren't enough to
|
8263
|
-
* key-value pair specifies a unique resource that
|
8525
|
+
* <p>Context information that enables CloudFormation to uniquely identify a resource. CloudFormation uses
|
8526
|
+
* context key-value pairs in cases where a resource's logical and physical IDs aren't enough to
|
8527
|
+
* uniquely identify that resource. Each context key-value pair specifies a unique resource that
|
8528
|
+
* contains the targeted resource.</p>
|
8264
8529
|
* @public
|
8265
8530
|
*/
|
8266
8531
|
PhysicalResourceIdContext?: PhysicalResourceIdContextKeyValuePair[] | undefined;
|
8267
8532
|
/**
|
8268
8533
|
* <p>Type of resource. For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-template-resource-type-ref.html">Amazon Web Services resource and
|
8269
|
-
*
|
8534
|
+
* property types reference</a> in the <i>CloudFormation User Guide</i>.</p>
|
8270
8535
|
* @public
|
8271
8536
|
*/
|
8272
8537
|
ResourceType: string | undefined;
|
8273
8538
|
/**
|
8274
|
-
* <p>Status of the actual configuration of the resource compared to its expected configuration.
|
8275
|
-
* only for resources whose <code>StackInstanceResourceDriftStatus</code> is
|
8539
|
+
* <p>Status of the actual configuration of the resource compared to its expected configuration.
|
8540
|
+
* These will be present only for resources whose <code>StackInstanceResourceDriftStatus</code> is
|
8541
|
+
* <code>MODIFIED</code>. </p>
|
8276
8542
|
* @public
|
8277
8543
|
*/
|
8278
8544
|
PropertyDifferences?: PropertyDifference[] | undefined;
|
@@ -8281,16 +8547,18 @@ export interface StackInstanceResourceDriftsSummary {
|
|
8281
8547
|
* <ul>
|
8282
8548
|
* <li>
|
8283
8549
|
* <p>
|
8284
|
-
* <code>DELETED</code>: The resource differs from its expected template configuration in
|
8285
|
-
* been deleted.</p>
|
8550
|
+
* <code>DELETED</code>: The resource differs from its expected template configuration in
|
8551
|
+
* that the resource has been deleted.</p>
|
8286
8552
|
* </li>
|
8287
8553
|
* <li>
|
8288
8554
|
* <p>
|
8289
|
-
* <code>MODIFIED</code>: One or more resource properties differ from their expected template
|
8555
|
+
* <code>MODIFIED</code>: One or more resource properties differ from their expected template
|
8556
|
+
* values.</p>
|
8290
8557
|
* </li>
|
8291
8558
|
* <li>
|
8292
8559
|
* <p>
|
8293
|
-
* <code>IN_SYNC</code>: The resource's actual configuration matches its expected template
|
8560
|
+
* <code>IN_SYNC</code>: The resource's actual configuration matches its expected template
|
8561
|
+
* configuration.</p>
|
8294
8562
|
* </li>
|
8295
8563
|
* <li>
|
8296
8564
|
* <p>
|
@@ -8434,8 +8702,8 @@ export interface StackInstanceSummary {
|
|
8434
8702
|
*/
|
8435
8703
|
Region?: string | undefined;
|
8436
8704
|
/**
|
8437
|
-
* <p>[Self-managed permissions] The name of the Amazon Web Services account that the stack instance is
|
8438
|
-
* with.</p>
|
8705
|
+
* <p>[Self-managed permissions] The name of the Amazon Web Services account that the stack instance is
|
8706
|
+
* associated with.</p>
|
8439
8707
|
* @public
|
8440
8708
|
*/
|
8441
8709
|
Account?: string | undefined;
|
@@ -8445,29 +8713,34 @@ export interface StackInstanceSummary {
|
|
8445
8713
|
*/
|
8446
8714
|
StackId?: string | undefined;
|
8447
8715
|
/**
|
8448
|
-
* <p>The status of the stack instance, in terms of its synchronization with its associated stack
|
8716
|
+
* <p>The status of the stack instance, in terms of its synchronization with its associated stack
|
8717
|
+
* set.</p>
|
8449
8718
|
* <ul>
|
8450
8719
|
* <li>
|
8451
8720
|
* <p>
|
8452
|
-
* <code>INOPERABLE</code>: A <code>DeleteStackInstances</code> operation has failed and left
|
8453
|
-
* unstable state. Stacks in this state are excluded from further
|
8454
|
-
*
|
8721
|
+
* <code>INOPERABLE</code>: A <code>DeleteStackInstances</code> operation has failed and left
|
8722
|
+
* the stack in an unstable state. Stacks in this state are excluded from further
|
8723
|
+
* <code>UpdateStackSet</code> operations. You might need to perform a
|
8724
|
+
* <code>DeleteStackInstances</code> operation, with <code>RetainStacks</code> set to
|
8455
8725
|
* <code>true</code>, to delete the stack instance, and then delete the stack manually.
|
8456
|
-
* <code>INOPERABLE</code> can be returned here when the cause is a failed import. If it's due to
|
8457
|
-
* operation can be retried once the failures are fixed. To see if this is
|
8458
|
-
*
|
8726
|
+
* <code>INOPERABLE</code> can be returned here when the cause is a failed import. If it's due to
|
8727
|
+
* a failed import, the operation can be retried once the failures are fixed. To see if this is
|
8728
|
+
* due to a failed import, call the <a>DescribeStackInstance</a> API operation, look at
|
8729
|
+
* the <code>DetailedStatus</code> member returned in the <code>StackInstanceSummary</code>
|
8730
|
+
* member.</p>
|
8459
8731
|
* </li>
|
8460
8732
|
* <li>
|
8461
8733
|
* <p>
|
8462
|
-
* <code>OUTDATED</code>: The stack isn't currently up to date with the stack set
|
8734
|
+
* <code>OUTDATED</code>: The stack isn't currently up to date with the stack set
|
8735
|
+
* because:</p>
|
8463
8736
|
* <ul>
|
8464
8737
|
* <li>
|
8465
|
-
* <p>The associated stack failed during a <code>CreateStackSet</code> or
|
8466
|
-
*
|
8738
|
+
* <p>The associated stack failed during a <code>CreateStackSet</code> or
|
8739
|
+
* <code>UpdateStackSet</code> operation.</p>
|
8467
8740
|
* </li>
|
8468
8741
|
* <li>
|
8469
|
-
* <p>The stack was part of a <code>CreateStackSet</code> or <code>UpdateStackSet</code>
|
8470
|
-
* was stopped before the stack was created or updated.</p>
|
8742
|
+
* <p>The stack was part of a <code>CreateStackSet</code> or <code>UpdateStackSet</code>
|
8743
|
+
* operation that failed or was stopped before the stack was created or updated.</p>
|
8471
8744
|
* </li>
|
8472
8745
|
* </ul>
|
8473
8746
|
* </li>
|
@@ -8490,30 +8763,30 @@ export interface StackInstanceSummary {
|
|
8490
8763
|
*/
|
8491
8764
|
StackInstanceStatus?: StackInstanceComprehensiveStatus | undefined;
|
8492
8765
|
/**
|
8493
|
-
* <p>[Service-managed permissions] The organization root ID or organizational unit (OU) IDs that
|
8494
|
-
* <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_DeploymentTargets.html">DeploymentTargets</a>.</p>
|
8766
|
+
* <p>[Service-managed permissions] The organization root ID or organizational unit (OU) IDs that
|
8767
|
+
* you specified for <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_DeploymentTargets.html">DeploymentTargets</a>.</p>
|
8495
8768
|
* @public
|
8496
8769
|
*/
|
8497
8770
|
OrganizationalUnitId?: string | undefined;
|
8498
8771
|
/**
|
8499
|
-
* <p>Status of the stack instance's actual configuration compared to the expected template and
|
8500
|
-
* configuration of the stack set to which it belongs.</p>
|
8772
|
+
* <p>Status of the stack instance's actual configuration compared to the expected template and
|
8773
|
+
* parameter configuration of the stack set to which it belongs.</p>
|
8501
8774
|
* <ul>
|
8502
8775
|
* <li>
|
8503
8776
|
* <p>
|
8504
|
-
* <code>DRIFTED</code>: The stack differs from the expected template and parameter
|
8505
|
-
* set to which it belongs. A stack instance is considered to have
|
8506
|
-
* associated stack have drifted.</p>
|
8777
|
+
* <code>DRIFTED</code>: The stack differs from the expected template and parameter
|
8778
|
+
* configuration of the stack set to which it belongs. A stack instance is considered to have
|
8779
|
+
* drifted if one or more of the resources in the associated stack have drifted.</p>
|
8507
8780
|
* </li>
|
8508
8781
|
* <li>
|
8509
8782
|
* <p>
|
8510
|
-
* <code>NOT_CHECKED</code>: CloudFormation hasn't checked if the stack instance differs from its
|
8511
|
-
* configuration.</p>
|
8783
|
+
* <code>NOT_CHECKED</code>: CloudFormation hasn't checked if the stack instance differs from its
|
8784
|
+
* expected stack set configuration.</p>
|
8512
8785
|
* </li>
|
8513
8786
|
* <li>
|
8514
8787
|
* <p>
|
8515
|
-
* <code>IN_SYNC</code>: The stack instance's actual configuration matches its expected stack
|
8516
|
-
* configuration.</p>
|
8788
|
+
* <code>IN_SYNC</code>: The stack instance's actual configuration matches its expected stack
|
8789
|
+
* set configuration.</p>
|
8517
8790
|
* </li>
|
8518
8791
|
* <li>
|
8519
8792
|
* <p>
|
@@ -8524,8 +8797,9 @@ export interface StackInstanceSummary {
|
|
8524
8797
|
*/
|
8525
8798
|
DriftStatus?: StackDriftStatus | undefined;
|
8526
8799
|
/**
|
8527
|
-
* <p>Most recent time when CloudFormation performed a drift detection operation on the stack
|
8528
|
-
*
|
8800
|
+
* <p>Most recent time when CloudFormation performed a drift detection operation on the stack
|
8801
|
+
* instance. This value will be <code>NULL</code> for any stack instance on which drift detection
|
8802
|
+
* hasn't yet been performed.</p>
|
8529
8803
|
* @public
|
8530
8804
|
*/
|
8531
8805
|
LastDriftCheckTimestamp?: Date | undefined;
|
@@ -8555,59 +8829,324 @@ export interface ListStackInstancesOutput {
|
|
8555
8829
|
NextToken?: string | undefined;
|
8556
8830
|
}
|
8557
8831
|
/**
|
8558
|
-
* <p>The input for the <a>ListStackResource</a> action.</p>
|
8559
8832
|
* @public
|
8560
8833
|
*/
|
8561
|
-
export interface
|
8834
|
+
export interface ListStackRefactorActionsInput {
|
8562
8835
|
/**
|
8563
|
-
* <p>The
|
8564
|
-
* interchangeable:</p>
|
8565
|
-
* <ul>
|
8566
|
-
* <li>
|
8567
|
-
* <p>Running stacks: You can specify either the stack's name or its unique stack ID.</p>
|
8568
|
-
* </li>
|
8569
|
-
* <li>
|
8570
|
-
* <p>Deleted stacks: You must specify the unique stack ID.</p>
|
8571
|
-
* </li>
|
8572
|
-
* </ul>
|
8573
|
-
* <p>Default: There is no default value.</p>
|
8836
|
+
* <p>The ID associated with the stack refactor created from the <a>CreateStackRefactor</a> action.</p>
|
8574
8837
|
* @public
|
8575
8838
|
*/
|
8576
|
-
|
8839
|
+
StackRefactorId: string | undefined;
|
8577
8840
|
/**
|
8578
|
-
* <p>
|
8579
|
-
*
|
8841
|
+
* <p>If the request doesn't return all the remaining results, <code>NextToken</code> is set to a token. To retrieve
|
8842
|
+
* the next set of results, call this action again and assign that token to the request object's <code>NextToken</code>
|
8843
|
+
* parameter. If the request returns all results, <code>NextToken</code> is set to <code>null</code>.</p>
|
8580
8844
|
* @public
|
8581
8845
|
*/
|
8582
8846
|
NextToken?: string | undefined;
|
8847
|
+
/**
|
8848
|
+
* <p>The maximum number of results to be returned with a single call. If the number of available results exceeds this
|
8849
|
+
* maximum, the response includes a <code>NextToken</code> value that you can assign to the <code>NextToken</code>
|
8850
|
+
* request parameter to get the next set of results.</p>
|
8851
|
+
* @public
|
8852
|
+
*/
|
8853
|
+
MaxResults?: number | undefined;
|
8583
8854
|
}
|
8584
8855
|
/**
|
8585
|
-
* <p>Summarizes information about whether the resource's actual configuration differs, or has
|
8586
|
-
* <i>drifted</i>, from its expected configuration.</p>
|
8587
8856
|
* @public
|
8857
|
+
* @enum
|
8588
8858
|
*/
|
8589
|
-
export
|
8859
|
+
export declare const StackRefactorActionType: {
|
8860
|
+
readonly CREATE: "CREATE";
|
8861
|
+
readonly MOVE: "MOVE";
|
8862
|
+
};
|
8863
|
+
/**
|
8864
|
+
* @public
|
8865
|
+
*/
|
8866
|
+
export type StackRefactorActionType = (typeof StackRefactorActionType)[keyof typeof StackRefactorActionType];
|
8867
|
+
/**
|
8868
|
+
* @public
|
8869
|
+
* @enum
|
8870
|
+
*/
|
8871
|
+
export declare const StackRefactorDetection: {
|
8872
|
+
readonly AUTO: "AUTO";
|
8873
|
+
readonly MANUAL: "MANUAL";
|
8874
|
+
};
|
8875
|
+
/**
|
8876
|
+
* @public
|
8877
|
+
*/
|
8878
|
+
export type StackRefactorDetection = (typeof StackRefactorDetection)[keyof typeof StackRefactorDetection];
|
8879
|
+
/**
|
8880
|
+
* @public
|
8881
|
+
* @enum
|
8882
|
+
*/
|
8883
|
+
export declare const StackRefactorActionEntity: {
|
8884
|
+
readonly RESOURCE: "RESOURCE";
|
8885
|
+
readonly STACK: "STACK";
|
8886
|
+
};
|
8887
|
+
/**
|
8888
|
+
* @public
|
8889
|
+
*/
|
8890
|
+
export type StackRefactorActionEntity = (typeof StackRefactorActionEntity)[keyof typeof StackRefactorActionEntity];
|
8891
|
+
/**
|
8892
|
+
* <p>Describes the stack and the action that CloudFormation will perform on it if you execute the stack refactor.</p>
|
8893
|
+
* @public
|
8894
|
+
*/
|
8895
|
+
export interface StackRefactorAction {
|
8590
8896
|
/**
|
8591
|
-
* <p>
|
8897
|
+
* <p>The action that CloudFormation takes on the stack.</p>
|
8898
|
+
* @public
|
8899
|
+
*/
|
8900
|
+
Action?: StackRefactorActionType | undefined;
|
8901
|
+
/**
|
8902
|
+
* <p>The type that will be evaluated in the <code>StackRefactorAction</code>. The following are potential <code>Entity</code> types:</p>
|
8592
8903
|
* <ul>
|
8593
8904
|
* <li>
|
8594
8905
|
* <p>
|
8595
|
-
* <code>
|
8596
|
-
*
|
8906
|
+
* <code>Stack</code>
|
8907
|
+
* </p>
|
8597
8908
|
* </li>
|
8598
8909
|
* <li>
|
8599
8910
|
* <p>
|
8600
|
-
* <code>
|
8911
|
+
* <code>Resource</code>
|
8912
|
+
* </p>
|
8601
8913
|
* </li>
|
8602
|
-
*
|
8603
|
-
*
|
8604
|
-
|
8605
|
-
|
8606
|
-
|
8607
|
-
*
|
8608
|
-
*
|
8609
|
-
|
8610
|
-
|
8914
|
+
* </ul>
|
8915
|
+
* @public
|
8916
|
+
*/
|
8917
|
+
Entity?: StackRefactorActionEntity | undefined;
|
8918
|
+
/**
|
8919
|
+
* <p>The name or unique identifier associated with the physical instance of the resource.</p>
|
8920
|
+
* @public
|
8921
|
+
*/
|
8922
|
+
PhysicalResourceId?: string | undefined;
|
8923
|
+
/**
|
8924
|
+
* <p>A key-value pair that identifies the target resource. The key is an identifier property (for example,
|
8925
|
+
* <code>BucketName</code> for <code>AWS::S3::Bucket</code> resources) and the value is the actual property value (for
|
8926
|
+
* example, <code>MyS3Bucket</code>).</p>
|
8927
|
+
* @public
|
8928
|
+
*/
|
8929
|
+
ResourceIdentifier?: string | undefined;
|
8930
|
+
/**
|
8931
|
+
* <p>A description to help you identify the refactor.</p>
|
8932
|
+
* @public
|
8933
|
+
*/
|
8934
|
+
Description?: string | undefined;
|
8935
|
+
/**
|
8936
|
+
* <p>The detection type is one of the following:</p>
|
8937
|
+
* <ul>
|
8938
|
+
* <li>
|
8939
|
+
* <p>Auto: CloudFormation figured out the mapping on its own.</p>
|
8940
|
+
* </li>
|
8941
|
+
* <li>
|
8942
|
+
* <p>Manual: The customer provided the mapping in the <code>ResourceMapping</code> parameter.</p>
|
8943
|
+
* </li>
|
8944
|
+
* </ul>
|
8945
|
+
* @public
|
8946
|
+
*/
|
8947
|
+
Detection?: StackRefactorDetection | undefined;
|
8948
|
+
/**
|
8949
|
+
* <p>The description of the detection type.</p>
|
8950
|
+
* @public
|
8951
|
+
*/
|
8952
|
+
DetectionReason?: string | undefined;
|
8953
|
+
/**
|
8954
|
+
* <p>Assigns one or more tags to specified resources.</p>
|
8955
|
+
* @public
|
8956
|
+
*/
|
8957
|
+
TagResources?: Tag[] | undefined;
|
8958
|
+
/**
|
8959
|
+
* <p>Removes one or more tags to specified resources.</p>
|
8960
|
+
* @public
|
8961
|
+
*/
|
8962
|
+
UntagResources?: string[] | undefined;
|
8963
|
+
/**
|
8964
|
+
* <p>The mapping for the stack resource <code>Source</code> and stack resource <code>Destination</code>.</p>
|
8965
|
+
* @public
|
8966
|
+
*/
|
8967
|
+
ResourceMapping?: ResourceMapping | undefined;
|
8968
|
+
}
|
8969
|
+
/**
|
8970
|
+
* @public
|
8971
|
+
*/
|
8972
|
+
export interface ListStackRefactorActionsOutput {
|
8973
|
+
/**
|
8974
|
+
* <p>The stack refactor actions.</p>
|
8975
|
+
* @public
|
8976
|
+
*/
|
8977
|
+
StackRefactorActions: StackRefactorAction[] | undefined;
|
8978
|
+
/**
|
8979
|
+
* <p>If the request doesn't return all the remaining results, <code>NextToken</code> is set to a token. To retrieve
|
8980
|
+
* the next set of results, call this action again and assign that token to the request object's <code>NextToken</code>
|
8981
|
+
* parameter. If the request returns all results, <code>NextToken</code> is set to <code>null</code>.</p>
|
8982
|
+
* @public
|
8983
|
+
*/
|
8984
|
+
NextToken?: string | undefined;
|
8985
|
+
}
|
8986
|
+
/**
|
8987
|
+
* @public
|
8988
|
+
*/
|
8989
|
+
export interface ListStackRefactorsInput {
|
8990
|
+
/**
|
8991
|
+
* <p>Execution status to use as a filter. Specify one or more execution status codes to list only stack refactors with the specified
|
8992
|
+
* execution status codes.</p>
|
8993
|
+
* @public
|
8994
|
+
*/
|
8995
|
+
ExecutionStatusFilter?: StackRefactorExecutionStatus[] | undefined;
|
8996
|
+
/**
|
8997
|
+
* <p>If the request doesn't return all the remaining results, <code>NextToken</code> is set to a token. To retrieve
|
8998
|
+
* the next set of results, call this action again and assign that token to the request object's <code>NextToken</code>
|
8999
|
+
* parameter. If the request returns all results, <code>NextToken</code> is set to <code>null</code>.</p>
|
9000
|
+
* @public
|
9001
|
+
*/
|
9002
|
+
NextToken?: string | undefined;
|
9003
|
+
/**
|
9004
|
+
* <p>The maximum number of results to be returned with a single call. If the number of available results exceeds this
|
9005
|
+
* maximum, the response includes a <code>NextToken</code> value that you can assign to the <code>NextToken</code>
|
9006
|
+
* request parameter to get the next set of results.</p>
|
9007
|
+
* @public
|
9008
|
+
*/
|
9009
|
+
MaxResults?: number | undefined;
|
9010
|
+
}
|
9011
|
+
/**
|
9012
|
+
* <p>The summary of a stack refactor operation.</p>
|
9013
|
+
* @public
|
9014
|
+
*/
|
9015
|
+
export interface StackRefactorSummary {
|
9016
|
+
/**
|
9017
|
+
* <p>The ID associated with the stack refactor created from the <a>CreateStackRefactor</a> action.</p>
|
9018
|
+
* @public
|
9019
|
+
*/
|
9020
|
+
StackRefactorId?: string | undefined;
|
9021
|
+
/**
|
9022
|
+
* <p>A description to help you identify the refactor.</p>
|
9023
|
+
* @public
|
9024
|
+
*/
|
9025
|
+
Description?: string | undefined;
|
9026
|
+
/**
|
9027
|
+
* <p>The operation status that's provided after calling the <a>ExecuteStackRefactor</a> action.</p>
|
9028
|
+
* @public
|
9029
|
+
*/
|
9030
|
+
ExecutionStatus?: StackRefactorExecutionStatus | undefined;
|
9031
|
+
/**
|
9032
|
+
* <p>A detailed explanation for the stack refactor <code>ExecutionStatus</code>.</p>
|
9033
|
+
* @public
|
9034
|
+
*/
|
9035
|
+
ExecutionStatusReason?: string | undefined;
|
9036
|
+
/**
|
9037
|
+
* <p>The stack refactor operation status that's provided after calling the <a>CreateStackRefactor</a> action.</p>
|
9038
|
+
* @public
|
9039
|
+
*/
|
9040
|
+
Status?: StackRefactorStatus | undefined;
|
9041
|
+
/**
|
9042
|
+
* <p>A detailed explanation for the stack refactor <code>Status</code>.</p>
|
9043
|
+
* @public
|
9044
|
+
*/
|
9045
|
+
StatusReason?: string | undefined;
|
9046
|
+
}
|
9047
|
+
/**
|
9048
|
+
* @public
|
9049
|
+
*/
|
9050
|
+
export interface ListStackRefactorsOutput {
|
9051
|
+
/**
|
9052
|
+
* <p>Provides a summary of a stack refactor, including the following:</p>
|
9053
|
+
* <ul>
|
9054
|
+
* <li>
|
9055
|
+
* <p>
|
9056
|
+
* <code>StackRefactorId</code>
|
9057
|
+
* </p>
|
9058
|
+
* </li>
|
9059
|
+
* <li>
|
9060
|
+
* <p>
|
9061
|
+
* <code>Status</code>
|
9062
|
+
* </p>
|
9063
|
+
* </li>
|
9064
|
+
* <li>
|
9065
|
+
* <p>
|
9066
|
+
* <code>StatusReason</code>
|
9067
|
+
* </p>
|
9068
|
+
* </li>
|
9069
|
+
* <li>
|
9070
|
+
* <p>
|
9071
|
+
* <code>ExecutionStatus</code>
|
9072
|
+
* </p>
|
9073
|
+
* </li>
|
9074
|
+
* <li>
|
9075
|
+
* <p>
|
9076
|
+
* <code>ExecutionStatusReason</code>
|
9077
|
+
* </p>
|
9078
|
+
* </li>
|
9079
|
+
* <li>
|
9080
|
+
* <p>
|
9081
|
+
* <code>Description</code>
|
9082
|
+
* </p>
|
9083
|
+
* </li>
|
9084
|
+
* </ul>
|
9085
|
+
* @public
|
9086
|
+
*/
|
9087
|
+
StackRefactorSummaries: StackRefactorSummary[] | undefined;
|
9088
|
+
/**
|
9089
|
+
* <p>If the request doesn't return all the remaining results, <code>NextToken</code> is set to a token. To retrieve
|
9090
|
+
* the next set of results, call this action again and assign that token to the request object's <code>NextToken</code>
|
9091
|
+
* parameter. If the request returns all results, <code>NextToken</code> is set to <code>null</code>.</p>
|
9092
|
+
* @public
|
9093
|
+
*/
|
9094
|
+
NextToken?: string | undefined;
|
9095
|
+
}
|
9096
|
+
/**
|
9097
|
+
* <p>The input for the <a>ListStackResource</a> action.</p>
|
9098
|
+
* @public
|
9099
|
+
*/
|
9100
|
+
export interface ListStackResourcesInput {
|
9101
|
+
/**
|
9102
|
+
* <p>The name or the unique stack ID that is associated with the stack, which aren't always
|
9103
|
+
* interchangeable:</p>
|
9104
|
+
* <ul>
|
9105
|
+
* <li>
|
9106
|
+
* <p>Running stacks: You can specify either the stack's name or its unique stack ID.</p>
|
9107
|
+
* </li>
|
9108
|
+
* <li>
|
9109
|
+
* <p>Deleted stacks: You must specify the unique stack ID.</p>
|
9110
|
+
* </li>
|
9111
|
+
* </ul>
|
9112
|
+
* <p>Default: There is no default value.</p>
|
9113
|
+
* @public
|
9114
|
+
*/
|
9115
|
+
StackName: string | undefined;
|
9116
|
+
/**
|
9117
|
+
* <p>A string that identifies the next page of stack resources that you want to
|
9118
|
+
* retrieve.</p>
|
9119
|
+
* @public
|
9120
|
+
*/
|
9121
|
+
NextToken?: string | undefined;
|
9122
|
+
}
|
9123
|
+
/**
|
9124
|
+
* <p>Summarizes information about whether the resource's actual configuration differs, or has
|
9125
|
+
* <i>drifted</i>, from its expected configuration.</p>
|
9126
|
+
* @public
|
9127
|
+
*/
|
9128
|
+
export interface StackResourceDriftInformationSummary {
|
9129
|
+
/**
|
9130
|
+
* <p>Status of the resource's actual configuration compared to its expected configuration.</p>
|
9131
|
+
* <ul>
|
9132
|
+
* <li>
|
9133
|
+
* <p>
|
9134
|
+
* <code>DELETED</code>: The resource differs from its expected configuration in that it has
|
9135
|
+
* been deleted.</p>
|
9136
|
+
* </li>
|
9137
|
+
* <li>
|
9138
|
+
* <p>
|
9139
|
+
* <code>MODIFIED</code>: The resource differs from its expected configuration.</p>
|
9140
|
+
* </li>
|
9141
|
+
* <li>
|
9142
|
+
* <p>
|
9143
|
+
* <code>NOT_CHECKED</code>: CloudFormation hasn't checked if the resource differs from its
|
9144
|
+
* expected configuration.</p>
|
9145
|
+
* <p>Any resources that don't currently support drift detection have a status of
|
9146
|
+
* <code>NOT_CHECKED</code>. For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/resource-import-supported-resources.html">Resource
|
9147
|
+
* type support for imports and drift detection</a>. If you performed an <a>ContinueUpdateRollback</a> operation on a stack, any resources included in
|
9148
|
+
* <code>ResourcesToSkip</code> will also have a status of <code>NOT_CHECKED</code>. For more
|
9149
|
+
* information about skipping resources during rollback operations, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-continueupdaterollback.html">Continue rolling back an update</a> in the <i>CloudFormation User Guide</i>.</p>
|
8611
9150
|
* </li>
|
8612
9151
|
* <li>
|
8613
9152
|
* <p>
|
@@ -8894,7 +9433,8 @@ export interface ListStackSetAutoDeploymentTargetsInput {
|
|
8894
9433
|
*/
|
8895
9434
|
export interface StackSetAutoDeploymentTargetSummary {
|
8896
9435
|
/**
|
8897
|
-
* <p>The organization root ID or organizational unit (OU) IDs where the stack set is
|
9436
|
+
* <p>The organization root ID or organizational unit (OU) IDs where the stack set is
|
9437
|
+
* targeted.</p>
|
8898
9438
|
* @public
|
8899
9439
|
*/
|
8900
9440
|
OrganizationalUnitId?: string | undefined;
|
@@ -9024,8 +9564,8 @@ export declare const StackSetOperationResultStatus: {
|
|
9024
9564
|
*/
|
9025
9565
|
export type StackSetOperationResultStatus = (typeof StackSetOperationResultStatus)[keyof typeof StackSetOperationResultStatus];
|
9026
9566
|
/**
|
9027
|
-
* <p>The structure that contains information about a specified operation's results for a given
|
9028
|
-
* Region.</p>
|
9567
|
+
* <p>The structure that contains information about a specified operation's results for a given
|
9568
|
+
* account in a given Region.</p>
|
9029
9569
|
* @public
|
9030
9570
|
*/
|
9031
9571
|
export interface StackSetOperationResultSummary {
|
@@ -9040,31 +9580,35 @@ export interface StackSetOperationResultSummary {
|
|
9040
9580
|
*/
|
9041
9581
|
Region?: string | undefined;
|
9042
9582
|
/**
|
9043
|
-
* <p>The result status of the stack set operation for the given account in the given
|
9583
|
+
* <p>The result status of the stack set operation for the given account in the given
|
9584
|
+
* Region.</p>
|
9044
9585
|
* <ul>
|
9045
9586
|
* <li>
|
9046
9587
|
* <p>
|
9047
|
-
* <code>CANCELLED</code>: The operation in the specified account and Region has been
|
9048
|
-
* because a user has stopped the stack set operation, or because the
|
9049
|
-
* been exceeded.</p>
|
9588
|
+
* <code>CANCELLED</code>: The operation in the specified account and Region has been
|
9589
|
+
* canceled. This is either because a user has stopped the stack set operation, or because the
|
9590
|
+
* failure tolerance of the stack set operation has been exceeded.</p>
|
9050
9591
|
* </li>
|
9051
9592
|
* <li>
|
9052
9593
|
* <p>
|
9053
9594
|
* <code>FAILED</code>: The operation in the specified account and Region failed.</p>
|
9054
|
-
* <p>If the stack set operation fails in enough accounts within a Region, the failure tolerance
|
9055
|
-
* operation as a whole might be exceeded.</p>
|
9595
|
+
* <p>If the stack set operation fails in enough accounts within a Region, the failure tolerance
|
9596
|
+
* for the stack set operation as a whole might be exceeded.</p>
|
9056
9597
|
* </li>
|
9057
9598
|
* <li>
|
9058
9599
|
* <p>
|
9059
|
-
* <code>RUNNING</code>: The operation in the specified account and Region is currently in
|
9600
|
+
* <code>RUNNING</code>: The operation in the specified account and Region is currently in
|
9601
|
+
* progress.</p>
|
9060
9602
|
* </li>
|
9061
9603
|
* <li>
|
9062
9604
|
* <p>
|
9063
|
-
* <code>PENDING</code>: The operation in the specified account and Region has yet to
|
9605
|
+
* <code>PENDING</code>: The operation in the specified account and Region has yet to
|
9606
|
+
* start.</p>
|
9064
9607
|
* </li>
|
9065
9608
|
* <li>
|
9066
9609
|
* <p>
|
9067
|
-
* <code>SUCCEEDED</code>: The operation in the specified account and Region completed
|
9610
|
+
* <code>SUCCEEDED</code>: The operation in the specified account and Region completed
|
9611
|
+
* successfully.</p>
|
9068
9612
|
* </li>
|
9069
9613
|
* </ul>
|
9070
9614
|
* @public
|
@@ -9076,14 +9620,14 @@ export interface StackSetOperationResultSummary {
|
|
9076
9620
|
*/
|
9077
9621
|
StatusReason?: string | undefined;
|
9078
9622
|
/**
|
9079
|
-
* <p>The results of the account gate function CloudFormation invokes, if present, before proceeding
|
9080
|
-
* in an account.</p>
|
9623
|
+
* <p>The results of the account gate function CloudFormation invokes, if present, before proceeding
|
9624
|
+
* with stack set operations in an account.</p>
|
9081
9625
|
* @public
|
9082
9626
|
*/
|
9083
9627
|
AccountGateResult?: AccountGateResult | undefined;
|
9084
9628
|
/**
|
9085
|
-
* <p>[Service-managed permissions] The organization root ID or organizational unit (OU) IDs that
|
9086
|
-
* <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_DeploymentTargets.html">DeploymentTargets</a>.</p>
|
9629
|
+
* <p>[Service-managed permissions] The organization root ID or organizational unit (OU) IDs that
|
9630
|
+
* you specified for <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_DeploymentTargets.html">DeploymentTargets</a>.</p>
|
9087
9631
|
* @public
|
9088
9632
|
*/
|
9089
9633
|
OrganizationalUnitId?: string | undefined;
|
@@ -9168,9 +9712,10 @@ export interface StackSetOperationSummary {
|
|
9168
9712
|
*/
|
9169
9713
|
OperationId?: string | undefined;
|
9170
9714
|
/**
|
9171
|
-
* <p>The type of operation: <code>CREATE</code>, <code>UPDATE</code>, or <code>DELETE</code>.
|
9172
|
-
* operations affect only the specified stack instances that are associated with
|
9173
|
-
* operations affect both the stack set itself and
|
9715
|
+
* <p>The type of operation: <code>CREATE</code>, <code>UPDATE</code>, or <code>DELETE</code>.
|
9716
|
+
* Create and delete operations affect only the specified stack instances that are associated with
|
9717
|
+
* the specified stack set. Update operations affect both the stack set itself and
|
9718
|
+
* <i>all</i> associated stack set instances.</p>
|
9174
9719
|
* @public
|
9175
9720
|
*/
|
9176
9721
|
Action?: StackSetOperationAction | undefined;
|
@@ -9179,16 +9724,19 @@ export interface StackSetOperationSummary {
|
|
9179
9724
|
* <ul>
|
9180
9725
|
* <li>
|
9181
9726
|
* <p>
|
9182
|
-
* <code>FAILED</code>: The operation exceeded the specified failure tolerance. The failure
|
9183
|
-
* you've set for an operation is applied for each Region during stack create
|
9184
|
-
*
|
9185
|
-
*
|
9727
|
+
* <code>FAILED</code>: The operation exceeded the specified failure tolerance. The failure
|
9728
|
+
* tolerance value that you've set for an operation is applied for each Region during stack create
|
9729
|
+
* and update operations. If the number of failed stacks within a Region exceeds the failure
|
9730
|
+
* tolerance, the status of the operation in the Region is set to <code>FAILED</code>. This in
|
9731
|
+
* turn sets the status of the operation as a whole to <code>FAILED</code>, and CloudFormation cancels
|
9732
|
+
* the operation in any remaining Regions.</p>
|
9186
9733
|
* </li>
|
9187
9734
|
* <li>
|
9188
9735
|
* <p>
|
9189
|
-
* <code>QUEUED</code>: [Service-managed permissions] For automatic deployments that require
|
9190
|
-
* operations, the operation is queued to be performed. For more information, see
|
9191
|
-
*
|
9736
|
+
* <code>QUEUED</code>: [Service-managed permissions] For automatic deployments that require
|
9737
|
+
* a sequence of operations, the operation is queued to be performed. For more information, see
|
9738
|
+
* the <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/what-is-cfnstacksets.html#stackset-status-codes">stack
|
9739
|
+
* set operation status codes</a> in the <i>CloudFormation User Guide</i>.</p>
|
9192
9740
|
* </li>
|
9193
9741
|
* <li>
|
9194
9742
|
* <p>
|
@@ -9200,29 +9748,30 @@ export interface StackSetOperationSummary {
|
|
9200
9748
|
* </li>
|
9201
9749
|
* <li>
|
9202
9750
|
* <p>
|
9203
|
-
* <code>STOPPING</code>: The operation is in the process of stopping, at user
|
9751
|
+
* <code>STOPPING</code>: The operation is in the process of stopping, at user
|
9752
|
+
* request.</p>
|
9204
9753
|
* </li>
|
9205
9754
|
* <li>
|
9206
9755
|
* <p>
|
9207
|
-
* <code>SUCCEEDED</code>: The operation completed creating or updating all the specified
|
9208
|
-
* exceeding the failure tolerance for the operation.</p>
|
9756
|
+
* <code>SUCCEEDED</code>: The operation completed creating or updating all the specified
|
9757
|
+
* stacks without exceeding the failure tolerance for the operation.</p>
|
9209
9758
|
* </li>
|
9210
9759
|
* </ul>
|
9211
9760
|
* @public
|
9212
9761
|
*/
|
9213
9762
|
Status?: StackSetOperationStatus | undefined;
|
9214
9763
|
/**
|
9215
|
-
* <p>The time at which the operation was initiated. Note that the creation times for the stack
|
9216
|
-
* differ from the creation time of the individual stacks themselves. This is
|
9217
|
-
*
|
9218
|
-
* stacks.</p>
|
9764
|
+
* <p>The time at which the operation was initiated. Note that the creation times for the stack
|
9765
|
+
* set operation might differ from the creation time of the individual stacks themselves. This is
|
9766
|
+
* because CloudFormation needs to perform preparatory work for the operation, such as dispatching the
|
9767
|
+
* work to the requested Regions, before actually creating the first stacks.</p>
|
9219
9768
|
* @public
|
9220
9769
|
*/
|
9221
9770
|
CreationTimestamp?: Date | undefined;
|
9222
9771
|
/**
|
9223
|
-
* <p>The time at which the stack set operation ended, across all accounts and Regions specified.
|
9224
|
-
* doesn't necessarily mean that the stack set operation was successful, or even
|
9225
|
-
* Region.</p>
|
9772
|
+
* <p>The time at which the stack set operation ended, across all accounts and Regions specified.
|
9773
|
+
* Note that this doesn't necessarily mean that the stack set operation was successful, or even
|
9774
|
+
* attempted, in each account or Region.</p>
|
9226
9775
|
* @public
|
9227
9776
|
*/
|
9228
9777
|
EndTimestamp?: Date | undefined;
|
@@ -9238,8 +9787,8 @@ export interface StackSetOperationSummary {
|
|
9238
9787
|
StatusDetails?: StackSetOperationStatusDetails | undefined;
|
9239
9788
|
/**
|
9240
9789
|
* <p>The user-specified preferences for how CloudFormation performs a stack set operation.</p>
|
9241
|
-
* <p>For more information about maximum concurrent accounts and failure tolerance, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/what-is-cfnstacksets.html#stackset-ops-options">Stack
|
9242
|
-
* options</a>.</p>
|
9790
|
+
* <p>For more information about maximum concurrent accounts and failure tolerance, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/what-is-cfnstacksets.html#stackset-ops-options">Stack
|
9791
|
+
* set operation options</a>.</p>
|
9243
9792
|
* @public
|
9244
9793
|
*/
|
9245
9794
|
OperationPreferences?: StackSetOperationPreferences | undefined;
|
@@ -9327,7 +9876,8 @@ export interface StackSetSummary {
|
|
9327
9876
|
*/
|
9328
9877
|
StackSetId?: string | undefined;
|
9329
9878
|
/**
|
9330
|
-
* <p>A description of the stack set that you specify when the stack set is created or
|
9879
|
+
* <p>A description of the stack set that you specify when the stack set is created or
|
9880
|
+
* updated.</p>
|
9331
9881
|
* @public
|
9332
9882
|
*/
|
9333
9883
|
Description?: string | undefined;
|
@@ -9337,8 +9887,7 @@ export interface StackSetSummary {
|
|
9337
9887
|
*/
|
9338
9888
|
Status?: StackSetStatus | undefined;
|
9339
9889
|
/**
|
9340
|
-
* <p>[Service-managed permissions] Describes whether StackSets automatically deploys to Organizations
|
9341
|
-
* accounts that are added to a target organizational unit (OU).</p>
|
9890
|
+
* <p>[Service-managed permissions] Describes whether StackSets automatically deploys to Organizations accounts that are added to a target organizational unit (OU).</p>
|
9342
9891
|
* @public
|
9343
9892
|
*/
|
9344
9893
|
AutoDeployment?: AutoDeployment | undefined;
|
@@ -9346,29 +9895,30 @@ export interface StackSetSummary {
|
|
9346
9895
|
* <p>Describes how the IAM roles required for stack set operations are created.</p>
|
9347
9896
|
* <ul>
|
9348
9897
|
* <li>
|
9349
|
-
* <p>With <code>self-managed</code> permissions, you must create the administrator and
|
9350
|
-
* deploy to target accounts. For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-prereqs-self-managed.html">Grant
|
9351
|
-
*
|
9898
|
+
* <p>With <code>self-managed</code> permissions, you must create the administrator and
|
9899
|
+
* execution roles required to deploy to target accounts. For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-prereqs-self-managed.html">Grant
|
9900
|
+
* self-managed permissions</a>.</p>
|
9352
9901
|
* </li>
|
9353
9902
|
* <li>
|
9354
|
-
* <p>With <code>service-managed</code> permissions, StackSets automatically creates the IAM
|
9355
|
-
* deploy to accounts managed by Organizations. For more information,
|
9356
|
-
*
|
9903
|
+
* <p>With <code>service-managed</code> permissions, StackSets automatically creates the IAM
|
9904
|
+
* roles required to deploy to accounts managed by Organizations. For more information,
|
9905
|
+
* see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-orgs-activate-trusted-access.html">Activate
|
9906
|
+
* trusted access for stack sets with Organizations</a>.</p>
|
9357
9907
|
* </li>
|
9358
9908
|
* </ul>
|
9359
9909
|
* @public
|
9360
9910
|
*/
|
9361
9911
|
PermissionModel?: PermissionModels | undefined;
|
9362
9912
|
/**
|
9363
|
-
* <p>Status of the stack set's actual configuration compared to its expected template and
|
9364
|
-
* stack set is considered to have drifted if one or more of its stack
|
9365
|
-
* template and parameter configuration.</p>
|
9913
|
+
* <p>Status of the stack set's actual configuration compared to its expected template and
|
9914
|
+
* parameter configuration. A stack set is considered to have drifted if one or more of its stack
|
9915
|
+
* instances have drifted from their expected template and parameter configuration.</p>
|
9366
9916
|
* <ul>
|
9367
9917
|
* <li>
|
9368
9918
|
* <p>
|
9369
|
-
* <code>DRIFTED</code>: One or more of the stack instances belonging to the stack set stack
|
9370
|
-
* expected template and parameter configuration. A stack instance is considered
|
9371
|
-
* resources in the associated stack have drifted.</p>
|
9919
|
+
* <code>DRIFTED</code>: One or more of the stack instances belonging to the stack set stack
|
9920
|
+
* differs from the expected template and parameter configuration. A stack instance is considered
|
9921
|
+
* to have drifted if one or more of the resources in the associated stack have drifted.</p>
|
9372
9922
|
* </li>
|
9373
9923
|
* <li>
|
9374
9924
|
* <p>
|
@@ -9376,8 +9926,8 @@ export interface StackSetSummary {
|
|
9376
9926
|
* </li>
|
9377
9927
|
* <li>
|
9378
9928
|
* <p>
|
9379
|
-
* <code>IN_SYNC</code>: All the stack instances belonging to the stack set stack match from
|
9380
|
-
* template and parameter configuration.</p>
|
9929
|
+
* <code>IN_SYNC</code>: All the stack instances belonging to the stack set stack match from
|
9930
|
+
* the expected template and parameter configuration.</p>
|
9381
9931
|
* </li>
|
9382
9932
|
* <li>
|
9383
9933
|
* <p>
|
@@ -9388,745 +9938,16 @@ export interface StackSetSummary {
|
|
9388
9938
|
*/
|
9389
9939
|
DriftStatus?: StackDriftStatus | undefined;
|
9390
9940
|
/**
|
9391
|
-
* <p>Most recent time when CloudFormation performed a drift detection operation on the stack set.
|
9392
|
-
*
|
9941
|
+
* <p>Most recent time when CloudFormation performed a drift detection operation on the stack set.
|
9942
|
+
* This value will be <code>NULL</code> for any stack set on which drift detection hasn't yet been
|
9943
|
+
* performed.</p>
|
9393
9944
|
* @public
|
9394
9945
|
*/
|
9395
9946
|
LastDriftCheckTimestamp?: Date | undefined;
|
9396
9947
|
/**
|
9397
|
-
* <p>Describes whether StackSets performs non-conflicting operations concurrently and queues
|
9398
|
-
* operations.</p>
|
9948
|
+
* <p>Describes whether StackSets performs non-conflicting operations concurrently and queues
|
9949
|
+
* conflicting operations.</p>
|
9399
9950
|
* @public
|
9400
9951
|
*/
|
9401
9952
|
ManagedExecution?: ManagedExecution | undefined;
|
9402
9953
|
}
|
9403
|
-
/**
|
9404
|
-
* @public
|
9405
|
-
*/
|
9406
|
-
export interface ListStackSetsOutput {
|
9407
|
-
/**
|
9408
|
-
* <p>A list of <code>StackSetSummary</code> structures that contain information about the
|
9409
|
-
* user's stack sets.</p>
|
9410
|
-
* @public
|
9411
|
-
*/
|
9412
|
-
Summaries?: StackSetSummary[] | undefined;
|
9413
|
-
/**
|
9414
|
-
* <p>If the request doesn't return all of the remaining results, <code>NextToken</code> is set
|
9415
|
-
* to a token. To retrieve the next set of results, call <code>ListStackInstances</code> again
|
9416
|
-
* and assign that token to the request object's <code>NextToken</code> parameter. If the request
|
9417
|
-
* returns all results, <code>NextToken</code> is set to <code>null</code>.</p>
|
9418
|
-
* @public
|
9419
|
-
*/
|
9420
|
-
NextToken?: string | undefined;
|
9421
|
-
}
|
9422
|
-
/**
|
9423
|
-
* @public
|
9424
|
-
*/
|
9425
|
-
export interface ListTypeRegistrationsInput {
|
9426
|
-
/**
|
9427
|
-
* <p>The kind of extension.</p>
|
9428
|
-
* <p>Conditional: You must specify either <code>TypeName</code> and <code>Type</code>, or
|
9429
|
-
* <code>Arn</code>.</p>
|
9430
|
-
* @public
|
9431
|
-
*/
|
9432
|
-
Type?: RegistryType | undefined;
|
9433
|
-
/**
|
9434
|
-
* <p>The name of the extension.</p>
|
9435
|
-
* <p>Conditional: You must specify either <code>TypeName</code> and <code>Type</code>, or
|
9436
|
-
* <code>Arn</code>.</p>
|
9437
|
-
* @public
|
9438
|
-
*/
|
9439
|
-
TypeName?: string | undefined;
|
9440
|
-
/**
|
9441
|
-
* <p>The Amazon Resource Name (ARN) of the extension.</p>
|
9442
|
-
* <p>Conditional: You must specify either <code>TypeName</code> and <code>Type</code>, or
|
9443
|
-
* <code>Arn</code>.</p>
|
9444
|
-
* @public
|
9445
|
-
*/
|
9446
|
-
TypeArn?: string | undefined;
|
9447
|
-
/**
|
9448
|
-
* <p>The current status of the extension registration request.</p>
|
9449
|
-
* <p>The default is <code>IN_PROGRESS</code>.</p>
|
9450
|
-
* @public
|
9451
|
-
*/
|
9452
|
-
RegistrationStatusFilter?: RegistrationStatus | undefined;
|
9453
|
-
/**
|
9454
|
-
* <p>The maximum number of results to be returned with a single call. If the number of
|
9455
|
-
* available results exceeds this maximum, the response includes a <code>NextToken</code> value
|
9456
|
-
* that you can assign to the <code>NextToken</code> request parameter to get the next set of
|
9457
|
-
* results.</p>
|
9458
|
-
* @public
|
9459
|
-
*/
|
9460
|
-
MaxResults?: number | undefined;
|
9461
|
-
/**
|
9462
|
-
* <p>If the previous paginated request didn't return all the remaining results, the response
|
9463
|
-
* object's <code>NextToken</code> parameter value is set to a token. To retrieve the next set of
|
9464
|
-
* results, call this action again and assign that token to the request object's
|
9465
|
-
* <code>NextToken</code> parameter. If there are no remaining results, the previous response
|
9466
|
-
* object's <code>NextToken</code> parameter is set to <code>null</code>.</p>
|
9467
|
-
* @public
|
9468
|
-
*/
|
9469
|
-
NextToken?: string | undefined;
|
9470
|
-
}
|
9471
|
-
/**
|
9472
|
-
* @public
|
9473
|
-
*/
|
9474
|
-
export interface ListTypeRegistrationsOutput {
|
9475
|
-
/**
|
9476
|
-
* <p>A list of extension registration tokens.</p>
|
9477
|
-
* <p>Use <a>DescribeTypeRegistration</a> to return detailed information about a type
|
9478
|
-
* registration request.</p>
|
9479
|
-
* @public
|
9480
|
-
*/
|
9481
|
-
RegistrationTokenList?: string[] | undefined;
|
9482
|
-
/**
|
9483
|
-
* <p>If the request doesn't return all the remaining results, <code>NextToken</code> is set to
|
9484
|
-
* a token. To retrieve the next set of results, call this action again and assign that token to
|
9485
|
-
* the request object's <code>NextToken</code> parameter. If the request returns all results,
|
9486
|
-
* <code>NextToken</code> is set to <code>null</code>.</p>
|
9487
|
-
* @public
|
9488
|
-
*/
|
9489
|
-
NextToken?: string | undefined;
|
9490
|
-
}
|
9491
|
-
/**
|
9492
|
-
* <p>Filter criteria to use in determining which extensions to return.</p>
|
9493
|
-
* @public
|
9494
|
-
*/
|
9495
|
-
export interface TypeFilters {
|
9496
|
-
/**
|
9497
|
-
* <p>The category of extensions to return.</p>
|
9498
|
-
* <ul>
|
9499
|
-
* <li>
|
9500
|
-
* <p>
|
9501
|
-
* <code>REGISTERED</code>: Private extensions that have been registered for this account and
|
9502
|
-
* Region.</p>
|
9503
|
-
* </li>
|
9504
|
-
* <li>
|
9505
|
-
* <p>
|
9506
|
-
* <code>ACTIVATED</code>: Public extensions that have been activated for this account and
|
9507
|
-
* Region.</p>
|
9508
|
-
* </li>
|
9509
|
-
* <li>
|
9510
|
-
* <p>
|
9511
|
-
* <code>THIRD_PARTY</code>: Extensions available for use from publishers other than Amazon.
|
9512
|
-
* This includes:</p>
|
9513
|
-
* <ul>
|
9514
|
-
* <li>
|
9515
|
-
* <p>Private extensions registered in the account.</p>
|
9516
|
-
* </li>
|
9517
|
-
* <li>
|
9518
|
-
* <p>Public extensions from publishers other than Amazon, whether activated or not.</p>
|
9519
|
-
* </li>
|
9520
|
-
* </ul>
|
9521
|
-
* </li>
|
9522
|
-
* <li>
|
9523
|
-
* <p>
|
9524
|
-
* <code>AWS_TYPES</code>: Extensions available for use from Amazon.</p>
|
9525
|
-
* </li>
|
9526
|
-
* </ul>
|
9527
|
-
* @public
|
9528
|
-
*/
|
9529
|
-
Category?: Category | undefined;
|
9530
|
-
/**
|
9531
|
-
* <p>The id of the publisher of the extension.</p>
|
9532
|
-
* <p>Extensions published by Amazon aren't assigned a publisher ID. Use the
|
9533
|
-
* <code>AWS_TYPES</code> category to specify a list of types published by Amazon.</p>
|
9534
|
-
* @public
|
9535
|
-
*/
|
9536
|
-
PublisherId?: string | undefined;
|
9537
|
-
/**
|
9538
|
-
* <p>A prefix to use as a filter for results.</p>
|
9539
|
-
* @public
|
9540
|
-
*/
|
9541
|
-
TypeNamePrefix?: string | undefined;
|
9542
|
-
}
|
9543
|
-
/**
|
9544
|
-
* @public
|
9545
|
-
*/
|
9546
|
-
export interface ListTypesInput {
|
9547
|
-
/**
|
9548
|
-
* <p>The scope at which the extensions are visible and usable in CloudFormation operations.</p>
|
9549
|
-
* <p>Valid values include:</p>
|
9550
|
-
* <ul>
|
9551
|
-
* <li>
|
9552
|
-
* <p>
|
9553
|
-
* <code>PRIVATE</code>: Extensions that are visible and usable within this account and
|
9554
|
-
* Region. This includes:</p>
|
9555
|
-
* <ul>
|
9556
|
-
* <li>
|
9557
|
-
* <p>Private extensions you have registered in this account and Region.</p>
|
9558
|
-
* </li>
|
9559
|
-
* <li>
|
9560
|
-
* <p>Public extensions that you have activated in this account and Region.</p>
|
9561
|
-
* </li>
|
9562
|
-
* </ul>
|
9563
|
-
* </li>
|
9564
|
-
* <li>
|
9565
|
-
* <p>
|
9566
|
-
* <code>PUBLIC</code>: Extensions that are publicly visible and available to be
|
9567
|
-
* activated within any Amazon Web Services account. This includes extensions from Amazon Web Services, in addition to
|
9568
|
-
* third-party publishers.</p>
|
9569
|
-
* </li>
|
9570
|
-
* </ul>
|
9571
|
-
* <p>The default is <code>PRIVATE</code>.</p>
|
9572
|
-
* @public
|
9573
|
-
*/
|
9574
|
-
Visibility?: Visibility | undefined;
|
9575
|
-
/**
|
9576
|
-
* <p>For resource types, the provisioning behavior of the resource type. CloudFormation determines
|
9577
|
-
* the provisioning type during registration, based on the types of handlers in the schema
|
9578
|
-
* handler package submitted.</p>
|
9579
|
-
* <p>Valid values include:</p>
|
9580
|
-
* <ul>
|
9581
|
-
* <li>
|
9582
|
-
* <p>
|
9583
|
-
* <code>FULLY_MUTABLE</code>: The resource type includes an update handler to process
|
9584
|
-
* updates to the type during stack update operations.</p>
|
9585
|
-
* </li>
|
9586
|
-
* <li>
|
9587
|
-
* <p>
|
9588
|
-
* <code>IMMUTABLE</code>: The resource type doesn't include an update handler, so the
|
9589
|
-
* type can't be updated and must instead be replaced during stack update operations.</p>
|
9590
|
-
* </li>
|
9591
|
-
* <li>
|
9592
|
-
* <p>
|
9593
|
-
* <code>NON_PROVISIONABLE</code>: The resource type doesn't include create, read, and
|
9594
|
-
* delete handlers, and therefore can't actually be provisioned.</p>
|
9595
|
-
* </li>
|
9596
|
-
* </ul>
|
9597
|
-
* <p>The default is <code>FULLY_MUTABLE</code>.</p>
|
9598
|
-
* @public
|
9599
|
-
*/
|
9600
|
-
ProvisioningType?: ProvisioningType | undefined;
|
9601
|
-
/**
|
9602
|
-
* <p>The deprecation status of the extension that you want to get summary information
|
9603
|
-
* about.</p>
|
9604
|
-
* <p>Valid values include:</p>
|
9605
|
-
* <ul>
|
9606
|
-
* <li>
|
9607
|
-
* <p>
|
9608
|
-
* <code>LIVE</code>: The extension is registered for use in CloudFormation
|
9609
|
-
* operations.</p>
|
9610
|
-
* </li>
|
9611
|
-
* <li>
|
9612
|
-
* <p>
|
9613
|
-
* <code>DEPRECATED</code>: The extension has been deregistered and can no longer be used
|
9614
|
-
* in CloudFormation operations.</p>
|
9615
|
-
* </li>
|
9616
|
-
* </ul>
|
9617
|
-
* @public
|
9618
|
-
*/
|
9619
|
-
DeprecatedStatus?: DeprecatedStatus | undefined;
|
9620
|
-
/**
|
9621
|
-
* <p>The type of extension.</p>
|
9622
|
-
* @public
|
9623
|
-
*/
|
9624
|
-
Type?: RegistryType | undefined;
|
9625
|
-
/**
|
9626
|
-
* <p>Filter criteria to use in determining which extensions to return.</p>
|
9627
|
-
* <p>Filters must be compatible with <code>Visibility</code> to return valid results. For
|
9628
|
-
* example, specifying <code>AWS_TYPES</code> for <code>Category</code> and <code>PRIVATE</code>
|
9629
|
-
* for <code>Visibility</code> returns an empty list of types, but specifying <code>PUBLIC</code>
|
9630
|
-
* for <code>Visibility</code> returns the desired list.</p>
|
9631
|
-
* @public
|
9632
|
-
*/
|
9633
|
-
Filters?: TypeFilters | undefined;
|
9634
|
-
/**
|
9635
|
-
* <p>The maximum number of results to be returned with a single call. If the number of
|
9636
|
-
* available results exceeds this maximum, the response includes a <code>NextToken</code> value
|
9637
|
-
* that you can assign to the <code>NextToken</code> request parameter to get the next set of
|
9638
|
-
* results.</p>
|
9639
|
-
* @public
|
9640
|
-
*/
|
9641
|
-
MaxResults?: number | undefined;
|
9642
|
-
/**
|
9643
|
-
* <p>If the previous paginated request didn't return all the remaining results, the response
|
9644
|
-
* object's <code>NextToken</code> parameter value is set to a token. To retrieve the next set of
|
9645
|
-
* results, call this action again and assign that token to the request object's
|
9646
|
-
* <code>NextToken</code> parameter. If there are no remaining results, the previous response
|
9647
|
-
* object's <code>NextToken</code> parameter is set to <code>null</code>.</p>
|
9648
|
-
* @public
|
9649
|
-
*/
|
9650
|
-
NextToken?: string | undefined;
|
9651
|
-
}
|
9652
|
-
/**
|
9653
|
-
* <p>Contains summary information about the specified CloudFormation extension.</p>
|
9654
|
-
* @public
|
9655
|
-
*/
|
9656
|
-
export interface TypeSummary {
|
9657
|
-
/**
|
9658
|
-
* <p>The kind of extension.</p>
|
9659
|
-
* @public
|
9660
|
-
*/
|
9661
|
-
Type?: RegistryType | undefined;
|
9662
|
-
/**
|
9663
|
-
* <p>The name of the extension.</p>
|
9664
|
-
* <p>If you specified a <code>TypeNameAlias</code> when you call the <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_ActivateType.html">ActivateType</a> API
|
9665
|
-
* operation in your account and Region, CloudFormation considers that alias as the type name.</p>
|
9666
|
-
* @public
|
9667
|
-
*/
|
9668
|
-
TypeName?: string | undefined;
|
9669
|
-
/**
|
9670
|
-
* <p>The ID of the default version of the extension. The default version is used when the
|
9671
|
-
* extension version isn't specified.</p>
|
9672
|
-
* <p>This applies only to private extensions you have registered in your account. For public
|
9673
|
-
* extensions, both those provided by Amazon and published by third parties, CloudFormation returns
|
9674
|
-
* <code>null</code>. For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_RegisterType.html">RegisterType</a>.</p>
|
9675
|
-
* <p>To set the default version of an extension, use <a>SetTypeDefaultVersion</a>.</p>
|
9676
|
-
* @public
|
9677
|
-
*/
|
9678
|
-
DefaultVersionId?: string | undefined;
|
9679
|
-
/**
|
9680
|
-
* <p>The Amazon Resource Name (ARN) of the extension.</p>
|
9681
|
-
* @public
|
9682
|
-
*/
|
9683
|
-
TypeArn?: string | undefined;
|
9684
|
-
/**
|
9685
|
-
* <p>When the specified extension version was registered. This applies only to:</p>
|
9686
|
-
* <ul>
|
9687
|
-
* <li>
|
9688
|
-
* <p>Private extensions you have registered in your account. For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_RegisterType.html">RegisterType</a>.</p>
|
9689
|
-
* </li>
|
9690
|
-
* <li>
|
9691
|
-
* <p>Public extensions you have activated in your account with auto-update specified. For more
|
9692
|
-
* information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_ActivateType.html">ActivateType</a>.</p>
|
9693
|
-
* </li>
|
9694
|
-
* </ul>
|
9695
|
-
* <p>For all other extension types, CloudFormation returns <code>null</code>.</p>
|
9696
|
-
* @public
|
9697
|
-
*/
|
9698
|
-
LastUpdated?: Date | undefined;
|
9699
|
-
/**
|
9700
|
-
* <p>The description of the extension.</p>
|
9701
|
-
* @public
|
9702
|
-
*/
|
9703
|
-
Description?: string | undefined;
|
9704
|
-
/**
|
9705
|
-
* <p>The ID of the extension publisher, if the extension is published by a third party.
|
9706
|
-
* Extensions published by Amazon don't return a publisher ID.</p>
|
9707
|
-
* @public
|
9708
|
-
*/
|
9709
|
-
PublisherId?: string | undefined;
|
9710
|
-
/**
|
9711
|
-
* <p>For public extensions that have been activated for this account and Region, the type name of
|
9712
|
-
* the public extension.</p>
|
9713
|
-
* <p>If you specified a <code>TypeNameAlias</code> when enabling the extension in this account
|
9714
|
-
* and Region, CloudFormation treats that alias as the extension's type name within the account and
|
9715
|
-
* Region, not the type name of the public extension. For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/registry-public.html#registry-public-enable-alias">Use
|
9716
|
-
* aliases to refer to extensions</a> in the <i>CloudFormation User Guide</i>.</p>
|
9717
|
-
* @public
|
9718
|
-
*/
|
9719
|
-
OriginalTypeName?: string | undefined;
|
9720
|
-
/**
|
9721
|
-
* <p>For public extensions that have been activated for this account and Region, the version of
|
9722
|
-
* the public extension to be used for CloudFormation operations in this account and Region.</p>
|
9723
|
-
* <p>How you specified <code>AutoUpdate</code> when enabling the extension affects whether
|
9724
|
-
* CloudFormation automatically updates the extension in this account and Region when a new version is
|
9725
|
-
* released. For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/registry-public.html#registry-public-enable-auto">Automatically use new versions of extensions</a> in the
|
9726
|
-
* <i>CloudFormation User Guide</i>.</p>
|
9727
|
-
* @public
|
9728
|
-
*/
|
9729
|
-
PublicVersionNumber?: string | undefined;
|
9730
|
-
/**
|
9731
|
-
* <p>For public extensions that have been activated for this account and Region, the latest
|
9732
|
-
* version of the public extension <i>that is available</i>. For any extensions other
|
9733
|
-
* than activated third-party extensions, CloudFormation returns <code>null</code>.</p>
|
9734
|
-
* <p>How you specified <code>AutoUpdate</code> when enabling the extension affects whether
|
9735
|
-
* CloudFormation automatically updates the extension in this account and Region when a new version is
|
9736
|
-
* released. For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/registry-public.html#registry-public-enable-auto">Automatically use new versions of extensions</a> in the
|
9737
|
-
* <i>CloudFormation User Guide</i>.</p>
|
9738
|
-
* @public
|
9739
|
-
*/
|
9740
|
-
LatestPublicVersion?: string | undefined;
|
9741
|
-
/**
|
9742
|
-
* <p>The service used to verify the publisher identity.</p>
|
9743
|
-
* <p>For more information, see <a href="https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/publish-extension.html">Publishing extensions to make
|
9744
|
-
* them available for public use</a> in the <i>CloudFormation Command Line Interface (CLI) User Guide</i>.</p>
|
9745
|
-
* @public
|
9746
|
-
*/
|
9747
|
-
PublisherIdentity?: IdentityProvider | undefined;
|
9748
|
-
/**
|
9749
|
-
* <p>The publisher name, as defined in the public profile for that publisher in the service used
|
9750
|
-
* to verify the publisher identity.</p>
|
9751
|
-
* @public
|
9752
|
-
*/
|
9753
|
-
PublisherName?: string | undefined;
|
9754
|
-
/**
|
9755
|
-
* <p>Whether the extension is activated for this account and Region.</p>
|
9756
|
-
* <p>This applies only to third-party public extensions. Extensions published by Amazon are
|
9757
|
-
* activated by default.</p>
|
9758
|
-
* @public
|
9759
|
-
*/
|
9760
|
-
IsActivated?: boolean | undefined;
|
9761
|
-
}
|
9762
|
-
/**
|
9763
|
-
* @public
|
9764
|
-
*/
|
9765
|
-
export interface ListTypesOutput {
|
9766
|
-
/**
|
9767
|
-
* <p>A list of <code>TypeSummary</code> structures that contain information about the specified
|
9768
|
-
* extensions.</p>
|
9769
|
-
* @public
|
9770
|
-
*/
|
9771
|
-
TypeSummaries?: TypeSummary[] | undefined;
|
9772
|
-
/**
|
9773
|
-
* <p>If the request doesn't return all the remaining results, <code>NextToken</code> is set to
|
9774
|
-
* a token. To retrieve the next set of results, call this action again and assign that token to
|
9775
|
-
* the request object's <code>NextToken</code> parameter. If the request returns all results,
|
9776
|
-
* <code>NextToken</code> is set to <code>null</code>.</p>
|
9777
|
-
* @public
|
9778
|
-
*/
|
9779
|
-
NextToken?: string | undefined;
|
9780
|
-
}
|
9781
|
-
/**
|
9782
|
-
* @public
|
9783
|
-
*/
|
9784
|
-
export interface ListTypeVersionsInput {
|
9785
|
-
/**
|
9786
|
-
* <p>The kind of the extension.</p>
|
9787
|
-
* <p>Conditional: You must specify either <code>TypeName</code> and <code>Type</code>, or
|
9788
|
-
* <code>Arn</code>.</p>
|
9789
|
-
* @public
|
9790
|
-
*/
|
9791
|
-
Type?: RegistryType | undefined;
|
9792
|
-
/**
|
9793
|
-
* <p>The name of the extension for which you want version summary information.</p>
|
9794
|
-
* <p>Conditional: You must specify either <code>TypeName</code> and <code>Type</code>, or
|
9795
|
-
* <code>Arn</code>.</p>
|
9796
|
-
* @public
|
9797
|
-
*/
|
9798
|
-
TypeName?: string | undefined;
|
9799
|
-
/**
|
9800
|
-
* <p>The Amazon Resource Name (ARN) of the extension for which you want version summary
|
9801
|
-
* information.</p>
|
9802
|
-
* <p>Conditional: You must specify either <code>TypeName</code> and <code>Type</code>, or
|
9803
|
-
* <code>Arn</code>.</p>
|
9804
|
-
* @public
|
9805
|
-
*/
|
9806
|
-
Arn?: string | undefined;
|
9807
|
-
/**
|
9808
|
-
* <p>The maximum number of results to be returned with a single call. If the number of
|
9809
|
-
* available results exceeds this maximum, the response includes a <code>NextToken</code> value
|
9810
|
-
* that you can assign to the <code>NextToken</code> request parameter to get the next set of
|
9811
|
-
* results.</p>
|
9812
|
-
* @public
|
9813
|
-
*/
|
9814
|
-
MaxResults?: number | undefined;
|
9815
|
-
/**
|
9816
|
-
* <p>If the previous paginated request didn't return all of the remaining results, the response
|
9817
|
-
* object's <code>NextToken</code> parameter value is set to a token. To retrieve the next set of
|
9818
|
-
* results, call this action again and assign that token to the request object's
|
9819
|
-
* <code>NextToken</code> parameter. If there are no remaining results, the previous response
|
9820
|
-
* object's <code>NextToken</code> parameter is set to <code>null</code>.</p>
|
9821
|
-
* @public
|
9822
|
-
*/
|
9823
|
-
NextToken?: string | undefined;
|
9824
|
-
/**
|
9825
|
-
* <p>The deprecation status of the extension versions that you want to get summary information
|
9826
|
-
* about.</p>
|
9827
|
-
* <p>Valid values include:</p>
|
9828
|
-
* <ul>
|
9829
|
-
* <li>
|
9830
|
-
* <p>
|
9831
|
-
* <code>LIVE</code>: The extension version is registered and can be used in CloudFormation
|
9832
|
-
* operations, dependent on its provisioning behavior and visibility scope.</p>
|
9833
|
-
* </li>
|
9834
|
-
* <li>
|
9835
|
-
* <p>
|
9836
|
-
* <code>DEPRECATED</code>: The extension version has been deregistered and can no longer
|
9837
|
-
* be used in CloudFormation operations.</p>
|
9838
|
-
* </li>
|
9839
|
-
* </ul>
|
9840
|
-
* <p>The default is <code>LIVE</code>.</p>
|
9841
|
-
* @public
|
9842
|
-
*/
|
9843
|
-
DeprecatedStatus?: DeprecatedStatus | undefined;
|
9844
|
-
/**
|
9845
|
-
* <p>The publisher ID of the extension publisher.</p>
|
9846
|
-
* <p>Extensions published by Amazon aren't assigned a publisher ID.</p>
|
9847
|
-
* @public
|
9848
|
-
*/
|
9849
|
-
PublisherId?: string | undefined;
|
9850
|
-
}
|
9851
|
-
/**
|
9852
|
-
* <p>Contains summary information about a specific version of a CloudFormation extension.</p>
|
9853
|
-
* @public
|
9854
|
-
*/
|
9855
|
-
export interface TypeVersionSummary {
|
9856
|
-
/**
|
9857
|
-
* <p>The kind of extension.</p>
|
9858
|
-
* @public
|
9859
|
-
*/
|
9860
|
-
Type?: RegistryType | undefined;
|
9861
|
-
/**
|
9862
|
-
* <p>The name of the extension.</p>
|
9863
|
-
* @public
|
9864
|
-
*/
|
9865
|
-
TypeName?: string | undefined;
|
9866
|
-
/**
|
9867
|
-
* <p>The ID of a specific version of the extension. The version ID is the value at the end of the
|
9868
|
-
* Amazon Resource Name (ARN) assigned to the extension version when it's registered.</p>
|
9869
|
-
* @public
|
9870
|
-
*/
|
9871
|
-
VersionId?: string | undefined;
|
9872
|
-
/**
|
9873
|
-
* <p>Whether the specified extension version is set as the default version.</p>
|
9874
|
-
* <p>This applies only to private extensions you have registered in your account, and extensions
|
9875
|
-
* published by Amazon. For public third-party extensions, CloudFormation returns
|
9876
|
-
* <code>null</code>.</p>
|
9877
|
-
* @public
|
9878
|
-
*/
|
9879
|
-
IsDefaultVersion?: boolean | undefined;
|
9880
|
-
/**
|
9881
|
-
* <p>The Amazon Resource Name (ARN) of the extension version.</p>
|
9882
|
-
* @public
|
9883
|
-
*/
|
9884
|
-
Arn?: string | undefined;
|
9885
|
-
/**
|
9886
|
-
* <p>When the version was registered.</p>
|
9887
|
-
* @public
|
9888
|
-
*/
|
9889
|
-
TimeCreated?: Date | undefined;
|
9890
|
-
/**
|
9891
|
-
* <p>The description of the extension version.</p>
|
9892
|
-
* @public
|
9893
|
-
*/
|
9894
|
-
Description?: string | undefined;
|
9895
|
-
/**
|
9896
|
-
* <p>For public extensions that have been activated for this account and Region, the version of
|
9897
|
-
* the public extension to be used for CloudFormation operations in this account and Region. For any
|
9898
|
-
* extensions other than activated third-party extensions, CloudFormation returns
|
9899
|
-
* <code>null</code>.</p>
|
9900
|
-
* <p>How you specified <code>AutoUpdate</code> when enabling the extension affects whether
|
9901
|
-
* CloudFormation automatically updates the extension in this account and Region when a new version is
|
9902
|
-
* released. For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/registry-public.html#registry-public-enable-auto">Automatically use new versions of extensions</a> in the
|
9903
|
-
* <i>CloudFormation User Guide</i>.</p>
|
9904
|
-
* @public
|
9905
|
-
*/
|
9906
|
-
PublicVersionNumber?: string | undefined;
|
9907
|
-
}
|
9908
|
-
/**
|
9909
|
-
* @public
|
9910
|
-
*/
|
9911
|
-
export interface ListTypeVersionsOutput {
|
9912
|
-
/**
|
9913
|
-
* <p>A list of <code>TypeVersionSummary</code> structures that contain information about the
|
9914
|
-
* specified extension's versions.</p>
|
9915
|
-
* @public
|
9916
|
-
*/
|
9917
|
-
TypeVersionSummaries?: TypeVersionSummary[] | undefined;
|
9918
|
-
/**
|
9919
|
-
* <p>If the request doesn't return all of the remaining results, <code>NextToken</code> is set
|
9920
|
-
* to a token. To retrieve the next set of results, call this action again and assign that token
|
9921
|
-
* to the request object's <code>NextToken</code> parameter. If the request returns all results,
|
9922
|
-
* <code>NextToken</code> is set to <code>null</code>.</p>
|
9923
|
-
* @public
|
9924
|
-
*/
|
9925
|
-
NextToken?: string | undefined;
|
9926
|
-
}
|
9927
|
-
/**
|
9928
|
-
* @public
|
9929
|
-
*/
|
9930
|
-
export interface PublishTypeInput {
|
9931
|
-
/**
|
9932
|
-
* <p>The type of the extension.</p>
|
9933
|
-
* <p>Conditional: You must specify <code>Arn</code>, or <code>TypeName</code> and
|
9934
|
-
* <code>Type</code>.</p>
|
9935
|
-
* @public
|
9936
|
-
*/
|
9937
|
-
Type?: ThirdPartyType | undefined;
|
9938
|
-
/**
|
9939
|
-
* <p>The Amazon Resource Name (ARN) of the extension.</p>
|
9940
|
-
* <p>Conditional: You must specify <code>Arn</code>, or <code>TypeName</code> and
|
9941
|
-
* <code>Type</code>.</p>
|
9942
|
-
* @public
|
9943
|
-
*/
|
9944
|
-
Arn?: string | undefined;
|
9945
|
-
/**
|
9946
|
-
* <p>The name of the extension.</p>
|
9947
|
-
* <p>Conditional: You must specify <code>Arn</code>, or <code>TypeName</code> and
|
9948
|
-
* <code>Type</code>.</p>
|
9949
|
-
* @public
|
9950
|
-
*/
|
9951
|
-
TypeName?: string | undefined;
|
9952
|
-
/**
|
9953
|
-
* <p>The version number to assign to this version of the extension.</p>
|
9954
|
-
* <p>Use the following format, and adhere to semantic versioning when assigning a version
|
9955
|
-
* number to your extension:</p>
|
9956
|
-
* <p>
|
9957
|
-
* <code>MAJOR.MINOR.PATCH</code>
|
9958
|
-
* </p>
|
9959
|
-
* <p>For more information, see <a href="https://semver.org/">Semantic Versioning
|
9960
|
-
* 2.0.0</a>.</p>
|
9961
|
-
* <p>If you don't specify a version number, CloudFormation increments the version number by one
|
9962
|
-
* minor version release.</p>
|
9963
|
-
* <p>You cannot specify a version number the first time you publish a type. CloudFormation
|
9964
|
-
* automatically sets the first version number to be <code>1.0.0</code>.</p>
|
9965
|
-
* @public
|
9966
|
-
*/
|
9967
|
-
PublicVersionNumber?: string | undefined;
|
9968
|
-
}
|
9969
|
-
/**
|
9970
|
-
* @public
|
9971
|
-
*/
|
9972
|
-
export interface PublishTypeOutput {
|
9973
|
-
/**
|
9974
|
-
* <p>The Amazon Resource Name (ARN) assigned to the public extension upon publication.</p>
|
9975
|
-
* @public
|
9976
|
-
*/
|
9977
|
-
PublicTypeArn?: string | undefined;
|
9978
|
-
}
|
9979
|
-
/**
|
9980
|
-
* <p>Error reserved for use by the <a href="https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/what-is-cloudformation-cli.html">CloudFormation CLI</a>. CloudFormation doesn't
|
9981
|
-
* return this error to users.</p>
|
9982
|
-
* @public
|
9983
|
-
*/
|
9984
|
-
export declare class InvalidStateTransitionException extends __BaseException {
|
9985
|
-
readonly name: "InvalidStateTransitionException";
|
9986
|
-
readonly $fault: "client";
|
9987
|
-
Message?: string | undefined;
|
9988
|
-
/**
|
9989
|
-
* @internal
|
9990
|
-
*/
|
9991
|
-
constructor(opts: __ExceptionOptionType<InvalidStateTransitionException, __BaseException>);
|
9992
|
-
}
|
9993
|
-
/**
|
9994
|
-
* <p>Error reserved for use by the <a href="https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/what-is-cloudformation-cli.html">CloudFormation CLI</a>. CloudFormation doesn't
|
9995
|
-
* return this error to users.</p>
|
9996
|
-
* @public
|
9997
|
-
*/
|
9998
|
-
export declare class OperationStatusCheckFailedException extends __BaseException {
|
9999
|
-
readonly name: "OperationStatusCheckFailedException";
|
10000
|
-
readonly $fault: "client";
|
10001
|
-
Message?: string | undefined;
|
10002
|
-
/**
|
10003
|
-
* @internal
|
10004
|
-
*/
|
10005
|
-
constructor(opts: __ExceptionOptionType<OperationStatusCheckFailedException, __BaseException>);
|
10006
|
-
}
|
10007
|
-
/**
|
10008
|
-
* @public
|
10009
|
-
* @enum
|
10010
|
-
*/
|
10011
|
-
export declare const OperationStatus: {
|
10012
|
-
readonly FAILED: "FAILED";
|
10013
|
-
readonly IN_PROGRESS: "IN_PROGRESS";
|
10014
|
-
readonly PENDING: "PENDING";
|
10015
|
-
readonly SUCCESS: "SUCCESS";
|
10016
|
-
};
|
10017
|
-
/**
|
10018
|
-
* @public
|
10019
|
-
*/
|
10020
|
-
export type OperationStatus = (typeof OperationStatus)[keyof typeof OperationStatus];
|
10021
|
-
/**
|
10022
|
-
* @public
|
10023
|
-
* @enum
|
10024
|
-
*/
|
10025
|
-
export declare const HandlerErrorCode: {
|
10026
|
-
readonly AccessDenied: "AccessDenied";
|
10027
|
-
readonly AlreadyExists: "AlreadyExists";
|
10028
|
-
readonly GeneralServiceException: "GeneralServiceException";
|
10029
|
-
readonly HandlerInternalFailure: "HandlerInternalFailure";
|
10030
|
-
readonly InternalFailure: "InternalFailure";
|
10031
|
-
readonly InvalidCredentials: "InvalidCredentials";
|
10032
|
-
readonly InvalidRequest: "InvalidRequest";
|
10033
|
-
readonly InvalidTypeConfiguration: "InvalidTypeConfiguration";
|
10034
|
-
readonly NetworkFailure: "NetworkFailure";
|
10035
|
-
readonly NonCompliant: "NonCompliant";
|
10036
|
-
readonly NotFound: "NotFound";
|
10037
|
-
readonly NotUpdatable: "NotUpdatable";
|
10038
|
-
readonly ResourceConflict: "ResourceConflict";
|
10039
|
-
readonly ServiceInternalError: "ServiceInternalError";
|
10040
|
-
readonly ServiceLimitExceeded: "ServiceLimitExceeded";
|
10041
|
-
readonly ServiceTimeout: "NotStabilized";
|
10042
|
-
readonly Throttling: "Throttling";
|
10043
|
-
readonly Unknown: "Unknown";
|
10044
|
-
readonly UnsupportedTarget: "UnsupportedTarget";
|
10045
|
-
};
|
10046
|
-
/**
|
10047
|
-
* @public
|
10048
|
-
*/
|
10049
|
-
export type HandlerErrorCode = (typeof HandlerErrorCode)[keyof typeof HandlerErrorCode];
|
10050
|
-
/**
|
10051
|
-
* @public
|
10052
|
-
*/
|
10053
|
-
export interface RecordHandlerProgressInput {
|
10054
|
-
/**
|
10055
|
-
* <p>Reserved for use by the <a href="https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/what-is-cloudformation-cli.html">CloudFormation
|
10056
|
-
* CLI</a>.</p>
|
10057
|
-
* @public
|
10058
|
-
*/
|
10059
|
-
BearerToken: string | undefined;
|
10060
|
-
/**
|
10061
|
-
* <p>Reserved for use by the <a href="https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/what-is-cloudformation-cli.html">CloudFormation
|
10062
|
-
* CLI</a>.</p>
|
10063
|
-
* @public
|
10064
|
-
*/
|
10065
|
-
OperationStatus: OperationStatus | undefined;
|
10066
|
-
/**
|
10067
|
-
* <p>Reserved for use by the <a href="https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/what-is-cloudformation-cli.html">CloudFormation
|
10068
|
-
* CLI</a>.</p>
|
10069
|
-
* @public
|
10070
|
-
*/
|
10071
|
-
CurrentOperationStatus?: OperationStatus | undefined;
|
10072
|
-
/**
|
10073
|
-
* <p>Reserved for use by the <a href="https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/what-is-cloudformation-cli.html">CloudFormation
|
10074
|
-
* CLI</a>.</p>
|
10075
|
-
* @public
|
10076
|
-
*/
|
10077
|
-
StatusMessage?: string | undefined;
|
10078
|
-
/**
|
10079
|
-
* <p>Reserved for use by the <a href="https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/what-is-cloudformation-cli.html">CloudFormation
|
10080
|
-
* CLI</a>.</p>
|
10081
|
-
* @public
|
10082
|
-
*/
|
10083
|
-
ErrorCode?: HandlerErrorCode | undefined;
|
10084
|
-
/**
|
10085
|
-
* <p>Reserved for use by the <a href="https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/what-is-cloudformation-cli.html">CloudFormation
|
10086
|
-
* CLI</a>.</p>
|
10087
|
-
* @public
|
10088
|
-
*/
|
10089
|
-
ResourceModel?: string | undefined;
|
10090
|
-
/**
|
10091
|
-
* <p>Reserved for use by the <a href="https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/what-is-cloudformation-cli.html">CloudFormation
|
10092
|
-
* CLI</a>.</p>
|
10093
|
-
* @public
|
10094
|
-
*/
|
10095
|
-
ClientRequestToken?: string | undefined;
|
10096
|
-
}
|
10097
|
-
/**
|
10098
|
-
* @public
|
10099
|
-
*/
|
10100
|
-
export interface RecordHandlerProgressOutput {
|
10101
|
-
}
|
10102
|
-
/**
|
10103
|
-
* @public
|
10104
|
-
*/
|
10105
|
-
export interface RegisterPublisherInput {
|
10106
|
-
/**
|
10107
|
-
* <p>Whether you accept the <a href="https://cloudformation-registry-documents.s3.amazonaws.com/Terms_and_Conditions_for_AWS_CloudFormation_Registry_Publishers.pdf">Terms and Conditions</a> for publishing extensions in the CloudFormation registry. You must
|
10108
|
-
* accept the terms and conditions in order to register to publish public extensions to the
|
10109
|
-
* CloudFormation registry.</p>
|
10110
|
-
* <p>The default is <code>false</code>.</p>
|
10111
|
-
* @public
|
10112
|
-
*/
|
10113
|
-
AcceptTermsAndConditions?: boolean | undefined;
|
10114
|
-
/**
|
10115
|
-
* <p>If you are using a Bitbucket or GitHub account for identity verification, the Amazon
|
10116
|
-
* Resource Name (ARN) for your connection to that account.</p>
|
10117
|
-
* <p>For more information, see <a href="https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/publish-extension.html#publish-extension-prereqs">Prerequisite: Registering your account to publish CloudFormation extensions</a> in the
|
10118
|
-
* <i>CloudFormation Command Line Interface (CLI) User Guide</i>.</p>
|
10119
|
-
* @public
|
10120
|
-
*/
|
10121
|
-
ConnectionArn?: string | undefined;
|
10122
|
-
}
|
10123
|
-
/**
|
10124
|
-
* @public
|
10125
|
-
*/
|
10126
|
-
export interface RegisterPublisherOutput {
|
10127
|
-
/**
|
10128
|
-
* <p>The ID assigned this account by CloudFormation for publishing extensions.</p>
|
10129
|
-
* @public
|
10130
|
-
*/
|
10131
|
-
PublisherId?: string | undefined;
|
10132
|
-
}
|