@aws-sdk/client-cloudformation 3.41.0 → 3.46.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +47 -0
- package/README.md +11 -11
- package/dist-cjs/endpoints.js +1 -0
- package/dist-cjs/models/models_0.js +10 -4
- package/dist-cjs/protocols/Aws_query.js +48 -0
- package/dist-cjs/runtimeConfig.js +0 -2
- package/dist-es/endpoints.js +1 -0
- package/dist-es/models/models_0.js +4 -0
- package/dist-es/protocols/Aws_query.js +51 -0
- package/dist-es/runtimeConfig.js +0 -2
- package/dist-types/CloudFormation.d.ts +114 -117
- package/dist-types/CloudFormationClient.d.ts +11 -11
- package/dist-types/commands/CancelUpdateStackCommand.d.ts +2 -2
- package/dist-types/commands/ContinueUpdateRollbackCommand.d.ts +5 -6
- package/dist-types/commands/CreateChangeSetCommand.d.ts +8 -7
- package/dist-types/commands/CreateStackCommand.d.ts +2 -2
- package/dist-types/commands/CreateStackInstancesCommand.d.ts +3 -1
- package/dist-types/commands/DeleteChangeSetCommand.d.ts +2 -2
- package/dist-types/commands/DeleteStackCommand.d.ts +3 -3
- package/dist-types/commands/DescribeAccountLimitsCommand.d.ts +1 -2
- package/dist-types/commands/DescribeStackEventsCommand.d.ts +3 -2
- package/dist-types/commands/DescribeStackInstanceCommand.d.ts +1 -2
- package/dist-types/commands/DescribeStackResourceCommand.d.ts +2 -2
- package/dist-types/commands/DescribeStackResourceDriftsCommand.d.ts +3 -3
- package/dist-types/commands/DescribeStackResourcesCommand.d.ts +8 -9
- package/dist-types/commands/DescribeStacksCommand.d.ts +3 -4
- package/dist-types/commands/DetectStackDriftCommand.d.ts +6 -6
- package/dist-types/commands/DetectStackResourceDriftCommand.d.ts +2 -2
- package/dist-types/commands/EstimateTemplateCostCommand.d.ts +2 -3
- package/dist-types/commands/ExecuteChangeSetCommand.d.ts +2 -2
- package/dist-types/commands/GetStackPolicyCommand.d.ts +2 -2
- package/dist-types/commands/GetTemplateCommand.d.ts +4 -4
- package/dist-types/commands/GetTemplateSummaryCommand.d.ts +2 -2
- package/dist-types/commands/ImportStacksToStackSetCommand.d.ts +6 -8
- package/dist-types/commands/ListChangeSetsCommand.d.ts +1 -2
- package/dist-types/commands/ListStackInstancesCommand.d.ts +2 -3
- package/dist-types/commands/ListStackSetsCommand.d.ts +1 -2
- package/dist-types/commands/RollbackStackCommand.d.ts +8 -3
- package/dist-types/commands/SignalResourceCommand.d.ts +3 -4
- package/dist-types/commands/UpdateStackCommand.d.ts +4 -4
- package/dist-types/commands/UpdateStackInstancesCommand.d.ts +6 -6
- package/dist-types/commands/UpdateStackSetCommand.d.ts +2 -2
- package/dist-types/commands/UpdateTerminationProtectionCommand.d.ts +2 -2
- package/dist-types/commands/ValidateTemplateCommand.d.ts +2 -2
- package/dist-types/models/models_0.d.ts +657 -635
- package/dist-types/ts3.4/models/models_0.d.ts +22 -1
- package/package.json +37 -44
|
@@ -67,20 +67,20 @@ import { UpdateTerminationProtectionCommandInput, UpdateTerminationProtectionCom
|
|
|
67
67
|
import { ValidateTemplateCommandInput, ValidateTemplateCommandOutput } from "./commands/ValidateTemplateCommand";
|
|
68
68
|
/**
|
|
69
69
|
* <fullname>AWS CloudFormation</fullname>
|
|
70
|
-
* <p>CloudFormation allows you to create and manage Amazon Web Services infrastructure
|
|
71
|
-
* predictably and repeatedly. You can use CloudFormation to leverage
|
|
72
|
-
*
|
|
73
|
-
* Service, Elastic Load Balancing, and Auto Scaling to
|
|
74
|
-
* scalable, cost-effective applications without creating or
|
|
75
|
-
* infrastructure.</p>
|
|
70
|
+
* <p>CloudFormation allows you to create and manage Amazon Web Services infrastructure
|
|
71
|
+
* deployments predictably and repeatedly. You can use CloudFormation to leverage
|
|
72
|
+
* Amazon Web Services products, such as Amazon Elastic Compute Cloud, Amazon Elastic Block
|
|
73
|
+
* Store, Amazon Simple Notification Service, Elastic Load Balancing, and Auto Scaling to
|
|
74
|
+
* build highly-reliable, highly scalable, cost-effective applications without creating or
|
|
75
|
+
* configuring the underlying Amazon Web Services infrastructure.</p>
|
|
76
76
|
* <p>With CloudFormation, you declare all of your resources and dependencies in a
|
|
77
77
|
* template file. The template defines a collection of resources as a single unit called a
|
|
78
|
-
* stack. CloudFormation creates and deletes all member resources of the stack
|
|
79
|
-
* and manages all dependencies between the resources for you.</p>
|
|
78
|
+
* stack. CloudFormation creates and deletes all member resources of the stack
|
|
79
|
+
* together and manages all dependencies between the resources for you.</p>
|
|
80
80
|
* <p>For more information about CloudFormation, see the <a href="http://aws.amazon.com/cloudformation/">CloudFormation Product Page</a>.</p>
|
|
81
|
-
* <p>CloudFormation makes use of other Amazon Web Services products. If you need
|
|
82
|
-
* technical information about a specific Amazon Web Services product, you can find
|
|
83
|
-
* documentation at <a href="https://docs.aws.amazon.com/">
|
|
81
|
+
* <p>CloudFormation makes use of other Amazon Web Services products. If you need
|
|
82
|
+
* additional technical information about a specific Amazon Web Services product, you can find
|
|
83
|
+
* the product's technical documentation at <a href="https://docs.aws.amazon.com/">
|
|
84
84
|
* <code>docs.aws.amazon.com</code>
|
|
85
85
|
* </a>.</p>
|
|
86
86
|
*/
|
|
@@ -107,8 +107,8 @@ export declare class CloudFormation extends CloudFormationClient {
|
|
|
107
107
|
batchDescribeTypeConfigurations(args: BatchDescribeTypeConfigurationsCommandInput, cb: (err: any, data?: BatchDescribeTypeConfigurationsCommandOutput) => void): void;
|
|
108
108
|
batchDescribeTypeConfigurations(args: BatchDescribeTypeConfigurationsCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: BatchDescribeTypeConfigurationsCommandOutput) => void): void;
|
|
109
109
|
/**
|
|
110
|
-
* <p>Cancels an update on the specified stack. If the call completes successfully, the
|
|
111
|
-
*
|
|
110
|
+
* <p>Cancels an update on the specified stack. If the call completes successfully, the stack
|
|
111
|
+
* rolls back the update and reverts to the previous stack configuration.</p>
|
|
112
112
|
* <note>
|
|
113
113
|
* <p>You can cancel only stacks that are in the UPDATE_IN_PROGRESS state.</p>
|
|
114
114
|
* </note>
|
|
@@ -122,12 +122,11 @@ export declare class CloudFormation extends CloudFormationClient {
|
|
|
122
122
|
* the cause of the failure, you can manually <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/troubleshooting.html#troubleshooting-errors-update-rollback-failed"> fix the error</a> and continue the rollback. By continuing the rollback, you can
|
|
123
123
|
* return your stack to a working state (the <code>UPDATE_ROLLBACK_COMPLETE</code> state), and
|
|
124
124
|
* then try to update the stack again.</p>
|
|
125
|
-
* <p>A stack goes into the <code>UPDATE_ROLLBACK_FAILED</code> state when
|
|
126
|
-
*
|
|
127
|
-
*
|
|
128
|
-
*
|
|
129
|
-
*
|
|
130
|
-
* it, causing the update rollback to fail.</p>
|
|
125
|
+
* <p>A stack goes into the <code>UPDATE_ROLLBACK_FAILED</code> state when CloudFormation cannot roll back all changes after a failed stack update. For example,
|
|
126
|
+
* you might have a stack that is rolling back to an old database instance that was deleted
|
|
127
|
+
* outside of CloudFormation. Because CloudFormation doesn't know the database
|
|
128
|
+
* was deleted, it assumes that the database instance still exists and attempts to roll back
|
|
129
|
+
* to it, causing the update rollback to fail.</p>
|
|
131
130
|
*/
|
|
132
131
|
continueUpdateRollback(args: ContinueUpdateRollbackCommandInput, options?: __HttpHandlerOptions): Promise<ContinueUpdateRollbackCommandOutput>;
|
|
133
132
|
continueUpdateRollback(args: ContinueUpdateRollbackCommandInput, cb: (err: any, data?: ContinueUpdateRollbackCommandOutput) => void): void;
|
|
@@ -136,11 +135,12 @@ export declare class CloudFormation extends CloudFormationClient {
|
|
|
136
135
|
* <p>Creates a list of changes that will be applied to a stack so that you can review the
|
|
137
136
|
* changes before executing them. You can create a change set for a stack that doesn't exist
|
|
138
137
|
* or an existing stack. If you create a change set for a stack that doesn't exist, the change
|
|
139
|
-
* set shows all of the resources that CloudFormation will create. If you create a
|
|
140
|
-
* set for an existing stack, CloudFormation compares the stack's information
|
|
141
|
-
* information that you submit in the change set and lists the differences. Use
|
|
142
|
-
* understand which resources CloudFormation will create or change, and
|
|
143
|
-
* resources in an existing stack, before you create or update a
|
|
138
|
+
* set shows all of the resources that CloudFormation will create. If you create a
|
|
139
|
+
* change set for an existing stack, CloudFormation compares the stack's information
|
|
140
|
+
* with the information that you submit in the change set and lists the differences. Use
|
|
141
|
+
* change sets to understand which resources CloudFormation will create or change, and
|
|
142
|
+
* how it will change resources in an existing stack, before you create or update a
|
|
143
|
+
* stack.</p>
|
|
144
144
|
* <p>To create a change set for a stack that doesn't exist, for the
|
|
145
145
|
* <code>ChangeSetType</code> parameter, specify <code>CREATE</code>. To create a change
|
|
146
146
|
* set for an existing stack, specify <code>UPDATE</code> for the <code>ChangeSetType</code>
|
|
@@ -149,8 +149,8 @@ export declare class CloudFormation extends CloudFormationClient {
|
|
|
149
149
|
* successfully completes, CloudFormation starts creating the change set. To check the
|
|
150
150
|
* status of the change set or to review it, use the <a>DescribeChangeSet</a>
|
|
151
151
|
* action.</p>
|
|
152
|
-
* <p>When you are satisfied with the changes the change set will make, execute the change
|
|
153
|
-
*
|
|
152
|
+
* <p>When you are satisfied with the changes the change set will make, execute the change set
|
|
153
|
+
* by using the <a>ExecuteChangeSet</a> action. CloudFormation doesn't make
|
|
154
154
|
* changes until you execute the change set.</p>
|
|
155
155
|
* <p>To create a change set for the entire stack hierachy, set
|
|
156
156
|
* <code>IncludeNestedStacks</code> to <code>True</code>.</p>
|
|
@@ -159,15 +159,17 @@ export declare class CloudFormation extends CloudFormationClient {
|
|
|
159
159
|
createChangeSet(args: CreateChangeSetCommandInput, cb: (err: any, data?: CreateChangeSetCommandOutput) => void): void;
|
|
160
160
|
createChangeSet(args: CreateChangeSetCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: CreateChangeSetCommandOutput) => void): void;
|
|
161
161
|
/**
|
|
162
|
-
* <p>Creates a stack as specified in the template. After the call completes successfully,
|
|
163
|
-
*
|
|
162
|
+
* <p>Creates a stack as specified in the template. After the call completes successfully, the
|
|
163
|
+
* stack creation starts. You can check the status of the stack via the <a>DescribeStacks</a> API.</p>
|
|
164
164
|
*/
|
|
165
165
|
createStack(args: CreateStackCommandInput, options?: __HttpHandlerOptions): Promise<CreateStackCommandOutput>;
|
|
166
166
|
createStack(args: CreateStackCommandInput, cb: (err: any, data?: CreateStackCommandOutput) => void): void;
|
|
167
167
|
createStack(args: CreateStackCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: CreateStackCommandOutput) => void): void;
|
|
168
168
|
/**
|
|
169
169
|
* <p>Creates stack instances for the specified accounts, within the specified Regions. A
|
|
170
|
-
* stack instance refers to a stack in a specific account and Region. You must specify at
|
|
170
|
+
* stack instance refers to a stack in a specific account and Region. You must specify at
|
|
171
|
+
* least one value for either <code>Accounts</code> or <code>DeploymentTargets</code>, and you
|
|
172
|
+
* must specify at least one value for <code>Regions</code>.</p>
|
|
171
173
|
*/
|
|
172
174
|
createStackInstances(args: CreateStackInstancesCommandInput, options?: __HttpHandlerOptions): Promise<CreateStackInstancesCommandOutput>;
|
|
173
175
|
createStackInstances(args: CreateStackInstancesCommandInput, cb: (err: any, data?: CreateStackInstancesCommandOutput) => void): void;
|
|
@@ -190,8 +192,8 @@ export declare class CloudFormation extends CloudFormationClient {
|
|
|
190
192
|
deactivateType(args: DeactivateTypeCommandInput, cb: (err: any, data?: DeactivateTypeCommandOutput) => void): void;
|
|
191
193
|
deactivateType(args: DeactivateTypeCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: DeactivateTypeCommandOutput) => void): void;
|
|
192
194
|
/**
|
|
193
|
-
* <p>Deletes the specified change set. Deleting change sets ensures that no one executes
|
|
194
|
-
*
|
|
195
|
+
* <p>Deletes the specified change set. Deleting change sets ensures that no one executes the
|
|
196
|
+
* wrong change set.</p>
|
|
195
197
|
* <p>If the call successfully completes, CloudFormation successfully deleted the
|
|
196
198
|
* change set.</p>
|
|
197
199
|
* <p>If <code>IncludeNestedStacks</code> specifies <code>True</code> during the creation of
|
|
@@ -203,9 +205,9 @@ export declare class CloudFormation extends CloudFormationClient {
|
|
|
203
205
|
deleteChangeSet(args: DeleteChangeSetCommandInput, cb: (err: any, data?: DeleteChangeSetCommandOutput) => void): void;
|
|
204
206
|
deleteChangeSet(args: DeleteChangeSetCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: DeleteChangeSetCommandOutput) => void): void;
|
|
205
207
|
/**
|
|
206
|
-
* <p>Deletes a specified stack. Once the call completes successfully, stack deletion
|
|
207
|
-
*
|
|
208
|
-
*
|
|
208
|
+
* <p>Deletes a specified stack. Once the call completes successfully, stack deletion starts.
|
|
209
|
+
* Deleted stacks do not show up in the <a>DescribeStacks</a> API if the deletion
|
|
210
|
+
* has been completed successfully.</p>
|
|
209
211
|
*/
|
|
210
212
|
deleteStack(args: DeleteStackCommandInput, options?: __HttpHandlerOptions): Promise<DeleteStackCommandOutput>;
|
|
211
213
|
deleteStack(args: DeleteStackCommandInput, cb: (err: any, data?: DeleteStackCommandOutput) => void): void;
|
|
@@ -241,8 +243,7 @@ export declare class CloudFormation extends CloudFormationClient {
|
|
|
241
243
|
/**
|
|
242
244
|
* <p>Retrieves your account's CloudFormation limits, such as the maximum number of
|
|
243
245
|
* stacks that you can create in your account. For more information about account limits, see
|
|
244
|
-
* <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cloudformation-limits.html">CloudFormation
|
|
245
|
-
* Limits</a> in the <i>CloudFormation User Guide</i>.</p>
|
|
246
|
+
* <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cloudformation-limits.html">CloudFormation Limits</a> in the <i>CloudFormation User Guide</i>.</p>
|
|
246
247
|
*/
|
|
247
248
|
describeAccountLimits(args: DescribeAccountLimitsCommandInput, options?: __HttpHandlerOptions): Promise<DescribeAccountLimitsCommandOutput>;
|
|
248
249
|
describeAccountLimits(args: DescribeAccountLimitsCommandInput, cb: (err: any, data?: DescribeAccountLimitsCommandOutput) => void): void;
|
|
@@ -298,8 +299,9 @@ export declare class CloudFormation extends CloudFormationClient {
|
|
|
298
299
|
describeStackDriftDetectionStatus(args: DescribeStackDriftDetectionStatusCommandInput, cb: (err: any, data?: DescribeStackDriftDetectionStatusCommandOutput) => void): void;
|
|
299
300
|
describeStackDriftDetectionStatus(args: DescribeStackDriftDetectionStatusCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: DescribeStackDriftDetectionStatusCommandOutput) => void): void;
|
|
300
301
|
/**
|
|
301
|
-
* <p>Returns all stack related events for a specified stack in reverse chronological
|
|
302
|
-
*
|
|
302
|
+
* <p>Returns all stack related events for a specified stack in reverse chronological order.
|
|
303
|
+
* For more information about a stack's event history, go to <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/concept-stack.html">Stacks</a> in the
|
|
304
|
+
* CloudFormation User Guide.</p>
|
|
303
305
|
* <note>
|
|
304
306
|
* <p>You can list events for stacks that have failed to create or have been deleted by
|
|
305
307
|
* specifying the unique stack identifier (stack ID).</p>
|
|
@@ -310,16 +312,15 @@ export declare class CloudFormation extends CloudFormationClient {
|
|
|
310
312
|
describeStackEvents(args: DescribeStackEventsCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: DescribeStackEventsCommandOutput) => void): void;
|
|
311
313
|
/**
|
|
312
314
|
* <p>Returns the stack instance that's associated with the specified stack set, Amazon Web Services account, and Region.</p>
|
|
313
|
-
* <p>For a list of stack instances that are associated with a specific stack set, use
|
|
314
|
-
* <a>ListStackInstances</a>.</p>
|
|
315
|
+
* <p>For a list of stack instances that are associated with a specific stack set, use <a>ListStackInstances</a>.</p>
|
|
315
316
|
*/
|
|
316
317
|
describeStackInstance(args: DescribeStackInstanceCommandInput, options?: __HttpHandlerOptions): Promise<DescribeStackInstanceCommandOutput>;
|
|
317
318
|
describeStackInstance(args: DescribeStackInstanceCommandInput, cb: (err: any, data?: DescribeStackInstanceCommandOutput) => void): void;
|
|
318
319
|
describeStackInstance(args: DescribeStackInstanceCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: DescribeStackInstanceCommandOutput) => void): void;
|
|
319
320
|
/**
|
|
320
321
|
* <p>Returns a description of the specified resource in the specified stack.</p>
|
|
321
|
-
* <p>For deleted stacks, DescribeStackResource returns resource information for up to 90
|
|
322
|
-
*
|
|
322
|
+
* <p>For deleted stacks, DescribeStackResource returns resource information for up to 90 days
|
|
323
|
+
* after the stack has been deleted.</p>
|
|
323
324
|
*/
|
|
324
325
|
describeStackResource(args: DescribeStackResourceCommandInput, options?: __HttpHandlerOptions): Promise<DescribeStackResourceCommandOutput>;
|
|
325
326
|
describeStackResource(args: DescribeStackResourceCommandInput, cb: (err: any, data?: DescribeStackResourceCommandOutput) => void): void;
|
|
@@ -332,9 +333,9 @@ export declare class CloudFormation extends CloudFormationClient {
|
|
|
332
333
|
* resource that has been checked for drift. Resources that haven't yet been checked for drift
|
|
333
334
|
* are not included. Resources that do not currently support drift detection are not checked,
|
|
334
335
|
* and so not included. For a list of resources that support drift detection, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-stack-drift-resource-list.html">Resources that Support Drift Detection</a>.</p>
|
|
335
|
-
* <p>Use <a>DetectStackResourceDrift</a> to detect drift on individual
|
|
336
|
-
*
|
|
337
|
-
*
|
|
336
|
+
* <p>Use <a>DetectStackResourceDrift</a> to detect drift on individual resources,
|
|
337
|
+
* or <a>DetectStackDrift</a> to detect drift on all supported resources for a
|
|
338
|
+
* given stack.</p>
|
|
338
339
|
*/
|
|
339
340
|
describeStackResourceDrifts(args: DescribeStackResourceDriftsCommandInput, options?: __HttpHandlerOptions): Promise<DescribeStackResourceDriftsCommandOutput>;
|
|
340
341
|
describeStackResourceDrifts(args: DescribeStackResourceDriftsCommandInput, cb: (err: any, data?: DescribeStackResourceDriftsCommandOutput) => void): void;
|
|
@@ -345,31 +346,29 @@ export declare class CloudFormation extends CloudFormationClient {
|
|
|
345
346
|
* stack are returned. If <code>PhysicalResourceId</code> is specified, the associated
|
|
346
347
|
* resources of the stack that the resource belongs to are returned.</p>
|
|
347
348
|
* <note>
|
|
348
|
-
* <p>Only the first 100 resources will be returned. If your stack has more resources
|
|
349
|
-
*
|
|
349
|
+
* <p>Only the first 100 resources will be returned. If your stack has more resources than
|
|
350
|
+
* this, you should use <code>ListStackResources</code> instead.</p>
|
|
350
351
|
* </note>
|
|
351
|
-
* <p>For deleted stacks, <code>DescribeStackResources</code> returns resource information
|
|
352
|
-
*
|
|
353
|
-
* <p>You must specify either <code>StackName</code> or <code>PhysicalResourceId</code>,
|
|
354
|
-
*
|
|
352
|
+
* <p>For deleted stacks, <code>DescribeStackResources</code> returns resource information for
|
|
353
|
+
* up to 90 days after the stack has been deleted.</p>
|
|
354
|
+
* <p>You must specify either <code>StackName</code> or <code>PhysicalResourceId</code>, but
|
|
355
|
+
* not both. In addition, you can specify <code>LogicalResourceId</code> to filter the
|
|
355
356
|
* returned result. For more information about resources, the <code>LogicalResourceId</code>
|
|
356
357
|
* and <code>PhysicalResourceId</code>, go to the <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/">CloudFormation User
|
|
357
358
|
* Guide</a>.</p>
|
|
358
359
|
* <note>
|
|
359
|
-
* <p>A <code>ValidationError</code> is returned if you specify both
|
|
360
|
-
*
|
|
361
|
-
* request.</p>
|
|
360
|
+
* <p>A <code>ValidationError</code> is returned if you specify both <code>StackName</code>
|
|
361
|
+
* and <code>PhysicalResourceId</code> in the same request.</p>
|
|
362
362
|
* </note>
|
|
363
363
|
*/
|
|
364
364
|
describeStackResources(args: DescribeStackResourcesCommandInput, options?: __HttpHandlerOptions): Promise<DescribeStackResourcesCommandOutput>;
|
|
365
365
|
describeStackResources(args: DescribeStackResourcesCommandInput, cb: (err: any, data?: DescribeStackResourcesCommandOutput) => void): void;
|
|
366
366
|
describeStackResources(args: DescribeStackResourcesCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: DescribeStackResourcesCommandOutput) => void): void;
|
|
367
367
|
/**
|
|
368
|
-
* <p>Returns the description for the specified stack; if no stack name was specified, then
|
|
369
|
-
*
|
|
368
|
+
* <p>Returns the description for the specified stack; if no stack name was specified, then it
|
|
369
|
+
* returns the description for all the stacks created.</p>
|
|
370
370
|
* <note>
|
|
371
|
-
* <p>If the stack does not exist, an <code>ValidationError</code> is
|
|
372
|
-
* returned.</p>
|
|
371
|
+
* <p>If the stack does not exist, an <code>ValidationError</code> is returned.</p>
|
|
373
372
|
* </note>
|
|
374
373
|
*/
|
|
375
374
|
describeStacks(args: DescribeStacksCommandInput, options?: __HttpHandlerOptions): Promise<DescribeStacksCommandOutput>;
|
|
@@ -422,15 +421,15 @@ export declare class CloudFormation extends CloudFormationClient {
|
|
|
422
421
|
* of its resources differ from their expected template configurations. For more information,
|
|
423
422
|
* see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-stack-drift.html">Detecting
|
|
424
423
|
* Unregulated Configuration Changes to Stacks and Resources</a>.</p>
|
|
425
|
-
* <p>Use <code>DetectStackDrift</code> to detect drift on all supported resources for a
|
|
426
|
-
*
|
|
424
|
+
* <p>Use <code>DetectStackDrift</code> to detect drift on all supported resources for a given
|
|
425
|
+
* stack, or <a>DetectStackResourceDrift</a> to detect drift on individual
|
|
427
426
|
* resources.</p>
|
|
428
427
|
* <p>For a list of stack resources that currently support drift detection, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-stack-drift-resource-list.html">Resources that Support Drift Detection</a>.</p>
|
|
429
428
|
* <p>
|
|
430
|
-
* <code>DetectStackDrift</code> can take up to several minutes, depending on the number
|
|
431
|
-
*
|
|
432
|
-
*
|
|
433
|
-
* its resources.</p>
|
|
429
|
+
* <code>DetectStackDrift</code> can take up to several minutes, depending on the number of
|
|
430
|
+
* resources contained within the stack. Use <a>DescribeStackDriftDetectionStatus</a> to monitor the progress of a detect stack drift operation. Once the drift detection
|
|
431
|
+
* operation has completed, use <a>DescribeStackResourceDrifts</a> to return drift
|
|
432
|
+
* information about the stack and its resources.</p>
|
|
434
433
|
* <p>When detecting drift on a stack, CloudFormation does not detect drift on any nested stacks
|
|
435
434
|
* belonging to that stack. Perform <code>DetectStackDrift</code> directly on the nested stack
|
|
436
435
|
* itself.</p>
|
|
@@ -449,8 +448,8 @@ export declare class CloudFormation extends CloudFormationClient {
|
|
|
449
448
|
* <p>Use <code>DetectStackResourceDrift</code> to detect drift on individual resources, or
|
|
450
449
|
* <a>DetectStackDrift</a> to detect drift on all resources in a given stack
|
|
451
450
|
* that support drift detection.</p>
|
|
452
|
-
* <p>Resources that do not currently support drift detection cannot be checked. For a list
|
|
453
|
-
*
|
|
451
|
+
* <p>Resources that do not currently support drift detection cannot be checked. For a list of
|
|
452
|
+
* resources that support drift detection, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-stack-drift-resource-list.html">Resources that Support Drift Detection</a>.</p>
|
|
454
453
|
*/
|
|
455
454
|
detectStackResourceDrift(args: DetectStackResourceDriftCommandInput, options?: __HttpHandlerOptions): Promise<DetectStackResourceDriftCommandOutput>;
|
|
456
455
|
detectStackResourceDrift(args: DetectStackResourceDriftCommandInput, cb: (err: any, data?: DetectStackResourceDriftCommandOutput) => void): void;
|
|
@@ -505,16 +504,15 @@ export declare class CloudFormation extends CloudFormationClient {
|
|
|
505
504
|
detectStackSetDrift(args: DetectStackSetDriftCommandInput, cb: (err: any, data?: DetectStackSetDriftCommandOutput) => void): void;
|
|
506
505
|
detectStackSetDrift(args: DetectStackSetDriftCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: DetectStackSetDriftCommandOutput) => void): void;
|
|
507
506
|
/**
|
|
508
|
-
* <p>Returns the estimated monthly cost of a template. The return value is an Amazon Web Services Simple
|
|
509
|
-
*
|
|
510
|
-
* template.</p>
|
|
507
|
+
* <p>Returns the estimated monthly cost of a template. The return value is an Amazon Web Services Simple Monthly Calculator URL with a query string that describes the
|
|
508
|
+
* resources required to run the template.</p>
|
|
511
509
|
*/
|
|
512
510
|
estimateTemplateCost(args: EstimateTemplateCostCommandInput, options?: __HttpHandlerOptions): Promise<EstimateTemplateCostCommandOutput>;
|
|
513
511
|
estimateTemplateCost(args: EstimateTemplateCostCommandInput, cb: (err: any, data?: EstimateTemplateCostCommandOutput) => void): void;
|
|
514
512
|
estimateTemplateCost(args: EstimateTemplateCostCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: EstimateTemplateCostCommandOutput) => void): void;
|
|
515
513
|
/**
|
|
516
|
-
* <p>Updates a stack using the input information that was provided when the specified
|
|
517
|
-
*
|
|
514
|
+
* <p>Updates a stack using the input information that was provided when the specified change
|
|
515
|
+
* set was created. After the call successfully completes, CloudFormation starts
|
|
518
516
|
* updating the stack. Use the <a>DescribeStacks</a> action to view the status of
|
|
519
517
|
* the update.</p>
|
|
520
518
|
* <p>When you execute a change set, CloudFormation deletes all other change sets
|
|
@@ -529,17 +527,17 @@ export declare class CloudFormation extends CloudFormationClient {
|
|
|
529
527
|
executeChangeSet(args: ExecuteChangeSetCommandInput, cb: (err: any, data?: ExecuteChangeSetCommandOutput) => void): void;
|
|
530
528
|
executeChangeSet(args: ExecuteChangeSetCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: ExecuteChangeSetCommandOutput) => void): void;
|
|
531
529
|
/**
|
|
532
|
-
* <p>Returns the stack policy for a specified stack. If a stack doesn't have a policy, a
|
|
533
|
-
*
|
|
530
|
+
* <p>Returns the stack policy for a specified stack. If a stack doesn't have a policy, a null
|
|
531
|
+
* value is returned.</p>
|
|
534
532
|
*/
|
|
535
533
|
getStackPolicy(args: GetStackPolicyCommandInput, options?: __HttpHandlerOptions): Promise<GetStackPolicyCommandOutput>;
|
|
536
534
|
getStackPolicy(args: GetStackPolicyCommandInput, cb: (err: any, data?: GetStackPolicyCommandOutput) => void): void;
|
|
537
535
|
getStackPolicy(args: GetStackPolicyCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: GetStackPolicyCommandOutput) => void): void;
|
|
538
536
|
/**
|
|
539
|
-
* <p>Returns the template body for a specified stack. You can get the template for running
|
|
540
|
-
*
|
|
541
|
-
* <p>For deleted stacks, GetTemplate returns the template for up to 90 days after the
|
|
542
|
-
*
|
|
537
|
+
* <p>Returns the template body for a specified stack. You can get the template for running or
|
|
538
|
+
* deleted stacks.</p>
|
|
539
|
+
* <p>For deleted stacks, GetTemplate returns the template for up to 90 days after the stack
|
|
540
|
+
* has been deleted.</p>
|
|
543
541
|
* <note>
|
|
544
542
|
* <p>If the template does not exist, a <code>ValidationError</code> is returned.</p>
|
|
545
543
|
* </note>
|
|
@@ -554,29 +552,26 @@ export declare class CloudFormation extends CloudFormationClient {
|
|
|
554
552
|
* stack set.</p>
|
|
555
553
|
* <p>You can use the <code>GetTemplateSummary</code> action when you submit a template, or
|
|
556
554
|
* you can get template information for a stack set, or a running or deleted stack.</p>
|
|
557
|
-
* <p>For deleted stacks, <code>GetTemplateSummary</code> returns the template information
|
|
558
|
-
*
|
|
555
|
+
* <p>For deleted stacks, <code>GetTemplateSummary</code> returns the template information for
|
|
556
|
+
* up to 90 days after the stack has been deleted. If the template does not exist, a
|
|
559
557
|
* <code>ValidationError</code> is returned.</p>
|
|
560
558
|
*/
|
|
561
559
|
getTemplateSummary(args: GetTemplateSummaryCommandInput, options?: __HttpHandlerOptions): Promise<GetTemplateSummaryCommandOutput>;
|
|
562
560
|
getTemplateSummary(args: GetTemplateSummaryCommandInput, cb: (err: any, data?: GetTemplateSummaryCommandOutput) => void): void;
|
|
563
561
|
getTemplateSummary(args: GetTemplateSummaryCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: GetTemplateSummaryCommandOutput) => void): void;
|
|
564
562
|
/**
|
|
565
|
-
* <p>
|
|
566
|
-
*
|
|
567
|
-
* different
|
|
568
|
-
*
|
|
569
|
-
*
|
|
570
|
-
*
|
|
571
|
-
* <code>ImportStacksToStackSet</code> is only supported by self-managed permissions.</p>
|
|
572
|
-
* </note>
|
|
563
|
+
* <p>Use the stack import operations for self-managed or service-managed StackSets. For
|
|
564
|
+
* self-managed StackSets, the import operation can import stacks in the administrator account
|
|
565
|
+
* or in different target accounts and Amazon Web Services Regions. For service-managed
|
|
566
|
+
* StackSets, the import operation can import any stack in the same AWS Organizations as the
|
|
567
|
+
* management account. The import operation can import up to 10 stacks using inline stack IDs
|
|
568
|
+
* or up to 10,000 stacks using an Amazon S3 object.</p>
|
|
573
569
|
*/
|
|
574
570
|
importStacksToStackSet(args: ImportStacksToStackSetCommandInput, options?: __HttpHandlerOptions): Promise<ImportStacksToStackSetCommandOutput>;
|
|
575
571
|
importStacksToStackSet(args: ImportStacksToStackSetCommandInput, cb: (err: any, data?: ImportStacksToStackSetCommandOutput) => void): void;
|
|
576
572
|
importStacksToStackSet(args: ImportStacksToStackSetCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: ImportStacksToStackSetCommandOutput) => void): void;
|
|
577
573
|
/**
|
|
578
|
-
* <p>Returns the ID and status of each active change set for a stack. For example,
|
|
579
|
-
* CloudFormation lists change sets that are in the <code>CREATE_IN_PROGRESS</code> or
|
|
574
|
+
* <p>Returns the ID and status of each active change set for a stack. For example, CloudFormation lists change sets that are in the <code>CREATE_IN_PROGRESS</code> or
|
|
580
575
|
* <code>CREATE_PENDING</code> state.</p>
|
|
581
576
|
*/
|
|
582
577
|
listChangeSets(args: ListChangeSetsCommandInput, options?: __HttpHandlerOptions): Promise<ListChangeSetsCommandOutput>;
|
|
@@ -606,9 +601,8 @@ export declare class CloudFormation extends CloudFormationClient {
|
|
|
606
601
|
listImports(args: ListImportsCommandInput, cb: (err: any, data?: ListImportsCommandOutput) => void): void;
|
|
607
602
|
listImports(args: ListImportsCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: ListImportsCommandOutput) => void): void;
|
|
608
603
|
/**
|
|
609
|
-
* <p>Returns summary information about stack instances that are associated with the
|
|
610
|
-
*
|
|
611
|
-
* Amazon Web Services account name or Region, or that have a specific status.</p>
|
|
604
|
+
* <p>Returns summary information about stack instances that are associated with the specified
|
|
605
|
+
* stack set. You can filter for stack instances that are associated with a specific Amazon Web Services account name or Region, or that have a specific status.</p>
|
|
612
606
|
*/
|
|
613
607
|
listStackInstances(args: ListStackInstancesCommandInput, options?: __HttpHandlerOptions): Promise<ListStackInstancesCommandOutput>;
|
|
614
608
|
listStackInstances(args: ListStackInstancesCommandInput, cb: (err: any, data?: ListStackInstancesCommandOutput) => void): void;
|
|
@@ -644,8 +638,7 @@ export declare class CloudFormation extends CloudFormationClient {
|
|
|
644
638
|
listStackSetOperations(args: ListStackSetOperationsCommandInput, cb: (err: any, data?: ListStackSetOperationsCommandOutput) => void): void;
|
|
645
639
|
listStackSetOperations(args: ListStackSetOperationsCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: ListStackSetOperationsCommandOutput) => void): void;
|
|
646
640
|
/**
|
|
647
|
-
* <p>Returns summary information about stack sets that are associated with the
|
|
648
|
-
* user.</p>
|
|
641
|
+
* <p>Returns summary information about stack sets that are associated with the user.</p>
|
|
649
642
|
* <ul>
|
|
650
643
|
* <li>
|
|
651
644
|
* <p>[Self-managed permissions] If you set the <code>CallAs</code> parameter to
|
|
@@ -751,9 +744,14 @@ export declare class CloudFormation extends CloudFormationClient {
|
|
|
751
744
|
registerType(args: RegisterTypeCommandInput, cb: (err: any, data?: RegisterTypeCommandOutput) => void): void;
|
|
752
745
|
registerType(args: RegisterTypeCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: RegisterTypeCommandOutput) => void): void;
|
|
753
746
|
/**
|
|
754
|
-
* <p>When specifying <code>RollbackStack</code>, you preserve the state of previously
|
|
755
|
-
*
|
|
756
|
-
*
|
|
747
|
+
* <p>When specifying <code>RollbackStack</code>, you preserve the state of previously
|
|
748
|
+
* provisioned resources when an operation fails. You can check the status of the stack
|
|
749
|
+
* through the <a>DescribeStacks</a> API.</p>
|
|
750
|
+
* <p>Rolls back the specified stack to the last known stable state from
|
|
751
|
+
* <code>CREATE_FAILED</code> or <code>UPDATE_FAILED</code> stack statuses.</p>
|
|
752
|
+
* <p>This operation will delete a stack if it doesn't contain a last known stable state. A
|
|
753
|
+
* last known stable state includes any status in a <code>*_COMPLETE</code>. This includes the
|
|
754
|
+
* following stack statuses.</p>
|
|
757
755
|
* <ul>
|
|
758
756
|
* <li>
|
|
759
757
|
* <p>
|
|
@@ -817,10 +815,9 @@ export declare class CloudFormation extends CloudFormationClient {
|
|
|
817
815
|
setTypeDefaultVersion(args: SetTypeDefaultVersionCommandInput, cb: (err: any, data?: SetTypeDefaultVersionCommandOutput) => void): void;
|
|
818
816
|
setTypeDefaultVersion(args: SetTypeDefaultVersionCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: SetTypeDefaultVersionCommandOutput) => void): void;
|
|
819
817
|
/**
|
|
820
|
-
* <p>Sends a signal to the specified resource with a success or failure status. You can
|
|
821
|
-
*
|
|
822
|
-
*
|
|
823
|
-
* required number of signals or the timeout period is exceeded. The SignalResource API is
|
|
818
|
+
* <p>Sends a signal to the specified resource with a success or failure status. You can use
|
|
819
|
+
* the SignalResource API in conjunction with a creation policy or update policy. CloudFormation doesn't proceed with a stack creation or update until resources receive
|
|
820
|
+
* the required number of signals or the timeout period is exceeded. The SignalResource API is
|
|
824
821
|
* useful in cases where you want to send signals from anywhere other than an Amazon EC2
|
|
825
822
|
* instance.</p>
|
|
826
823
|
*/
|
|
@@ -863,25 +860,25 @@ export declare class CloudFormation extends CloudFormationClient {
|
|
|
863
860
|
testType(args: TestTypeCommandInput, cb: (err: any, data?: TestTypeCommandOutput) => void): void;
|
|
864
861
|
testType(args: TestTypeCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: TestTypeCommandOutput) => void): void;
|
|
865
862
|
/**
|
|
866
|
-
* <p>Updates a stack as specified in the template. After the call completes successfully,
|
|
867
|
-
*
|
|
863
|
+
* <p>Updates a stack as specified in the template. After the call completes successfully, the
|
|
864
|
+
* stack update starts. You can check the status of the stack via the <a>DescribeStacks</a> action.</p>
|
|
868
865
|
* <p>To get a copy of the template for an existing stack, you can use the <a>GetTemplate</a> action.</p>
|
|
869
|
-
* <p>For more information about creating an update template, updating a stack, and
|
|
870
|
-
*
|
|
866
|
+
* <p>For more information about creating an update template, updating a stack, and monitoring
|
|
867
|
+
* the progress of the update, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks.html">Updating a
|
|
871
868
|
* Stack</a>.</p>
|
|
872
869
|
*/
|
|
873
870
|
updateStack(args: UpdateStackCommandInput, options?: __HttpHandlerOptions): Promise<UpdateStackCommandOutput>;
|
|
874
871
|
updateStack(args: UpdateStackCommandInput, cb: (err: any, data?: UpdateStackCommandOutput) => void): void;
|
|
875
872
|
updateStack(args: UpdateStackCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: UpdateStackCommandOutput) => void): void;
|
|
876
873
|
/**
|
|
877
|
-
* <p>Updates the parameter values for stack instances for the specified accounts, within
|
|
878
|
-
*
|
|
879
|
-
* <p>You can only update stack instances in Regions and accounts where they already exist;
|
|
880
|
-
*
|
|
874
|
+
* <p>Updates the parameter values for stack instances for the specified accounts, within the
|
|
875
|
+
* specified Regions. A stack instance refers to a stack in a specific account and Region. </p>
|
|
876
|
+
* <p>You can only update stack instances in Regions and accounts where they already exist; to
|
|
877
|
+
* create additional stack instances, use <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_CreateStackInstances.html">CreateStackInstances</a>. </p>
|
|
881
878
|
* <p>During stack set updates, any parameters overridden for a stack instance are not
|
|
882
879
|
* updated, but retain their overridden value.</p>
|
|
883
|
-
* <p>You can only update the parameter <i>values</i> that are specified in
|
|
884
|
-
*
|
|
880
|
+
* <p>You can only update the parameter <i>values</i> that are specified in the
|
|
881
|
+
* stack set; to add or delete a parameter itself, use <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_UpdateStackSet.html">UpdateStackSet</a> to update the stack set template. If you add a parameter to a
|
|
885
882
|
* template, before you can override the parameter value specified in the stack set you must
|
|
886
883
|
* first use <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_UpdateStackSet.html">UpdateStackSet</a> to update all stack instances with the updated template and
|
|
887
884
|
* parameter value specified in the stack set. Once a stack instance has been updated with the
|
|
@@ -894,8 +891,8 @@ export declare class CloudFormation extends CloudFormationClient {
|
|
|
894
891
|
/**
|
|
895
892
|
* <p>Updates the stack set, and associated stack instances in the specified accounts and
|
|
896
893
|
* Regions.</p>
|
|
897
|
-
* <p>Even if the stack set operation created by updating the stack set fails (completely
|
|
898
|
-
*
|
|
894
|
+
* <p>Even if the stack set operation created by updating the stack set fails (completely or
|
|
895
|
+
* partially, below or above a specified failure tolerance), the stack set is updated with
|
|
899
896
|
* your changes. Subsequent <a>CreateStackInstances</a> calls on the specified
|
|
900
897
|
* stack set use the updated stack set.</p>
|
|
901
898
|
*/
|
|
@@ -903,8 +900,8 @@ export declare class CloudFormation extends CloudFormationClient {
|
|
|
903
900
|
updateStackSet(args: UpdateStackSetCommandInput, cb: (err: any, data?: UpdateStackSetCommandOutput) => void): void;
|
|
904
901
|
updateStackSet(args: UpdateStackSetCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: UpdateStackSetCommandOutput) => void): void;
|
|
905
902
|
/**
|
|
906
|
-
* <p>Updates termination protection for the specified stack. If a user attempts to delete
|
|
907
|
-
*
|
|
903
|
+
* <p>Updates termination protection for the specified stack. If a user attempts to delete a
|
|
904
|
+
* stack with termination protection enabled, the operation fails and the stack remains
|
|
908
905
|
* unchanged. For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-protect-stacks.html">Protecting a
|
|
909
906
|
* Stack From Being Deleted</a> in the <i>CloudFormation User Guide</i>.</p>
|
|
910
907
|
* <p>For <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-nested-stacks.html">nested
|
|
@@ -916,8 +913,8 @@ export declare class CloudFormation extends CloudFormationClient {
|
|
|
916
913
|
updateTerminationProtection(args: UpdateTerminationProtectionCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: UpdateTerminationProtectionCommandOutput) => void): void;
|
|
917
914
|
/**
|
|
918
915
|
* <p>Validates a specified template. CloudFormation first checks if the template is
|
|
919
|
-
* valid JSON. If it isn't, CloudFormation checks if the template is valid YAML. If
|
|
920
|
-
* these checks fail, CloudFormation returns a template validation error.</p>
|
|
916
|
+
* valid JSON. If it isn't, CloudFormation checks if the template is valid YAML. If
|
|
917
|
+
* both these checks fail, CloudFormation returns a template validation error.</p>
|
|
921
918
|
*/
|
|
922
919
|
validateTemplate(args: ValidateTemplateCommandInput, options?: __HttpHandlerOptions): Promise<ValidateTemplateCommandOutput>;
|
|
923
920
|
validateTemplate(args: ValidateTemplateCommandInput, cb: (err: any, data?: ValidateTemplateCommandOutput) => void): void;
|
|
@@ -188,20 +188,20 @@ export interface CloudFormationClientResolvedConfig extends CloudFormationClient
|
|
|
188
188
|
}
|
|
189
189
|
/**
|
|
190
190
|
* <fullname>AWS CloudFormation</fullname>
|
|
191
|
-
* <p>CloudFormation allows you to create and manage Amazon Web Services infrastructure
|
|
192
|
-
* predictably and repeatedly. You can use CloudFormation to leverage
|
|
193
|
-
*
|
|
194
|
-
* Service, Elastic Load Balancing, and Auto Scaling to
|
|
195
|
-
* scalable, cost-effective applications without creating or
|
|
196
|
-
* infrastructure.</p>
|
|
191
|
+
* <p>CloudFormation allows you to create and manage Amazon Web Services infrastructure
|
|
192
|
+
* deployments predictably and repeatedly. You can use CloudFormation to leverage
|
|
193
|
+
* Amazon Web Services products, such as Amazon Elastic Compute Cloud, Amazon Elastic Block
|
|
194
|
+
* Store, Amazon Simple Notification Service, Elastic Load Balancing, and Auto Scaling to
|
|
195
|
+
* build highly-reliable, highly scalable, cost-effective applications without creating or
|
|
196
|
+
* configuring the underlying Amazon Web Services infrastructure.</p>
|
|
197
197
|
* <p>With CloudFormation, you declare all of your resources and dependencies in a
|
|
198
198
|
* template file. The template defines a collection of resources as a single unit called a
|
|
199
|
-
* stack. CloudFormation creates and deletes all member resources of the stack
|
|
200
|
-
* and manages all dependencies between the resources for you.</p>
|
|
199
|
+
* stack. CloudFormation creates and deletes all member resources of the stack
|
|
200
|
+
* together and manages all dependencies between the resources for you.</p>
|
|
201
201
|
* <p>For more information about CloudFormation, see the <a href="http://aws.amazon.com/cloudformation/">CloudFormation Product Page</a>.</p>
|
|
202
|
-
* <p>CloudFormation makes use of other Amazon Web Services products. If you need
|
|
203
|
-
* technical information about a specific Amazon Web Services product, you can find
|
|
204
|
-
* documentation at <a href="https://docs.aws.amazon.com/">
|
|
202
|
+
* <p>CloudFormation makes use of other Amazon Web Services products. If you need
|
|
203
|
+
* additional technical information about a specific Amazon Web Services product, you can find
|
|
204
|
+
* the product's technical documentation at <a href="https://docs.aws.amazon.com/">
|
|
205
205
|
* <code>docs.aws.amazon.com</code>
|
|
206
206
|
* </a>.</p>
|
|
207
207
|
*/
|
|
@@ -7,8 +7,8 @@ export interface CancelUpdateStackCommandInput extends CancelUpdateStackInput {
|
|
|
7
7
|
export interface CancelUpdateStackCommandOutput extends __MetadataBearer {
|
|
8
8
|
}
|
|
9
9
|
/**
|
|
10
|
-
* <p>Cancels an update on the specified stack. If the call completes successfully, the
|
|
11
|
-
*
|
|
10
|
+
* <p>Cancels an update on the specified stack. If the call completes successfully, the stack
|
|
11
|
+
* rolls back the update and reverts to the previous stack configuration.</p>
|
|
12
12
|
* <note>
|
|
13
13
|
* <p>You can cancel only stacks that are in the UPDATE_IN_PROGRESS state.</p>
|
|
14
14
|
* </note>
|
|
@@ -12,12 +12,11 @@ export interface ContinueUpdateRollbackCommandOutput extends ContinueUpdateRollb
|
|
|
12
12
|
* the cause of the failure, you can manually <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/troubleshooting.html#troubleshooting-errors-update-rollback-failed"> fix the error</a> and continue the rollback. By continuing the rollback, you can
|
|
13
13
|
* return your stack to a working state (the <code>UPDATE_ROLLBACK_COMPLETE</code> state), and
|
|
14
14
|
* then try to update the stack again.</p>
|
|
15
|
-
* <p>A stack goes into the <code>UPDATE_ROLLBACK_FAILED</code> state when
|
|
16
|
-
*
|
|
17
|
-
*
|
|
18
|
-
*
|
|
19
|
-
*
|
|
20
|
-
* it, causing the update rollback to fail.</p>
|
|
15
|
+
* <p>A stack goes into the <code>UPDATE_ROLLBACK_FAILED</code> state when CloudFormation cannot roll back all changes after a failed stack update. For example,
|
|
16
|
+
* you might have a stack that is rolling back to an old database instance that was deleted
|
|
17
|
+
* outside of CloudFormation. Because CloudFormation doesn't know the database
|
|
18
|
+
* was deleted, it assumes that the database instance still exists and attempts to roll back
|
|
19
|
+
* to it, causing the update rollback to fail.</p>
|
|
21
20
|
* @example
|
|
22
21
|
* Use a bare-bones client and the command you need to make an API call.
|
|
23
22
|
* ```javascript
|
|
@@ -10,11 +10,12 @@ export interface CreateChangeSetCommandOutput extends CreateChangeSetOutput, __M
|
|
|
10
10
|
* <p>Creates a list of changes that will be applied to a stack so that you can review the
|
|
11
11
|
* changes before executing them. You can create a change set for a stack that doesn't exist
|
|
12
12
|
* or an existing stack. If you create a change set for a stack that doesn't exist, the change
|
|
13
|
-
* set shows all of the resources that CloudFormation will create. If you create a
|
|
14
|
-
* set for an existing stack, CloudFormation compares the stack's information
|
|
15
|
-
* information that you submit in the change set and lists the differences. Use
|
|
16
|
-
* understand which resources CloudFormation will create or change, and
|
|
17
|
-
* resources in an existing stack, before you create or update a
|
|
13
|
+
* set shows all of the resources that CloudFormation will create. If you create a
|
|
14
|
+
* change set for an existing stack, CloudFormation compares the stack's information
|
|
15
|
+
* with the information that you submit in the change set and lists the differences. Use
|
|
16
|
+
* change sets to understand which resources CloudFormation will create or change, and
|
|
17
|
+
* how it will change resources in an existing stack, before you create or update a
|
|
18
|
+
* stack.</p>
|
|
18
19
|
* <p>To create a change set for a stack that doesn't exist, for the
|
|
19
20
|
* <code>ChangeSetType</code> parameter, specify <code>CREATE</code>. To create a change
|
|
20
21
|
* set for an existing stack, specify <code>UPDATE</code> for the <code>ChangeSetType</code>
|
|
@@ -23,8 +24,8 @@ export interface CreateChangeSetCommandOutput extends CreateChangeSetOutput, __M
|
|
|
23
24
|
* successfully completes, CloudFormation starts creating the change set. To check the
|
|
24
25
|
* status of the change set or to review it, use the <a>DescribeChangeSet</a>
|
|
25
26
|
* action.</p>
|
|
26
|
-
* <p>When you are satisfied with the changes the change set will make, execute the change
|
|
27
|
-
*
|
|
27
|
+
* <p>When you are satisfied with the changes the change set will make, execute the change set
|
|
28
|
+
* by using the <a>ExecuteChangeSet</a> action. CloudFormation doesn't make
|
|
28
29
|
* changes until you execute the change set.</p>
|
|
29
30
|
* <p>To create a change set for the entire stack hierachy, set
|
|
30
31
|
* <code>IncludeNestedStacks</code> to <code>True</code>.</p>
|
|
@@ -7,8 +7,8 @@ export interface CreateStackCommandInput extends CreateStackInput {
|
|
|
7
7
|
export interface CreateStackCommandOutput extends CreateStackOutput, __MetadataBearer {
|
|
8
8
|
}
|
|
9
9
|
/**
|
|
10
|
-
* <p>Creates a stack as specified in the template. After the call completes successfully,
|
|
11
|
-
*
|
|
10
|
+
* <p>Creates a stack as specified in the template. After the call completes successfully, the
|
|
11
|
+
* stack creation starts. You can check the status of the stack via the <a>DescribeStacks</a> API.</p>
|
|
12
12
|
* @example
|
|
13
13
|
* Use a bare-bones client and the command you need to make an API call.
|
|
14
14
|
* ```javascript
|