@aws-sdk/client-cloudformation 3.28.0 → 3.32.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 +38 -0
- package/CloudFormation.ts +126 -61
- package/CloudFormationClient.ts +14 -11
- package/README.md +11 -11
- package/commands/ContinueUpdateRollbackCommand.ts +6 -5
- package/commands/CreateChangeSetCommand.ts +7 -8
- package/commands/CreateStackInstancesCommand.ts +1 -3
- package/commands/DeleteStackInstancesCommand.ts +1 -1
- package/commands/DeleteStackSetCommand.ts +1 -1
- package/commands/DescribeAccountLimitsCommand.ts +2 -2
- package/commands/DescribeChangeSetCommand.ts +2 -1
- package/commands/DescribeStackInstanceCommand.ts +1 -1
- package/commands/DescribeStackResourceDriftsCommand.ts +3 -4
- package/commands/DescribeStacksCommand.ts +1 -1
- package/commands/EstimateTemplateCostCommand.ts +3 -2
- package/commands/ExecuteChangeSetCommand.ts +3 -3
- package/commands/GetTemplateCommand.ts +1 -2
- package/commands/ListChangeSetsCommand.ts +2 -1
- package/commands/ListExportsCommand.ts +1 -1
- package/commands/ListImportsCommand.ts +2 -2
- package/commands/ListStackInstancesCommand.ts +1 -1
- package/commands/ListStackSetsCommand.ts +2 -2
- package/commands/RegisterPublisherCommand.ts +1 -1
- package/commands/RegisterTypeCommand.ts +1 -1
- package/commands/RollbackStackCommand.ts +123 -0
- package/commands/SignalResourceCommand.ts +3 -2
- package/commands/UpdateTerminationProtectionCommand.ts +1 -1
- package/commands/ValidateTemplateCommand.ts +3 -4
- package/dist/cjs/CloudFormation.js +26 -11
- package/dist/cjs/CloudFormation.js.map +1 -1
- package/dist/cjs/CloudFormationClient.js +11 -11
- package/dist/cjs/CloudFormationClient.js.map +1 -1
- package/dist/cjs/commands/ContinueUpdateRollbackCommand.js +6 -5
- package/dist/cjs/commands/ContinueUpdateRollbackCommand.js.map +1 -1
- package/dist/cjs/commands/CreateChangeSetCommand.js +7 -8
- package/dist/cjs/commands/CreateChangeSetCommand.js.map +1 -1
- package/dist/cjs/commands/CreateStackInstancesCommand.js +1 -3
- package/dist/cjs/commands/CreateStackInstancesCommand.js.map +1 -1
- package/dist/cjs/commands/DeleteStackInstancesCommand.js +1 -1
- package/dist/cjs/commands/DeleteStackSetCommand.js +1 -1
- package/dist/cjs/commands/DescribeAccountLimitsCommand.js +2 -2
- package/dist/cjs/commands/DescribeChangeSetCommand.js +2 -1
- package/dist/cjs/commands/DescribeChangeSetCommand.js.map +1 -1
- package/dist/cjs/commands/DescribeStackInstanceCommand.js +1 -1
- package/dist/cjs/commands/DescribeStackResourceDriftsCommand.js +3 -4
- package/dist/cjs/commands/DescribeStackResourceDriftsCommand.js.map +1 -1
- package/dist/cjs/commands/DescribeStacksCommand.js +1 -1
- package/dist/cjs/commands/EstimateTemplateCostCommand.js +3 -2
- package/dist/cjs/commands/EstimateTemplateCostCommand.js.map +1 -1
- package/dist/cjs/commands/ExecuteChangeSetCommand.js +3 -3
- package/dist/cjs/commands/GetTemplateCommand.js +1 -2
- package/dist/cjs/commands/GetTemplateCommand.js.map +1 -1
- package/dist/cjs/commands/ListChangeSetsCommand.js +2 -1
- package/dist/cjs/commands/ListChangeSetsCommand.js.map +1 -1
- package/dist/cjs/commands/ListExportsCommand.js +1 -1
- package/dist/cjs/commands/ListImportsCommand.js +2 -2
- package/dist/cjs/commands/ListStackInstancesCommand.js +1 -1
- package/dist/cjs/commands/ListStackSetsCommand.js +2 -2
- package/dist/cjs/commands/RegisterPublisherCommand.js +1 -1
- package/dist/cjs/commands/RegisterTypeCommand.js +1 -1
- package/dist/cjs/commands/RollbackStackCommand.js +90 -0
- package/dist/cjs/commands/RollbackStackCommand.js.map +1 -0
- package/dist/cjs/commands/SignalResourceCommand.js +3 -2
- package/dist/cjs/commands/SignalResourceCommand.js.map +1 -1
- package/dist/cjs/commands/UpdateTerminationProtectionCommand.js +1 -1
- package/dist/cjs/commands/ValidateTemplateCommand.js +3 -4
- package/dist/cjs/commands/ValidateTemplateCommand.js.map +1 -1
- package/dist/cjs/index.js +1 -0
- package/dist/cjs/index.js.map +1 -1
- package/dist/cjs/models/models_0.js +26 -1
- package/dist/cjs/models/models_0.js.map +1 -1
- package/dist/cjs/package.json +32 -32
- package/dist/cjs/protocols/Aws_query.js +135 -47
- package/dist/cjs/protocols/Aws_query.js.map +1 -1
- package/dist/es/CloudFormation.js +26 -11
- package/dist/es/CloudFormation.js.map +1 -1
- package/dist/es/CloudFormationClient.js +11 -11
- package/dist/es/CloudFormationClient.js.map +1 -1
- package/dist/es/commands/ContinueUpdateRollbackCommand.js +6 -5
- package/dist/es/commands/ContinueUpdateRollbackCommand.js.map +1 -1
- package/dist/es/commands/CreateChangeSetCommand.js +7 -8
- package/dist/es/commands/CreateChangeSetCommand.js.map +1 -1
- package/dist/es/commands/CreateStackInstancesCommand.js +1 -3
- package/dist/es/commands/CreateStackInstancesCommand.js.map +1 -1
- package/dist/es/commands/DeleteStackInstancesCommand.js +1 -1
- package/dist/es/commands/DeleteStackSetCommand.js +1 -1
- package/dist/es/commands/DescribeAccountLimitsCommand.js +2 -2
- package/dist/es/commands/DescribeChangeSetCommand.js +2 -1
- package/dist/es/commands/DescribeChangeSetCommand.js.map +1 -1
- package/dist/es/commands/DescribeStackInstanceCommand.js +1 -1
- package/dist/es/commands/DescribeStackResourceDriftsCommand.js +3 -4
- package/dist/es/commands/DescribeStackResourceDriftsCommand.js.map +1 -1
- package/dist/es/commands/DescribeStacksCommand.js +1 -1
- package/dist/es/commands/EstimateTemplateCostCommand.js +3 -2
- package/dist/es/commands/EstimateTemplateCostCommand.js.map +1 -1
- package/dist/es/commands/ExecuteChangeSetCommand.js +3 -3
- package/dist/es/commands/GetTemplateCommand.js +1 -2
- package/dist/es/commands/GetTemplateCommand.js.map +1 -1
- package/dist/es/commands/ListChangeSetsCommand.js +2 -1
- package/dist/es/commands/ListChangeSetsCommand.js.map +1 -1
- package/dist/es/commands/ListExportsCommand.js +1 -1
- package/dist/es/commands/ListImportsCommand.js +2 -2
- package/dist/es/commands/ListStackInstancesCommand.js +1 -1
- package/dist/es/commands/ListStackSetsCommand.js +2 -2
- package/dist/es/commands/RegisterPublisherCommand.js +1 -1
- package/dist/es/commands/RegisterTypeCommand.js +1 -1
- package/dist/es/commands/RollbackStackCommand.js +94 -0
- package/dist/es/commands/RollbackStackCommand.js.map +1 -0
- package/dist/es/commands/SignalResourceCommand.js +3 -2
- package/dist/es/commands/SignalResourceCommand.js.map +1 -1
- package/dist/es/commands/UpdateTerminationProtectionCommand.js +1 -1
- package/dist/es/commands/ValidateTemplateCommand.js +3 -4
- package/dist/es/commands/ValidateTemplateCommand.js.map +1 -1
- package/dist/es/endpoints.js +1 -2
- package/dist/es/endpoints.js.map +1 -1
- package/dist/es/index.js +1 -0
- package/dist/es/index.js.map +1 -1
- package/dist/es/models/models_0.js +21 -0
- package/dist/es/models/models_0.js.map +1 -1
- package/dist/es/package.json +32 -32
- package/dist/es/protocols/Aws_query.js +140 -46
- package/dist/es/protocols/Aws_query.js.map +1 -1
- package/dist/types/CloudFormation.d.ts +96 -61
- package/dist/types/CloudFormationClient.d.ts +14 -13
- package/dist/types/commands/ContinueUpdateRollbackCommand.d.ts +6 -5
- package/dist/types/commands/CreateChangeSetCommand.d.ts +7 -8
- package/dist/types/commands/CreateStackInstancesCommand.d.ts +1 -3
- package/dist/types/commands/DeleteStackInstancesCommand.d.ts +1 -1
- package/dist/types/commands/DeleteStackSetCommand.d.ts +1 -1
- package/dist/types/commands/DescribeAccountLimitsCommand.d.ts +2 -2
- package/dist/types/commands/DescribeChangeSetCommand.d.ts +2 -1
- package/dist/types/commands/DescribeStackInstanceCommand.d.ts +1 -1
- package/dist/types/commands/DescribeStackResourceDriftsCommand.d.ts +3 -4
- package/dist/types/commands/DescribeStacksCommand.d.ts +1 -1
- package/dist/types/commands/EstimateTemplateCostCommand.d.ts +3 -2
- package/dist/types/commands/ExecuteChangeSetCommand.d.ts +3 -3
- package/dist/types/commands/GetTemplateCommand.d.ts +1 -2
- package/dist/types/commands/ListChangeSetsCommand.d.ts +2 -1
- package/dist/types/commands/ListExportsCommand.d.ts +1 -1
- package/dist/types/commands/ListImportsCommand.d.ts +2 -2
- package/dist/types/commands/ListStackInstancesCommand.d.ts +1 -1
- package/dist/types/commands/ListStackSetsCommand.d.ts +2 -2
- package/dist/types/commands/RegisterPublisherCommand.d.ts +1 -1
- package/dist/types/commands/RegisterTypeCommand.d.ts +1 -1
- package/dist/types/commands/RollbackStackCommand.d.ts +64 -0
- package/dist/types/commands/SignalResourceCommand.d.ts +3 -2
- package/dist/types/commands/UpdateTerminationProtectionCommand.d.ts +1 -1
- package/dist/types/commands/ValidateTemplateCommand.d.ts +3 -4
- package/dist/types/index.d.ts +1 -0
- package/dist/types/models/models_0.d.ts +424 -376
- package/dist/types/protocols/Aws_query.d.ts +3 -0
- package/dist/types/ts3.4/CloudFormation.d.ts +96 -61
- package/dist/types/ts3.4/CloudFormationClient.d.ts +14 -13
- package/dist/types/ts3.4/commands/ContinueUpdateRollbackCommand.d.ts +6 -5
- package/dist/types/ts3.4/commands/CreateChangeSetCommand.d.ts +7 -8
- package/dist/types/ts3.4/commands/CreateStackInstancesCommand.d.ts +1 -3
- package/dist/types/ts3.4/commands/DeleteStackInstancesCommand.d.ts +1 -1
- package/dist/types/ts3.4/commands/DeleteStackSetCommand.d.ts +1 -1
- package/dist/types/ts3.4/commands/DescribeAccountLimitsCommand.d.ts +2 -2
- package/dist/types/ts3.4/commands/DescribeChangeSetCommand.d.ts +2 -1
- package/dist/types/ts3.4/commands/DescribeStackInstanceCommand.d.ts +1 -1
- package/dist/types/ts3.4/commands/DescribeStackResourceDriftsCommand.d.ts +3 -4
- package/dist/types/ts3.4/commands/DescribeStacksCommand.d.ts +1 -1
- package/dist/types/ts3.4/commands/EstimateTemplateCostCommand.d.ts +3 -2
- package/dist/types/ts3.4/commands/ExecuteChangeSetCommand.d.ts +3 -3
- package/dist/types/ts3.4/commands/GetTemplateCommand.d.ts +1 -2
- package/dist/types/ts3.4/commands/ListChangeSetsCommand.d.ts +2 -1
- package/dist/types/ts3.4/commands/ListExportsCommand.d.ts +1 -1
- package/dist/types/ts3.4/commands/ListImportsCommand.d.ts +2 -2
- package/dist/types/ts3.4/commands/ListStackInstancesCommand.d.ts +1 -1
- package/dist/types/ts3.4/commands/ListStackSetsCommand.d.ts +2 -2
- package/dist/types/ts3.4/commands/RegisterPublisherCommand.d.ts +1 -1
- package/dist/types/ts3.4/commands/RegisterTypeCommand.d.ts +1 -1
- package/dist/types/ts3.4/commands/RollbackStackCommand.d.ts +64 -0
- package/dist/types/ts3.4/commands/SignalResourceCommand.d.ts +3 -2
- package/dist/types/ts3.4/commands/UpdateTerminationProtectionCommand.d.ts +1 -1
- package/dist/types/ts3.4/commands/ValidateTemplateCommand.d.ts +3 -4
- package/dist/types/ts3.4/index.d.ts +1 -0
- package/dist/types/ts3.4/models/models_0.d.ts +424 -376
- package/dist/types/ts3.4/protocols/Aws_query.d.ts +3 -0
- package/index.ts +1 -0
- package/models/models_0.ts +435 -375
- package/package.json +32 -32
- package/protocols/Aws_query.ts +151 -46
package/CHANGELOG.md
CHANGED
|
@@ -3,6 +3,44 @@
|
|
|
3
3
|
All notable changes to this project will be documented in this file.
|
|
4
4
|
See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
|
|
5
5
|
|
|
6
|
+
# [3.32.0](https://github.com/aws/aws-sdk-js-v3/compare/v3.31.0...v3.32.0) (2021-09-17)
|
|
7
|
+
|
|
8
|
+
**Note:** Version bump only for package @aws-sdk/client-cloudformation
|
|
9
|
+
|
|
10
|
+
|
|
11
|
+
|
|
12
|
+
|
|
13
|
+
|
|
14
|
+
# [3.31.0](https://github.com/aws/aws-sdk-js-v3/compare/v3.30.0...v3.31.0) (2021-09-11)
|
|
15
|
+
|
|
16
|
+
|
|
17
|
+
### Features
|
|
18
|
+
|
|
19
|
+
* **clients:** update clients as of 09/10/2021 ([#2776](https://github.com/aws/aws-sdk-js-v3/issues/2776)) ([3f49ae7](https://github.com/aws/aws-sdk-js-v3/commit/3f49ae758688f73d5ce16ee21ac597a113199bff))
|
|
20
|
+
|
|
21
|
+
|
|
22
|
+
|
|
23
|
+
|
|
24
|
+
|
|
25
|
+
# [3.30.0](https://github.com/aws/aws-sdk-js-v3/compare/v3.29.0...v3.30.0) (2021-09-07)
|
|
26
|
+
|
|
27
|
+
**Note:** Version bump only for package @aws-sdk/client-cloudformation
|
|
28
|
+
|
|
29
|
+
|
|
30
|
+
|
|
31
|
+
|
|
32
|
+
|
|
33
|
+
# [3.29.0](https://github.com/aws/aws-sdk-js-v3/compare/v3.28.0...v3.29.0) (2021-09-02)
|
|
34
|
+
|
|
35
|
+
|
|
36
|
+
### Features
|
|
37
|
+
|
|
38
|
+
* **clients:** update clients as of 09/02/2021 ([#2744](https://github.com/aws/aws-sdk-js-v3/issues/2744)) ([19f061f](https://github.com/aws/aws-sdk-js-v3/commit/19f061fa189539c8e64563e5337ac640450c17ab))
|
|
39
|
+
|
|
40
|
+
|
|
41
|
+
|
|
42
|
+
|
|
43
|
+
|
|
6
44
|
# [3.28.0](https://github.com/aws/aws-sdk-js-v3/compare/v3.27.0...v3.28.0) (2021-08-27)
|
|
7
45
|
|
|
8
46
|
|
package/CloudFormation.ts
CHANGED
|
@@ -232,6 +232,11 @@ import {
|
|
|
232
232
|
RegisterTypeCommandInput,
|
|
233
233
|
RegisterTypeCommandOutput,
|
|
234
234
|
} from "./commands/RegisterTypeCommand";
|
|
235
|
+
import {
|
|
236
|
+
RollbackStackCommand,
|
|
237
|
+
RollbackStackCommandInput,
|
|
238
|
+
RollbackStackCommandOutput,
|
|
239
|
+
} from "./commands/RollbackStackCommand";
|
|
235
240
|
import {
|
|
236
241
|
SetStackPolicyCommand,
|
|
237
242
|
SetStackPolicyCommandInput,
|
|
@@ -283,20 +288,20 @@ import { HttpHandlerOptions as __HttpHandlerOptions } from "@aws-sdk/types";
|
|
|
283
288
|
|
|
284
289
|
/**
|
|
285
290
|
* <fullname>AWS CloudFormation</fullname>
|
|
286
|
-
* <p>CloudFormation allows you to create and manage Amazon Web Services
|
|
287
|
-
*
|
|
288
|
-
*
|
|
289
|
-
*
|
|
290
|
-
*
|
|
291
|
-
*
|
|
291
|
+
* <p>CloudFormation allows you to create and manage Amazon Web Services infrastructure deployments
|
|
292
|
+
* predictably and repeatedly. You can use CloudFormation to leverage Amazon Web Services products, such
|
|
293
|
+
* as Amazon Elastic Compute Cloud, Amazon Elastic Block Store, Amazon Simple Notification
|
|
294
|
+
* Service, Elastic Load Balancing, and Auto Scaling to build highly-reliable, highly
|
|
295
|
+
* scalable, cost-effective applications without creating or configuring the underlying Amazon Web Services
|
|
296
|
+
* infrastructure.</p>
|
|
292
297
|
* <p>With CloudFormation, you declare all of your resources and dependencies in a
|
|
293
298
|
* template file. The template defines a collection of resources as a single unit called a
|
|
294
|
-
* stack. CloudFormation creates and deletes all member resources of the stack
|
|
295
|
-
*
|
|
299
|
+
* stack. CloudFormation creates and deletes all member resources of the stack together
|
|
300
|
+
* and manages all dependencies between the resources for you.</p>
|
|
296
301
|
* <p>For more information about CloudFormation, see the <a href="http://aws.amazon.com/cloudformation/">CloudFormation Product Page</a>.</p>
|
|
297
|
-
* <p>CloudFormation makes use of other Amazon Web Services products. If you need
|
|
298
|
-
*
|
|
299
|
-
*
|
|
302
|
+
* <p>CloudFormation makes use of other Amazon Web Services products. If you need additional
|
|
303
|
+
* technical information about a specific Amazon Web Services product, you can find the product's technical
|
|
304
|
+
* documentation at <a href="https://docs.aws.amazon.com/">
|
|
300
305
|
* <code>docs.aws.amazon.com</code>
|
|
301
306
|
* </a>.</p>
|
|
302
307
|
*/
|
|
@@ -413,11 +418,12 @@ export class CloudFormation extends CloudFormationClient {
|
|
|
413
418
|
* 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
|
|
414
419
|
* return your stack to a working state (the <code>UPDATE_ROLLBACK_COMPLETE</code> state), and
|
|
415
420
|
* then try to update the stack again.</p>
|
|
416
|
-
* <p>A stack goes into the <code>UPDATE_ROLLBACK_FAILED</code> state when
|
|
417
|
-
*
|
|
418
|
-
*
|
|
419
|
-
*
|
|
420
|
-
*
|
|
421
|
+
* <p>A stack goes into the <code>UPDATE_ROLLBACK_FAILED</code> state when
|
|
422
|
+
* CloudFormation cannot roll back all changes after a failed stack update. For example, you
|
|
423
|
+
* might have a stack that is rolling back to an old database instance that was deleted
|
|
424
|
+
* outside of CloudFormation. Because CloudFormation doesn't know the database was
|
|
425
|
+
* deleted, it assumes that the database instance still exists and attempts to roll back to
|
|
426
|
+
* it, causing the update rollback to fail.</p>
|
|
421
427
|
*/
|
|
422
428
|
public continueUpdateRollback(
|
|
423
429
|
args: ContinueUpdateRollbackCommandInput,
|
|
@@ -452,12 +458,11 @@ export class CloudFormation extends CloudFormationClient {
|
|
|
452
458
|
* <p>Creates a list of changes that will be applied to a stack so that you can review the
|
|
453
459
|
* changes before executing them. You can create a change set for a stack that doesn't exist
|
|
454
460
|
* or an existing stack. If you create a change set for a stack that doesn't exist, the change
|
|
455
|
-
* set shows all of the resources that CloudFormation will create. If you create a
|
|
456
|
-
*
|
|
457
|
-
*
|
|
458
|
-
*
|
|
459
|
-
*
|
|
460
|
-
* stack.</p>
|
|
461
|
+
* set shows all of the resources that CloudFormation will create. If you create a change
|
|
462
|
+
* set for an existing stack, CloudFormation compares the stack's information with the
|
|
463
|
+
* information that you submit in the change set and lists the differences. Use change sets to
|
|
464
|
+
* understand which resources CloudFormation will create or change, and how it will change
|
|
465
|
+
* resources in an existing stack, before you create or update a stack.</p>
|
|
461
466
|
* <p>To create a change set for a stack that doesn't exist, for the
|
|
462
467
|
* <code>ChangeSetType</code> parameter, specify <code>CREATE</code>. To create a change
|
|
463
468
|
* set for an existing stack, specify <code>UPDATE</code> for the <code>ChangeSetType</code>
|
|
@@ -467,8 +472,8 @@ export class CloudFormation extends CloudFormationClient {
|
|
|
467
472
|
* status of the change set or to review it, use the <a>DescribeChangeSet</a>
|
|
468
473
|
* action.</p>
|
|
469
474
|
* <p>When you are satisfied with the changes the change set will make, execute the change
|
|
470
|
-
* set by using the <a>ExecuteChangeSet</a> action. CloudFormation doesn't
|
|
471
|
-
*
|
|
475
|
+
* set by using the <a>ExecuteChangeSet</a> action. CloudFormation doesn't make
|
|
476
|
+
* changes until you execute the change set.</p>
|
|
472
477
|
* <p>To create a change set for the entire stack hierachy, set
|
|
473
478
|
* <code>IncludeNestedStacks</code> to <code>True</code>.</p>
|
|
474
479
|
*/
|
|
@@ -530,9 +535,7 @@ export class CloudFormation extends CloudFormationClient {
|
|
|
530
535
|
|
|
531
536
|
/**
|
|
532
537
|
* <p>Creates stack instances for the specified accounts, within the specified Regions. A
|
|
533
|
-
* stack instance refers to a stack in a specific account and Region. You must specify at
|
|
534
|
-
* least one value for either <code>Accounts</code> or <code>DeploymentTargets</code>, and you
|
|
535
|
-
* must specify at least one value for <code>Regions</code>.</p>
|
|
538
|
+
* stack instance refers to a stack in a specific account and Region. You must specify at least one value for either <code>Accounts</code> or <code>DeploymentTargets</code>, and you must specify at least one value for <code>Regions</code>.</p>
|
|
536
539
|
*/
|
|
537
540
|
public createStackInstances(
|
|
538
541
|
args: CreateStackInstancesCommandInput,
|
|
@@ -700,7 +703,7 @@ export class CloudFormation extends CloudFormationClient {
|
|
|
700
703
|
}
|
|
701
704
|
|
|
702
705
|
/**
|
|
703
|
-
* <p>Deletes stack instances for the specified accounts, in the specified Regions
|
|
706
|
+
* <p>Deletes stack instances for the specified accounts, in the specified Regions.</p>
|
|
704
707
|
*/
|
|
705
708
|
public deleteStackInstances(
|
|
706
709
|
args: DeleteStackInstancesCommandInput,
|
|
@@ -733,7 +736,7 @@ export class CloudFormation extends CloudFormationClient {
|
|
|
733
736
|
|
|
734
737
|
/**
|
|
735
738
|
* <p>Deletes a stack set. Before you can delete a stack set, all of its member stack
|
|
736
|
-
* instances must be deleted. For more information about how to do this, see <a>DeleteStackInstances</a
|
|
739
|
+
* instances must be deleted. For more information about how to do this, see <a>DeleteStackInstances</a>.</p>
|
|
737
740
|
*/
|
|
738
741
|
public deleteStackSet(
|
|
739
742
|
args: DeleteStackSetCommandInput,
|
|
@@ -808,8 +811,8 @@ export class CloudFormation extends CloudFormationClient {
|
|
|
808
811
|
/**
|
|
809
812
|
* <p>Retrieves your account's CloudFormation limits, such as the maximum number of
|
|
810
813
|
* stacks that you can create in your account. For more information about account limits, see
|
|
811
|
-
* <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cloudformation-limits.html">CloudFormation
|
|
812
|
-
*
|
|
814
|
+
* <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cloudformation-limits.html">CloudFormation
|
|
815
|
+
* Limits</a> in the <i>CloudFormation User Guide</i>.</p>
|
|
813
816
|
*/
|
|
814
817
|
public describeAccountLimits(
|
|
815
818
|
args: DescribeAccountLimitsCommandInput,
|
|
@@ -841,7 +844,8 @@ export class CloudFormation extends CloudFormationClient {
|
|
|
841
844
|
}
|
|
842
845
|
|
|
843
846
|
/**
|
|
844
|
-
* <p>Returns the inputs for the change set and a list of changes that CloudFormation
|
|
847
|
+
* <p>Returns the inputs for the change set and a list of changes that CloudFormation
|
|
848
|
+
* will make if you execute the change set. For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-changesets.html">Updating Stacks Using Change Sets</a> in the CloudFormation User
|
|
845
849
|
* Guide.</p>
|
|
846
850
|
*/
|
|
847
851
|
public describeChangeSet(
|
|
@@ -1005,7 +1009,7 @@ export class CloudFormation extends CloudFormationClient {
|
|
|
1005
1009
|
}
|
|
1006
1010
|
|
|
1007
1011
|
/**
|
|
1008
|
-
* <p>Returns the stack instance that's associated with the specified stack set, account, and Region.</p>
|
|
1012
|
+
* <p>Returns the stack instance that's associated with the specified stack set, Amazon Web Services account, and Region.</p>
|
|
1009
1013
|
* <p>For a list of stack instances that are associated with a specific stack set, use
|
|
1010
1014
|
* <a>ListStackInstances</a>.</p>
|
|
1011
1015
|
*/
|
|
@@ -1077,10 +1081,9 @@ export class CloudFormation extends CloudFormationClient {
|
|
|
1077
1081
|
* specified stack. This includes actual and expected configuration values for resources where
|
|
1078
1082
|
* CloudFormation detects configuration drift.</p>
|
|
1079
1083
|
* <p>For a given stack, there will be one <code>StackResourceDrift</code> for each stack
|
|
1080
|
-
* resource that has been checked for drift. Resources that
|
|
1081
|
-
*
|
|
1082
|
-
*
|
|
1083
|
-
* <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-stack-drift-resource-list.html">Resources that Support Drift Detection</a>.</p>
|
|
1084
|
+
* resource that has been checked for drift. Resources that haven't yet been checked for drift
|
|
1085
|
+
* are not included. Resources that do not currently support drift detection are not checked,
|
|
1086
|
+
* 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>
|
|
1084
1087
|
* <p>Use <a>DetectStackResourceDrift</a> to detect drift on individual
|
|
1085
1088
|
* resources, or <a>DetectStackDrift</a> to detect drift on all supported resources
|
|
1086
1089
|
* for a given stack.</p>
|
|
@@ -1169,7 +1172,7 @@ export class CloudFormation extends CloudFormationClient {
|
|
|
1169
1172
|
* <p>Returns the description for the specified stack; if no stack name was specified, then
|
|
1170
1173
|
* it returns the description for all the stacks created.</p>
|
|
1171
1174
|
* <note>
|
|
1172
|
-
* <p>If the stack does not exist, an <code>
|
|
1175
|
+
* <p>If the stack does not exist, an <code>ValidationError</code> is
|
|
1173
1176
|
* returned.</p>
|
|
1174
1177
|
* </note>
|
|
1175
1178
|
*/
|
|
@@ -1511,8 +1514,9 @@ export class CloudFormation extends CloudFormationClient {
|
|
|
1511
1514
|
}
|
|
1512
1515
|
|
|
1513
1516
|
/**
|
|
1514
|
-
* <p>Returns the estimated monthly cost of a template. The return value is an Amazon Web Services Simple
|
|
1515
|
-
* resources required to run the
|
|
1517
|
+
* <p>Returns the estimated monthly cost of a template. The return value is an Amazon Web Services Simple
|
|
1518
|
+
* Monthly Calculator URL with a query string that describes the resources required to run the
|
|
1519
|
+
* template.</p>
|
|
1516
1520
|
*/
|
|
1517
1521
|
public estimateTemplateCost(
|
|
1518
1522
|
args: EstimateTemplateCostCommandInput,
|
|
@@ -1545,9 +1549,9 @@ export class CloudFormation extends CloudFormationClient {
|
|
|
1545
1549
|
|
|
1546
1550
|
/**
|
|
1547
1551
|
* <p>Updates a stack using the input information that was provided when the specified
|
|
1548
|
-
* change set was created. After the call successfully completes, CloudFormation
|
|
1549
|
-
*
|
|
1550
|
-
*
|
|
1552
|
+
* change set was created. After the call successfully completes, CloudFormation starts
|
|
1553
|
+
* updating the stack. Use the <a>DescribeStacks</a> action to view the status of
|
|
1554
|
+
* the update.</p>
|
|
1551
1555
|
* <p>When you execute a change set, CloudFormation deletes all other change sets
|
|
1552
1556
|
* associated with the stack because they aren't valid for the updated stack.</p>
|
|
1553
1557
|
* <p>If a stack policy is associated with the stack, CloudFormation enforces the
|
|
@@ -1624,8 +1628,7 @@ export class CloudFormation extends CloudFormationClient {
|
|
|
1624
1628
|
* <p>For deleted stacks, GetTemplate returns the template for up to 90 days after the
|
|
1625
1629
|
* stack has been deleted.</p>
|
|
1626
1630
|
* <note>
|
|
1627
|
-
* <p>
|
|
1628
|
-
* </p>
|
|
1631
|
+
* <p>If the template does not exist, a <code>ValidationError</code> is returned.</p>
|
|
1629
1632
|
* </note>
|
|
1630
1633
|
*/
|
|
1631
1634
|
public getTemplate(args: GetTemplateCommandInput, options?: __HttpHandlerOptions): Promise<GetTemplateCommandOutput>;
|
|
@@ -1731,7 +1734,8 @@ export class CloudFormation extends CloudFormationClient {
|
|
|
1731
1734
|
}
|
|
1732
1735
|
|
|
1733
1736
|
/**
|
|
1734
|
-
* <p>Returns the ID and status of each active change set for a stack. For example,
|
|
1737
|
+
* <p>Returns the ID and status of each active change set for a stack. For example,
|
|
1738
|
+
* CloudFormation lists change sets that are in the <code>CREATE_IN_PROGRESS</code> or
|
|
1735
1739
|
* <code>CREATE_PENDING</code> state.</p>
|
|
1736
1740
|
*/
|
|
1737
1741
|
public listChangeSets(
|
|
@@ -1768,7 +1772,7 @@ export class CloudFormation extends CloudFormationClient {
|
|
|
1768
1772
|
* action. Use this action to see the exported output values that you can import into other
|
|
1769
1773
|
* stacks. To import values, use the <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-importvalue.html">
|
|
1770
1774
|
* <code>Fn::ImportValue</code>
|
|
1771
|
-
* </a> function
|
|
1775
|
+
* </a> function.</p>
|
|
1772
1776
|
* <p>For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-stack-exports.html">
|
|
1773
1777
|
* CloudFormation Export Stack Output Values</a>.</p>
|
|
1774
1778
|
*/
|
|
@@ -1798,10 +1802,10 @@ export class CloudFormation extends CloudFormationClient {
|
|
|
1798
1802
|
/**
|
|
1799
1803
|
* <p>Lists all stacks that are importing an exported output value. To modify or remove an
|
|
1800
1804
|
* exported output value, first use this action to see which stacks are using it. To see the
|
|
1801
|
-
* exported output values in your account, see <a>ListExports</a
|
|
1805
|
+
* exported output values in your account, see <a>ListExports</a>.</p>
|
|
1802
1806
|
* <p>For more information about importing an exported output value, see the <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-importvalue.html">
|
|
1803
1807
|
* <code>Fn::ImportValue</code>
|
|
1804
|
-
* </a> function
|
|
1808
|
+
* </a> function.</p>
|
|
1805
1809
|
*/
|
|
1806
1810
|
public listImports(args: ListImportsCommandInput, options?: __HttpHandlerOptions): Promise<ListImportsCommandOutput>;
|
|
1807
1811
|
public listImports(args: ListImportsCommandInput, cb: (err: any, data?: ListImportsCommandOutput) => void): void;
|
|
@@ -1829,7 +1833,7 @@ export class CloudFormation extends CloudFormationClient {
|
|
|
1829
1833
|
/**
|
|
1830
1834
|
* <p>Returns summary information about stack instances that are associated with the
|
|
1831
1835
|
* specified stack set. You can filter for stack instances that are associated with a specific
|
|
1832
|
-
*
|
|
1836
|
+
* Amazon Web Services account name or Region, or that have a specific status.</p>
|
|
1833
1837
|
*/
|
|
1834
1838
|
public listStackInstances(
|
|
1835
1839
|
args: ListStackInstancesCommandInput,
|
|
@@ -1994,8 +1998,8 @@ export class CloudFormation extends CloudFormationClient {
|
|
|
1994
1998
|
* <ul>
|
|
1995
1999
|
* <li>
|
|
1996
2000
|
* <p>[Self-managed permissions] If you set the <code>CallAs</code> parameter to
|
|
1997
|
-
* <code>SELF</code> while signed in to your account,
|
|
1998
|
-
* <code>ListStackSets</code> returns all self-managed stack sets in your account.</p>
|
|
2001
|
+
* <code>SELF</code> while signed in to your Amazon Web Services account,
|
|
2002
|
+
* <code>ListStackSets</code> returns all self-managed stack sets in your Amazon Web Services account.</p>
|
|
1999
2003
|
* </li>
|
|
2000
2004
|
* <li>
|
|
2001
2005
|
* <p>[Service-managed permissions] If you set the <code>CallAs</code> parameter to
|
|
@@ -2197,7 +2201,7 @@ export class CloudFormation extends CloudFormationClient {
|
|
|
2197
2201
|
/**
|
|
2198
2202
|
* <p>Registers your account as a publisher of public extensions in the CloudFormation
|
|
2199
2203
|
* registry. Public extensions are available for use by all CloudFormation users. This
|
|
2200
|
-
* publisher ID applies to your account in all Regions.</p>
|
|
2204
|
+
* publisher ID applies to your account in all Amazon Web Services Regions.</p>
|
|
2201
2205
|
* <p>For information on requirements for registering as a public extension publisher, see
|
|
2202
2206
|
* <a href="https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/publish-extension.html#publish-extension-prereqs">Registering your account to publish CloudFormation
|
|
2203
2207
|
* extensions</a> in the <i>CloudFormation CLI User Guide</i>.</p>
|
|
@@ -2234,7 +2238,7 @@ export class CloudFormation extends CloudFormationClient {
|
|
|
2234
2238
|
|
|
2235
2239
|
/**
|
|
2236
2240
|
* <p>Registers an extension with the CloudFormation service. Registering an
|
|
2237
|
-
* extension makes it available for use in CloudFormation templates in your account, and includes:</p>
|
|
2241
|
+
* extension makes it available for use in CloudFormation templates in your Amazon Web Services account, and includes:</p>
|
|
2238
2242
|
* <ul>
|
|
2239
2243
|
* <li>
|
|
2240
2244
|
* <p>Validating the extension schema</p>
|
|
@@ -2288,6 +2292,67 @@ export class CloudFormation extends CloudFormationClient {
|
|
|
2288
2292
|
}
|
|
2289
2293
|
}
|
|
2290
2294
|
|
|
2295
|
+
/**
|
|
2296
|
+
* <p>When specifying <code>RollbackStack</code>, you preserve the state of previously provisioned resources when an operation fails. You can check the status of the stack through the <a>DescribeStacks</a> API.</p>
|
|
2297
|
+
* <p>Rolls back the specified stack to the last known stable state from <code>CREATE_FAILED</code> or <code>UPDATE_FAILED</code> stack statuses.</p>
|
|
2298
|
+
* <p>This operation will delete a stack if it doesn't contain a last known stable state. A last known stable state includes any status in a <code>*_COMPLETE</code>. This includes the following stack statuses.</p>
|
|
2299
|
+
* <ul>
|
|
2300
|
+
* <li>
|
|
2301
|
+
* <p>
|
|
2302
|
+
* <code>CREATE_COMPLETE</code>
|
|
2303
|
+
* </p>
|
|
2304
|
+
* </li>
|
|
2305
|
+
* <li>
|
|
2306
|
+
* <p>
|
|
2307
|
+
* <code>UPDATE_COMPLETE</code>
|
|
2308
|
+
* </p>
|
|
2309
|
+
* </li>
|
|
2310
|
+
* <li>
|
|
2311
|
+
* <p>
|
|
2312
|
+
* <code>UPDATE_ROLLBACK_COMPLETE</code>
|
|
2313
|
+
* </p>
|
|
2314
|
+
* </li>
|
|
2315
|
+
* <li>
|
|
2316
|
+
* <p>
|
|
2317
|
+
* <code>IMPORT_COMPLETE</code>
|
|
2318
|
+
* </p>
|
|
2319
|
+
* </li>
|
|
2320
|
+
* <li>
|
|
2321
|
+
* <p>
|
|
2322
|
+
* <code>IMPORT_ROLLBACK_COMPLETE</code>
|
|
2323
|
+
* </p>
|
|
2324
|
+
* </li>
|
|
2325
|
+
* </ul>
|
|
2326
|
+
*/
|
|
2327
|
+
public rollbackStack(
|
|
2328
|
+
args: RollbackStackCommandInput,
|
|
2329
|
+
options?: __HttpHandlerOptions
|
|
2330
|
+
): Promise<RollbackStackCommandOutput>;
|
|
2331
|
+
public rollbackStack(
|
|
2332
|
+
args: RollbackStackCommandInput,
|
|
2333
|
+
cb: (err: any, data?: RollbackStackCommandOutput) => void
|
|
2334
|
+
): void;
|
|
2335
|
+
public rollbackStack(
|
|
2336
|
+
args: RollbackStackCommandInput,
|
|
2337
|
+
options: __HttpHandlerOptions,
|
|
2338
|
+
cb: (err: any, data?: RollbackStackCommandOutput) => void
|
|
2339
|
+
): void;
|
|
2340
|
+
public rollbackStack(
|
|
2341
|
+
args: RollbackStackCommandInput,
|
|
2342
|
+
optionsOrCb?: __HttpHandlerOptions | ((err: any, data?: RollbackStackCommandOutput) => void),
|
|
2343
|
+
cb?: (err: any, data?: RollbackStackCommandOutput) => void
|
|
2344
|
+
): Promise<RollbackStackCommandOutput> | void {
|
|
2345
|
+
const command = new RollbackStackCommand(args);
|
|
2346
|
+
if (typeof optionsOrCb === "function") {
|
|
2347
|
+
this.send(command, optionsOrCb);
|
|
2348
|
+
} else if (typeof cb === "function") {
|
|
2349
|
+
if (typeof optionsOrCb !== "object") throw new Error(`Expect http options but get ${typeof optionsOrCb}`);
|
|
2350
|
+
this.send(command, optionsOrCb || {}, cb);
|
|
2351
|
+
} else {
|
|
2352
|
+
return this.send(command, optionsOrCb);
|
|
2353
|
+
}
|
|
2354
|
+
}
|
|
2355
|
+
|
|
2291
2356
|
/**
|
|
2292
2357
|
* <p>Sets a stack policy for a specified stack.</p>
|
|
2293
2358
|
*/
|
|
@@ -2399,8 +2464,9 @@ export class CloudFormation extends CloudFormationClient {
|
|
|
2399
2464
|
|
|
2400
2465
|
/**
|
|
2401
2466
|
* <p>Sends a signal to the specified resource with a success or failure status. You can
|
|
2402
|
-
* use the SignalResource API in conjunction with a creation policy or update policy.
|
|
2403
|
-
*
|
|
2467
|
+
* use the SignalResource API in conjunction with a creation policy or update policy.
|
|
2468
|
+
* CloudFormation doesn't proceed with a stack creation or update until resources receive the
|
|
2469
|
+
* required number of signals or the timeout period is exceeded. The SignalResource API is
|
|
2404
2470
|
* useful in cases where you want to send signals from anywhere other than an Amazon EC2
|
|
2405
2471
|
* instance.</p>
|
|
2406
2472
|
*/
|
|
@@ -2631,7 +2697,7 @@ export class CloudFormation extends CloudFormationClient {
|
|
|
2631
2697
|
* a stack with termination protection enabled, the operation fails and the stack remains
|
|
2632
2698
|
* unchanged. For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-protect-stacks.html">Protecting a
|
|
2633
2699
|
* Stack From Being Deleted</a> in the <i>CloudFormation User Guide</i>.</p>
|
|
2634
|
-
* <p>
|
|
2700
|
+
* <p>For <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-nested-stacks.html">nested
|
|
2635
2701
|
* stacks</a>, termination protection is set on the root stack and cannot be changed
|
|
2636
2702
|
* directly on the nested stack.</p>
|
|
2637
2703
|
*/
|
|
@@ -2665,10 +2731,9 @@ export class CloudFormation extends CloudFormationClient {
|
|
|
2665
2731
|
}
|
|
2666
2732
|
|
|
2667
2733
|
/**
|
|
2668
|
-
* <p>Validates a specified template. CloudFormation first checks if the template
|
|
2669
|
-
*
|
|
2670
|
-
*
|
|
2671
|
-
* error.</p>
|
|
2734
|
+
* <p>Validates a specified template. CloudFormation first checks if the template is
|
|
2735
|
+
* valid JSON. If it isn't, CloudFormation checks if the template is valid YAML. If both
|
|
2736
|
+
* these checks fail, CloudFormation returns a template validation error.</p>
|
|
2672
2737
|
*/
|
|
2673
2738
|
public validateTemplate(
|
|
2674
2739
|
args: ValidateTemplateCommandInput,
|
package/CloudFormationClient.ts
CHANGED
|
@@ -114,6 +114,7 @@ import {
|
|
|
114
114
|
} from "./commands/RecordHandlerProgressCommand";
|
|
115
115
|
import { RegisterPublisherCommandInput, RegisterPublisherCommandOutput } from "./commands/RegisterPublisherCommand";
|
|
116
116
|
import { RegisterTypeCommandInput, RegisterTypeCommandOutput } from "./commands/RegisterTypeCommand";
|
|
117
|
+
import { RollbackStackCommandInput, RollbackStackCommandOutput } from "./commands/RollbackStackCommand";
|
|
117
118
|
import { SetStackPolicyCommandInput, SetStackPolicyCommandOutput } from "./commands/SetStackPolicyCommand";
|
|
118
119
|
import {
|
|
119
120
|
SetTypeConfigurationCommandInput,
|
|
@@ -246,6 +247,7 @@ export type ServiceInputTypes =
|
|
|
246
247
|
| RecordHandlerProgressCommandInput
|
|
247
248
|
| RegisterPublisherCommandInput
|
|
248
249
|
| RegisterTypeCommandInput
|
|
250
|
+
| RollbackStackCommandInput
|
|
249
251
|
| SetStackPolicyCommandInput
|
|
250
252
|
| SetTypeConfigurationCommandInput
|
|
251
253
|
| SetTypeDefaultVersionCommandInput
|
|
@@ -312,6 +314,7 @@ export type ServiceOutputTypes =
|
|
|
312
314
|
| RecordHandlerProgressCommandOutput
|
|
313
315
|
| RegisterPublisherCommandOutput
|
|
314
316
|
| RegisterTypeCommandOutput
|
|
317
|
+
| RollbackStackCommandOutput
|
|
315
318
|
| SetStackPolicyCommandOutput
|
|
316
319
|
| SetTypeConfigurationCommandOutput
|
|
317
320
|
| SetTypeDefaultVersionCommandOutput
|
|
@@ -464,20 +467,20 @@ export interface CloudFormationClientResolvedConfig extends CloudFormationClient
|
|
|
464
467
|
|
|
465
468
|
/**
|
|
466
469
|
* <fullname>AWS CloudFormation</fullname>
|
|
467
|
-
* <p>CloudFormation allows you to create and manage Amazon Web Services
|
|
468
|
-
*
|
|
469
|
-
*
|
|
470
|
-
*
|
|
471
|
-
*
|
|
472
|
-
*
|
|
470
|
+
* <p>CloudFormation allows you to create and manage Amazon Web Services infrastructure deployments
|
|
471
|
+
* predictably and repeatedly. You can use CloudFormation to leverage Amazon Web Services products, such
|
|
472
|
+
* as Amazon Elastic Compute Cloud, Amazon Elastic Block Store, Amazon Simple Notification
|
|
473
|
+
* Service, Elastic Load Balancing, and Auto Scaling to build highly-reliable, highly
|
|
474
|
+
* scalable, cost-effective applications without creating or configuring the underlying Amazon Web Services
|
|
475
|
+
* infrastructure.</p>
|
|
473
476
|
* <p>With CloudFormation, you declare all of your resources and dependencies in a
|
|
474
477
|
* template file. The template defines a collection of resources as a single unit called a
|
|
475
|
-
* stack. CloudFormation creates and deletes all member resources of the stack
|
|
476
|
-
*
|
|
478
|
+
* stack. CloudFormation creates and deletes all member resources of the stack together
|
|
479
|
+
* and manages all dependencies between the resources for you.</p>
|
|
477
480
|
* <p>For more information about CloudFormation, see the <a href="http://aws.amazon.com/cloudformation/">CloudFormation Product Page</a>.</p>
|
|
478
|
-
* <p>CloudFormation makes use of other Amazon Web Services products. If you need
|
|
479
|
-
*
|
|
480
|
-
*
|
|
481
|
+
* <p>CloudFormation makes use of other Amazon Web Services products. If you need additional
|
|
482
|
+
* technical information about a specific Amazon Web Services product, you can find the product's technical
|
|
483
|
+
* documentation at <a href="https://docs.aws.amazon.com/">
|
|
481
484
|
* <code>docs.aws.amazon.com</code>
|
|
482
485
|
* </a>.</p>
|
|
483
486
|
*/
|
package/README.md
CHANGED
|
@@ -9,20 +9,20 @@ AWS SDK for JavaScript CloudFormation Client for Node.js, Browser and React Nati
|
|
|
9
9
|
|
|
10
10
|
<fullname>AWS CloudFormation</fullname>
|
|
11
11
|
|
|
12
|
-
<p>CloudFormation allows you to create and manage Amazon Web Services
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
12
|
+
<p>CloudFormation allows you to create and manage Amazon Web Services infrastructure deployments
|
|
13
|
+
predictably and repeatedly. You can use CloudFormation to leverage Amazon Web Services products, such
|
|
14
|
+
as Amazon Elastic Compute Cloud, Amazon Elastic Block Store, Amazon Simple Notification
|
|
15
|
+
Service, Elastic Load Balancing, and Auto Scaling to build highly-reliable, highly
|
|
16
|
+
scalable, cost-effective applications without creating or configuring the underlying Amazon Web Services
|
|
17
|
+
infrastructure.</p>
|
|
18
18
|
<p>With CloudFormation, you declare all of your resources and dependencies in a
|
|
19
19
|
template file. The template defines a collection of resources as a single unit called a
|
|
20
|
-
stack. CloudFormation creates and deletes all member resources of the stack
|
|
21
|
-
|
|
20
|
+
stack. CloudFormation creates and deletes all member resources of the stack together
|
|
21
|
+
and manages all dependencies between the resources for you.</p>
|
|
22
22
|
<p>For more information about CloudFormation, see the <a href="http://aws.amazon.com/cloudformation/">CloudFormation Product Page</a>.</p>
|
|
23
|
-
<p>CloudFormation makes use of other Amazon Web Services products. If you need
|
|
24
|
-
|
|
25
|
-
|
|
23
|
+
<p>CloudFormation makes use of other Amazon Web Services products. If you need additional
|
|
24
|
+
technical information about a specific Amazon Web Services product, you can find the product's technical
|
|
25
|
+
documentation at <a href="https://docs.aws.amazon.com/">
|
|
26
26
|
<code>docs.aws.amazon.com</code>
|
|
27
27
|
</a>.</p>
|
|
28
28
|
|
|
@@ -26,11 +26,12 @@ export interface ContinueUpdateRollbackCommandOutput extends ContinueUpdateRollb
|
|
|
26
26
|
* 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
|
|
27
27
|
* return your stack to a working state (the <code>UPDATE_ROLLBACK_COMPLETE</code> state), and
|
|
28
28
|
* then try to update the stack again.</p>
|
|
29
|
-
* <p>A stack goes into the <code>UPDATE_ROLLBACK_FAILED</code> state when
|
|
30
|
-
*
|
|
31
|
-
*
|
|
32
|
-
*
|
|
33
|
-
*
|
|
29
|
+
* <p>A stack goes into the <code>UPDATE_ROLLBACK_FAILED</code> state when
|
|
30
|
+
* CloudFormation cannot roll back all changes after a failed stack update. For example, you
|
|
31
|
+
* might have a stack that is rolling back to an old database instance that was deleted
|
|
32
|
+
* outside of CloudFormation. Because CloudFormation doesn't know the database was
|
|
33
|
+
* deleted, it assumes that the database instance still exists and attempts to roll back to
|
|
34
|
+
* it, causing the update rollback to fail.</p>
|
|
34
35
|
* @example
|
|
35
36
|
* Use a bare-bones client and the command you need to make an API call.
|
|
36
37
|
* ```javascript
|
|
@@ -24,12 +24,11 @@ export interface CreateChangeSetCommandOutput extends CreateChangeSetOutput, __M
|
|
|
24
24
|
* <p>Creates a list of changes that will be applied to a stack so that you can review the
|
|
25
25
|
* changes before executing them. You can create a change set for a stack that doesn't exist
|
|
26
26
|
* or an existing stack. If you create a change set for a stack that doesn't exist, the change
|
|
27
|
-
* set shows all of the resources that CloudFormation will create. If you create a
|
|
28
|
-
*
|
|
29
|
-
*
|
|
30
|
-
*
|
|
31
|
-
*
|
|
32
|
-
* stack.</p>
|
|
27
|
+
* set shows all of the resources that CloudFormation will create. If you create a change
|
|
28
|
+
* set for an existing stack, CloudFormation compares the stack's information with the
|
|
29
|
+
* information that you submit in the change set and lists the differences. Use change sets to
|
|
30
|
+
* understand which resources CloudFormation will create or change, and how it will change
|
|
31
|
+
* resources in an existing stack, before you create or update a stack.</p>
|
|
33
32
|
* <p>To create a change set for a stack that doesn't exist, for the
|
|
34
33
|
* <code>ChangeSetType</code> parameter, specify <code>CREATE</code>. To create a change
|
|
35
34
|
* set for an existing stack, specify <code>UPDATE</code> for the <code>ChangeSetType</code>
|
|
@@ -39,8 +38,8 @@ export interface CreateChangeSetCommandOutput extends CreateChangeSetOutput, __M
|
|
|
39
38
|
* status of the change set or to review it, use the <a>DescribeChangeSet</a>
|
|
40
39
|
* action.</p>
|
|
41
40
|
* <p>When you are satisfied with the changes the change set will make, execute the change
|
|
42
|
-
* set by using the <a>ExecuteChangeSet</a> action. CloudFormation doesn't
|
|
43
|
-
*
|
|
41
|
+
* set by using the <a>ExecuteChangeSet</a> action. CloudFormation doesn't make
|
|
42
|
+
* changes until you execute the change set.</p>
|
|
44
43
|
* <p>To create a change set for the entire stack hierachy, set
|
|
45
44
|
* <code>IncludeNestedStacks</code> to <code>True</code>.</p>
|
|
46
45
|
* @example
|
|
@@ -22,9 +22,7 @@ export interface CreateStackInstancesCommandOutput extends CreateStackInstancesO
|
|
|
22
22
|
|
|
23
23
|
/**
|
|
24
24
|
* <p>Creates stack instances for the specified accounts, within the specified Regions. A
|
|
25
|
-
* stack instance refers to a stack in a specific account and Region. You must specify at
|
|
26
|
-
* least one value for either <code>Accounts</code> or <code>DeploymentTargets</code>, and you
|
|
27
|
-
* must specify at least one value for <code>Regions</code>.</p>
|
|
25
|
+
* stack instance refers to a stack in a specific account and Region. You must specify at least one value for either <code>Accounts</code> or <code>DeploymentTargets</code>, and you must specify at least one value for <code>Regions</code>.</p>
|
|
28
26
|
* @example
|
|
29
27
|
* Use a bare-bones client and the command you need to make an API call.
|
|
30
28
|
* ```javascript
|
|
@@ -21,7 +21,7 @@ export interface DeleteStackInstancesCommandInput extends DeleteStackInstancesIn
|
|
|
21
21
|
export interface DeleteStackInstancesCommandOutput extends DeleteStackInstancesOutput, __MetadataBearer {}
|
|
22
22
|
|
|
23
23
|
/**
|
|
24
|
-
* <p>Deletes stack instances for the specified accounts, in the specified Regions
|
|
24
|
+
* <p>Deletes stack instances for the specified accounts, in the specified Regions.</p>
|
|
25
25
|
* @example
|
|
26
26
|
* Use a bare-bones client and the command you need to make an API call.
|
|
27
27
|
* ```javascript
|
|
@@ -22,7 +22,7 @@ export interface DeleteStackSetCommandOutput extends DeleteStackSetOutput, __Met
|
|
|
22
22
|
|
|
23
23
|
/**
|
|
24
24
|
* <p>Deletes a stack set. Before you can delete a stack set, all of its member stack
|
|
25
|
-
* instances must be deleted. For more information about how to do this, see <a>DeleteStackInstances</a
|
|
25
|
+
* instances must be deleted. For more information about how to do this, see <a>DeleteStackInstances</a>.</p>
|
|
26
26
|
* @example
|
|
27
27
|
* Use a bare-bones client and the command you need to make an API call.
|
|
28
28
|
* ```javascript
|
|
@@ -23,8 +23,8 @@ export interface DescribeAccountLimitsCommandOutput extends DescribeAccountLimit
|
|
|
23
23
|
/**
|
|
24
24
|
* <p>Retrieves your account's CloudFormation limits, such as the maximum number of
|
|
25
25
|
* stacks that you can create in your account. For more information about account limits, see
|
|
26
|
-
* <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cloudformation-limits.html">CloudFormation
|
|
27
|
-
*
|
|
26
|
+
* <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cloudformation-limits.html">CloudFormation
|
|
27
|
+
* Limits</a> in the <i>CloudFormation User Guide</i>.</p>
|
|
28
28
|
* @example
|
|
29
29
|
* Use a bare-bones client and the command you need to make an API call.
|
|
30
30
|
* ```javascript
|
|
@@ -21,7 +21,8 @@ export interface DescribeChangeSetCommandInput extends DescribeChangeSetInput {}
|
|
|
21
21
|
export interface DescribeChangeSetCommandOutput extends DescribeChangeSetOutput, __MetadataBearer {}
|
|
22
22
|
|
|
23
23
|
/**
|
|
24
|
-
* <p>Returns the inputs for the change set and a list of changes that CloudFormation
|
|
24
|
+
* <p>Returns the inputs for the change set and a list of changes that CloudFormation
|
|
25
|
+
* will make if you execute the change set. For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-changesets.html">Updating Stacks Using Change Sets</a> in the CloudFormation User
|
|
25
26
|
* Guide.</p>
|
|
26
27
|
* @example
|
|
27
28
|
* Use a bare-bones client and the command you need to make an API call.
|