From 9dd25ecb8ee37b4231e1c1e0b0199079b5d04058 Mon Sep 17 00:00:00 2001
From: awstools Returns the inputs for the change set and a list of changes that CloudFormation will make if you execute the
* change set. For more information, see Updating Stacks Using Change
- * Sets in the CloudFormation User Guide.
Returns all stack related events for a specified stack in reverse chronological order. For more information - * about a stack's event history, go to Stacks in the CloudFormation User Guide.
+ * about a stack's event history, go to Stacks in the + * CloudFormation User Guide. *You can list events for stacks that have failed to create or have been deleted by specifying the unique stack * identifier (stack ID).
diff --git a/clients/client-cloudformation/src/commands/ListChangeSetsCommand.ts b/clients/client-cloudformation/src/commands/ListChangeSetsCommand.ts index eef3328a845b..0ae2b1d7c148 100644 --- a/clients/client-cloudformation/src/commands/ListChangeSetsCommand.ts +++ b/clients/client-cloudformation/src/commands/ListChangeSetsCommand.ts @@ -66,6 +66,7 @@ export interface ListChangeSetsCommandOutput extends ListChangeSetsOutput, __Met * // IncludeNestedStacks: true || false, * // ParentChangeSetId: "STRING_VALUE", * // RootChangeSetId: "STRING_VALUE", + * // ImportExistingResources: true || false, * // }, * // ], * // NextToken: "STRING_VALUE", diff --git a/clients/client-cloudformation/src/models/models_0.ts b/clients/client-cloudformation/src/models/models_0.ts index 47f6f3018fe4..bc702bb98e66 100644 --- a/clients/client-cloudformation/src/models/models_0.ts +++ b/clients/client-cloudformation/src/models/models_0.ts @@ -1411,6 +1411,12 @@ export interface ChangeSetSummary { *The root change set ID.
*/ RootChangeSetId?: string; + + /** + * @public + *Indicates if the stack set imports resources that already exist.
+ */ + ImportExistingResources?: boolean; } /** @@ -1825,7 +1831,7 @@ export interface CreateChangeSetInput { * default, CloudFormation grants permissions to all resource types. Identity and Access Management (IAM) * uses this parameter for condition keys in IAM policies for CloudFormation. For more information, * see Controlling access - * with Identity and Access Management in the CloudFormation User Guide. + * with Identity and Access Management in the CloudFormation User Guide. *Only one of the Capabilities
and ResourceType
parameters can be specified.
Indicates if the stack set imports resources that already exist.
+ *This parameter can only import resources that have custom names in templates. For more information, see name type in the + * CloudFormation User Guide. To import resources that do not accept custom names, such as EC2 instances, + * use the resource import feature instead. For more information, see Bringing existing resources into CloudFormation + * management in the CloudFormation User Guide.
+ *Structure containing the template body with a minimum length of 1 byte and a maximum length of 51,200 bytes. For - * more information, go to Template anatomy in the CloudFormation User Guide.
+ * more information, go to Template anatomy in the CloudFormation User Guide. *Conditional: You must specify either the TemplateBody
or the TemplateURL
parameter,
* but not both.
Location of file containing the template body. The URL must point to a template (max size: 460,800 bytes) that's * located in an Amazon S3 bucket or a Systems Manager document. For more information, go to the Template anatomy in the - * CloudFormation User Guide.
+ * CloudFormation User Guide. *Conditional: You must specify either the TemplateBody
or the TemplateURL
parameter,
* but not both.
- * STRICT_FAILURE_TOLERANCE
: Dynamically lowers the concurrency level to ensure
- * the number of failed accounts never exceeds the FailureToleranceCount
+1.
- * StackSets will set the actual concurrency of your deployment as the minimum value between the
- * MaxConcurrentCount
and the FailureToleranceCount
+1. This is the
- * default behavior.
STRICT_FAILURE_TOLERANCE
: This option dynamically lowers the concurrency
+ * level to ensure the number of failed accounts never exceeds the value of
+ * FailureToleranceCount
+1. The initial actual concurrency is set to the lower of
+ * either the value of the MaxConcurrentCount
, or the value of
+ * MaxConcurrentCount
+1. The actual concurrency is then reduced proportionally by
+ * the number of failures. This is the default behavior.
* If failure tolerance or Maximum concurrent accounts are set to percentages, the behavior * is similar.
*
- * SOFT_FAILURE_TOLERANCE
: Always run at the concurrency level set by the user
- * in the MaxConcurrentCount
or MaxConcurrentPercentage
, regardless of
- * the number of failures.
SOFT_FAILURE_TOLERANCE
: This option decouples
+ * FailureToleranceCount
from the actual concurrency. This allows stack set
+ * operations to run at the concurrency level set by the MaxConcurrentCount
value, or
+ * MaxConcurrentPercentage
, regardless of the number of failures.
* Indicates if the stack set imports resources that already exist.
+ *This parameter can only import resources that have custom names in templates. To import + * resources that do not accept custom names, such as EC2 instances, use the resource import feature instead.
+ *Structure containing the template body with a minimum length of 1 byte and a maximum length of 51,200 bytes. * (For more information, go to Template Anatomy in the - * CloudFormation User Guide.)
+ * CloudFormation User Guide.) *Conditional: You must pass TemplateBody
or TemplateURL
. If both are passed, only
* TemplateBody
is used.
Location of file containing the template body. The URL must point to a template that's located in an Amazon S3 bucket or a Systems Manager document. For more information, go to Template Anatomy in the - * CloudFormation User Guide.
+ * CloudFormation User Guide. *Conditional: You must pass TemplateURL
or TemplateBody
. If both are passed, only
* TemplateBody
is used.
Structure containing the stack policy body. (For more information, go to Prevent Updates to Stack Resources in - * the CloudFormation User Guide.)
+ * the CloudFormation User Guide.) */ StackPolicyBody?: string; } @@ -6800,7 +6830,7 @@ export interface GetTemplateOutput { /** * @public *Structure containing the template body. (For more information, go to Template Anatomy in the - * CloudFormation User Guide.)
+ * CloudFormation User Guide.) *CloudFormation returns the same template that was used when the stack was created.
*/ TemplateBody?: string; @@ -6837,7 +6867,7 @@ export interface GetTemplateSummaryInput { * @public *Structure containing the template body with a minimum length of 1 byte and a maximum length of 51,200 bytes. For * more information about templates, see Template anatomy in the - * CloudFormation User Guide.
+ * CloudFormation User Guide. *Conditional: You must specify only one of the following parameters: StackName
,
* StackSetName
, TemplateBody
, or TemplateURL
.
Location of file containing the template body. The URL must point to a template (max size: 460,800 bytes) that's * located in an Amazon S3 bucket or a Systems Manager document. For more information about templates, see - * Template anatomy - * in the CloudFormation User Guide.
+ * Template anatomy + * in the CloudFormation User Guide. *Conditional: You must specify only one of the following parameters: StackName
,
* StackSetName
, TemplateBody
, or TemplateURL
.
Context information that enables CloudFormation to uniquely identify a resource. CloudFormation uses context - * key-value pairs in cases where a resource's logical and physical IDs aren't enough to uniquely - * identify that resource. Each context key-value pair specifies a unique resource that contains the - * targeted resource.
+ *Context information that enables CloudFormation to uniquely identify a resource. CloudFormation uses + * context key-value pairs in cases where a resource's logical and physical IDs aren't enough + * to uniquely identify that resource. Each context key-value pair specifies a unique resource + * that contains the targeted resource.
*/ PhysicalResourceIdContext?: PhysicalResourceIdContextKeyValuePair[]; @@ -7436,9 +7466,9 @@ export interface StackInstanceResourceDriftsSummary { /** * @public - *Status of the actual configuration of the resource compared to its expected configuration.
- * These will be present only for resources whose StackInstanceResourceDriftStatus
is
- * MODIFIED
.
Status of the actual configuration of the resource compared to its expected
+ * configuration. These will be present only for resources whose
+ * StackInstanceResourceDriftStatus
is MODIFIED
.
Structure containing the stack policy body. For more information, go to Prevent updates to stack resources in
- * the CloudFormation User Guide. You can specify either the StackPolicyBody
or the StackPolicyURL
- * parameter, but not both.
StackPolicyBody
or the
+ * StackPolicyURL
parameter, but not both.
*/
StackPolicyBody?: string;
@@ -9844,7 +9874,7 @@ export interface UpdateStackInput {
* @public
* Structure containing the template body with a minimum length of 1 byte and a maximum length of 51,200 bytes. * (For more information, go to Template Anatomy in the - * CloudFormation User Guide.)
+ * CloudFormation User Guide.) *Conditional: You must specify only one of the following parameters: TemplateBody
,
* TemplateURL
, or set the UsePreviousTemplate
to true
.
Location of file containing the template body. The URL must point to a template that's located in an Amazon S3 bucket or a Systems Manager document. For more information, go to Template Anatomy in the - * CloudFormation User Guide.
+ * CloudFormation User Guide. *Conditional: You must specify only one of the following parameters: TemplateBody
,
* TemplateURL
, or set the UsePreviousTemplate
to true
.
Structure containing the template body with a minimum length of 1 byte and a maximum length of 51,200 bytes. For - * more information, go to Template Anatomy in the CloudFormation User Guide.
+ * more information, go to Template Anatomy in the CloudFormation User Guide. *Conditional: You must pass TemplateURL
or TemplateBody
. If both are passed, only
* TemplateBody
is used.
Location of file containing the template body. The URL must point to a template (max size: 460,800 bytes) that * is located in an Amazon S3 bucket or a Systems Manager document. For more information, go to Template Anatomy in the - * CloudFormation User Guide.
+ * CloudFormation User Guide. *Conditional: You must pass TemplateURL
or TemplateBody
. If both are passed, only
* TemplateBody
is used.
The root change set ID.
" } + }, + "ImportExistingResources": { + "target": "com.amazonaws.cloudformation#ImportExistingResources", + "traits": { + "smithy.api#documentation": "Indicates if the stack set imports resources that already exist.
" + } } }, "traits": { @@ -2301,17 +2307,6 @@ "expect": { "error": "Invalid Configuration: Missing Region" } - }, - { - "documentation": "Partition doesn't support DualStack", - "expect": { - "error": "DualStack is enabled but this partition does not support DualStack" - }, - "params": { - "Region": "us-isob-east-1", - "UseFIPS": false, - "UseDualStack": true - } } ], "version": "1.0" @@ -2482,7 +2477,7 @@ "ResourceTypes": { "target": "com.amazonaws.cloudformation#ResourceTypes", "traits": { - "smithy.api#documentation": "The template resource types that you have permissions to work with if you execute this change set, such as\n AWS::EC2::Instance
, AWS::EC2::*
, or Custom::MyCustomInstance
.
If the list of resource types doesn't include a resource type that you're updating, the stack update fails. By\n default, CloudFormation grants permissions to all resource types. Identity and Access Management (IAM)\n uses this parameter for condition keys in IAM policies for CloudFormation. For more information,\n see Controlling access\n with Identity and Access Management in the CloudFormation User Guide.
\nOnly one of the Capabilities
and ResourceType
parameters can be specified.
The template resource types that you have permissions to work with if you execute this change set, such as\n AWS::EC2::Instance
, AWS::EC2::*
, or Custom::MyCustomInstance
.
If the list of resource types doesn't include a resource type that you're updating, the stack update fails. By\n default, CloudFormation grants permissions to all resource types. Identity and Access Management (IAM)\n uses this parameter for condition keys in IAM policies for CloudFormation. For more information,\n see Controlling access\n with Identity and Access Management in the CloudFormation User Guide.
\nOnly one of the Capabilities
and ResourceType
parameters can be specified.
Determines what action will be taken if stack creation fails. If this parameter is specified, the\n DisableRollback
parameter to the ExecuteChangeSet API operation must not\n be specified. This must be one of these values:
\n DELETE
- Deletes the change set if the stack creation fails. This is only valid when the\n ChangeSetType
parameter is set to CREATE
. If the deletion of the stack fails, the status\n of the stack is DELETE_FAILED
.
\n DO_NOTHING
- if the stack creation fails, do nothing. This is equivalent to specifying\n true
for the DisableRollback
parameter to the ExecuteChangeSet API\n operation.
\n ROLLBACK
- if the stack creation fails, roll back the stack. This is equivalent to specifying\n false
for the DisableRollback
parameter to the ExecuteChangeSet API\n operation.
For nested stacks, when the OnStackFailure
parameter is set to DELETE
for the change\n set for the parent stack, any failure in a child stack will cause the parent stack creation to fail and all stacks to\n be deleted.
Indicates if the stack set imports resources that already exist.
\nThis parameter can only import resources that have custom names in templates. For more information, see name type in the\n CloudFormation User Guide. To import resources that do not accept custom names, such as EC2 instances,\n use the resource import feature instead. For more information, see Bringing existing resources into CloudFormation\n management in the CloudFormation User Guide.
\nStructure containing the template body with a minimum length of 1 byte and a maximum length of 51,200 bytes. For\n more information, go to Template anatomy in the CloudFormation User Guide.
\nConditional: You must specify either the TemplateBody
or the TemplateURL
parameter,\n but not both.
Structure containing the template body with a minimum length of 1 byte and a maximum length of 51,200 bytes. For\n more information, go to Template anatomy in the CloudFormation User Guide.
\nConditional: You must specify either the TemplateBody
or the TemplateURL
parameter,\n but not both.
Location of file containing the template body. The URL must point to a template (max size: 460,800 bytes) that's\n located in an Amazon S3 bucket or a Systems Manager document. For more information, go to the Template anatomy in the\n CloudFormation User Guide.
\nConditional: You must specify either the TemplateBody
or the TemplateURL
parameter,\n but not both.
Location of file containing the template body. The URL must point to a template (max size: 460,800 bytes) that's\n located in an Amazon S3 bucket or a Systems Manager document. For more information, go to the Template anatomy in the\n CloudFormation User Guide.
\nConditional: You must specify either the TemplateBody
or the TemplateURL
parameter,\n but not both.
Returns the inputs for the change set and a list of changes that CloudFormation will make if you execute the\n change set. For more information, see Updating Stacks Using Change\n Sets in the CloudFormation User Guide.
", + "smithy.api#documentation": "Returns the inputs for the change set and a list of changes that CloudFormation will make if you execute the\n change set. For more information, see Updating Stacks Using Change\n Sets in the CloudFormation User Guide.
", "smithy.api#suppress": ["WaitableTraitInvalidErrorType"], "smithy.waiters#waitable": { "ChangeSetCreateComplete": { @@ -3817,6 +3818,12 @@ "traits": { "smithy.api#documentation": "Determines what action will be taken if stack creation fails. When this parameter is specified, the\n DisableRollback
parameter to the ExecuteChangeSet API operation must not\n be specified. This must be one of these values:
\n DELETE
- Deletes the change set if the stack creation fails. This is only valid when the\n ChangeSetType
parameter is set to CREATE
. If the deletion of the stack fails, the status\n of the stack is DELETE_FAILED
.
\n DO_NOTHING
- if the stack creation fails, do nothing. This is equivalent to specifying\n true
for the DisableRollback
parameter to the ExecuteChangeSet API\n operation.
\n ROLLBACK
- if the stack creation fails, roll back the stack. This is equivalent to specifying\n false
for the DisableRollback
parameter to the ExecuteChangeSet API\n operation.
Indicates if the stack set imports resources that already exist.
\nThis parameter can only import resources that have custom names in templates. To import\n resources that do not accept custom names, such as EC2 instances, use the resource import feature instead.
\nReturns all stack related events for a specified stack in reverse chronological order. For more information\n about a stack's event history, go to Stacks in the CloudFormation User Guide.
\nYou can list events for stacks that have failed to create or have been deleted by specifying the unique stack\n identifier (stack ID).
\nReturns all stack related events for a specified stack in reverse chronological order. For more information\n about a stack's event history, go to Stacks in the\n CloudFormation User Guide.
\nYou can list events for stacks that have failed to create or have been deleted by specifying the unique stack\n identifier (stack ID).
\nStructure containing the template body with a minimum length of 1 byte and a maximum length of 51,200 bytes.\n (For more information, go to Template Anatomy in the\n CloudFormation User Guide.)
\nConditional: You must pass TemplateBody
or TemplateURL
. If both are passed, only\n TemplateBody
is used.
Structure containing the template body with a minimum length of 1 byte and a maximum length of 51,200 bytes.\n (For more information, go to Template Anatomy in the\n CloudFormation User Guide.)
\nConditional: You must pass TemplateBody
or TemplateURL
. If both are passed, only\n TemplateBody
is used.
Location of file containing the template body. The URL must point to a template that's located in an Amazon S3 bucket or a Systems Manager document. For more information, go to Template Anatomy in the\n CloudFormation User Guide.
\nConditional: You must pass TemplateURL
or TemplateBody
. If both are passed, only\n TemplateBody
is used.
Location of file containing the template body. The URL must point to a template that's located in an Amazon S3 bucket or a Systems Manager document. For more information, go to Template Anatomy in the\n CloudFormation User Guide.
\nConditional: You must pass TemplateURL
or TemplateBody
. If both are passed, only\n TemplateBody
is used.
Structure containing the stack policy body. (For more information, go to Prevent Updates to Stack Resources in\n the CloudFormation User Guide.)
" + "smithy.api#documentation": "Structure containing the stack policy body. (For more information, go to Prevent Updates to Stack Resources in\n the CloudFormation User Guide.)
" } } }, @@ -5792,7 +5799,7 @@ "TemplateBody": { "target": "com.amazonaws.cloudformation#TemplateBody", "traits": { - "smithy.api#documentation": "Structure containing the template body. (For more information, go to Template Anatomy in the\n CloudFormation User Guide.)
\nCloudFormation returns the same template that was used when the stack was created.
" + "smithy.api#documentation": "Structure containing the template body. (For more information, go to Template Anatomy in the\n CloudFormation User Guide.)
\nCloudFormation returns the same template that was used when the stack was created.
" } }, "StagesAvailable": { @@ -5830,13 +5837,13 @@ "TemplateBody": { "target": "com.amazonaws.cloudformation#TemplateBody", "traits": { - "smithy.api#documentation": "Structure containing the template body with a minimum length of 1 byte and a maximum length of 51,200 bytes. For\n more information about templates, see Template anatomy in the\n CloudFormation User Guide.
\nConditional: You must specify only one of the following parameters: StackName
,\n StackSetName
, TemplateBody
, or TemplateURL
.
Structure containing the template body with a minimum length of 1 byte and a maximum length of 51,200 bytes. For\n more information about templates, see Template anatomy in the\n CloudFormation User Guide.
\nConditional: You must specify only one of the following parameters: StackName
,\n StackSetName
, TemplateBody
, or TemplateURL
.
Location of file containing the template body. The URL must point to a template (max size: 460,800 bytes) that's\n located in an Amazon S3 bucket or a Systems Manager document. For more information about templates, see\n Template anatomy\n in the CloudFormation User Guide.
\nConditional: You must specify only one of the following parameters: StackName
,\n StackSetName
, TemplateBody
, or TemplateURL
.
Location of file containing the template body. The URL must point to a template (max size: 460,800 bytes) that's\n located in an Amazon S3 bucket or a Systems Manager document. For more information about templates, see\n Template anatomy\n in the CloudFormation User Guide.
\nConditional: You must specify only one of the following parameters: StackName
,\n StackSetName
, TemplateBody
, or TemplateURL
.
Structure containing the stack policy body. For more information, go to Prevent updates to stack resources in\n the CloudFormation User Guide. You can specify either the StackPolicyBody
or the StackPolicyURL
\n parameter, but not both.
Structure containing the stack policy body. For more information, go to Prevent updates to stack resources in\n the CloudFormation User Guide. You can specify either the StackPolicyBody
or the\n StackPolicyURL
parameter, but not both.
Context information that enables CloudFormation to uniquely identify a resource. CloudFormation uses context\n key-value pairs in cases where a resource's logical and physical IDs aren't enough to uniquely\n identify that resource. Each context key-value pair specifies a unique resource that contains the\n targeted resource.
" + "smithy.api#documentation": "Context information that enables CloudFormation to uniquely identify a resource. CloudFormation uses\n context key-value pairs in cases where a resource's logical and physical IDs aren't enough\n to uniquely identify that resource. Each context key-value pair specifies a unique resource\n that contains the targeted resource.
" } }, "ResourceType": { @@ -10274,7 +10284,7 @@ "PropertyDifferences": { "target": "com.amazonaws.cloudformation#PropertyDifferences", "traits": { - "smithy.api#documentation": "Status of the actual configuration of the resource compared to its expected configuration.\n These will be present only for resources whose StackInstanceResourceDriftStatus
is\n MODIFIED
.
Status of the actual configuration of the resource compared to its expected\n configuration. These will be present only for resources whose\n StackInstanceResourceDriftStatus
is MODIFIED
.
Specifies how the concurrency level behaves during the operation execution.
\n\n STRICT_FAILURE_TOLERANCE
: Dynamically lowers the concurrency level to ensure\n the number of failed accounts never exceeds the FailureToleranceCount
+1.\n StackSets will set the actual concurrency of your deployment as the minimum value between the\n MaxConcurrentCount
and the FailureToleranceCount
+1. This is the\n default behavior.
If failure tolerance or Maximum concurrent accounts are set to percentages, the behavior\n is similar.
\n\n SOFT_FAILURE_TOLERANCE
: Always run at the concurrency level set by the user\n in the MaxConcurrentCount
or MaxConcurrentPercentage
, regardless of\n the number of failures.
Specifies how the concurrency level behaves during the operation execution.
\n\n STRICT_FAILURE_TOLERANCE
: This option dynamically lowers the concurrency\n level to ensure the number of failed accounts never exceeds the value of\n FailureToleranceCount
+1. The initial actual concurrency is set to the lower of\n either the value of the MaxConcurrentCount
, or the value of\n MaxConcurrentCount
+1. The actual concurrency is then reduced proportionally by\n the number of failures. This is the default behavior.
If failure tolerance or Maximum concurrent accounts are set to percentages, the behavior\n is similar.
\n\n SOFT_FAILURE_TOLERANCE
: This option decouples\n FailureToleranceCount
from the actual concurrency. This allows stack set\n operations to run at the concurrency level set by the MaxConcurrentCount
value, or\n MaxConcurrentPercentage
, regardless of the number of failures.
Structure containing the template body with a minimum length of 1 byte and a maximum length of 51,200 bytes.\n (For more information, go to Template Anatomy in the\n CloudFormation User Guide.)
\nConditional: You must specify only one of the following parameters: TemplateBody
,\n TemplateURL
, or set the UsePreviousTemplate
to true
.
Structure containing the template body with a minimum length of 1 byte and a maximum length of 51,200 bytes.\n (For more information, go to Template Anatomy in the\n CloudFormation User Guide.)
\nConditional: You must specify only one of the following parameters: TemplateBody
,\n TemplateURL
, or set the UsePreviousTemplate
to true
.
Location of file containing the template body. The URL must point to a template that's located in an Amazon S3 bucket or a Systems Manager document. For more information, go to Template Anatomy in the\n CloudFormation User Guide.
\nConditional: You must specify only one of the following parameters: TemplateBody
,\n TemplateURL
, or set the UsePreviousTemplate
to true
.
Location of file containing the template body. The URL must point to a template that's located in an Amazon S3 bucket or a Systems Manager document. For more information, go to Template Anatomy in the\n CloudFormation User Guide.
\nConditional: You must specify only one of the following parameters: TemplateBody
,\n TemplateURL
, or set the UsePreviousTemplate
to true
.
Structure containing the template body with a minimum length of 1 byte and a maximum length of 51,200 bytes. For\n more information, go to Template Anatomy in the CloudFormation User Guide.
\nConditional: You must pass TemplateURL
or TemplateBody
. If both are passed, only\n TemplateBody
is used.
Structure containing the template body with a minimum length of 1 byte and a maximum length of 51,200 bytes. For\n more information, go to Template Anatomy in the CloudFormation User Guide.
\nConditional: You must pass TemplateURL
or TemplateBody
. If both are passed, only\n TemplateBody
is used.
Location of file containing the template body. The URL must point to a template (max size: 460,800 bytes) that\n is located in an Amazon S3 bucket or a Systems Manager document. For more information, go to Template Anatomy in the\n CloudFormation User Guide.
\nConditional: You must pass TemplateURL
or TemplateBody
. If both are passed, only\n TemplateBody
is used.
Location of file containing the template body. The URL must point to a template (max size: 460,800 bytes) that\n is located in an Amazon S3 bucket or a Systems Manager document. For more information, go to Template Anatomy in the\n CloudFormation User Guide.
\nConditional: You must pass TemplateURL
or TemplateBody
. If both are passed, only\n TemplateBody
is used.