@aws-sdk/client-cloudformation 3.42.0 → 3.47.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 +51 -0
- package/README.md +11 -11
- package/dist-cjs/endpoints.js +1 -16
- package/dist-cjs/models/models_0.js +9 -135
- package/dist-cjs/protocols/Aws_query.js +48 -0
- package/dist-cjs/runtimeConfig.browser.js +7 -2
- package/dist-cjs/runtimeConfig.js +9 -3
- package/dist-es/endpoints.js +1 -16
- package/dist-es/models/models_0.js +4 -88
- package/dist-es/protocols/Aws_query.js +51 -0
- package/dist-es/runtimeConfig.browser.js +12 -3
- package/dist-es/runtimeConfig.js +13 -6
- package/dist-types/CloudFormation.d.ts +114 -117
- package/dist-types/CloudFormationClient.d.ts +16 -12
- 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 +653 -763
- package/dist-types/runtimeConfig.browser.d.ts +3 -2
- package/dist-types/runtimeConfig.d.ts +4 -3
- package/dist-types/runtimeConfig.native.d.ts +1 -0
- package/dist-types/ts3.4/CloudFormationClient.d.ts +3 -1
- package/dist-types/ts3.4/models/models_0.d.ts +20 -87
- package/dist-types/ts3.4/runtimeConfig.browser.d.ts +3 -2
- package/dist-types/ts3.4/runtimeConfig.d.ts +4 -3
- package/dist-types/ts3.4/runtimeConfig.native.d.ts +1 -0
- package/package.json +39 -46
|
@@ -3,9 +3,9 @@ export declare type AccountGateStatus = "FAILED" | "SKIPPED" | "SUCCEEDED";
|
|
|
3
3
|
/**
|
|
4
4
|
* <p>Structure that contains the results of the account gate function which CloudFormation invokes, if present, before proceeding with a stack set operation in an
|
|
5
5
|
* account and Region.</p>
|
|
6
|
-
* <p>For each account and Region, CloudFormation lets you specify a Lambda
|
|
7
|
-
*
|
|
8
|
-
*
|
|
6
|
+
* <p>For each account and Region, CloudFormation lets you specify a Lambda function
|
|
7
|
+
* that encapsulates any requirements that must be met before CloudFormation can
|
|
8
|
+
* proceed with a stack set operation in that account and Region. CloudFormation
|
|
9
9
|
* invokes the function each time a stack set operation is requested for that account and
|
|
10
10
|
* Region; if the function returns <code>FAILED</code>, CloudFormation cancels the
|
|
11
11
|
* operation in that account and Region, and sets the stack set operation result status for
|
|
@@ -19,17 +19,15 @@ export interface AccountGateResult {
|
|
|
19
19
|
* <ul>
|
|
20
20
|
* <li>
|
|
21
21
|
* <p>
|
|
22
|
-
* <code>SUCCEEDED</code>: The account gate function has determined that the
|
|
23
|
-
*
|
|
24
|
-
* CloudFormation proceeds with the stack operation in that account and Region.
|
|
22
|
+
* <code>SUCCEEDED</code>: The account gate function has determined that the account
|
|
23
|
+
* and Region passes any requirements for a stack set operation to occur. CloudFormation proceeds with the stack operation in that account and Region.
|
|
25
24
|
* </p>
|
|
26
25
|
* </li>
|
|
27
26
|
* <li>
|
|
28
27
|
* <p>
|
|
29
|
-
* <code>FAILED</code>: The account gate function has determined that the account
|
|
30
|
-
*
|
|
31
|
-
*
|
|
32
|
-
* the stack set operation result status for that account and Region to
|
|
28
|
+
* <code>FAILED</code>: The account gate function has determined that the account and
|
|
29
|
+
* Region does not meet the requirements for a stack set operation to occur. AWS CloudFormation cancels the stack set operation in that account and Region, and
|
|
30
|
+
* sets the stack set operation result status for that account and Region to
|
|
33
31
|
* <code>FAILED</code>. </p>
|
|
34
32
|
* </li>
|
|
35
33
|
* <li>
|
|
@@ -38,19 +36,18 @@ export interface AccountGateResult {
|
|
|
38
36
|
* function for this account and Region, for one of the following reasons:</p>
|
|
39
37
|
* <ul>
|
|
40
38
|
* <li>
|
|
41
|
-
* <p>An account gate function has not been specified for the account and
|
|
42
|
-
*
|
|
43
|
-
*
|
|
39
|
+
* <p>An account gate function has not been specified for the account and Region.
|
|
40
|
+
* CloudFormation proceeds with the stack set operation in this account
|
|
41
|
+
* and Region.</p>
|
|
44
42
|
* </li>
|
|
45
43
|
* <li>
|
|
46
44
|
* <p>The <code>AWSCloudFormationStackSetExecutionRole</code> of the stack set
|
|
47
|
-
* adminstration account lacks permissions to invoke the function.
|
|
48
|
-
* CloudFormation proceeds with the stack set operation in this account and
|
|
45
|
+
* adminstration account lacks permissions to invoke the function. CloudFormation proceeds with the stack set operation in this account and
|
|
49
46
|
* Region.</p>
|
|
50
47
|
* </li>
|
|
51
48
|
* <li>
|
|
52
49
|
* <p>Either no action is necessary, or no action is possible, on the stack.
|
|
53
|
-
*
|
|
50
|
+
* CloudFormation skips the stack set operation in this account and
|
|
54
51
|
* Region.</p>
|
|
55
52
|
* </li>
|
|
56
53
|
* </ul>
|
|
@@ -59,8 +56,8 @@ export interface AccountGateResult {
|
|
|
59
56
|
*/
|
|
60
57
|
Status?: AccountGateStatus | string;
|
|
61
58
|
/**
|
|
62
|
-
* <p>The reason for the account gate status assigned to this account and Region for the
|
|
63
|
-
*
|
|
59
|
+
* <p>The reason for the account gate status assigned to this account and Region for the stack
|
|
60
|
+
* set operation.</p>
|
|
64
61
|
*/
|
|
65
62
|
StatusReason?: string;
|
|
66
63
|
}
|
|
@@ -239,12 +236,6 @@ export interface CFNRegistryException extends __SmithyException, $MetadataBearer
|
|
|
239
236
|
$fault: "client";
|
|
240
237
|
Message?: string;
|
|
241
238
|
}
|
|
242
|
-
export declare namespace CFNRegistryException {
|
|
243
|
-
/**
|
|
244
|
-
* @internal
|
|
245
|
-
*/
|
|
246
|
-
const filterSensitiveLog: (obj: CFNRegistryException) => any;
|
|
247
|
-
}
|
|
248
239
|
/**
|
|
249
240
|
* <p>The specified extension does not exist in the CloudFormation registry.</p>
|
|
250
241
|
*/
|
|
@@ -253,12 +244,6 @@ export interface TypeNotFoundException extends __SmithyException, $MetadataBeare
|
|
|
253
244
|
$fault: "client";
|
|
254
245
|
Message?: string;
|
|
255
246
|
}
|
|
256
|
-
export declare namespace TypeNotFoundException {
|
|
257
|
-
/**
|
|
258
|
-
* @internal
|
|
259
|
-
*/
|
|
260
|
-
const filterSensitiveLog: (obj: TypeNotFoundException) => any;
|
|
261
|
-
}
|
|
262
247
|
/**
|
|
263
248
|
* <p>The resource with the name requested already exists.</p>
|
|
264
249
|
*/
|
|
@@ -267,12 +252,6 @@ export interface AlreadyExistsException extends __SmithyException, $MetadataBear
|
|
|
267
252
|
$fault: "client";
|
|
268
253
|
Message?: string;
|
|
269
254
|
}
|
|
270
|
-
export declare namespace AlreadyExistsException {
|
|
271
|
-
/**
|
|
272
|
-
* @internal
|
|
273
|
-
*/
|
|
274
|
-
const filterSensitiveLog: (obj: AlreadyExistsException) => any;
|
|
275
|
-
}
|
|
276
255
|
/**
|
|
277
256
|
* <p>[Service-managed permissions] Describes whether StackSets automatically deploys to
|
|
278
257
|
* Organizations accounts that are added to a target organization or organizational
|
|
@@ -452,12 +431,6 @@ export interface TypeConfigurationNotFoundException extends __SmithyException, $
|
|
|
452
431
|
$fault: "client";
|
|
453
432
|
Message?: string;
|
|
454
433
|
}
|
|
455
|
-
export declare namespace TypeConfigurationNotFoundException {
|
|
456
|
-
/**
|
|
457
|
-
* @internal
|
|
458
|
-
*/
|
|
459
|
-
const filterSensitiveLog: (obj: TypeConfigurationNotFoundException) => any;
|
|
460
|
-
}
|
|
461
434
|
export declare enum CallAs {
|
|
462
435
|
DELEGATED_ADMIN = "DELEGATED_ADMIN",
|
|
463
436
|
SELF = "SELF"
|
|
@@ -471,11 +444,11 @@ export interface CancelUpdateStackInput {
|
|
|
471
444
|
*/
|
|
472
445
|
StackName: string | undefined;
|
|
473
446
|
/**
|
|
474
|
-
* <p>A unique identifier for this <code>CancelUpdateStack</code> request. Specify this
|
|
475
|
-
*
|
|
447
|
+
* <p>A unique identifier for this <code>CancelUpdateStack</code> request. Specify this token
|
|
448
|
+
* if you plan to retry requests so that CloudFormation knows that you're not
|
|
476
449
|
* attempting to cancel an update on a stack with the same name. You might retry
|
|
477
|
-
*
|
|
478
|
-
* received them.</p>
|
|
450
|
+
* <code>CancelUpdateStack</code> requests to ensure that CloudFormation
|
|
451
|
+
* successfully received them.</p>
|
|
479
452
|
*/
|
|
480
453
|
ClientRequestToken?: string;
|
|
481
454
|
}
|
|
@@ -493,12 +466,6 @@ export interface TokenAlreadyExistsException extends __SmithyException, $Metadat
|
|
|
493
466
|
$fault: "client";
|
|
494
467
|
Message?: string;
|
|
495
468
|
}
|
|
496
|
-
export declare namespace TokenAlreadyExistsException {
|
|
497
|
-
/**
|
|
498
|
-
* @internal
|
|
499
|
-
*/
|
|
500
|
-
const filterSensitiveLog: (obj: TokenAlreadyExistsException) => any;
|
|
501
|
-
}
|
|
502
469
|
export declare enum Capability {
|
|
503
470
|
CAPABILITY_AUTO_EXPAND = "CAPABILITY_AUTO_EXPAND",
|
|
504
471
|
CAPABILITY_IAM = "CAPABILITY_IAM",
|
|
@@ -573,21 +540,19 @@ export declare namespace ResourceTargetDefinition {
|
|
|
573
540
|
const filterSensitiveLog: (obj: ResourceTargetDefinition) => any;
|
|
574
541
|
}
|
|
575
542
|
/**
|
|
576
|
-
* <p>For a resource with <code>Modify</code> as the action, the
|
|
577
|
-
*
|
|
578
|
-
* to that resource.</p>
|
|
543
|
+
* <p>For a resource with <code>Modify</code> as the action, the <code>ResourceChange</code>
|
|
544
|
+
* structure describes the changes CloudFormation will make to that resource.</p>
|
|
579
545
|
*/
|
|
580
546
|
export interface ResourceChangeDetail {
|
|
581
547
|
/**
|
|
582
|
-
* <p>A <code>ResourceTargetDefinition</code> structure that describes the field that
|
|
583
|
-
* CloudFormation will change and whether the resource will be recreated.</p>
|
|
548
|
+
* <p>A <code>ResourceTargetDefinition</code> structure that describes the field that CloudFormation will change and whether the resource will be recreated.</p>
|
|
584
549
|
*/
|
|
585
550
|
Target?: ResourceTargetDefinition;
|
|
586
551
|
/**
|
|
587
552
|
* <p>Indicates whether CloudFormation can determine the target value, and whether the
|
|
588
553
|
* target value will change before you execute a change set.</p>
|
|
589
|
-
* <p>For <code>Static</code> evaluations, CloudFormation can determine that the
|
|
590
|
-
* value will change, and its value. For example, if you directly modify the
|
|
554
|
+
* <p>For <code>Static</code> evaluations, CloudFormation can determine that the
|
|
555
|
+
* target value will change, and its value. For example, if you directly modify the
|
|
591
556
|
* <code>InstanceType</code> property of an EC2 instance, CloudFormation knows that
|
|
592
557
|
* this property value will change, and its value, so this is a <code>Static</code>
|
|
593
558
|
* evaluation.</p>
|
|
@@ -601,8 +566,8 @@ export interface ResourceChangeDetail {
|
|
|
601
566
|
*/
|
|
602
567
|
Evaluation?: EvaluationType | string;
|
|
603
568
|
/**
|
|
604
|
-
* <p>The group to which the <code>CausingEntity</code> value belongs. There are five
|
|
605
|
-
*
|
|
569
|
+
* <p>The group to which the <code>CausingEntity</code> value belongs. There are five entity
|
|
570
|
+
* groups:</p>
|
|
606
571
|
* <ul>
|
|
607
572
|
* <li>
|
|
608
573
|
* <p>
|
|
@@ -634,7 +599,7 @@ export interface ResourceChangeDetail {
|
|
|
634
599
|
* <code>AWS::CloudFormation::Stack</code> resource, CloudFormation sets the
|
|
635
600
|
* <code>ChangeSource</code> to <code>Automatic</code> because the nested stack's
|
|
636
601
|
* template might have changed. Changes to a nested stack's template aren't visible to
|
|
637
|
-
*
|
|
602
|
+
* CloudFormation until you run an update on the parent stack.</p>
|
|
638
603
|
* </li>
|
|
639
604
|
* </ul>
|
|
640
605
|
*/
|
|
@@ -645,8 +610,8 @@ export interface ResourceChangeDetail {
|
|
|
645
610
|
* modified the value of the <code>KeyPairName</code> parameter, the
|
|
646
611
|
* <code>CausingEntity</code> is the name of the parameter
|
|
647
612
|
* (<code>KeyPairName</code>).</p>
|
|
648
|
-
* <p>If the <code>ChangeSource</code> value is <code>DirectModification</code>, no value
|
|
649
|
-
*
|
|
613
|
+
* <p>If the <code>ChangeSource</code> value is <code>DirectModification</code>, no value is
|
|
614
|
+
* given for <code>CausingEntity</code>.</p>
|
|
650
615
|
*/
|
|
651
616
|
CausingEntity?: string;
|
|
652
617
|
}
|
|
@@ -704,7 +669,7 @@ export declare enum Replacement {
|
|
|
704
669
|
}
|
|
705
670
|
/**
|
|
706
671
|
* <p>The <code>ResourceChange</code> structure describes the resource and the action that
|
|
707
|
-
*
|
|
672
|
+
* CloudFormation will perform on it if you execute this change set.</p>
|
|
708
673
|
*/
|
|
709
674
|
export interface ResourceChange {
|
|
710
675
|
/**
|
|
@@ -729,17 +694,17 @@ export interface ResourceChange {
|
|
|
729
694
|
*/
|
|
730
695
|
ResourceType?: string;
|
|
731
696
|
/**
|
|
732
|
-
* <p>For the <code>Modify</code> action, indicates whether CloudFormation will
|
|
733
|
-
* the resource by creating a new one and deleting the old one. This value depends on
|
|
734
|
-
* value of the <code>RequiresRecreation</code> property in the
|
|
697
|
+
* <p>For the <code>Modify</code> action, indicates whether CloudFormation will
|
|
698
|
+
* replace the resource by creating a new one and deleting the old one. This value depends on
|
|
699
|
+
* the value of the <code>RequiresRecreation</code> property in the
|
|
735
700
|
* <code>ResourceTargetDefinition</code> structure. For example, if the
|
|
736
701
|
* <code>RequiresRecreation</code> field is <code>Always</code> and the
|
|
737
702
|
* <code>Evaluation</code> field is <code>Static</code>, <code>Replacement</code> is
|
|
738
703
|
* <code>True</code>. If the <code>RequiresRecreation</code> field is <code>Always</code>
|
|
739
704
|
* and the <code>Evaluation</code> field is <code>Dynamic</code>, <code>Replacement</code> is
|
|
740
705
|
* <code>Conditionally</code>.</p>
|
|
741
|
-
* <p>If you have multiple changes with different <code>RequiresRecreation</code> values,
|
|
742
|
-
*
|
|
706
|
+
* <p>If you have multiple changes with different <code>RequiresRecreation</code> values, the
|
|
707
|
+
* <code>Replacement</code> value depends on the change with the most impact. A
|
|
743
708
|
* <code>RequiresRecreation</code> value of <code>Always</code> has the most impact,
|
|
744
709
|
* followed by <code>Conditionally</code>, and then <code>Never</code>.</p>
|
|
745
710
|
*/
|
|
@@ -752,8 +717,8 @@ export interface ResourceChange {
|
|
|
752
717
|
Scope?: (ResourceAttribute | string)[];
|
|
753
718
|
/**
|
|
754
719
|
* <p>For the <code>Modify</code> action, a list of <code>ResourceChangeDetail</code>
|
|
755
|
-
* structures that describes the changes that CloudFormation will make to the
|
|
756
|
-
*
|
|
720
|
+
* structures that describes the changes that CloudFormation will make to the
|
|
721
|
+
* resource. </p>
|
|
757
722
|
*/
|
|
758
723
|
Details?: ResourceChangeDetail[];
|
|
759
724
|
/**
|
|
@@ -787,7 +752,7 @@ export interface Change {
|
|
|
787
752
|
Type?: ChangeType | string;
|
|
788
753
|
/**
|
|
789
754
|
* <p>A <code>ResourceChange</code> structure that describes the resource and action that
|
|
790
|
-
*
|
|
755
|
+
* CloudFormation will perform.</p>
|
|
791
756
|
*/
|
|
792
757
|
ResourceChange?: ResourceChange;
|
|
793
758
|
}
|
|
@@ -798,20 +763,14 @@ export declare namespace Change {
|
|
|
798
763
|
const filterSensitiveLog: (obj: Change) => any;
|
|
799
764
|
}
|
|
800
765
|
/**
|
|
801
|
-
* <p>The specified change set name or ID doesn't exit. To view valid change sets for a
|
|
802
|
-
*
|
|
766
|
+
* <p>The specified change set name or ID doesn't exit. To view valid change sets for a stack,
|
|
767
|
+
* use the <code>ListChangeSets</code> action.</p>
|
|
803
768
|
*/
|
|
804
769
|
export interface ChangeSetNotFoundException extends __SmithyException, $MetadataBearer {
|
|
805
770
|
name: "ChangeSetNotFoundException";
|
|
806
771
|
$fault: "client";
|
|
807
772
|
Message?: string;
|
|
808
773
|
}
|
|
809
|
-
export declare namespace ChangeSetNotFoundException {
|
|
810
|
-
/**
|
|
811
|
-
* @internal
|
|
812
|
-
*/
|
|
813
|
-
const filterSensitiveLog: (obj: ChangeSetNotFoundException) => any;
|
|
814
|
-
}
|
|
815
774
|
export declare enum ChangeSetStatus {
|
|
816
775
|
CREATE_COMPLETE = "CREATE_COMPLETE",
|
|
817
776
|
CREATE_IN_PROGRESS = "CREATE_IN_PROGRESS",
|
|
@@ -831,8 +790,8 @@ export declare enum ExecutionStatus {
|
|
|
831
790
|
UNAVAILABLE = "UNAVAILABLE"
|
|
832
791
|
}
|
|
833
792
|
/**
|
|
834
|
-
* <p>The <code>ChangeSetSummary</code> structure describes a change set, its status, and
|
|
835
|
-
*
|
|
793
|
+
* <p>The <code>ChangeSetSummary</code> structure describes a change set, its status, and the
|
|
794
|
+
* stack with which it's associated.</p>
|
|
836
795
|
*/
|
|
837
796
|
export interface ChangeSetSummary {
|
|
838
797
|
/**
|
|
@@ -852,10 +811,10 @@ export interface ChangeSetSummary {
|
|
|
852
811
|
*/
|
|
853
812
|
ChangeSetName?: string;
|
|
854
813
|
/**
|
|
855
|
-
* <p>If the change set execution status is <code>AVAILABLE</code>, you can execute the
|
|
856
|
-
*
|
|
857
|
-
*
|
|
858
|
-
*
|
|
814
|
+
* <p>If the change set execution status is <code>AVAILABLE</code>, you can execute the change
|
|
815
|
+
* set. If you can’t execute the change set, the status indicates why. For example, a change
|
|
816
|
+
* set might be in an <code>UNAVAILABLE</code> state because CloudFormation is still
|
|
817
|
+
* creating it or in an <code>OBSOLETE</code> state because the stack was already
|
|
859
818
|
* updated.</p>
|
|
860
819
|
*/
|
|
861
820
|
ExecutionStatus?: ExecutionStatus | string;
|
|
@@ -907,8 +866,7 @@ export declare enum ChangeSetType {
|
|
|
907
866
|
*/
|
|
908
867
|
export interface ContinueUpdateRollbackInput {
|
|
909
868
|
/**
|
|
910
|
-
* <p>The name or the unique ID of the stack that you want to continue rolling
|
|
911
|
-
* back.</p>
|
|
869
|
+
* <p>The name or the unique ID of the stack that you want to continue rolling back.</p>
|
|
912
870
|
* <note>
|
|
913
871
|
* <p>Don't specify the name of a nested stack (a stack that was created by using the
|
|
914
872
|
* <code>AWS::CloudFormation::Stack</code> resource). Instead, use this operation on the
|
|
@@ -918,12 +876,11 @@ export interface ContinueUpdateRollbackInput {
|
|
|
918
876
|
*/
|
|
919
877
|
StackName: string | undefined;
|
|
920
878
|
/**
|
|
921
|
-
* <p>The Amazon Resource Name (ARN) of an Identity and Access Management (IAM) role
|
|
922
|
-
*
|
|
923
|
-
*
|
|
924
|
-
*
|
|
925
|
-
*
|
|
926
|
-
* Ensure that the role grants least privilege.</p>
|
|
879
|
+
* <p>The Amazon Resource Name (ARN) of an Identity and Access Management (IAM) role that CloudFormation assumes to roll back the stack. CloudFormation uses the role's
|
|
880
|
+
* credentials to make calls on your behalf. CloudFormation always uses this role for
|
|
881
|
+
* all future operations on the stack. As long as users have permission to operate on the
|
|
882
|
+
* stack, CloudFormation uses this role even if the users don't have permission to
|
|
883
|
+
* pass it. Ensure that the role grants least privilege.</p>
|
|
927
884
|
* <p>If you don't specify a value, CloudFormation uses the role that was previously
|
|
928
885
|
* associated with the stack. If no role is available, CloudFormation uses a temporary
|
|
929
886
|
* session that is generated from your user credentials.</p>
|
|
@@ -962,10 +919,10 @@ export interface ContinueUpdateRollbackInput {
|
|
|
962
919
|
*/
|
|
963
920
|
ResourcesToSkip?: string[];
|
|
964
921
|
/**
|
|
965
|
-
* <p>A unique identifier for this <code>ContinueUpdateRollback</code> request. Specify
|
|
966
|
-
*
|
|
922
|
+
* <p>A unique identifier for this <code>ContinueUpdateRollback</code> request. Specify this
|
|
923
|
+
* token if you plan to retry requests so that CloudFormationknows that you're not
|
|
967
924
|
* attempting to continue the rollback to a stack with the same name. You might retry
|
|
968
|
-
*
|
|
925
|
+
* <code>ContinueUpdateRollback</code> requests to ensure that CloudFormation
|
|
969
926
|
* successfully received them.</p>
|
|
970
927
|
*/
|
|
971
928
|
ClientRequestToken?: string;
|
|
@@ -993,8 +950,8 @@ export declare namespace ContinueUpdateRollbackOutput {
|
|
|
993
950
|
export interface Parameter {
|
|
994
951
|
/**
|
|
995
952
|
* <p>The key associated with the parameter. If you don't specify a key and value for a
|
|
996
|
-
* particular parameter, CloudFormation uses the default value that is specified in
|
|
997
|
-
* template.</p>
|
|
953
|
+
* particular parameter, CloudFormation uses the default value that is specified in
|
|
954
|
+
* your template.</p>
|
|
998
955
|
*/
|
|
999
956
|
ParameterKey?: string;
|
|
1000
957
|
/**
|
|
@@ -1008,9 +965,10 @@ export interface Parameter {
|
|
|
1008
965
|
*/
|
|
1009
966
|
UsePreviousValue?: boolean;
|
|
1010
967
|
/**
|
|
1011
|
-
* <p>Read-only. The value that corresponds to a
|
|
1012
|
-
* is returned only for <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/parameters-section-structure.html#aws-ssm-parameter-types">
|
|
1013
|
-
* <code>SSM</code>
|
|
968
|
+
* <p>Read-only. Read-only. The value that corresponds to a SSM parameter key.
|
|
969
|
+
* This field is returned only for <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/parameters-section-structure.html#aws-ssm-parameter-types">
|
|
970
|
+
* <code>SSM</code>
|
|
971
|
+
* </a> parameter types in the template.</p>
|
|
1014
972
|
*/
|
|
1015
973
|
ResolvedValue?: string;
|
|
1016
974
|
}
|
|
@@ -1050,20 +1008,20 @@ export declare namespace ResourceToImport {
|
|
|
1050
1008
|
const filterSensitiveLog: (obj: ResourceToImport) => any;
|
|
1051
1009
|
}
|
|
1052
1010
|
/**
|
|
1053
|
-
* <p>A rollback trigger CloudFormation monitors during creation and updating of stacks. If any of
|
|
1054
|
-
*
|
|
1055
|
-
*
|
|
1011
|
+
* <p>A rollback trigger CloudFormation monitors during creation and updating of stacks. If any of the
|
|
1012
|
+
* alarms you specify goes to ALARM state during the stack operation or within the specified
|
|
1013
|
+
* monitoring period afterwards, CloudFormation rolls back the entire stack
|
|
1056
1014
|
* operation. </p>
|
|
1057
1015
|
*/
|
|
1058
1016
|
export interface RollbackTrigger {
|
|
1059
1017
|
/**
|
|
1060
1018
|
* <p>The Amazon Resource Name (ARN) of the rollback trigger.</p>
|
|
1061
|
-
* <p>If a specified trigger is missing, the entire stack operation fails and is rolled
|
|
1062
|
-
*
|
|
1019
|
+
* <p>If a specified trigger is missing, the entire stack operation fails and is rolled back.
|
|
1020
|
+
* </p>
|
|
1063
1021
|
*/
|
|
1064
1022
|
Arn: string | undefined;
|
|
1065
1023
|
/**
|
|
1066
|
-
* <p>The resource type of the rollback trigger.
|
|
1024
|
+
* <p>The resource type of the rollback trigger. Specify either <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-cw-alarm.html">AWS::CloudWatch::Alarm</a> or <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudwatch-compositealarm.html">AWS::CloudWatch::CompositeAlarm</a> resource types.</p>
|
|
1067
1025
|
*/
|
|
1068
1026
|
Type: string | undefined;
|
|
1069
1027
|
}
|
|
@@ -1076,17 +1034,16 @@ export declare namespace RollbackTrigger {
|
|
|
1076
1034
|
/**
|
|
1077
1035
|
* <p>Structure containing the rollback triggers for CloudFormation to monitor during stack creation
|
|
1078
1036
|
* and updating operations, and for the specified monitoring period afterwards.</p>
|
|
1079
|
-
* <p>Rollback triggers enable you to have CloudFormation monitor the state of your application
|
|
1080
|
-
*
|
|
1081
|
-
*
|
|
1082
|
-
* <a href="http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-rollback-triggers.html">Monitor and Roll Back Stack
|
|
1037
|
+
* <p>Rollback triggers enable you to have CloudFormation monitor the state of your application during
|
|
1038
|
+
* stack creation and updating, and to roll back that operation if the application breaches
|
|
1039
|
+
* the threshold of any of the alarms you've specified. For more information, see <a href="http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-rollback-triggers.html">Monitor and Roll Back Stack
|
|
1083
1040
|
* Operations</a>.</p>
|
|
1084
1041
|
*/
|
|
1085
1042
|
export interface RollbackConfiguration {
|
|
1086
1043
|
/**
|
|
1087
1044
|
* <p>The triggers to monitor during stack creation or update actions. </p>
|
|
1088
|
-
* <p>By default, CloudFormation saves the rollback triggers specified for a stack and applies them
|
|
1089
|
-
*
|
|
1045
|
+
* <p>By default, CloudFormation saves the rollback triggers specified for a stack and applies them to
|
|
1046
|
+
* any subsequent update operations for the stack, unless you specify otherwise. If you do
|
|
1090
1047
|
* specify rollback triggers for this parameter, those triggers replace any list of triggers
|
|
1091
1048
|
* previously specified for the stack. This means:</p>
|
|
1092
1049
|
* <ul>
|
|
@@ -1106,22 +1063,22 @@ export interface RollbackConfiguration {
|
|
|
1106
1063
|
* parameter.</p>
|
|
1107
1064
|
* </li>
|
|
1108
1065
|
* </ul>
|
|
1109
|
-
* <p>If a specified trigger is missing, the entire stack operation fails and is rolled
|
|
1110
|
-
*
|
|
1066
|
+
* <p>If a specified trigger is missing, the entire stack operation fails and is rolled back.
|
|
1067
|
+
* </p>
|
|
1111
1068
|
*/
|
|
1112
1069
|
RollbackTriggers?: RollbackTrigger[];
|
|
1113
1070
|
/**
|
|
1114
|
-
* <p>The amount of time, in minutes, during which CloudFormation should monitor all
|
|
1115
|
-
* rollback triggers after the stack creation or update operation deploys all necessary
|
|
1071
|
+
* <p>The amount of time, in minutes, during which CloudFormation should monitor all
|
|
1072
|
+
* the rollback triggers after the stack creation or update operation deploys all necessary
|
|
1116
1073
|
* resources.</p>
|
|
1117
1074
|
* <p>The default is 0 minutes.</p>
|
|
1118
|
-
* <p>If you specify a monitoring period but do not specify any rollback triggers,
|
|
1119
|
-
*
|
|
1120
|
-
*
|
|
1121
|
-
*
|
|
1122
|
-
*
|
|
1123
|
-
*
|
|
1124
|
-
*
|
|
1075
|
+
* <p>If you specify a monitoring period but do not specify any rollback triggers, CloudFormation still waits the specified period of time before cleaning up old
|
|
1076
|
+
* resources after update operations. You can use this monitoring period to perform any manual
|
|
1077
|
+
* stack validation desired, and manually cancel the stack creation or update (using <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_CancelUpdateStack.html">CancelUpdateStack</a>, for example) as necessary.</p>
|
|
1078
|
+
* <p>If you specify 0 for this parameter, CloudFormation still monitors the
|
|
1079
|
+
* specified rollback triggers during stack creation and update operations. Then, for update
|
|
1080
|
+
* operations, it begins disposing of old resources immediately once the operation
|
|
1081
|
+
* completes.</p>
|
|
1125
1082
|
*/
|
|
1126
1083
|
MonitoringTimeInMinutes?: number;
|
|
1127
1084
|
}
|
|
@@ -1139,8 +1096,7 @@ export interface Tag {
|
|
|
1139
1096
|
/**
|
|
1140
1097
|
* <p>
|
|
1141
1098
|
* <i>Required</i>. A string used to identify this tag. You can specify a
|
|
1142
|
-
* maximum of 128 characters for a tag key. Tags owned by Amazon Web Services (Amazon Web Services) have the
|
|
1143
|
-
* reserved prefix: <code>aws:</code>.</p>
|
|
1099
|
+
* maximum of 128 characters for a tag key. Tags owned by Amazon Web Services (Amazon Web Services) have the reserved prefix: <code>aws:</code>.</p>
|
|
1144
1100
|
*/
|
|
1145
1101
|
Key: string | undefined;
|
|
1146
1102
|
/**
|
|
@@ -1161,27 +1117,26 @@ export declare namespace Tag {
|
|
|
1161
1117
|
*/
|
|
1162
1118
|
export interface CreateChangeSetInput {
|
|
1163
1119
|
/**
|
|
1164
|
-
* <p>The name or the unique ID of the stack for which you are creating a change set.
|
|
1165
|
-
* CloudFormation generates the change set by comparing this stack's information with the
|
|
1120
|
+
* <p>The name or the unique ID of the stack for which you are creating a change set. CloudFormation generates the change set by comparing this stack's information with the
|
|
1166
1121
|
* information that you submit, such as a modified template or different parameter input
|
|
1167
1122
|
* values.</p>
|
|
1168
1123
|
*/
|
|
1169
1124
|
StackName: string | undefined;
|
|
1170
1125
|
/**
|
|
1171
|
-
* <p>A structure that contains the body of the revised template, with a minimum length of
|
|
1172
|
-
*
|
|
1173
|
-
* comparing this template with the template of the stack that you specified.</p>
|
|
1126
|
+
* <p>A structure that contains the body of the revised template, with a minimum length of 1
|
|
1127
|
+
* byte and a maximum length of 51,200 bytes. CloudFormation generates the change set
|
|
1128
|
+
* by comparing this template with the template of the stack that you specified.</p>
|
|
1174
1129
|
* <p>Conditional: You must specify only <code>TemplateBody</code> or
|
|
1175
|
-
*
|
|
1130
|
+
* <code>TemplateURL</code>.</p>
|
|
1176
1131
|
*/
|
|
1177
1132
|
TemplateBody?: string;
|
|
1178
1133
|
/**
|
|
1179
1134
|
* <p>The location of the file that contains the revised template. The URL must point to a
|
|
1180
1135
|
* template (max size: 460,800 bytes) that is located in an S3 bucket or a Systems Manager
|
|
1181
|
-
* document. CloudFormation generates the change set by comparing this template with
|
|
1182
|
-
* stack that you specified.</p>
|
|
1136
|
+
* document. CloudFormation generates the change set by comparing this template with
|
|
1137
|
+
* the stack that you specified.</p>
|
|
1183
1138
|
* <p>Conditional: You must specify only <code>TemplateBody</code> or
|
|
1184
|
-
*
|
|
1139
|
+
* <code>TemplateURL</code>.</p>
|
|
1185
1140
|
*/
|
|
1186
1141
|
TemplateURL?: string;
|
|
1187
1142
|
/**
|
|
@@ -1190,8 +1145,8 @@ export interface CreateChangeSetInput {
|
|
|
1190
1145
|
*/
|
|
1191
1146
|
UsePreviousTemplate?: boolean;
|
|
1192
1147
|
/**
|
|
1193
|
-
* <p>A list of <code>Parameter</code> structures that specify input parameters for the
|
|
1194
|
-
*
|
|
1148
|
+
* <p>A list of <code>Parameter</code> structures that specify input parameters for the change
|
|
1149
|
+
* set. For more information, see the <a>Parameter</a> data type.</p>
|
|
1195
1150
|
*/
|
|
1196
1151
|
Parameters?: Parameter[];
|
|
1197
1152
|
/**
|
|
@@ -1202,8 +1157,8 @@ export interface CreateChangeSetInput {
|
|
|
1202
1157
|
* <p>
|
|
1203
1158
|
* <code>CAPABILITY_IAM</code> and <code>CAPABILITY_NAMED_IAM</code>
|
|
1204
1159
|
* </p>
|
|
1205
|
-
* <p>Some stack templates might include resources that can affect permissions in
|
|
1206
|
-
*
|
|
1160
|
+
* <p>Some stack templates might include resources that can affect permissions in your
|
|
1161
|
+
* Amazon Web Services account; for example, by creating new Identity and Access Management
|
|
1207
1162
|
* (IAM) users. For those stacks, you must explicitly acknowledge this by specifying one
|
|
1208
1163
|
* of these capabilities.</p>
|
|
1209
1164
|
* <p>The following IAM resources require you to specify either the
|
|
@@ -1223,9 +1178,8 @@ export interface CreateChangeSetInput {
|
|
|
1223
1178
|
* <code>InsufficientCapabilities</code> error.</p>
|
|
1224
1179
|
* </li>
|
|
1225
1180
|
* </ul>
|
|
1226
|
-
* <p>If your stack template contains these resources, we recommend that you review
|
|
1227
|
-
*
|
|
1228
|
-
* necessary.</p>
|
|
1181
|
+
* <p>If your stack template contains these resources, we recommend that you review all
|
|
1182
|
+
* permissions associated with them and edit their permissions if necessary.</p>
|
|
1229
1183
|
* <ul>
|
|
1230
1184
|
* <li>
|
|
1231
1185
|
* <p>
|
|
@@ -1297,24 +1251,23 @@ export interface CreateChangeSetInput {
|
|
|
1297
1251
|
*/
|
|
1298
1252
|
Capabilities?: (Capability | string)[];
|
|
1299
1253
|
/**
|
|
1300
|
-
* <p>The template resource types that you have permissions to work with if you execute
|
|
1301
|
-
*
|
|
1254
|
+
* <p>The template resource types that you have permissions to work with if you execute this
|
|
1255
|
+
* change set, such as <code>AWS::EC2::Instance</code>, <code>AWS::EC2::*</code>, or
|
|
1302
1256
|
* <code>Custom::MyCustomInstance</code>.</p>
|
|
1303
|
-
* <p>If the list of resource types doesn't include a resource type that you're updating,
|
|
1304
|
-
*
|
|
1305
|
-
* types. Identity and Access Management (IAM) uses this parameter for condition keys in
|
|
1306
|
-
*
|
|
1307
|
-
*
|
|
1308
|
-
* Guide.</p>
|
|
1257
|
+
* <p>If the list of resource types doesn't include a resource type that you're updating, the
|
|
1258
|
+
* stack update fails. By default, CloudFormation grants permissions to all resource
|
|
1259
|
+
* types. Identity and Access Management (IAM) uses this parameter for condition keys in IAM policies
|
|
1260
|
+
* for CloudFormation. For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html">Controlling Access with
|
|
1261
|
+
* Identity and Access Management</a> in the CloudFormation User Guide.</p>
|
|
1309
1262
|
*/
|
|
1310
1263
|
ResourceTypes?: string[];
|
|
1311
1264
|
/**
|
|
1312
1265
|
* <p>The Amazon Resource Name (ARN) of an Identity and Access Management (IAM) role
|
|
1313
|
-
* that CloudFormation assumes when executing the change set. CloudFormation
|
|
1314
|
-
* role's credentials to make calls on your behalf. CloudFormation uses this
|
|
1315
|
-
* future operations on the stack. As long as users have permission to operate on
|
|
1316
|
-
* CloudFormation uses this role even if the users don't have permission to
|
|
1317
|
-
* Ensure that the role grants least privilege.</p>
|
|
1266
|
+
* that CloudFormation assumes when executing the change set. CloudFormation
|
|
1267
|
+
* uses the role's credentials to make calls on your behalf. CloudFormation uses this
|
|
1268
|
+
* role for all future operations on the stack. As long as users have permission to operate on
|
|
1269
|
+
* the stack, CloudFormation uses this role even if the users don't have permission to
|
|
1270
|
+
* pass it. Ensure that the role grants least privilege.</p>
|
|
1318
1271
|
* <p>If you don't specify a value, CloudFormation uses the role that was previously
|
|
1319
1272
|
* associated with the stack. If no role is available, CloudFormation uses a temporary
|
|
1320
1273
|
* session that is generated from your user credentials.</p>
|
|
@@ -1339,14 +1292,13 @@ export interface CreateChangeSetInput {
|
|
|
1339
1292
|
/**
|
|
1340
1293
|
* <p>The name of the change set. The name must be unique among all change sets that are
|
|
1341
1294
|
* associated with the specified stack.</p>
|
|
1342
|
-
* <p>A change set name can contain only alphanumeric, case sensitive characters and
|
|
1343
|
-
*
|
|
1344
|
-
* characters.</p>
|
|
1295
|
+
* <p>A change set name can contain only alphanumeric, case sensitive characters and hyphens.
|
|
1296
|
+
* It must start with an alphabetic character and cannot exceed 128 characters.</p>
|
|
1345
1297
|
*/
|
|
1346
1298
|
ChangeSetName: string | undefined;
|
|
1347
1299
|
/**
|
|
1348
|
-
* <p>A unique identifier for this <code>CreateChangeSet</code> request. Specify this token
|
|
1349
|
-
*
|
|
1300
|
+
* <p>A unique identifier for this <code>CreateChangeSet</code> request. Specify this token if
|
|
1301
|
+
* you plan to retry requests so that CloudFormation knows that you're not attempting
|
|
1350
1302
|
* to create another change set with the same name. You might retry
|
|
1351
1303
|
* <code>CreateChangeSet</code> requests to ensure that CloudFormation successfully
|
|
1352
1304
|
* received them.</p>
|
|
@@ -1361,8 +1313,8 @@ export interface CreateChangeSetInput {
|
|
|
1361
1313
|
* <code>CREATE</code>. To create a change set for an existing stack, specify
|
|
1362
1314
|
* <code>UPDATE</code>. To create a change set for an import operation, specify
|
|
1363
1315
|
* <code>IMPORT</code>.</p>
|
|
1364
|
-
* <p>If you create a change set for a new stack, CloudFormation creates a stack with
|
|
1365
|
-
* unique stack ID, but no template or resources. The stack will be in the <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-describing-stacks.html#d0e11995">
|
|
1316
|
+
* <p>If you create a change set for a new stack, CloudFormation creates a stack with
|
|
1317
|
+
* a unique stack ID, but no template or resources. The stack will be in the <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-describing-stacks.html#d0e11995">
|
|
1366
1318
|
* <code>REVIEW_IN_PROGRESS</code>
|
|
1367
1319
|
* </a> state until you execute the change
|
|
1368
1320
|
* set.</p>
|
|
@@ -1416,12 +1368,6 @@ export interface InsufficientCapabilitiesException extends __SmithyException, $M
|
|
|
1416
1368
|
$fault: "client";
|
|
1417
1369
|
Message?: string;
|
|
1418
1370
|
}
|
|
1419
|
-
export declare namespace InsufficientCapabilitiesException {
|
|
1420
|
-
/**
|
|
1421
|
-
* @internal
|
|
1422
|
-
*/
|
|
1423
|
-
const filterSensitiveLog: (obj: InsufficientCapabilitiesException) => any;
|
|
1424
|
-
}
|
|
1425
1371
|
/**
|
|
1426
1372
|
* <p>The quota for the resource has already been reached.</p>
|
|
1427
1373
|
* <p>For information on resource and stack limitations, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cloudformation-limits.html">Limits</a> in
|
|
@@ -1432,12 +1378,6 @@ export interface LimitExceededException extends __SmithyException, $MetadataBear
|
|
|
1432
1378
|
$fault: "client";
|
|
1433
1379
|
Message?: string;
|
|
1434
1380
|
}
|
|
1435
|
-
export declare namespace LimitExceededException {
|
|
1436
|
-
/**
|
|
1437
|
-
* @internal
|
|
1438
|
-
*/
|
|
1439
|
-
const filterSensitiveLog: (obj: LimitExceededException) => any;
|
|
1440
|
-
}
|
|
1441
1381
|
export declare enum OnFailure {
|
|
1442
1382
|
DELETE = "DELETE",
|
|
1443
1383
|
DO_NOTHING = "DO_NOTHING",
|
|
@@ -1475,14 +1415,14 @@ export interface CreateStackInput {
|
|
|
1475
1415
|
*/
|
|
1476
1416
|
TemplateURL?: string;
|
|
1477
1417
|
/**
|
|
1478
|
-
* <p>A list of <code>Parameter</code> structures that specify input parameters for the
|
|
1479
|
-
*
|
|
1418
|
+
* <p>A list of <code>Parameter</code> structures that specify input parameters for the stack.
|
|
1419
|
+
* For more information, see the <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_Parameter.html">Parameter</a> data
|
|
1480
1420
|
* type.</p>
|
|
1481
1421
|
*/
|
|
1482
1422
|
Parameters?: Parameter[];
|
|
1483
1423
|
/**
|
|
1484
|
-
* <p>Set to <code>true</code> to disable rollback of the stack if stack creation failed.
|
|
1485
|
-
*
|
|
1424
|
+
* <p>Set to <code>true</code> to disable rollback of the stack if stack creation failed. You
|
|
1425
|
+
* can specify either <code>DisableRollback</code> or <code>OnFailure</code>, but not
|
|
1486
1426
|
* both.</p>
|
|
1487
1427
|
* <p>Default: <code>false</code>
|
|
1488
1428
|
* </p>
|
|
@@ -1513,8 +1453,8 @@ export interface CreateStackInput {
|
|
|
1513
1453
|
* <p>
|
|
1514
1454
|
* <code>CAPABILITY_IAM</code> and <code>CAPABILITY_NAMED_IAM</code>
|
|
1515
1455
|
* </p>
|
|
1516
|
-
* <p>Some stack templates might include resources that can affect permissions in
|
|
1517
|
-
*
|
|
1456
|
+
* <p>Some stack templates might include resources that can affect permissions in your
|
|
1457
|
+
* Amazon Web Services account; for example, by creating new Identity and Access Management
|
|
1518
1458
|
* (IAM) users. For those stacks, you must explicitly acknowledge this by specifying one
|
|
1519
1459
|
* of these capabilities.</p>
|
|
1520
1460
|
* <p>The following IAM resources require you to specify either the
|
|
@@ -1533,9 +1473,8 @@ export interface CreateStackInput {
|
|
|
1533
1473
|
* <code>InsufficientCapabilities</code> error.</p>
|
|
1534
1474
|
* </li>
|
|
1535
1475
|
* </ul>
|
|
1536
|
-
* <p>If your stack template contains these resources, we recommend that you review
|
|
1537
|
-
*
|
|
1538
|
-
* necessary.</p>
|
|
1476
|
+
* <p>If your stack template contains these resources, we recommend that you review all
|
|
1477
|
+
* permissions associated with them and edit their permissions if necessary.</p>
|
|
1539
1478
|
* <ul>
|
|
1540
1479
|
* <li>
|
|
1541
1480
|
* <p>
|
|
@@ -1611,8 +1550,8 @@ export interface CreateStackInput {
|
|
|
1611
1550
|
*/
|
|
1612
1551
|
Capabilities?: (Capability | string)[];
|
|
1613
1552
|
/**
|
|
1614
|
-
* <p>The template resource types that you have permissions to work with for this create
|
|
1615
|
-
*
|
|
1553
|
+
* <p>The template resource types that you have permissions to work with for this create stack
|
|
1554
|
+
* action, such as <code>AWS::EC2::Instance</code>, <code>AWS::EC2::*</code>, or
|
|
1616
1555
|
* <code>Custom::MyCustomInstance</code>. Use the following syntax to describe template
|
|
1617
1556
|
* resource types: <code>AWS::*</code> (for all Amazon Web Services resources),
|
|
1618
1557
|
* <code>Custom::*</code> (for all custom resources),
|
|
@@ -1621,19 +1560,20 @@ export interface CreateStackInput {
|
|
|
1621
1560
|
* <code>AWS::<i>service_name</i>::*</code> (for all resources of a
|
|
1622
1561
|
* particular Amazon Web Services service), and
|
|
1623
1562
|
* <code>AWS::<i>service_name</i>::<i>resource_logical_ID</i>
|
|
1624
|
-
*
|
|
1625
|
-
* <p>If the list of resource types doesn't include a resource that you're creating, the
|
|
1626
|
-
*
|
|
1627
|
-
* types. Identity and Access Management (IAM) uses this parameter for CloudFormation-specific
|
|
1563
|
+
* </code> (for a specific Amazon Web Services resource).</p>
|
|
1564
|
+
* <p>If the list of resource types doesn't include a resource that you're creating, the stack
|
|
1565
|
+
* creation fails. By default, CloudFormation grants permissions to all resource
|
|
1566
|
+
* types. Identity and Access Management (IAM) uses this parameter for CloudFormation-specific
|
|
1567
|
+
* condition keys in IAM policies. For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html">Controlling Access with
|
|
1568
|
+
* Identity and Access Management</a>.</p>
|
|
1628
1569
|
*/
|
|
1629
1570
|
ResourceTypes?: string[];
|
|
1630
1571
|
/**
|
|
1631
|
-
* <p>The Amazon Resource Name (ARN) of an Identity and Access Management (IAM) role
|
|
1632
|
-
*
|
|
1633
|
-
*
|
|
1634
|
-
*
|
|
1635
|
-
*
|
|
1636
|
-
* Ensure that the role grants least privilege.</p>
|
|
1572
|
+
* <p>The Amazon Resource Name (ARN) of an Identity and Access Management (IAM) role that CloudFormation assumes to create the stack. CloudFormation uses the role's
|
|
1573
|
+
* credentials to make calls on your behalf. CloudFormation always uses this role for
|
|
1574
|
+
* all future operations on the stack. As long as users have permission to operate on the
|
|
1575
|
+
* stack, CloudFormation uses this role even if the users don't have permission to
|
|
1576
|
+
* pass it. Ensure that the role grants least privilege.</p>
|
|
1637
1577
|
* <p>If you don't specify a value, CloudFormation uses the role that was previously
|
|
1638
1578
|
* associated with the stack. If no role is available, CloudFormation uses a temporary
|
|
1639
1579
|
* session that is generated from your user credentials.</p>
|
|
@@ -1649,16 +1589,16 @@ export interface CreateStackInput {
|
|
|
1649
1589
|
OnFailure?: OnFailure | string;
|
|
1650
1590
|
/**
|
|
1651
1591
|
* <p>Structure containing the stack policy body. For more information, go to <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/protect-stack-resources.html"> Prevent Updates
|
|
1652
|
-
* to Stack Resources</a> in the <i>CloudFormation User
|
|
1653
|
-
* You can specify either the <code>StackPolicyBody</code> or the
|
|
1654
|
-
*
|
|
1592
|
+
* to Stack Resources</a> in the <i>CloudFormation User
|
|
1593
|
+
* Guide</i>. You can specify either the <code>StackPolicyBody</code> or the
|
|
1594
|
+
* <code>StackPolicyURL</code> parameter, but not both.</p>
|
|
1655
1595
|
*/
|
|
1656
1596
|
StackPolicyBody?: string;
|
|
1657
1597
|
/**
|
|
1658
|
-
* <p>Location of a file containing the stack policy. The URL must point to a policy
|
|
1659
|
-
*
|
|
1660
|
-
*
|
|
1661
|
-
*
|
|
1598
|
+
* <p>Location of a file containing the stack policy. The URL must point to a policy (maximum
|
|
1599
|
+
* size: 16 KB) located in an S3 bucket in the same Region as the stack. You can specify
|
|
1600
|
+
* either the <code>StackPolicyBody</code> or the <code>StackPolicyURL</code> parameter, but
|
|
1601
|
+
* not both.</p>
|
|
1662
1602
|
*/
|
|
1663
1603
|
StackPolicyURL?: string;
|
|
1664
1604
|
/**
|
|
@@ -1668,21 +1608,21 @@ export interface CreateStackInput {
|
|
|
1668
1608
|
*/
|
|
1669
1609
|
Tags?: Tag[];
|
|
1670
1610
|
/**
|
|
1671
|
-
* <p>A unique identifier for this <code>CreateStack</code> request. Specify this token if
|
|
1672
|
-
*
|
|
1611
|
+
* <p>A unique identifier for this <code>CreateStack</code> request. Specify this token if you
|
|
1612
|
+
* plan to retry requests so that CloudFormation knows that you're not attempting to
|
|
1673
1613
|
* create a stack with the same name. You might retry <code>CreateStack</code> requests to
|
|
1674
1614
|
* ensure that CloudFormation successfully received them.</p>
|
|
1675
1615
|
* <p>All events triggered by a given stack operation are assigned the same client request
|
|
1676
1616
|
* token, which you can use to track operations. For example, if you execute a
|
|
1677
|
-
*
|
|
1678
|
-
*
|
|
1679
|
-
*
|
|
1617
|
+
* <code>CreateStack</code> operation with the token <code>token1</code>, then all the
|
|
1618
|
+
* <code>StackEvents</code> generated by that operation will have
|
|
1619
|
+
* <code>ClientRequestToken</code> set as <code>token1</code>.</p>
|
|
1680
1620
|
* <p>In the console, stack operations display the client request token on the Events tab.
|
|
1681
1621
|
* Stack operations that are initiated from the console use the token format
|
|
1682
1622
|
* <i>Console-StackOperation-ID</i>, which helps you easily identify the
|
|
1683
1623
|
* stack operation . For example, if you create a stack using the console, each stack event
|
|
1684
1624
|
* would be assigned the same token in the following format:
|
|
1685
|
-
*
|
|
1625
|
+
* <code>Console-CreateStack-7f59c3cf-00d2-40c7-b2ff-e75db0987002</code>. </p>
|
|
1686
1626
|
*/
|
|
1687
1627
|
ClientRequestToken?: string;
|
|
1688
1628
|
/**
|
|
@@ -1769,34 +1709,33 @@ export interface StackSetOperationPreferences {
|
|
|
1769
1709
|
*/
|
|
1770
1710
|
RegionOrder?: string[];
|
|
1771
1711
|
/**
|
|
1772
|
-
* <p>The number of accounts, per Region, for which this operation can fail before
|
|
1773
|
-
* CloudFormation
|
|
1774
|
-
*
|
|
1712
|
+
* <p>The number of accounts, per Region, for which this operation can fail before CloudFormation stops the operation in that Region. If the operation is stopped in a
|
|
1713
|
+
* Region, CloudFormation doesn't attempt the operation in any subsequent
|
|
1714
|
+
* Regions.</p>
|
|
1775
1715
|
* <p>Conditional: You must specify either <code>FailureToleranceCount</code> or
|
|
1776
1716
|
* <code>FailureTolerancePercentage</code> (but not both).</p>
|
|
1777
1717
|
* <p>By default, <code>0</code> is specified.</p>
|
|
1778
1718
|
*/
|
|
1779
1719
|
FailureToleranceCount?: number;
|
|
1780
1720
|
/**
|
|
1781
|
-
* <p>The percentage of accounts, per Region, for which this stack operation can fail
|
|
1782
|
-
*
|
|
1721
|
+
* <p>The percentage of accounts, per Region, for which this stack operation can fail before
|
|
1722
|
+
* CloudFormation stops the operation in that Region. If the operation is stopped
|
|
1783
1723
|
* in a Region, CloudFormation doesn't attempt the operation in any subsequent
|
|
1784
1724
|
* Regions.</p>
|
|
1785
|
-
* <p>When calculating the number of accounts based on the specified percentage,
|
|
1786
|
-
* CloudFormation rounds <i>down</i> to the next whole number.</p>
|
|
1725
|
+
* <p>When calculating the number of accounts based on the specified percentage, CloudFormation rounds <i>down</i> to the next whole number.</p>
|
|
1787
1726
|
* <p>Conditional: You must specify either <code>FailureToleranceCount</code> or
|
|
1788
1727
|
* <code>FailureTolerancePercentage</code>, but not both.</p>
|
|
1789
1728
|
* <p>By default, <code>0</code> is specified.</p>
|
|
1790
1729
|
*/
|
|
1791
1730
|
FailureTolerancePercentage?: number;
|
|
1792
1731
|
/**
|
|
1793
|
-
* <p>The maximum number of accounts in which to perform this operation at one time. This
|
|
1794
|
-
*
|
|
1795
|
-
* <code>
|
|
1796
|
-
*
|
|
1797
|
-
* <p>Note that this setting lets you specify the <i>maximum</i> for
|
|
1798
|
-
*
|
|
1799
|
-
*
|
|
1732
|
+
* <p>The maximum number of accounts in which to perform this operation at one time. This is
|
|
1733
|
+
* dependent on the value of <code>FailureToleranceCount</code>.
|
|
1734
|
+
* <code>MaxConcurrentCount</code> is at most one more than the
|
|
1735
|
+
* <code>FailureToleranceCount</code>.</p>
|
|
1736
|
+
* <p>Note that this setting lets you specify the <i>maximum</i> for operations.
|
|
1737
|
+
* For large deployments, under certain circumstances the actual number of accounts acted upon
|
|
1738
|
+
* concurrently may be lower due to service throttling.</p>
|
|
1800
1739
|
* <p>Conditional: You must specify either <code>MaxConcurrentCount</code> or
|
|
1801
1740
|
* <code>MaxConcurrentPercentage</code>, but not both.</p>
|
|
1802
1741
|
* <p>By default, <code>1</code> is specified.</p>
|
|
@@ -1805,13 +1744,12 @@ export interface StackSetOperationPreferences {
|
|
|
1805
1744
|
/**
|
|
1806
1745
|
* <p>The maximum percentage of accounts in which to perform this operation at one
|
|
1807
1746
|
* time.</p>
|
|
1808
|
-
* <p>When calculating the number of accounts based on the specified percentage,
|
|
1809
|
-
*
|
|
1810
|
-
*
|
|
1811
|
-
*
|
|
1812
|
-
*
|
|
1813
|
-
*
|
|
1814
|
-
* accounts acted upon concurrently may be lower due to service throttling.</p>
|
|
1747
|
+
* <p>When calculating the number of accounts based on the specified percentage, CloudFormation rounds down to the next whole number. This is true except in cases where
|
|
1748
|
+
* rounding down would result is zero. In this case, CloudFormation sets the number
|
|
1749
|
+
* as one instead.</p>
|
|
1750
|
+
* <p>Note that this setting lets you specify the <i>maximum</i> for operations.
|
|
1751
|
+
* For large deployments, under certain circumstances the actual number of accounts acted upon
|
|
1752
|
+
* concurrently may be lower due to service throttling.</p>
|
|
1815
1753
|
* <p>Conditional: You must specify either <code>MaxConcurrentCount</code> or
|
|
1816
1754
|
* <code>MaxConcurrentPercentage</code>, but not both.</p>
|
|
1817
1755
|
* <p>By default, <code>1</code> is specified.</p>
|
|
@@ -1831,9 +1769,10 @@ export interface CreateStackInstancesInput {
|
|
|
1831
1769
|
*/
|
|
1832
1770
|
StackSetName: string | undefined;
|
|
1833
1771
|
/**
|
|
1834
|
-
* <p>[Self-managed permissions] The names of one or more Amazon Web Services accounts that you
|
|
1835
|
-
* specified Region(s) for.</p>
|
|
1836
|
-
* <p>You can specify <code>Accounts</code> or <code>DeploymentTargets</code>, but not
|
|
1772
|
+
* <p>[Self-managed permissions] The names of one or more Amazon Web Services accounts that you
|
|
1773
|
+
* want to create stack instances in the specified Region(s) for.</p>
|
|
1774
|
+
* <p>You can specify <code>Accounts</code> or <code>DeploymentTargets</code>, but not
|
|
1775
|
+
* both.</p>
|
|
1837
1776
|
*/
|
|
1838
1777
|
Accounts?: string[];
|
|
1839
1778
|
/**
|
|
@@ -1849,32 +1788,31 @@ export interface CreateStackInstancesInput {
|
|
|
1849
1788
|
*/
|
|
1850
1789
|
Regions: string[] | undefined;
|
|
1851
1790
|
/**
|
|
1852
|
-
* <p>A list of stack set parameters whose values you want to override in the selected
|
|
1853
|
-
*
|
|
1854
|
-
* <p>Any overridden parameter values will be applied to all stack instances in the
|
|
1855
|
-
*
|
|
1856
|
-
* how CloudFormation sets parameter values during stack instance operations:</p>
|
|
1791
|
+
* <p>A list of stack set parameters whose values you want to override in the selected stack
|
|
1792
|
+
* instances.</p>
|
|
1793
|
+
* <p>Any overridden parameter values will be applied to all stack instances in the specified
|
|
1794
|
+
* accounts and Regions. When specifying parameters and their values, be aware of how CloudFormation sets parameter values during stack instance operations:</p>
|
|
1857
1795
|
* <ul>
|
|
1858
1796
|
* <li>
|
|
1859
|
-
* <p>To override the current value for a parameter, include the parameter and
|
|
1860
|
-
*
|
|
1797
|
+
* <p>To override the current value for a parameter, include the parameter and specify
|
|
1798
|
+
* its value.</p>
|
|
1861
1799
|
* </li>
|
|
1862
1800
|
* <li>
|
|
1863
|
-
* <p>To leave an overridden parameter set to its present value, include the parameter
|
|
1864
|
-
* <code>true</code>. (You cannot specify
|
|
1865
|
-
* <code>UsePreviousValue</code> to <code>true</code>.)</p>
|
|
1801
|
+
* <p>To leave an overridden parameter set to its present value, include the parameter
|
|
1802
|
+
* and specify <code>UsePreviousValue</code> as <code>true</code>. (You cannot specify
|
|
1803
|
+
* both a value and set <code>UsePreviousValue</code> to <code>true</code>.)</p>
|
|
1866
1804
|
* </li>
|
|
1867
1805
|
* <li>
|
|
1868
1806
|
* <p>To set an overridden parameter back to the value specified in the stack set,
|
|
1869
1807
|
* specify a parameter list but do not include the parameter in the list.</p>
|
|
1870
1808
|
* </li>
|
|
1871
1809
|
* <li>
|
|
1872
|
-
* <p>To leave all parameters set to their present values, do not specify this
|
|
1873
|
-
*
|
|
1810
|
+
* <p>To leave all parameters set to their present values, do not specify this property
|
|
1811
|
+
* at all.</p>
|
|
1874
1812
|
* </li>
|
|
1875
1813
|
* </ul>
|
|
1876
|
-
* <p>During stack set updates, any parameter values overridden for a stack instance are
|
|
1877
|
-
*
|
|
1814
|
+
* <p>During stack set updates, any parameter values overridden for a stack instance are not
|
|
1815
|
+
* updated, but retain their overridden value.</p>
|
|
1878
1816
|
* <p>You can only override the parameter <i>values</i> that are specified in
|
|
1879
1817
|
* the 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.</p>
|
|
1880
1818
|
*/
|
|
@@ -1885,10 +1823,8 @@ export interface CreateStackInstancesInput {
|
|
|
1885
1823
|
OperationPreferences?: StackSetOperationPreferences;
|
|
1886
1824
|
/**
|
|
1887
1825
|
* <p>The unique identifier for this stack set operation.</p>
|
|
1888
|
-
* <p>The operation ID also functions as an idempotency token, to ensure that
|
|
1889
|
-
*
|
|
1890
|
-
* multiple times. You might retry stack set operation requests to ensure that
|
|
1891
|
-
* CloudFormation successfully received them.</p>
|
|
1826
|
+
* <p>The operation ID also functions as an idempotency token, to ensure that CloudFormation performs the stack set operation only once, even if you retry the request
|
|
1827
|
+
* multiple times. You might retry stack set operation requests to ensure that CloudFormation successfully received them.</p>
|
|
1892
1828
|
* <p>If you don't specify an operation ID, the SDK generates one
|
|
1893
1829
|
* automatically.</p>
|
|
1894
1830
|
* <p>Repeating this stack set operation with a new operation ID retries all stack instances
|
|
@@ -1896,15 +1832,21 @@ export interface CreateStackInstancesInput {
|
|
|
1896
1832
|
*/
|
|
1897
1833
|
OperationId?: string;
|
|
1898
1834
|
/**
|
|
1899
|
-
* <p>[Service-managed permissions] Specifies whether you are acting as an account
|
|
1900
|
-
*
|
|
1835
|
+
* <p>[Service-managed permissions] Specifies whether you are acting as an account
|
|
1836
|
+
* administrator in the organization's management account or as a delegated
|
|
1837
|
+
* administrator in a member account.</p>
|
|
1838
|
+
* <p>By default, <code>SELF</code> is specified. Use <code>SELF</code> for stack sets with
|
|
1839
|
+
* self-managed permissions.</p>
|
|
1901
1840
|
* <ul>
|
|
1902
1841
|
* <li>
|
|
1903
|
-
* <p>If you are signed in to the management account, specify
|
|
1842
|
+
* <p>If you are signed in to the management account, specify
|
|
1843
|
+
* <code>SELF</code>.</p>
|
|
1904
1844
|
* </li>
|
|
1905
1845
|
* <li>
|
|
1906
|
-
* <p>If you are signed in to a delegated administrator account, specify
|
|
1907
|
-
*
|
|
1846
|
+
* <p>If you are signed in to a delegated administrator account, specify
|
|
1847
|
+
* <code>DELEGATED_ADMIN</code>.</p>
|
|
1848
|
+
* <p>Your Amazon Web Services account must be registered as a delegated administrator in
|
|
1849
|
+
* the management account. For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-orgs-delegated-admin.html">Register a delegated administrator</a> in the <i>CloudFormation User Guide</i>.</p>
|
|
1908
1850
|
* </li>
|
|
1909
1851
|
* </ul>
|
|
1910
1852
|
*/
|
|
@@ -1936,12 +1878,6 @@ export interface InvalidOperationException extends __SmithyException, $MetadataB
|
|
|
1936
1878
|
$fault: "client";
|
|
1937
1879
|
Message?: string;
|
|
1938
1880
|
}
|
|
1939
|
-
export declare namespace InvalidOperationException {
|
|
1940
|
-
/**
|
|
1941
|
-
* @internal
|
|
1942
|
-
*/
|
|
1943
|
-
const filterSensitiveLog: (obj: InvalidOperationException) => any;
|
|
1944
|
-
}
|
|
1945
1881
|
/**
|
|
1946
1882
|
* <p>The specified operation ID already exists.</p>
|
|
1947
1883
|
*/
|
|
@@ -1950,27 +1886,15 @@ export interface OperationIdAlreadyExistsException extends __SmithyException, $M
|
|
|
1950
1886
|
$fault: "client";
|
|
1951
1887
|
Message?: string;
|
|
1952
1888
|
}
|
|
1953
|
-
export declare namespace OperationIdAlreadyExistsException {
|
|
1954
|
-
/**
|
|
1955
|
-
* @internal
|
|
1956
|
-
*/
|
|
1957
|
-
const filterSensitiveLog: (obj: OperationIdAlreadyExistsException) => any;
|
|
1958
|
-
}
|
|
1959
1889
|
/**
|
|
1960
|
-
* <p>Another operation is currently in progress for this stack set. Only one operation can
|
|
1961
|
-
*
|
|
1890
|
+
* <p>Another operation is currently in progress for this stack set. Only one operation can be
|
|
1891
|
+
* performed for a stack set at a given time.</p>
|
|
1962
1892
|
*/
|
|
1963
1893
|
export interface OperationInProgressException extends __SmithyException, $MetadataBearer {
|
|
1964
1894
|
name: "OperationInProgressException";
|
|
1965
1895
|
$fault: "client";
|
|
1966
1896
|
Message?: string;
|
|
1967
1897
|
}
|
|
1968
|
-
export declare namespace OperationInProgressException {
|
|
1969
|
-
/**
|
|
1970
|
-
* @internal
|
|
1971
|
-
*/
|
|
1972
|
-
const filterSensitiveLog: (obj: OperationInProgressException) => any;
|
|
1973
|
-
}
|
|
1974
1898
|
/**
|
|
1975
1899
|
* <p>The specified stack set doesn't exist.</p>
|
|
1976
1900
|
*/
|
|
@@ -1979,27 +1903,15 @@ export interface StackSetNotFoundException extends __SmithyException, $MetadataB
|
|
|
1979
1903
|
$fault: "client";
|
|
1980
1904
|
Message?: string;
|
|
1981
1905
|
}
|
|
1982
|
-
export declare namespace StackSetNotFoundException {
|
|
1983
|
-
/**
|
|
1984
|
-
* @internal
|
|
1985
|
-
*/
|
|
1986
|
-
const filterSensitiveLog: (obj: StackSetNotFoundException) => any;
|
|
1987
|
-
}
|
|
1988
1906
|
/**
|
|
1989
|
-
* <p>Another operation has been performed on this stack set since the specified operation
|
|
1990
|
-
*
|
|
1907
|
+
* <p>Another operation has been performed on this stack set since the specified operation was
|
|
1908
|
+
* performed. </p>
|
|
1991
1909
|
*/
|
|
1992
1910
|
export interface StaleRequestException extends __SmithyException, $MetadataBearer {
|
|
1993
1911
|
name: "StaleRequestException";
|
|
1994
1912
|
$fault: "client";
|
|
1995
1913
|
Message?: string;
|
|
1996
1914
|
}
|
|
1997
|
-
export declare namespace StaleRequestException {
|
|
1998
|
-
/**
|
|
1999
|
-
* @internal
|
|
2000
|
-
*/
|
|
2001
|
-
const filterSensitiveLog: (obj: StaleRequestException) => any;
|
|
2002
|
-
}
|
|
2003
1915
|
/**
|
|
2004
1916
|
* <p>The specified resource exists, but has been changed.</p>
|
|
2005
1917
|
*/
|
|
@@ -2008,11 +1920,31 @@ export interface CreatedButModifiedException extends __SmithyException, $Metadat
|
|
|
2008
1920
|
$fault: "client";
|
|
2009
1921
|
Message?: string;
|
|
2010
1922
|
}
|
|
2011
|
-
|
|
1923
|
+
/**
|
|
1924
|
+
* <p>Describes whether StackSets performs non-conflicting operations concurrently and queues
|
|
1925
|
+
* conflicting operations.</p>
|
|
1926
|
+
*/
|
|
1927
|
+
export interface ManagedExecution {
|
|
1928
|
+
/**
|
|
1929
|
+
* <p>When <code>true</code>, StackSets performs non-conflicting operations concurrently and
|
|
1930
|
+
* queues conflicting operations. After conflicting operations finish, StackSets starts queued
|
|
1931
|
+
* operations in request order.</p>
|
|
1932
|
+
* <note>
|
|
1933
|
+
* <p>If there are already running or queued operations, StackSets queues all incoming
|
|
1934
|
+
* operations even if they are non-conflicting.</p>
|
|
1935
|
+
* <p>You can't modify your stack set's execution configuration while there are running or
|
|
1936
|
+
* queued operations for that stack set.</p>
|
|
1937
|
+
* </note>
|
|
1938
|
+
* <p>When <code>false</code> (default), StackSets performs one operation at a time in request
|
|
1939
|
+
* order.</p>
|
|
1940
|
+
*/
|
|
1941
|
+
Active?: boolean;
|
|
1942
|
+
}
|
|
1943
|
+
export declare namespace ManagedExecution {
|
|
2012
1944
|
/**
|
|
2013
1945
|
* @internal
|
|
2014
1946
|
*/
|
|
2015
|
-
const filterSensitiveLog: (obj:
|
|
1947
|
+
const filterSensitiveLog: (obj: ManagedExecution) => any;
|
|
2016
1948
|
}
|
|
2017
1949
|
export declare type PermissionModels = "SELF_MANAGED" | "SERVICE_MANAGED";
|
|
2018
1950
|
export interface CreateStackSetInput {
|
|
@@ -2020,23 +1952,23 @@ export interface CreateStackSetInput {
|
|
|
2020
1952
|
* <p>The name to associate with the stack set. The name must be unique in the Region where
|
|
2021
1953
|
* you create your stack set.</p>
|
|
2022
1954
|
* <note>
|
|
2023
|
-
* <p>A stack name can contain only alphanumeric characters (case-sensitive) and
|
|
2024
|
-
*
|
|
1955
|
+
* <p>A stack name can contain only alphanumeric characters (case-sensitive) and hyphens.
|
|
1956
|
+
* It must start with an alphabetic character and can't be longer than 128
|
|
2025
1957
|
* characters.</p>
|
|
2026
1958
|
* </note>
|
|
2027
1959
|
*/
|
|
2028
1960
|
StackSetName: string | undefined;
|
|
2029
1961
|
/**
|
|
2030
|
-
* <p>A description of the stack set. You can use the description to identify the stack
|
|
2031
|
-
*
|
|
1962
|
+
* <p>A description of the stack set. You can use the description to identify the stack set's
|
|
1963
|
+
* purpose or other important information.</p>
|
|
2032
1964
|
*/
|
|
2033
1965
|
Description?: string;
|
|
2034
1966
|
/**
|
|
2035
1967
|
* <p>The structure that contains the template body, with a minimum length of 1 byte and a
|
|
2036
1968
|
* maximum length of 51,200 bytes. For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html">Template Anatomy</a>
|
|
2037
1969
|
* in the CloudFormation User Guide.</p>
|
|
2038
|
-
* <p>Conditional: You must specify either the TemplateBody or the TemplateURL parameter,
|
|
2039
|
-
*
|
|
1970
|
+
* <p>Conditional: You must specify either the TemplateBody or the TemplateURL parameter, but
|
|
1971
|
+
* not both.</p>
|
|
2040
1972
|
*/
|
|
2041
1973
|
TemplateBody?: string;
|
|
2042
1974
|
/**
|
|
@@ -2044,8 +1976,8 @@ export interface CreateStackSetInput {
|
|
|
2044
1976
|
* template (maximum size: 460,800 bytes) that's located in an Amazon S3 bucket or a Systems
|
|
2045
1977
|
* Manager document. For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html">Template Anatomy</a>
|
|
2046
1978
|
* in the CloudFormation User Guide.</p>
|
|
2047
|
-
* <p>Conditional: You must specify either the TemplateBody or the TemplateURL parameter,
|
|
2048
|
-
*
|
|
1979
|
+
* <p>Conditional: You must specify either the TemplateBody or the TemplateURL parameter, but
|
|
1980
|
+
* not both.</p>
|
|
2049
1981
|
*/
|
|
2050
1982
|
TemplateURL?: string;
|
|
2051
1983
|
/**
|
|
@@ -2066,8 +1998,8 @@ export interface CreateStackSetInput {
|
|
|
2066
1998
|
* <p>
|
|
2067
1999
|
* <code>CAPABILITY_IAM</code> and <code>CAPABILITY_NAMED_IAM</code>
|
|
2068
2000
|
* </p>
|
|
2069
|
-
* <p>Some stack templates might include resources that can affect permissions in
|
|
2070
|
-
*
|
|
2001
|
+
* <p>Some stack templates might include resources that can affect permissions in your
|
|
2002
|
+
* Amazon Web Services account; for example, by creating new Identity and Access Management
|
|
2071
2003
|
* (IAM) users. For those stack sets, you must explicitly acknowledge this by specifying
|
|
2072
2004
|
* one of these capabilities.</p>
|
|
2073
2005
|
* <p>The following IAM resources require you to specify either the
|
|
@@ -2086,9 +2018,8 @@ export interface CreateStackSetInput {
|
|
|
2086
2018
|
* <code>InsufficientCapabilities</code> error.</p>
|
|
2087
2019
|
* </li>
|
|
2088
2020
|
* </ul>
|
|
2089
|
-
* <p>If your stack template contains these resources, we recommend that you review
|
|
2090
|
-
*
|
|
2091
|
-
* necessary.</p>
|
|
2021
|
+
* <p>If your stack template contains these resources, we recommend that you review all
|
|
2022
|
+
* permissions associated with them and edit their permissions if necessary.</p>
|
|
2092
2023
|
* <ul>
|
|
2093
2024
|
* <li>
|
|
2094
2025
|
* <p>
|
|
@@ -2156,11 +2087,10 @@ export interface CreateStackSetInput {
|
|
|
2156
2087
|
Capabilities?: (Capability | string)[];
|
|
2157
2088
|
/**
|
|
2158
2089
|
* <p>The key-value pairs to associate with this stack set and the stacks created from it.
|
|
2159
|
-
*
|
|
2160
|
-
* the stacks. A maximum number of 50 tags can be specified.</p>
|
|
2161
|
-
* <p>If you specify tags as part of a <code>CreateStackSet</code> action,
|
|
2162
|
-
*
|
|
2163
|
-
* you don't, the entire <code>CreateStackSet</code> action fails with an <code>access
|
|
2090
|
+
* CloudFormation also propagates these tags to supported resources that are
|
|
2091
|
+
* created in the stacks. A maximum number of 50 tags can be specified.</p>
|
|
2092
|
+
* <p>If you specify tags as part of a <code>CreateStackSet</code> action, CloudFormation checks to see if you have the required IAM permission to tag resources.
|
|
2093
|
+
* If you don't, the entire <code>CreateStackSet</code> action fails with an <code>access
|
|
2164
2094
|
* denied</code> error, and the stack set is not created.</p>
|
|
2165
2095
|
*/
|
|
2166
2096
|
Tags?: Tag[];
|
|
@@ -2230,14 +2160,19 @@ export interface CreateStackSetInput {
|
|
|
2230
2160
|
*/
|
|
2231
2161
|
CallAs?: CallAs | string;
|
|
2232
2162
|
/**
|
|
2233
|
-
* <p>A unique identifier for this <code>CreateStackSet</code> request. Specify this token
|
|
2234
|
-
*
|
|
2163
|
+
* <p>A unique identifier for this <code>CreateStackSet</code> request. Specify this token if
|
|
2164
|
+
* you plan to retry requests so that CloudFormation knows that you're not attempting
|
|
2235
2165
|
* to create another stack set with the same name. You might retry <code>CreateStackSet</code>
|
|
2236
2166
|
* requests to ensure that CloudFormation successfully received them.</p>
|
|
2237
2167
|
* <p>If you don't specify an operation ID, the SDK generates one
|
|
2238
2168
|
* automatically.</p>
|
|
2239
2169
|
*/
|
|
2240
2170
|
ClientRequestToken?: string;
|
|
2171
|
+
/**
|
|
2172
|
+
* <p>Describes whether StackSets performs non-conflicting operations concurrently and queues
|
|
2173
|
+
* conflicting operations.</p>
|
|
2174
|
+
*/
|
|
2175
|
+
ManagedExecution?: ManagedExecution;
|
|
2241
2176
|
}
|
|
2242
2177
|
export declare namespace CreateStackSetInput {
|
|
2243
2178
|
/**
|
|
@@ -2265,12 +2200,6 @@ export interface NameAlreadyExistsException extends __SmithyException, $Metadata
|
|
|
2265
2200
|
$fault: "client";
|
|
2266
2201
|
Message?: string;
|
|
2267
2202
|
}
|
|
2268
|
-
export declare namespace NameAlreadyExistsException {
|
|
2269
|
-
/**
|
|
2270
|
-
* @internal
|
|
2271
|
-
*/
|
|
2272
|
-
const filterSensitiveLog: (obj: NameAlreadyExistsException) => any;
|
|
2273
|
-
}
|
|
2274
2203
|
export interface DeactivateTypeInput {
|
|
2275
2204
|
/**
|
|
2276
2205
|
* <p>The type name of the extension, in this account and region. If you specified a type name
|
|
@@ -2311,13 +2240,12 @@ export declare namespace DeactivateTypeOutput {
|
|
|
2311
2240
|
*/
|
|
2312
2241
|
export interface DeleteChangeSetInput {
|
|
2313
2242
|
/**
|
|
2314
|
-
* <p>The name or Amazon Resource Name (ARN) of the change set that you want to
|
|
2315
|
-
* delete.</p>
|
|
2243
|
+
* <p>The name or Amazon Resource Name (ARN) of the change set that you want to delete.</p>
|
|
2316
2244
|
*/
|
|
2317
2245
|
ChangeSetName: string | undefined;
|
|
2318
2246
|
/**
|
|
2319
|
-
* <p>If you specified the name of a change set to delete, specify the stack name or ID
|
|
2320
|
-
*
|
|
2247
|
+
* <p>If you specified the name of a change set to delete, specify the stack name or ID (ARN)
|
|
2248
|
+
* that is associated with it.</p>
|
|
2321
2249
|
*/
|
|
2322
2250
|
StackName?: string;
|
|
2323
2251
|
}
|
|
@@ -2339,8 +2267,8 @@ export declare namespace DeleteChangeSetOutput {
|
|
|
2339
2267
|
const filterSensitiveLog: (obj: DeleteChangeSetOutput) => any;
|
|
2340
2268
|
}
|
|
2341
2269
|
/**
|
|
2342
|
-
* <p>The specified change set can't be used to update the stack. For example, the change
|
|
2343
|
-
*
|
|
2270
|
+
* <p>The specified change set can't be used to update the stack. For example, the change set
|
|
2271
|
+
* status might be <code>CREATE_IN_PROGRESS</code>, or the stack status might be
|
|
2344
2272
|
* <code>UPDATE_IN_PROGRESS</code>.</p>
|
|
2345
2273
|
*/
|
|
2346
2274
|
export interface InvalidChangeSetStatusException extends __SmithyException, $MetadataBearer {
|
|
@@ -2348,12 +2276,6 @@ export interface InvalidChangeSetStatusException extends __SmithyException, $Met
|
|
|
2348
2276
|
$fault: "client";
|
|
2349
2277
|
Message?: string;
|
|
2350
2278
|
}
|
|
2351
|
-
export declare namespace InvalidChangeSetStatusException {
|
|
2352
|
-
/**
|
|
2353
|
-
* @internal
|
|
2354
|
-
*/
|
|
2355
|
-
const filterSensitiveLog: (obj: InvalidChangeSetStatusException) => any;
|
|
2356
|
-
}
|
|
2357
2279
|
/**
|
|
2358
2280
|
* <p>The input for <a>DeleteStack</a> action.</p>
|
|
2359
2281
|
*/
|
|
@@ -2363,16 +2285,14 @@ export interface DeleteStackInput {
|
|
|
2363
2285
|
*/
|
|
2364
2286
|
StackName: string | undefined;
|
|
2365
2287
|
/**
|
|
2366
|
-
* <p>For stacks in the <code>DELETE_FAILED</code> state, a list of resource logical IDs
|
|
2367
|
-
*
|
|
2368
|
-
*
|
|
2369
|
-
*
|
|
2370
|
-
* S3 bucket, but you want to delete the stack.</p>
|
|
2288
|
+
* <p>For stacks in the <code>DELETE_FAILED</code> state, a list of resource logical IDs that
|
|
2289
|
+
* are associated with the resources you want to retain. During deletion, CloudFormation deletes the stack but does not delete the retained resources.</p>
|
|
2290
|
+
* <p>Retaining resources is useful when you cannot delete a resource, such as a non-empty S3
|
|
2291
|
+
* bucket, but you want to delete the stack.</p>
|
|
2371
2292
|
*/
|
|
2372
2293
|
RetainResources?: string[];
|
|
2373
2294
|
/**
|
|
2374
|
-
* <p>The Amazon Resource Name (ARN) of an Identity and Access Management (IAM) role
|
|
2375
|
-
* that CloudFormation assumes to delete the stack. CloudFormation uses the role's
|
|
2295
|
+
* <p>The Amazon Resource Name (ARN) of an Identity and Access Management (IAM) role that CloudFormation assumes to delete the stack. CloudFormation uses the role's
|
|
2376
2296
|
* credentials to make calls on your behalf.</p>
|
|
2377
2297
|
* <p>If you don't specify a value, CloudFormation uses the role that was previously
|
|
2378
2298
|
* associated with the stack. If no role is available, CloudFormation uses a temporary
|
|
@@ -2380,15 +2300,15 @@ export interface DeleteStackInput {
|
|
|
2380
2300
|
*/
|
|
2381
2301
|
RoleARN?: string;
|
|
2382
2302
|
/**
|
|
2383
|
-
* <p>A unique identifier for this <code>DeleteStack</code> request. Specify this token if
|
|
2384
|
-
*
|
|
2303
|
+
* <p>A unique identifier for this <code>DeleteStack</code> request. Specify this token if you
|
|
2304
|
+
* plan to retry requests so that CloudFormation knows that you're not attempting to
|
|
2385
2305
|
* delete a stack with the same name. You might retry <code>DeleteStack</code> requests to
|
|
2386
2306
|
* ensure that CloudFormation successfully received them.</p>
|
|
2387
2307
|
* <p>All events triggered by a given stack operation are assigned the same client request
|
|
2388
2308
|
* token, which you can use to track operations. For example, if you execute a
|
|
2389
|
-
*
|
|
2390
|
-
*
|
|
2391
|
-
*
|
|
2309
|
+
* <code>CreateStack</code> operation with the token <code>token1</code>, then all the
|
|
2310
|
+
* <code>StackEvents</code> generated by that operation will have
|
|
2311
|
+
* <code>ClientRequestToken</code> set as <code>token1</code>.</p>
|
|
2392
2312
|
* <p>In the console, stack operations display the client request token on the Events tab.
|
|
2393
2313
|
* Stack operations that are initiated from the console use the token format
|
|
2394
2314
|
* <i>Console-StackOperation-ID</i>, which helps you easily identify the
|
|
@@ -2411,8 +2331,10 @@ export interface DeleteStackInstancesInput {
|
|
|
2411
2331
|
*/
|
|
2412
2332
|
StackSetName: string | undefined;
|
|
2413
2333
|
/**
|
|
2414
|
-
* <p>[Self-managed permissions] The names of the Amazon Web Services accounts that you want to
|
|
2415
|
-
*
|
|
2334
|
+
* <p>[Self-managed permissions] The names of the Amazon Web Services accounts that you want to
|
|
2335
|
+
* delete stack instances for.</p>
|
|
2336
|
+
* <p>You can specify <code>Accounts</code> or <code>DeploymentTargets</code>, but not
|
|
2337
|
+
* both.</p>
|
|
2416
2338
|
*/
|
|
2417
2339
|
Accounts?: string[];
|
|
2418
2340
|
/**
|
|
@@ -2431,9 +2353,9 @@ export interface DeleteStackInstancesInput {
|
|
|
2431
2353
|
*/
|
|
2432
2354
|
OperationPreferences?: StackSetOperationPreferences;
|
|
2433
2355
|
/**
|
|
2434
|
-
* <p>Removes the stack instances from the specified stack set, but doesn't delete the
|
|
2435
|
-
*
|
|
2436
|
-
*
|
|
2356
|
+
* <p>Removes the stack instances from the specified stack set, but doesn't delete the stacks.
|
|
2357
|
+
* You can't reassociate a retained stack or add an existing, saved stack to a new stack
|
|
2358
|
+
* set.</p>
|
|
2437
2359
|
* <p>For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-concepts.html#stackset-ops-options">Stack set operation options</a>.</p>
|
|
2438
2360
|
*/
|
|
2439
2361
|
RetainStacks: boolean | undefined;
|
|
@@ -2441,10 +2363,8 @@ export interface DeleteStackInstancesInput {
|
|
|
2441
2363
|
* <p>The unique identifier for this stack set operation.</p>
|
|
2442
2364
|
* <p>If you don't specify an operation ID, the SDK generates one
|
|
2443
2365
|
* automatically.</p>
|
|
2444
|
-
* <p>The operation ID also functions as an idempotency token, to ensure that
|
|
2445
|
-
*
|
|
2446
|
-
* multiple times. You can retry stack set operation requests to ensure that
|
|
2447
|
-
* CloudFormation successfully received them.</p>
|
|
2366
|
+
* <p>The operation ID also functions as an idempotency token, to ensure that CloudFormation performs the stack set operation only once, even if you retry the request
|
|
2367
|
+
* multiple times. You can retry stack set operation requests to ensure that CloudFormation successfully received them.</p>
|
|
2448
2368
|
* <p>Repeating this stack set operation with a new operation ID retries all stack instances
|
|
2449
2369
|
* whose status is <code>OUTDATED</code>.</p>
|
|
2450
2370
|
*/
|
|
@@ -2489,8 +2409,8 @@ export declare namespace DeleteStackInstancesOutput {
|
|
|
2489
2409
|
}
|
|
2490
2410
|
export interface DeleteStackSetInput {
|
|
2491
2411
|
/**
|
|
2492
|
-
* <p>The name or unique ID of the stack set that you're deleting. You can obtain this
|
|
2493
|
-
*
|
|
2412
|
+
* <p>The name or unique ID of the stack set that you're deleting. You can obtain this value
|
|
2413
|
+
* by running <a>ListStackSets</a>.</p>
|
|
2494
2414
|
*/
|
|
2495
2415
|
StackSetName: string | undefined;
|
|
2496
2416
|
/**
|
|
@@ -2537,12 +2457,6 @@ export interface StackSetNotEmptyException extends __SmithyException, $MetadataB
|
|
|
2537
2457
|
$fault: "client";
|
|
2538
2458
|
Message?: string;
|
|
2539
2459
|
}
|
|
2540
|
-
export declare namespace StackSetNotEmptyException {
|
|
2541
|
-
/**
|
|
2542
|
-
* @internal
|
|
2543
|
-
*/
|
|
2544
|
-
const filterSensitiveLog: (obj: StackSetNotEmptyException) => any;
|
|
2545
|
-
}
|
|
2546
2460
|
export declare type RegistryType = "MODULE" | "RESOURCE";
|
|
2547
2461
|
export interface DeregisterTypeInput {
|
|
2548
2462
|
/**
|
|
@@ -2609,8 +2523,8 @@ export interface DescribeAccountLimitsOutput {
|
|
|
2609
2523
|
*/
|
|
2610
2524
|
AccountLimits?: AccountLimit[];
|
|
2611
2525
|
/**
|
|
2612
|
-
* <p>If the output exceeds 1 MB in size, a string that identifies the next page of limits.
|
|
2613
|
-
*
|
|
2526
|
+
* <p>If the output exceeds 1 MB in size, a string that identifies the next page of limits. If
|
|
2527
|
+
* no additional page exists, this value is null.</p>
|
|
2614
2528
|
*/
|
|
2615
2529
|
NextToken?: string;
|
|
2616
2530
|
}
|
|
@@ -2680,10 +2594,10 @@ export interface DescribeChangeSetOutput {
|
|
|
2680
2594
|
*/
|
|
2681
2595
|
CreationTime?: Date;
|
|
2682
2596
|
/**
|
|
2683
|
-
* <p>If the change set execution status is <code>AVAILABLE</code>, you can execute the
|
|
2684
|
-
*
|
|
2685
|
-
*
|
|
2686
|
-
*
|
|
2597
|
+
* <p>If the change set execution status is <code>AVAILABLE</code>, you can execute the change
|
|
2598
|
+
* set. If you can’t execute the change set, the status indicates why. For example, a change
|
|
2599
|
+
* set might be in an <code>UNAVAILABLE</code> state because CloudFormation is still
|
|
2600
|
+
* creating it or in an <code>OBSOLETE</code> state because the stack was already
|
|
2687
2601
|
* updated.</p>
|
|
2688
2602
|
*/
|
|
2689
2603
|
ExecutionStatus?: ExecutionStatus | string;
|
|
@@ -2713,18 +2627,16 @@ export interface DescribeChangeSetOutput {
|
|
|
2713
2627
|
*/
|
|
2714
2628
|
Capabilities?: (Capability | string)[];
|
|
2715
2629
|
/**
|
|
2716
|
-
* <p>If you execute the change set, the tags that will be associated with the
|
|
2717
|
-
* stack.</p>
|
|
2630
|
+
* <p>If you execute the change set, the tags that will be associated with the stack.</p>
|
|
2718
2631
|
*/
|
|
2719
2632
|
Tags?: Tag[];
|
|
2720
2633
|
/**
|
|
2721
|
-
* <p>A list of <code>Change</code> structures that describes the resources
|
|
2722
|
-
* CloudFormation changes if you execute the change set.</p>
|
|
2634
|
+
* <p>A list of <code>Change</code> structures that describes the resources CloudFormation changes if you execute the change set.</p>
|
|
2723
2635
|
*/
|
|
2724
2636
|
Changes?: Change[];
|
|
2725
2637
|
/**
|
|
2726
|
-
* <p>If the output exceeds 1 MB, a string that identifies the next page of changes. If
|
|
2727
|
-
*
|
|
2638
|
+
* <p>If the output exceeds 1 MB, a string that identifies the next page of changes. If there
|
|
2639
|
+
* is no additional page, this value is null.</p>
|
|
2728
2640
|
*/
|
|
2729
2641
|
NextToken?: string;
|
|
2730
2642
|
/**
|
|
@@ -2831,8 +2743,8 @@ export interface DescribeStackDriftDetectionStatusOutput {
|
|
|
2831
2743
|
StackId: string | undefined;
|
|
2832
2744
|
/**
|
|
2833
2745
|
* <p>The ID of the drift detection results of this operation.</p>
|
|
2834
|
-
* <p>CloudFormation generates new results, with a new drift detection ID, each time this operation
|
|
2835
|
-
*
|
|
2746
|
+
* <p>CloudFormation generates new results, with a new drift detection ID, each time this operation is
|
|
2747
|
+
* run. However, the number of reports CloudFormation retains for any given stack, and for how long,
|
|
2836
2748
|
* may vary.</p>
|
|
2837
2749
|
*/
|
|
2838
2750
|
StackDriftDetectionId: string | undefined;
|
|
@@ -2842,9 +2754,9 @@ export interface DescribeStackDriftDetectionStatusOutput {
|
|
|
2842
2754
|
* <ul>
|
|
2843
2755
|
* <li>
|
|
2844
2756
|
* <p>
|
|
2845
|
-
* <code>DRIFTED</code>: The stack differs from its expected template
|
|
2846
|
-
*
|
|
2847
|
-
*
|
|
2757
|
+
* <code>DRIFTED</code>: The stack differs from its expected template configuration.
|
|
2758
|
+
* A stack is considered to have drifted if one or more of its resources have
|
|
2759
|
+
* drifted.</p>
|
|
2848
2760
|
* </li>
|
|
2849
2761
|
* <li>
|
|
2850
2762
|
* <p>
|
|
@@ -2871,15 +2783,15 @@ export interface DescribeStackDriftDetectionStatusOutput {
|
|
|
2871
2783
|
* <code>DETECTION_COMPLETE</code>: The stack drift detection operation has
|
|
2872
2784
|
* successfully completed for all resources in the stack that support drift detection.
|
|
2873
2785
|
* (Resources that do not currently support stack detection remain unchecked.)</p>
|
|
2874
|
-
* <p>If you specified logical resource IDs for CloudFormation to use as a filter for the
|
|
2875
|
-
*
|
|
2876
|
-
*
|
|
2786
|
+
* <p>If you specified logical resource IDs for CloudFormation to use as a filter for the stack
|
|
2787
|
+
* drift detection operation, only the resources with those logical IDs are checked for
|
|
2788
|
+
* drift.</p>
|
|
2877
2789
|
* </li>
|
|
2878
2790
|
* <li>
|
|
2879
2791
|
* <p>
|
|
2880
|
-
* <code>DETECTION_FAILED</code>: The stack drift detection operation has failed
|
|
2881
|
-
*
|
|
2882
|
-
*
|
|
2792
|
+
* <code>DETECTION_FAILED</code>: The stack drift detection operation has failed for
|
|
2793
|
+
* at least one resource in the stack. Results will be available for resources on which
|
|
2794
|
+
* CloudFormation successfully completed drift detection.</p>
|
|
2883
2795
|
* </li>
|
|
2884
2796
|
* <li>
|
|
2885
2797
|
* <p>
|
|
@@ -2915,8 +2827,8 @@ export declare namespace DescribeStackDriftDetectionStatusOutput {
|
|
|
2915
2827
|
*/
|
|
2916
2828
|
export interface DescribeStackEventsInput {
|
|
2917
2829
|
/**
|
|
2918
|
-
* <p>The name or the unique stack ID that is associated with the stack, which are not
|
|
2919
|
-
*
|
|
2830
|
+
* <p>The name or the unique stack ID that is associated with the stack, which are not always
|
|
2831
|
+
* interchangeable:</p>
|
|
2920
2832
|
* <ul>
|
|
2921
2833
|
* <li>
|
|
2922
2834
|
* <p>Running stacks: You can specify either the stack's name or its unique stack
|
|
@@ -2990,8 +2902,8 @@ export interface StackEvent {
|
|
|
2990
2902
|
*/
|
|
2991
2903
|
PhysicalResourceId?: string;
|
|
2992
2904
|
/**
|
|
2993
|
-
* <p>Type of resource. (For more information, go to <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-template-resource-type-ref.html">Amazon Web Services
|
|
2994
|
-
*
|
|
2905
|
+
* <p>Type of resource. (For more information, go to <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-template-resource-type-ref.html">Amazon Web Services Resource Types Reference</a> in the CloudFormation User
|
|
2906
|
+
* Guide.)</p>
|
|
2995
2907
|
*/
|
|
2996
2908
|
ResourceType?: string;
|
|
2997
2909
|
/**
|
|
@@ -3014,15 +2926,15 @@ export interface StackEvent {
|
|
|
3014
2926
|
* <p>The token passed to the operation that generated this event.</p>
|
|
3015
2927
|
* <p>All events triggered by a given stack operation are assigned the same client request
|
|
3016
2928
|
* token, which you can use to track operations. For example, if you execute a
|
|
3017
|
-
*
|
|
3018
|
-
*
|
|
3019
|
-
*
|
|
2929
|
+
* <code>CreateStack</code> operation with the token <code>token1</code>, then all the
|
|
2930
|
+
* <code>StackEvents</code> generated by that operation will have
|
|
2931
|
+
* <code>ClientRequestToken</code> set as <code>token1</code>.</p>
|
|
3020
2932
|
* <p>In the console, stack operations display the client request token on the Events tab.
|
|
3021
2933
|
* Stack operations that are initiated from the console use the token format
|
|
3022
2934
|
* <i>Console-StackOperation-ID</i>, which helps you easily identify the
|
|
3023
2935
|
* stack operation . For example, if you create a stack using the console, each stack event
|
|
3024
2936
|
* would be assigned the same token in the following format:
|
|
3025
|
-
*
|
|
2937
|
+
* <code>Console-CreateStack-7f59c3cf-00d2-40c7-b2ff-e75db0987002</code>. </p>
|
|
3026
2938
|
*/
|
|
3027
2939
|
ClientRequestToken?: string;
|
|
3028
2940
|
}
|
|
@@ -3041,8 +2953,8 @@ export interface DescribeStackEventsOutput {
|
|
|
3041
2953
|
*/
|
|
3042
2954
|
StackEvents?: StackEvent[];
|
|
3043
2955
|
/**
|
|
3044
|
-
* <p>If the output exceeds 1 MB in size, a string that identifies the next page of events.
|
|
3045
|
-
*
|
|
2956
|
+
* <p>If the output exceeds 1 MB in size, a string that identifies the next page of events. If
|
|
2957
|
+
* no additional page exists, this value is null.</p>
|
|
3046
2958
|
*/
|
|
3047
2959
|
NextToken?: string;
|
|
3048
2960
|
}
|
|
@@ -3059,7 +2971,8 @@ export interface DescribeStackInstanceInput {
|
|
|
3059
2971
|
*/
|
|
3060
2972
|
StackSetName: string | undefined;
|
|
3061
2973
|
/**
|
|
3062
|
-
* <p>The ID of an Amazon Web Services account that's associated with this stack
|
|
2974
|
+
* <p>The ID of an Amazon Web Services account that's associated with this stack
|
|
2975
|
+
* instance.</p>
|
|
3063
2976
|
*/
|
|
3064
2977
|
StackInstanceAccount: string | undefined;
|
|
3065
2978
|
/**
|
|
@@ -3147,12 +3060,12 @@ export declare namespace StackInstanceComprehensiveStatus {
|
|
|
3147
3060
|
}
|
|
3148
3061
|
export declare type StackInstanceStatus = "CURRENT" | "INOPERABLE" | "OUTDATED";
|
|
3149
3062
|
/**
|
|
3150
|
-
* <p>An CloudFormation stack, in a specific account and Region, that's part of a
|
|
3151
|
-
* set operation. A stack instance is a reference to an attempted or actual stack in a
|
|
3152
|
-
* account within a given Region. A stack instance can exist without a stack—for
|
|
3153
|
-
* the stack couldn't be created for some reason. A stack instance is associated
|
|
3154
|
-
* stack set. Each stack instance contains the ID of its associated stack set,
|
|
3155
|
-
* ID of the actual stack and the stack status.</p>
|
|
3063
|
+
* <p>An CloudFormation stack, in a specific account and Region, that's part of a
|
|
3064
|
+
* stack set operation. A stack instance is a reference to an attempted or actual stack in a
|
|
3065
|
+
* given account within a given Region. A stack instance can exist without a stack—for
|
|
3066
|
+
* example, if the stack couldn't be created for some reason. A stack instance is associated
|
|
3067
|
+
* with only one stack set. Each stack instance contains the ID of its associated stack set,
|
|
3068
|
+
* as well as the ID of the actual stack and the stack status.</p>
|
|
3156
3069
|
*/
|
|
3157
3070
|
export interface StackInstance {
|
|
3158
3071
|
/**
|
|
@@ -3161,11 +3074,13 @@ export interface StackInstance {
|
|
|
3161
3074
|
*/
|
|
3162
3075
|
StackSetId?: string;
|
|
3163
3076
|
/**
|
|
3164
|
-
* <p>The name of the Amazon Web Services Region that the stack instance is associated
|
|
3077
|
+
* <p>The name of the Amazon Web Services Region that the stack instance is associated
|
|
3078
|
+
* with.</p>
|
|
3165
3079
|
*/
|
|
3166
3080
|
Region?: string;
|
|
3167
3081
|
/**
|
|
3168
|
-
* <p>[Self-managed permissions] The name of the Amazon Web Services account that the stack
|
|
3082
|
+
* <p>[Self-managed permissions] The name of the Amazon Web Services account that the stack
|
|
3083
|
+
* instance is associated with.</p>
|
|
3169
3084
|
*/
|
|
3170
3085
|
Account?: string;
|
|
3171
3086
|
/**
|
|
@@ -3183,9 +3098,9 @@ export interface StackInstance {
|
|
|
3183
3098
|
* <ul>
|
|
3184
3099
|
* <li>
|
|
3185
3100
|
* <p>
|
|
3186
|
-
* <code>INOPERABLE</code>: A <code>DeleteStackInstances</code> operation has
|
|
3187
|
-
*
|
|
3188
|
-
*
|
|
3101
|
+
* <code>INOPERABLE</code>: A <code>DeleteStackInstances</code> operation has failed
|
|
3102
|
+
* and left the stack in an unstable state. Stacks in this state are excluded from
|
|
3103
|
+
* further <code>UpdateStackSet</code> operations. You might need to perform a
|
|
3189
3104
|
* <code>DeleteStackInstances</code> operation, with <code>RetainStacks</code> set to
|
|
3190
3105
|
* <code>true</code>, to delete the stack instance, and then delete the stack
|
|
3191
3106
|
* manually.</p>
|
|
@@ -3208,8 +3123,7 @@ export interface StackInstance {
|
|
|
3208
3123
|
* </li>
|
|
3209
3124
|
* <li>
|
|
3210
3125
|
* <p>
|
|
3211
|
-
* <code>CURRENT</code>: The stack is currently up to date with the stack
|
|
3212
|
-
* set.</p>
|
|
3126
|
+
* <code>CURRENT</code>: The stack is currently up to date with the stack set.</p>
|
|
3213
3127
|
* </li>
|
|
3214
3128
|
* </ul>
|
|
3215
3129
|
*/
|
|
@@ -3289,19 +3203,13 @@ export interface StackInstanceNotFoundException extends __SmithyException, $Meta
|
|
|
3289
3203
|
$fault: "client";
|
|
3290
3204
|
Message?: string;
|
|
3291
3205
|
}
|
|
3292
|
-
export declare namespace StackInstanceNotFoundException {
|
|
3293
|
-
/**
|
|
3294
|
-
* @internal
|
|
3295
|
-
*/
|
|
3296
|
-
const filterSensitiveLog: (obj: StackInstanceNotFoundException) => any;
|
|
3297
|
-
}
|
|
3298
3206
|
/**
|
|
3299
3207
|
* <p>The input for <a>DescribeStackResource</a> action.</p>
|
|
3300
3208
|
*/
|
|
3301
3209
|
export interface DescribeStackResourceInput {
|
|
3302
3210
|
/**
|
|
3303
|
-
* <p>The name or the unique stack ID that is associated with the stack, which are not
|
|
3304
|
-
*
|
|
3211
|
+
* <p>The name or the unique stack ID that is associated with the stack, which are not always
|
|
3212
|
+
* interchangeable:</p>
|
|
3305
3213
|
* <ul>
|
|
3306
3214
|
* <li>
|
|
3307
3215
|
* <p>Running stacks: You can specify either the stack's name or its unique stack
|
|
@@ -3333,8 +3241,8 @@ export declare enum StackResourceDriftStatus {
|
|
|
3333
3241
|
NOT_CHECKED = "NOT_CHECKED"
|
|
3334
3242
|
}
|
|
3335
3243
|
/**
|
|
3336
|
-
* <p>Contains information about whether the resource's actual configuration differs, or
|
|
3337
|
-
*
|
|
3244
|
+
* <p>Contains information about whether the resource's actual configuration differs, or has
|
|
3245
|
+
* <i>drifted</i>, from its expected configuration.</p>
|
|
3338
3246
|
*/
|
|
3339
3247
|
export interface StackResourceDriftInformation {
|
|
3340
3248
|
/**
|
|
@@ -3343,8 +3251,8 @@ export interface StackResourceDriftInformation {
|
|
|
3343
3251
|
* <ul>
|
|
3344
3252
|
* <li>
|
|
3345
3253
|
* <p>
|
|
3346
|
-
* <code>DELETED</code>: The resource differs from its expected configuration in
|
|
3347
|
-
*
|
|
3254
|
+
* <code>DELETED</code>: The resource differs from its expected configuration in that
|
|
3255
|
+
* it has been deleted.</p>
|
|
3348
3256
|
* </li>
|
|
3349
3257
|
* <li>
|
|
3350
3258
|
* <p>
|
|
@@ -3353,8 +3261,8 @@ export interface StackResourceDriftInformation {
|
|
|
3353
3261
|
* </li>
|
|
3354
3262
|
* <li>
|
|
3355
3263
|
* <p>
|
|
3356
|
-
* <code>NOT_CHECKED</code>: CloudFormation has not checked if the resource differs from
|
|
3357
|
-
*
|
|
3264
|
+
* <code>NOT_CHECKED</code>: CloudFormation has not checked if the resource differs from its
|
|
3265
|
+
* expected configuration.</p>
|
|
3358
3266
|
* <p>Any resources that do not currently support drift detection have a status of
|
|
3359
3267
|
* <code>NOT_CHECKED</code>. For more information, 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>
|
|
3360
3268
|
* </li>
|
|
@@ -3395,13 +3303,13 @@ export interface StackResourceDetail {
|
|
|
3395
3303
|
*/
|
|
3396
3304
|
LogicalResourceId: string | undefined;
|
|
3397
3305
|
/**
|
|
3398
|
-
* <p>The name or unique identifier that corresponds to a physical instance ID of a
|
|
3399
|
-
*
|
|
3306
|
+
* <p>The name or unique identifier that corresponds to a physical instance ID of a resource
|
|
3307
|
+
* supported by CloudFormation.</p>
|
|
3400
3308
|
*/
|
|
3401
3309
|
PhysicalResourceId?: string;
|
|
3402
3310
|
/**
|
|
3403
|
-
* <p>Type of resource. ((For more information, go to <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-template-resource-type-ref.html">Amazon Web Services
|
|
3404
|
-
*
|
|
3311
|
+
* <p>Type of resource. ((For more information, go to <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-template-resource-type-ref.html">Amazon Web Services Resource Types Reference</a> in the CloudFormation User
|
|
3312
|
+
* Guide.)</p>
|
|
3405
3313
|
*/
|
|
3406
3314
|
ResourceType: string | undefined;
|
|
3407
3315
|
/**
|
|
@@ -3421,8 +3329,8 @@ export interface StackResourceDetail {
|
|
|
3421
3329
|
*/
|
|
3422
3330
|
Description?: string;
|
|
3423
3331
|
/**
|
|
3424
|
-
* <p>The content of the <code>Metadata</code> attribute declared for the resource. For
|
|
3425
|
-
*
|
|
3332
|
+
* <p>The content of the <code>Metadata</code> attribute declared for the resource. For more
|
|
3333
|
+
* information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-attribute-metadata.html">Metadata
|
|
3426
3334
|
* Attribute</a> in the CloudFormation User Guide.</p>
|
|
3427
3335
|
*/
|
|
3428
3336
|
Metadata?: string;
|
|
@@ -3450,8 +3358,8 @@ export declare namespace StackResourceDetail {
|
|
|
3450
3358
|
*/
|
|
3451
3359
|
export interface DescribeStackResourceOutput {
|
|
3452
3360
|
/**
|
|
3453
|
-
* <p>A <code>StackResourceDetail</code> structure containing the description of the
|
|
3454
|
-
*
|
|
3361
|
+
* <p>A <code>StackResourceDetail</code> structure containing the description of the specified
|
|
3362
|
+
* resource in the specified stack.</p>
|
|
3455
3363
|
*/
|
|
3456
3364
|
StackResourceDetail?: StackResourceDetail;
|
|
3457
3365
|
}
|
|
@@ -3477,8 +3385,8 @@ export interface DescribeStackResourceDriftsInput {
|
|
|
3477
3385
|
* </li>
|
|
3478
3386
|
* <li>
|
|
3479
3387
|
* <p>
|
|
3480
|
-
* <code>MODIFIED</code>: One or more resource properties differ from their
|
|
3481
|
-
*
|
|
3388
|
+
* <code>MODIFIED</code>: One or more resource properties differ from their expected
|
|
3389
|
+
* template values.</p>
|
|
3482
3390
|
* </li>
|
|
3483
3391
|
* <li>
|
|
3484
3392
|
* <p>
|
|
@@ -3550,8 +3458,8 @@ export interface PropertyDifference {
|
|
|
3550
3458
|
*/
|
|
3551
3459
|
PropertyPath: string | undefined;
|
|
3552
3460
|
/**
|
|
3553
|
-
* <p>The expected property value of the resource property, as defined in the stack
|
|
3554
|
-
*
|
|
3461
|
+
* <p>The expected property value of the resource property, as defined in the stack template
|
|
3462
|
+
* and any values specified as template parameters.</p>
|
|
3555
3463
|
*/
|
|
3556
3464
|
ExpectedValue: string | undefined;
|
|
3557
3465
|
/**
|
|
@@ -3563,8 +3471,8 @@ export interface PropertyDifference {
|
|
|
3563
3471
|
* <ul>
|
|
3564
3472
|
* <li>
|
|
3565
3473
|
* <p>
|
|
3566
|
-
* <code>ADD</code>: A value has been added to a resource property that is an
|
|
3567
|
-
*
|
|
3474
|
+
* <code>ADD</code>: A value has been added to a resource property that is an array
|
|
3475
|
+
* or list data type.</p>
|
|
3568
3476
|
* </li>
|
|
3569
3477
|
* <li>
|
|
3570
3478
|
* <p>
|
|
@@ -3573,8 +3481,8 @@ export interface PropertyDifference {
|
|
|
3573
3481
|
* </li>
|
|
3574
3482
|
* <li>
|
|
3575
3483
|
* <p>
|
|
3576
|
-
* <code>NOT_EQUAL</code>: The current property value differs from its expected
|
|
3577
|
-
*
|
|
3484
|
+
* <code>NOT_EQUAL</code>: The current property value differs from its expected value
|
|
3485
|
+
* (as defined in the stack template and any values specified as template
|
|
3578
3486
|
* parameters).</p>
|
|
3579
3487
|
* </li>
|
|
3580
3488
|
* </ul>
|
|
@@ -3593,12 +3501,12 @@ export declare namespace PropertyDifference {
|
|
|
3593
3501
|
* drift. Only resource properties explicitly defined in the stack template are checked for
|
|
3594
3502
|
* drift. For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-stack-drift.html">Detecting
|
|
3595
3503
|
* Unregulated Configuration Changes to Stacks and Resources</a>.</p>
|
|
3596
|
-
* <p>Resources that do not currently support drift detection cannot be checked. For a list
|
|
3597
|
-
*
|
|
3504
|
+
* <p>Resources that do not currently support drift detection cannot be checked. For a list of
|
|
3505
|
+
* resources that support drift detection, see <a href="http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-stack-drift-resource-list.html">Resources that Support
|
|
3598
3506
|
* Drift Detection</a>.</p>
|
|
3599
|
-
* <p>Use <a>DetectStackResourceDrift</a> to detect drift on individual
|
|
3600
|
-
*
|
|
3601
|
-
*
|
|
3507
|
+
* <p>Use <a>DetectStackResourceDrift</a> to detect drift on individual resources,
|
|
3508
|
+
* or <a>DetectStackDrift</a> to detect drift on all resources in a given stack
|
|
3509
|
+
* that support drift detection.</p>
|
|
3602
3510
|
*/
|
|
3603
3511
|
export interface StackResourceDrift {
|
|
3604
3512
|
/**
|
|
@@ -3610,8 +3518,8 @@ export interface StackResourceDrift {
|
|
|
3610
3518
|
*/
|
|
3611
3519
|
LogicalResourceId: string | undefined;
|
|
3612
3520
|
/**
|
|
3613
|
-
* <p>The name or unique identifier that corresponds to a physical instance ID of a
|
|
3614
|
-
*
|
|
3521
|
+
* <p>The name or unique identifier that corresponds to a physical instance ID of a resource
|
|
3522
|
+
* supported by CloudFormation. </p>
|
|
3615
3523
|
*/
|
|
3616
3524
|
PhysicalResourceId?: string;
|
|
3617
3525
|
/**
|
|
@@ -3628,20 +3536,19 @@ export interface StackResourceDrift {
|
|
|
3628
3536
|
/**
|
|
3629
3537
|
* <p>A JSON structure containing the expected property values of the stack resource, as
|
|
3630
3538
|
* defined in the stack template and any values specified as template parameters. </p>
|
|
3631
|
-
* <p>For resources whose <code>StackResourceDriftStatus</code> is <code>DELETED</code>,
|
|
3632
|
-
*
|
|
3539
|
+
* <p>For resources whose <code>StackResourceDriftStatus</code> is <code>DELETED</code>, this
|
|
3540
|
+
* structure will not be present. </p>
|
|
3633
3541
|
*/
|
|
3634
3542
|
ExpectedProperties?: string;
|
|
3635
3543
|
/**
|
|
3636
|
-
* <p>A JSON structure containing the actual property values of the stack
|
|
3637
|
-
*
|
|
3638
|
-
*
|
|
3639
|
-
* this structure will not be present. </p>
|
|
3544
|
+
* <p>A JSON structure containing the actual property values of the stack resource.</p>
|
|
3545
|
+
* <p>For resources whose <code>StackResourceDriftStatus</code> is <code>DELETED</code>, this
|
|
3546
|
+
* structure will not be present. </p>
|
|
3640
3547
|
*/
|
|
3641
3548
|
ActualProperties?: string;
|
|
3642
3549
|
/**
|
|
3643
|
-
* <p>A collection of the resource properties whose actual values differ from their
|
|
3644
|
-
*
|
|
3550
|
+
* <p>A collection of the resource properties whose actual values differ from their expected
|
|
3551
|
+
* values. These will be present only for resources whose
|
|
3645
3552
|
* <code>StackResourceDriftStatus</code> is <code>MODIFIED</code>.
|
|
3646
3553
|
* </p>
|
|
3647
3554
|
*/
|
|
@@ -3657,9 +3564,9 @@ export interface StackResourceDrift {
|
|
|
3657
3564
|
* </li>
|
|
3658
3565
|
* <li>
|
|
3659
3566
|
* <p>
|
|
3660
|
-
* <code>MODIFIED</code>: One or more resource properties differ from their
|
|
3661
|
-
*
|
|
3662
|
-
*
|
|
3567
|
+
* <code>MODIFIED</code>: One or more resource properties differ from their expected
|
|
3568
|
+
* values (as defined in the stack template and any values specified as template
|
|
3569
|
+
* parameters).</p>
|
|
3663
3570
|
* </li>
|
|
3664
3571
|
* <li>
|
|
3665
3572
|
* <p>
|
|
@@ -3721,8 +3628,8 @@ export declare namespace DescribeStackResourceDriftsOutput {
|
|
|
3721
3628
|
*/
|
|
3722
3629
|
export interface DescribeStackResourcesInput {
|
|
3723
3630
|
/**
|
|
3724
|
-
* <p>The name or the unique stack ID that is associated with the stack, which are not
|
|
3725
|
-
*
|
|
3631
|
+
* <p>The name or the unique stack ID that is associated with the stack, which are not always
|
|
3632
|
+
* interchangeable:</p>
|
|
3726
3633
|
* <ul>
|
|
3727
3634
|
* <li>
|
|
3728
3635
|
* <p>Running stacks: You can specify either the stack's name or its unique stack
|
|
@@ -3743,14 +3650,14 @@ export interface DescribeStackResourcesInput {
|
|
|
3743
3650
|
*/
|
|
3744
3651
|
LogicalResourceId?: string;
|
|
3745
3652
|
/**
|
|
3746
|
-
* <p>The name or unique identifier that corresponds to a physical instance ID of a
|
|
3747
|
-
*
|
|
3653
|
+
* <p>The name or unique identifier that corresponds to a physical instance ID of a resource
|
|
3654
|
+
* supported by CloudFormation.</p>
|
|
3748
3655
|
* <p>For example, for an Amazon Elastic Compute Cloud (EC2) instance,
|
|
3749
3656
|
* <code>PhysicalResourceId</code> corresponds to the <code>InstanceId</code>. You can pass
|
|
3750
3657
|
* the EC2 <code>InstanceId</code> to <code>DescribeStackResources</code> to find which stack
|
|
3751
3658
|
* the instance belongs to and what other resources are part of the stack.</p>
|
|
3752
|
-
* <p>Required: Conditional. If you do not specify <code>PhysicalResourceId</code>, you
|
|
3753
|
-
*
|
|
3659
|
+
* <p>Required: Conditional. If you do not specify <code>PhysicalResourceId</code>, you must
|
|
3660
|
+
* specify <code>StackName</code>.</p>
|
|
3754
3661
|
* <p>Default: There is no default value.</p>
|
|
3755
3662
|
*/
|
|
3756
3663
|
PhysicalResourceId?: string;
|
|
@@ -3778,13 +3685,13 @@ export interface StackResource {
|
|
|
3778
3685
|
*/
|
|
3779
3686
|
LogicalResourceId: string | undefined;
|
|
3780
3687
|
/**
|
|
3781
|
-
* <p>The name or unique identifier that corresponds to a physical instance ID of a
|
|
3782
|
-
*
|
|
3688
|
+
* <p>The name or unique identifier that corresponds to a physical instance ID of a resource
|
|
3689
|
+
* supported by CloudFormation.</p>
|
|
3783
3690
|
*/
|
|
3784
3691
|
PhysicalResourceId?: string;
|
|
3785
3692
|
/**
|
|
3786
|
-
* <p>Type of resource. (For more information, go to <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-template-resource-type-ref.html">Amazon Web Services
|
|
3787
|
-
*
|
|
3693
|
+
* <p>Type of resource. (For more information, go to <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-template-resource-type-ref.html">Amazon Web Services Resource Types Reference</a> in the CloudFormation User
|
|
3694
|
+
* Guide.)</p>
|
|
3788
3695
|
*/
|
|
3789
3696
|
ResourceType: string | undefined;
|
|
3790
3697
|
/**
|
|
@@ -3842,8 +3749,8 @@ export declare namespace DescribeStackResourcesOutput {
|
|
|
3842
3749
|
*/
|
|
3843
3750
|
export interface DescribeStacksInput {
|
|
3844
3751
|
/**
|
|
3845
|
-
* <p>The name or the unique stack ID that is associated with the stack, which are not
|
|
3846
|
-
*
|
|
3752
|
+
* <p>The name or the unique stack ID that is associated with the stack, which are not always
|
|
3753
|
+
* interchangeable:</p>
|
|
3847
3754
|
* <ul>
|
|
3848
3755
|
* <li>
|
|
3849
3756
|
* <p>Running stacks: You can specify either the stack's name or its unique stack
|
|
@@ -3880,9 +3787,9 @@ export interface StackDriftInformation {
|
|
|
3880
3787
|
* <ul>
|
|
3881
3788
|
* <li>
|
|
3882
3789
|
* <p>
|
|
3883
|
-
* <code>DRIFTED</code>: The stack differs from its expected template
|
|
3884
|
-
*
|
|
3885
|
-
*
|
|
3790
|
+
* <code>DRIFTED</code>: The stack differs from its expected template configuration.
|
|
3791
|
+
* A stack is considered to have drifted if one or more of its resources have
|
|
3792
|
+
* drifted.</p>
|
|
3886
3793
|
* </li>
|
|
3887
3794
|
* <li>
|
|
3888
3795
|
* <p>
|
|
@@ -3902,8 +3809,8 @@ export interface StackDriftInformation {
|
|
|
3902
3809
|
*/
|
|
3903
3810
|
StackDriftStatus: StackDriftStatus | string | undefined;
|
|
3904
3811
|
/**
|
|
3905
|
-
* <p>Most recent time when a drift detection operation was initiated on the stack, or any
|
|
3906
|
-
*
|
|
3812
|
+
* <p>Most recent time when a drift detection operation was initiated on the stack, or any of
|
|
3813
|
+
* its individual resources that support drift detection.</p>
|
|
3907
3814
|
*/
|
|
3908
3815
|
LastCheckTimestamp?: Date;
|
|
3909
3816
|
}
|
|
@@ -3998,8 +3905,8 @@ export interface Stack {
|
|
|
3998
3905
|
*/
|
|
3999
3906
|
DeletionTime?: Date;
|
|
4000
3907
|
/**
|
|
4001
|
-
* <p>The time the stack was last updated. This field will only be returned if the stack
|
|
4002
|
-
*
|
|
3908
|
+
* <p>The time the stack was last updated. This field will only be returned if the stack has
|
|
3909
|
+
* been updated at least once.</p>
|
|
4003
3910
|
*/
|
|
4004
3911
|
LastUpdatedTime?: Date;
|
|
4005
3912
|
/**
|
|
@@ -4046,8 +3953,8 @@ export interface Stack {
|
|
|
4046
3953
|
*/
|
|
4047
3954
|
Outputs?: Output[];
|
|
4048
3955
|
/**
|
|
4049
|
-
* <p>The Amazon Resource Name (ARN) of an Identity and Access Management (IAM) role
|
|
4050
|
-
*
|
|
3956
|
+
* <p>The Amazon Resource Name (ARN) of an Identity and Access Management (IAM) role that is
|
|
3957
|
+
* associated with the stack. During a stack operation, CloudFormation uses this
|
|
4051
3958
|
* role's credentials to make calls on your behalf.</p>
|
|
4052
3959
|
*/
|
|
4053
3960
|
RoleARN?: string;
|
|
@@ -4067,15 +3974,13 @@ export interface Stack {
|
|
|
4067
3974
|
* <p>For nested stacks--stacks created as resources for another stack--the stack ID of the
|
|
4068
3975
|
* direct parent of this stack. For the first level of nested stacks, the root stack is also
|
|
4069
3976
|
* the parent stack.</p>
|
|
4070
|
-
* <p>For more information, see <a href="http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-nested-stacks.html">Working with Nested Stacks</a> in the
|
|
4071
|
-
* <i>CloudFormation User Guide</i>.</p>
|
|
3977
|
+
* <p>For more information, see <a href="http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-nested-stacks.html">Working with Nested Stacks</a> in the <i>CloudFormation User Guide</i>.</p>
|
|
4072
3978
|
*/
|
|
4073
3979
|
ParentId?: string;
|
|
4074
3980
|
/**
|
|
4075
3981
|
* <p>For nested stacks--stacks created as resources for another stack--the stack ID of the
|
|
4076
3982
|
* top-level stack to which the nested stack ultimately belongs.</p>
|
|
4077
|
-
* <p>For more information, see <a href="http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-nested-stacks.html">Working with Nested Stacks</a> in the
|
|
4078
|
-
* <i>CloudFormation User Guide</i>.</p>
|
|
3983
|
+
* <p>For more information, see <a href="http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-nested-stacks.html">Working with Nested Stacks</a> in the <i>CloudFormation User Guide</i>.</p>
|
|
4079
3984
|
*/
|
|
4080
3985
|
RootId?: string;
|
|
4081
3986
|
/**
|
|
@@ -4101,8 +4006,8 @@ export interface DescribeStacksOutput {
|
|
|
4101
4006
|
*/
|
|
4102
4007
|
Stacks?: Stack[];
|
|
4103
4008
|
/**
|
|
4104
|
-
* <p>If the output exceeds 1 MB in size, a string that identifies the next page of stacks.
|
|
4105
|
-
*
|
|
4009
|
+
* <p>If the output exceeds 1 MB in size, a string that identifies the next page of stacks. If
|
|
4010
|
+
* no additional page exists, this value is null.</p>
|
|
4106
4011
|
*/
|
|
4107
4012
|
NextToken?: string;
|
|
4108
4013
|
}
|
|
@@ -4276,9 +4181,9 @@ export declare namespace StackSetDriftDetectionDetails {
|
|
|
4276
4181
|
export declare type StackSetStatus = "ACTIVE" | "DELETED";
|
|
4277
4182
|
/**
|
|
4278
4183
|
* <p>A structure that contains information about a stack set. A stack set enables you to
|
|
4279
|
-
* provision stacks into Amazon Web Services accounts and across Regions by using a single
|
|
4280
|
-
*
|
|
4281
|
-
* capabilities that the template requires. </p>
|
|
4184
|
+
* provision stacks into Amazon Web Services accounts and across Regions by using a single
|
|
4185
|
+
* CloudFormation template. In the stack set, you specify the template to use, as
|
|
4186
|
+
* well as any parameters and capabilities that the template requires. </p>
|
|
4282
4187
|
*/
|
|
4283
4188
|
export interface StackSet {
|
|
4284
4189
|
/**
|
|
@@ -4299,8 +4204,8 @@ export interface StackSet {
|
|
|
4299
4204
|
*/
|
|
4300
4205
|
Status?: StackSetStatus | string;
|
|
4301
4206
|
/**
|
|
4302
|
-
* <p>The structure that contains the body of the template that was used to create or
|
|
4303
|
-
*
|
|
4207
|
+
* <p>The structure that contains the body of the template that was used to create or update
|
|
4208
|
+
* the stack set.</p>
|
|
4304
4209
|
*/
|
|
4305
4210
|
TemplateBody?: string;
|
|
4306
4211
|
/**
|
|
@@ -4309,14 +4214,15 @@ export interface StackSet {
|
|
|
4309
4214
|
Parameters?: Parameter[];
|
|
4310
4215
|
/**
|
|
4311
4216
|
* <p>The capabilities that are allowed in the stack set. Some stack set templates might
|
|
4312
|
-
* include resources that can affect permissions in your Amazon Web Services account—for
|
|
4313
|
-
* new Identity and Access Management (IAM) users. For more information, see
|
|
4217
|
+
* include resources that can affect permissions in your Amazon Web Services account—for
|
|
4218
|
+
* example, by creating new Identity and Access Management (IAM) users. For more information, see
|
|
4219
|
+
* <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html#capabilities">Acknowledging IAM Resources in CloudFormation Templates.</a>
|
|
4314
4220
|
* </p>
|
|
4315
4221
|
*/
|
|
4316
4222
|
Capabilities?: (Capability | string)[];
|
|
4317
4223
|
/**
|
|
4318
|
-
* <p>A list of tags that specify information about the stack set. A maximum number of 50
|
|
4319
|
-
*
|
|
4224
|
+
* <p>A list of tags that specify information about the stack set. A maximum number of 50 tags
|
|
4225
|
+
* can be specified.</p>
|
|
4320
4226
|
*/
|
|
4321
4227
|
Tags?: Tag[];
|
|
4322
4228
|
/**
|
|
@@ -4372,6 +4278,11 @@ export interface StackSet {
|
|
|
4372
4278
|
* that you specified for <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_DeploymentTargets.html">DeploymentTargets</a>.</p>
|
|
4373
4279
|
*/
|
|
4374
4280
|
OrganizationalUnitIds?: string[];
|
|
4281
|
+
/**
|
|
4282
|
+
* <p>Describes whether StackSets performs non-conflicting operations concurrently and queues
|
|
4283
|
+
* conflicting operations.</p>
|
|
4284
|
+
*/
|
|
4285
|
+
ManagedExecution?: ManagedExecution;
|
|
4375
4286
|
}
|
|
4376
4287
|
export declare namespace StackSet {
|
|
4377
4288
|
/**
|
|
@@ -4453,13 +4364,13 @@ export interface StackSetOperation {
|
|
|
4453
4364
|
* <ul>
|
|
4454
4365
|
* <li>
|
|
4455
4366
|
* <p>
|
|
4456
|
-
* <code>FAILED</code>: The operation exceeded the specified failure tolerance.
|
|
4457
|
-
*
|
|
4458
|
-
*
|
|
4459
|
-
*
|
|
4460
|
-
*
|
|
4461
|
-
*
|
|
4462
|
-
*
|
|
4367
|
+
* <code>FAILED</code>: The operation exceeded the specified failure tolerance. The
|
|
4368
|
+
* failure tolerance value that you've set for an operation is applied for each Region
|
|
4369
|
+
* during stack create and update operations. If the number of failed stacks within a
|
|
4370
|
+
* Region exceeds the failure tolerance, the status of the operation in the Region is
|
|
4371
|
+
* set to <code>FAILED</code>. This in turn sets the status of the operation as a whole
|
|
4372
|
+
* to <code>FAILED</code>, and CloudFormation cancels the operation in any
|
|
4373
|
+
* remaining Regions.</p>
|
|
4463
4374
|
* </li>
|
|
4464
4375
|
* <li>
|
|
4465
4376
|
* <p>
|
|
@@ -4490,15 +4401,13 @@ export interface StackSetOperation {
|
|
|
4490
4401
|
*/
|
|
4491
4402
|
Status?: StackSetOperationStatus | string;
|
|
4492
4403
|
/**
|
|
4493
|
-
* <p>The preferences for how CloudFormation performs this stack set
|
|
4494
|
-
* operation.</p>
|
|
4404
|
+
* <p>The preferences for how CloudFormation performs this stack set operation.</p>
|
|
4495
4405
|
*/
|
|
4496
4406
|
OperationPreferences?: StackSetOperationPreferences;
|
|
4497
4407
|
/**
|
|
4498
|
-
* <p>For stack set operations of action type <code>DELETE</code>, specifies whether to
|
|
4499
|
-
*
|
|
4500
|
-
*
|
|
4501
|
-
* set.</p>
|
|
4408
|
+
* <p>For stack set operations of action type <code>DELETE</code>, specifies whether to remove
|
|
4409
|
+
* the stack instances from the specified stack set, but doesn't delete the stacks. You can't
|
|
4410
|
+
* reassociate a retained stack, or add an existing, saved stack to a new stack set.</p>
|
|
4502
4411
|
*/
|
|
4503
4412
|
RetainStacks?: boolean;
|
|
4504
4413
|
/**
|
|
@@ -4518,9 +4427,9 @@ export interface StackSetOperation {
|
|
|
4518
4427
|
/**
|
|
4519
4428
|
* <p>The time at which the operation was initiated. Note that the creation times for the
|
|
4520
4429
|
* stack set operation might differ from the creation time of the individual stacks
|
|
4521
|
-
* themselves. This is because CloudFormation needs to perform preparatory work for
|
|
4522
|
-
* operation, such as dispatching the work to the requested Regions, before actually
|
|
4523
|
-
* the first stacks.</p>
|
|
4430
|
+
* themselves. This is because CloudFormation needs to perform preparatory work for
|
|
4431
|
+
* the operation, such as dispatching the work to the requested Regions, before actually
|
|
4432
|
+
* creating the first stacks.</p>
|
|
4524
4433
|
*/
|
|
4525
4434
|
CreationTimestamp?: Date;
|
|
4526
4435
|
/**
|
|
@@ -4570,12 +4479,6 @@ export interface OperationNotFoundException extends __SmithyException, $Metadata
|
|
|
4570
4479
|
$fault: "client";
|
|
4571
4480
|
Message?: string;
|
|
4572
4481
|
}
|
|
4573
|
-
export declare namespace OperationNotFoundException {
|
|
4574
|
-
/**
|
|
4575
|
-
* @internal
|
|
4576
|
-
*/
|
|
4577
|
-
const filterSensitiveLog: (obj: OperationNotFoundException) => any;
|
|
4578
|
-
}
|
|
4579
4482
|
export interface DescribeTypeInput {
|
|
4580
4483
|
/**
|
|
4581
4484
|
* <p>The kind of extension. </p>
|
|
@@ -5119,8 +5022,8 @@ export interface EstimateTemplateCostInput {
|
|
|
5119
5022
|
*/
|
|
5120
5023
|
TemplateBody?: string;
|
|
5121
5024
|
/**
|
|
5122
|
-
* <p>Location of file containing the template body. The URL must point to a template that
|
|
5123
|
-
*
|
|
5025
|
+
* <p>Location of file containing the template body. The URL must point to a template that is
|
|
5026
|
+
* located in an Amazon S3 bucket or a Systems Manager document. For more information, go to
|
|
5124
5027
|
* <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html">Template Anatomy</a>
|
|
5125
5028
|
* in the CloudFormation User Guide.</p>
|
|
5126
5029
|
* <p>Conditional: You must pass <code>TemplateURL</code> or <code>TemplateBody</code>. If
|
|
@@ -5143,8 +5046,8 @@ export declare namespace EstimateTemplateCostInput {
|
|
|
5143
5046
|
*/
|
|
5144
5047
|
export interface EstimateTemplateCostOutput {
|
|
5145
5048
|
/**
|
|
5146
|
-
* <p>An Amazon Web Services Simple Monthly Calculator URL with a query string that describes
|
|
5147
|
-
* required to run the template.</p>
|
|
5049
|
+
* <p>An Amazon Web Services Simple Monthly Calculator URL with a query string that describes
|
|
5050
|
+
* the resources required to run the template.</p>
|
|
5148
5051
|
*/
|
|
5149
5052
|
Url?: string;
|
|
5150
5053
|
}
|
|
@@ -5169,11 +5072,11 @@ export interface ExecuteChangeSetInput {
|
|
|
5169
5072
|
*/
|
|
5170
5073
|
StackName?: string;
|
|
5171
5074
|
/**
|
|
5172
|
-
* <p>A unique identifier for this <code>ExecuteChangeSet</code> request. Specify this
|
|
5173
|
-
*
|
|
5075
|
+
* <p>A unique identifier for this <code>ExecuteChangeSet</code> request. Specify this token
|
|
5076
|
+
* if you plan to retry requests so that CloudFormation knows that you're not
|
|
5174
5077
|
* attempting to execute a change set to update a stack with the same name. You might retry
|
|
5175
|
-
*
|
|
5176
|
-
* received them.</p>
|
|
5078
|
+
* <code>ExecuteChangeSet</code> requests to ensure that CloudFormation
|
|
5079
|
+
* successfully received them.</p>
|
|
5177
5080
|
*/
|
|
5178
5081
|
ClientRequestToken?: string;
|
|
5179
5082
|
/**
|
|
@@ -5205,8 +5108,8 @@ export declare namespace ExecuteChangeSetOutput {
|
|
|
5205
5108
|
*/
|
|
5206
5109
|
export interface GetStackPolicyInput {
|
|
5207
5110
|
/**
|
|
5208
|
-
* <p>The name or unique stack ID that is associated with the stack whose policy you want
|
|
5209
|
-
*
|
|
5111
|
+
* <p>The name or unique stack ID that is associated with the stack whose policy you want to
|
|
5112
|
+
* get.</p>
|
|
5210
5113
|
*/
|
|
5211
5114
|
StackName: string | undefined;
|
|
5212
5115
|
}
|
|
@@ -5241,8 +5144,8 @@ export declare enum TemplateStage {
|
|
|
5241
5144
|
*/
|
|
5242
5145
|
export interface GetTemplateInput {
|
|
5243
5146
|
/**
|
|
5244
|
-
* <p>The name or the unique stack ID that is associated with the stack, which are not
|
|
5245
|
-
*
|
|
5147
|
+
* <p>The name or the unique stack ID that is associated with the stack, which are not always
|
|
5148
|
+
* interchangeable:</p>
|
|
5246
5149
|
* <ul>
|
|
5247
5150
|
* <li>
|
|
5248
5151
|
* <p>Running stacks: You can specify either the stack's name or its unique stack
|
|
@@ -5288,11 +5191,11 @@ export interface GetTemplateOutput {
|
|
|
5288
5191
|
*/
|
|
5289
5192
|
TemplateBody?: string;
|
|
5290
5193
|
/**
|
|
5291
|
-
* <p>The stage of the template that you can retrieve. For stacks, the
|
|
5292
|
-
*
|
|
5293
|
-
*
|
|
5294
|
-
*
|
|
5295
|
-
*
|
|
5194
|
+
* <p>The stage of the template that you can retrieve. For stacks, the <code>Original</code>
|
|
5195
|
+
* and <code>Processed</code> templates are always available. For change sets, the
|
|
5196
|
+
* <code>Original</code> template is always available. After CloudFormation
|
|
5197
|
+
* finishes creating the change set, the <code>Processed</code> template becomes
|
|
5198
|
+
* available.</p>
|
|
5296
5199
|
*/
|
|
5297
5200
|
StagesAvailable?: (TemplateStage | string)[];
|
|
5298
5201
|
}
|
|
@@ -5367,9 +5270,9 @@ export declare namespace GetTemplateSummaryInput {
|
|
|
5367
5270
|
const filterSensitiveLog: (obj: GetTemplateSummaryInput) => any;
|
|
5368
5271
|
}
|
|
5369
5272
|
/**
|
|
5370
|
-
* <p>A set of criteria that CloudFormation uses to validate parameter values.
|
|
5371
|
-
* other constraints might be defined in the stack template, CloudFormation
|
|
5372
|
-
* the <code>AllowedValues</code> property.</p>
|
|
5273
|
+
* <p>A set of criteria that CloudFormation uses to validate parameter values.
|
|
5274
|
+
* Although other constraints might be defined in the stack template, CloudFormation
|
|
5275
|
+
* returns only the <code>AllowedValues</code> property.</p>
|
|
5373
5276
|
*/
|
|
5374
5277
|
export interface ParameterConstraints {
|
|
5375
5278
|
/**
|
|
@@ -5463,11 +5366,12 @@ export interface GetTemplateSummaryOutput {
|
|
|
5463
5366
|
*/
|
|
5464
5367
|
Description?: string;
|
|
5465
5368
|
/**
|
|
5466
|
-
* <p>The capabilities found within the template. If your template contains IAM
|
|
5467
|
-
* you must specify the <code>CAPABILITY_IAM</code> or
|
|
5468
|
-
*
|
|
5469
|
-
*
|
|
5470
|
-
* <p>For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html#capabilities">Acknowledging IAM Resources in CloudFormation
|
|
5369
|
+
* <p>The capabilities found within the template. If your template contains IAM
|
|
5370
|
+
* resources, you must specify the <code>CAPABILITY_IAM</code> or
|
|
5371
|
+
* <code>CAPABILITY_NAMED_IAM</code> value for this parameter when you use the <a>CreateStack</a> or <a>UpdateStack</a> actions with your template;
|
|
5372
|
+
* otherwise, those actions return an <code>InsufficientCapabilities</code> error.</p>
|
|
5373
|
+
* <p>For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html#capabilities">Acknowledging IAM Resources in CloudFormation
|
|
5374
|
+
* Templates</a>.</p>
|
|
5471
5375
|
*/
|
|
5472
5376
|
Capabilities?: (Capability | string)[];
|
|
5473
5377
|
/**
|
|
@@ -5487,8 +5391,7 @@ export interface GetTemplateSummaryOutput {
|
|
|
5487
5391
|
*/
|
|
5488
5392
|
Version?: string;
|
|
5489
5393
|
/**
|
|
5490
|
-
* <p>The value that is defined for the <code>Metadata</code> property of the
|
|
5491
|
-
* template.</p>
|
|
5394
|
+
* <p>The value that is defined for the <code>Metadata</code> property of the template.</p>
|
|
5492
5395
|
*/
|
|
5493
5396
|
Metadata?: string;
|
|
5494
5397
|
/**
|
|
@@ -5518,8 +5421,19 @@ export interface ImportStacksToStackSetInput {
|
|
|
5518
5421
|
/**
|
|
5519
5422
|
* <p>The IDs of the stacks you are importing into a stack set. You import up to 10 stacks per
|
|
5520
5423
|
* stack set at a time.</p>
|
|
5424
|
+
* <p>Specify either <code>StackIds</code> or <code>StackIdsUrl</code>.</p>
|
|
5425
|
+
*/
|
|
5426
|
+
StackIds?: string[];
|
|
5427
|
+
/**
|
|
5428
|
+
* <p>The Amazon S3 URL which contains list of stack ids to be inputted.</p>
|
|
5429
|
+
* <p>Specify either <code>StackIds</code> or <code>StackIdsUrl</code>.</p>
|
|
5430
|
+
*/
|
|
5431
|
+
StackIdsUrl?: string;
|
|
5432
|
+
/**
|
|
5433
|
+
* <p>The list of OU ID’s to which the stacks being imported has to be mapped as deployment
|
|
5434
|
+
* target.</p>
|
|
5521
5435
|
*/
|
|
5522
|
-
|
|
5436
|
+
OrganizationalUnitIds?: string[];
|
|
5523
5437
|
/**
|
|
5524
5438
|
* <p>The user-specified preferences for how CloudFormation performs a stack set
|
|
5525
5439
|
* operation. </p>
|
|
@@ -5571,12 +5485,6 @@ export interface StackNotFoundException extends __SmithyException, $MetadataBear
|
|
|
5571
5485
|
$fault: "client";
|
|
5572
5486
|
Message?: string;
|
|
5573
5487
|
}
|
|
5574
|
-
export declare namespace StackNotFoundException {
|
|
5575
|
-
/**
|
|
5576
|
-
* @internal
|
|
5577
|
-
*/
|
|
5578
|
-
const filterSensitiveLog: (obj: StackNotFoundException) => any;
|
|
5579
|
-
}
|
|
5580
5488
|
/**
|
|
5581
5489
|
* <p>The input for the <a>ListChangeSets</a> action.</p>
|
|
5582
5490
|
*/
|
|
@@ -5621,8 +5529,8 @@ export declare namespace ListChangeSetsOutput {
|
|
|
5621
5529
|
}
|
|
5622
5530
|
export interface ListExportsInput {
|
|
5623
5531
|
/**
|
|
5624
|
-
* <p>A string (provided by the <a>ListExports</a> response output) that
|
|
5625
|
-
*
|
|
5532
|
+
* <p>A string (provided by the <a>ListExports</a> response output) that identifies
|
|
5533
|
+
* the next page of exported output values that you asked to retrieve.</p>
|
|
5626
5534
|
*/
|
|
5627
5535
|
NextToken?: string;
|
|
5628
5536
|
}
|
|
@@ -5644,13 +5552,12 @@ export interface Export {
|
|
|
5644
5552
|
/**
|
|
5645
5553
|
* <p>The name of exported output value. Use this name and the <code>Fn::ImportValue</code>
|
|
5646
5554
|
* function to import the associated value into other stacks. The name is defined in the
|
|
5647
|
-
* <code>Export</code> field in the associated stack's <code>Outputs</code>
|
|
5648
|
-
* section.</p>
|
|
5555
|
+
* <code>Export</code> field in the associated stack's <code>Outputs</code> section.</p>
|
|
5649
5556
|
*/
|
|
5650
5557
|
Name?: string;
|
|
5651
5558
|
/**
|
|
5652
|
-
* <p>The value of the exported output, such as a resource physical ID. This value is
|
|
5653
|
-
*
|
|
5559
|
+
* <p>The value of the exported output, such as a resource physical ID. This value is defined
|
|
5560
|
+
* in the <code>Export</code> field in the associated stack's <code>Outputs</code>
|
|
5654
5561
|
* section.</p>
|
|
5655
5562
|
*/
|
|
5656
5563
|
Value?: string;
|
|
@@ -5667,8 +5574,8 @@ export interface ListExportsOutput {
|
|
|
5667
5574
|
*/
|
|
5668
5575
|
Exports?: Export[];
|
|
5669
5576
|
/**
|
|
5670
|
-
* <p>If the output exceeds 100 exported output values, a string that identifies the next
|
|
5671
|
-
*
|
|
5577
|
+
* <p>If the output exceeds 100 exported output values, a string that identifies the next page
|
|
5578
|
+
* of exports. If there is no additional page, this value is null.</p>
|
|
5672
5579
|
*/
|
|
5673
5580
|
NextToken?: string;
|
|
5674
5581
|
}
|
|
@@ -5702,8 +5609,8 @@ export interface ListImportsOutput {
|
|
|
5702
5609
|
*/
|
|
5703
5610
|
Imports?: string[];
|
|
5704
5611
|
/**
|
|
5705
|
-
* <p>A string that identifies the next page of exports. If there is no additional page,
|
|
5706
|
-
*
|
|
5612
|
+
* <p>A string that identifies the next page of exports. If there is no additional page, this
|
|
5613
|
+
* value is null.</p>
|
|
5707
5614
|
*/
|
|
5708
5615
|
NextToken?: string;
|
|
5709
5616
|
}
|
|
@@ -5735,8 +5642,7 @@ export declare namespace StackInstanceFilter {
|
|
|
5735
5642
|
}
|
|
5736
5643
|
export interface ListStackInstancesInput {
|
|
5737
5644
|
/**
|
|
5738
|
-
* <p>The name or unique ID of the stack set that you want to list stack instances
|
|
5739
|
-
* for.</p>
|
|
5645
|
+
* <p>The name or unique ID of the stack set that you want to list stack instances for.</p>
|
|
5740
5646
|
*/
|
|
5741
5647
|
StackSetName: string | undefined;
|
|
5742
5648
|
/**
|
|
@@ -5759,7 +5665,8 @@ export interface ListStackInstancesInput {
|
|
|
5759
5665
|
*/
|
|
5760
5666
|
Filters?: StackInstanceFilter[];
|
|
5761
5667
|
/**
|
|
5762
|
-
* <p>The name of the Amazon Web Services account that you want to list stack instances
|
|
5668
|
+
* <p>The name of the Amazon Web Services account that you want to list stack instances
|
|
5669
|
+
* for.</p>
|
|
5763
5670
|
*/
|
|
5764
5671
|
StackInstanceAccount?: string;
|
|
5765
5672
|
/**
|
|
@@ -5802,11 +5709,13 @@ export interface StackInstanceSummary {
|
|
|
5802
5709
|
*/
|
|
5803
5710
|
StackSetId?: string;
|
|
5804
5711
|
/**
|
|
5805
|
-
* <p>The name of the Amazon Web Services Region that the stack instance is associated
|
|
5712
|
+
* <p>The name of the Amazon Web Services Region that the stack instance is associated
|
|
5713
|
+
* with.</p>
|
|
5806
5714
|
*/
|
|
5807
5715
|
Region?: string;
|
|
5808
5716
|
/**
|
|
5809
|
-
* <p>[Self-managed permissions] The name of the Amazon Web Services account that the stack
|
|
5717
|
+
* <p>[Self-managed permissions] The name of the Amazon Web Services account that the stack
|
|
5718
|
+
* instance is associated with.</p>
|
|
5810
5719
|
*/
|
|
5811
5720
|
Account?: string;
|
|
5812
5721
|
/**
|
|
@@ -5819,9 +5728,9 @@ export interface StackInstanceSummary {
|
|
|
5819
5728
|
* <ul>
|
|
5820
5729
|
* <li>
|
|
5821
5730
|
* <p>
|
|
5822
|
-
* <code>INOPERABLE</code>: A <code>DeleteStackInstances</code> operation has
|
|
5823
|
-
*
|
|
5824
|
-
*
|
|
5731
|
+
* <code>INOPERABLE</code>: A <code>DeleteStackInstances</code> operation has failed
|
|
5732
|
+
* and left the stack in an unstable state. Stacks in this state are excluded from
|
|
5733
|
+
* further <code>UpdateStackSet</code> operations. You might need to perform a
|
|
5825
5734
|
* <code>DeleteStackInstances</code> operation, with <code>RetainStacks</code> set to
|
|
5826
5735
|
* <code>true</code>, to delete the stack instance, and then delete the stack
|
|
5827
5736
|
* manually.</p>
|
|
@@ -5844,15 +5753,13 @@ export interface StackInstanceSummary {
|
|
|
5844
5753
|
* </li>
|
|
5845
5754
|
* <li>
|
|
5846
5755
|
* <p>
|
|
5847
|
-
* <code>CURRENT</code>: The stack is currently up to date with the stack
|
|
5848
|
-
* set.</p>
|
|
5756
|
+
* <code>CURRENT</code>: The stack is currently up to date with the stack set.</p>
|
|
5849
5757
|
* </li>
|
|
5850
5758
|
* </ul>
|
|
5851
5759
|
*/
|
|
5852
5760
|
Status?: StackInstanceStatus | string;
|
|
5853
5761
|
/**
|
|
5854
|
-
* <p>The explanation for the specific status code assigned to this stack
|
|
5855
|
-
* instance.</p>
|
|
5762
|
+
* <p>The explanation for the specific status code assigned to this stack instance.</p>
|
|
5856
5763
|
*/
|
|
5857
5764
|
StatusReason?: string;
|
|
5858
5765
|
/**
|
|
@@ -5915,8 +5822,7 @@ export interface ListStackInstancesOutput {
|
|
|
5915
5822
|
* <p>If the request doesn't return all of the remaining results, <code>NextToken</code> is
|
|
5916
5823
|
* set to a token. To retrieve the next set of results, call <code>ListStackInstances</code>
|
|
5917
5824
|
* again and assign that token to the request object's <code>NextToken</code> parameter. If
|
|
5918
|
-
* the request returns all results, <code>NextToken</code> is set to
|
|
5919
|
-
* <code>null</code>.</p>
|
|
5825
|
+
* the request returns all results, <code>NextToken</code> is set to <code>null</code>.</p>
|
|
5920
5826
|
*/
|
|
5921
5827
|
NextToken?: string;
|
|
5922
5828
|
}
|
|
@@ -5931,8 +5837,8 @@ export declare namespace ListStackInstancesOutput {
|
|
|
5931
5837
|
*/
|
|
5932
5838
|
export interface ListStackResourcesInput {
|
|
5933
5839
|
/**
|
|
5934
|
-
* <p>The name or the unique stack ID that is associated with the stack, which are not
|
|
5935
|
-
*
|
|
5840
|
+
* <p>The name or the unique stack ID that is associated with the stack, which are not always
|
|
5841
|
+
* interchangeable:</p>
|
|
5936
5842
|
* <ul>
|
|
5937
5843
|
* <li>
|
|
5938
5844
|
* <p>Running stacks: You can specify either the stack's name or its unique stack
|
|
@@ -5958,8 +5864,8 @@ export declare namespace ListStackResourcesInput {
|
|
|
5958
5864
|
const filterSensitiveLog: (obj: ListStackResourcesInput) => any;
|
|
5959
5865
|
}
|
|
5960
5866
|
/**
|
|
5961
|
-
* <p>Summarizes information about whether the resource's actual configuration differs, or
|
|
5962
|
-
*
|
|
5867
|
+
* <p>Summarizes information about whether the resource's actual configuration differs, or has
|
|
5868
|
+
* <i>drifted</i>, from its expected configuration.</p>
|
|
5963
5869
|
*/
|
|
5964
5870
|
export interface StackResourceDriftInformationSummary {
|
|
5965
5871
|
/**
|
|
@@ -5968,8 +5874,8 @@ export interface StackResourceDriftInformationSummary {
|
|
|
5968
5874
|
* <ul>
|
|
5969
5875
|
* <li>
|
|
5970
5876
|
* <p>
|
|
5971
|
-
* <code>DELETED</code>: The resource differs from its expected configuration in
|
|
5972
|
-
*
|
|
5877
|
+
* <code>DELETED</code>: The resource differs from its expected configuration in that
|
|
5878
|
+
* it has been deleted.</p>
|
|
5973
5879
|
* </li>
|
|
5974
5880
|
* <li>
|
|
5975
5881
|
* <p>
|
|
@@ -5978,8 +5884,8 @@ export interface StackResourceDriftInformationSummary {
|
|
|
5978
5884
|
* </li>
|
|
5979
5885
|
* <li>
|
|
5980
5886
|
* <p>
|
|
5981
|
-
* <code>NOT_CHECKED</code>: CloudFormation has not checked if the resource differs from
|
|
5982
|
-
*
|
|
5887
|
+
* <code>NOT_CHECKED</code>: CloudFormation has not checked if the resource differs from its
|
|
5888
|
+
* expected configuration.</p>
|
|
5983
5889
|
* <p>Any resources that do not currently support drift detection have a status of
|
|
5984
5890
|
* <code>NOT_CHECKED</code>. For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-stack-drift-resource-list.html">Resources that Support Drift Detection</a>. If you performed an <a>ContinueUpdateRollback</a> operation on a stack, any resources included in
|
|
5985
5891
|
* <code>ResourcesToSkip</code> will also have a status of <code>NOT_CHECKED</code>.
|
|
@@ -6019,8 +5925,8 @@ export interface StackResourceSummary {
|
|
|
6019
5925
|
*/
|
|
6020
5926
|
PhysicalResourceId?: string;
|
|
6021
5927
|
/**
|
|
6022
|
-
* <p>Type of resource. (For more information, go to <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-template-resource-type-ref.html">Amazon Web Services
|
|
6023
|
-
*
|
|
5928
|
+
* <p>Type of resource. (For more information, go to <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-template-resource-type-ref.html">Amazon Web Services Resource Types Reference</a> in the CloudFormation User
|
|
5929
|
+
* Guide.)</p>
|
|
6024
5930
|
*/
|
|
6025
5931
|
ResourceType: string | undefined;
|
|
6026
5932
|
/**
|
|
@@ -6063,8 +5969,8 @@ export interface ListStackResourcesOutput {
|
|
|
6063
5969
|
*/
|
|
6064
5970
|
StackResourceSummaries?: StackResourceSummary[];
|
|
6065
5971
|
/**
|
|
6066
|
-
* <p>If the output exceeds 1 MB, a string that identifies the next page of stack
|
|
6067
|
-
*
|
|
5972
|
+
* <p>If the output exceeds 1 MB, a string that identifies the next page of stack resources.
|
|
5973
|
+
* If no additional page exists, this value is null.</p>
|
|
6068
5974
|
*/
|
|
6069
5975
|
NextToken?: string;
|
|
6070
5976
|
}
|
|
@@ -6108,9 +6014,9 @@ export interface StackDriftInformationSummary {
|
|
|
6108
6014
|
* <ul>
|
|
6109
6015
|
* <li>
|
|
6110
6016
|
* <p>
|
|
6111
|
-
* <code>DRIFTED</code>: The stack differs from its expected template
|
|
6112
|
-
*
|
|
6113
|
-
*
|
|
6017
|
+
* <code>DRIFTED</code>: The stack differs from its expected template configuration.
|
|
6018
|
+
* A stack is considered to have drifted if one or more of its resources have
|
|
6019
|
+
* drifted.</p>
|
|
6114
6020
|
* </li>
|
|
6115
6021
|
* <li>
|
|
6116
6022
|
* <p>
|
|
@@ -6130,8 +6036,8 @@ export interface StackDriftInformationSummary {
|
|
|
6130
6036
|
*/
|
|
6131
6037
|
StackDriftStatus: StackDriftStatus | string | undefined;
|
|
6132
6038
|
/**
|
|
6133
|
-
* <p>Most recent time when a drift detection operation was initiated on the stack, or any
|
|
6134
|
-
*
|
|
6039
|
+
* <p>Most recent time when a drift detection operation was initiated on the stack, or any of
|
|
6040
|
+
* its individual resources that support drift detection.</p>
|
|
6135
6041
|
*/
|
|
6136
6042
|
LastCheckTimestamp?: Date;
|
|
6137
6043
|
}
|
|
@@ -6162,8 +6068,8 @@ export interface StackSummary {
|
|
|
6162
6068
|
*/
|
|
6163
6069
|
CreationTime: Date | undefined;
|
|
6164
6070
|
/**
|
|
6165
|
-
* <p>The time the stack was last updated. This field will only be returned if the stack
|
|
6166
|
-
*
|
|
6071
|
+
* <p>The time the stack was last updated. This field will only be returned if the stack has
|
|
6072
|
+
* been updated at least once.</p>
|
|
6167
6073
|
*/
|
|
6168
6074
|
LastUpdatedTime?: Date;
|
|
6169
6075
|
/**
|
|
@@ -6182,15 +6088,13 @@ export interface StackSummary {
|
|
|
6182
6088
|
* <p>For nested stacks--stacks created as resources for another stack--the stack ID of the
|
|
6183
6089
|
* direct parent of this stack. For the first level of nested stacks, the root stack is also
|
|
6184
6090
|
* the parent stack.</p>
|
|
6185
|
-
* <p>For more information, see <a href="http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-nested-stacks.html">Working with Nested Stacks</a> in the
|
|
6186
|
-
* <i>CloudFormation User Guide</i>.</p>
|
|
6091
|
+
* <p>For more information, see <a href="http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-nested-stacks.html">Working with Nested Stacks</a> in the <i>CloudFormation User Guide</i>.</p>
|
|
6187
6092
|
*/
|
|
6188
6093
|
ParentId?: string;
|
|
6189
6094
|
/**
|
|
6190
6095
|
* <p>For nested stacks--stacks created as resources for another stack--the stack ID of the
|
|
6191
6096
|
* top-level stack to which the nested stack ultimately belongs.</p>
|
|
6192
|
-
* <p>For more information, see <a href="http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-nested-stacks.html">Working with Nested Stacks</a> in the
|
|
6193
|
-
* <i>CloudFormation User Guide</i>.</p>
|
|
6097
|
+
* <p>For more information, see <a href="http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-nested-stacks.html">Working with Nested Stacks</a> in the <i>CloudFormation User Guide</i>.</p>
|
|
6194
6098
|
*/
|
|
6195
6099
|
RootId?: string;
|
|
6196
6100
|
/**
|
|
@@ -6217,8 +6121,8 @@ export interface ListStacksOutput {
|
|
|
6217
6121
|
*/
|
|
6218
6122
|
StackSummaries?: StackSummary[];
|
|
6219
6123
|
/**
|
|
6220
|
-
* <p>If the output exceeds 1 MB in size, a string that identifies the next page of stacks.
|
|
6221
|
-
*
|
|
6124
|
+
* <p>If the output exceeds 1 MB in size, a string that identifies the next page of stacks. If
|
|
6125
|
+
* no additional page exists, this value is null.</p>
|
|
6222
6126
|
*/
|
|
6223
6127
|
NextToken?: string;
|
|
6224
6128
|
}
|
|
@@ -6287,7 +6191,8 @@ export declare type StackSetOperationResultStatus = "CANCELLED" | "FAILED" | "PE
|
|
|
6287
6191
|
*/
|
|
6288
6192
|
export interface StackSetOperationResultSummary {
|
|
6289
6193
|
/**
|
|
6290
|
-
* <p>[Self-managed permissions] The name of the Amazon Web Services account for this operation
|
|
6194
|
+
* <p>[Self-managed permissions] The name of the Amazon Web Services account for this operation
|
|
6195
|
+
* result.</p>
|
|
6291
6196
|
*/
|
|
6292
6197
|
Account?: string;
|
|
6293
6198
|
/**
|
|
@@ -6300,16 +6205,15 @@ export interface StackSetOperationResultSummary {
|
|
|
6300
6205
|
* <ul>
|
|
6301
6206
|
* <li>
|
|
6302
6207
|
* <p>
|
|
6303
|
-
* <code>CANCELLED</code>: The operation in the specified account and Region has
|
|
6304
|
-
*
|
|
6208
|
+
* <code>CANCELLED</code>: The operation in the specified account and Region has been
|
|
6209
|
+
* cancelled. This is either because a user has stopped the stack set operation, or
|
|
6305
6210
|
* because the failure tolerance of the stack set operation has been exceeded.</p>
|
|
6306
6211
|
* </li>
|
|
6307
6212
|
* <li>
|
|
6308
6213
|
* <p>
|
|
6309
6214
|
* <code>FAILED</code>: The operation in the specified account and Region failed. </p>
|
|
6310
|
-
* <p>If the stack set operation fails in enough accounts within a Region, the
|
|
6311
|
-
*
|
|
6312
|
-
* </p>
|
|
6215
|
+
* <p>If the stack set operation fails in enough accounts within a Region, the failure
|
|
6216
|
+
* tolerance for the stack set operation as a whole might be exceeded. </p>
|
|
6313
6217
|
* </li>
|
|
6314
6218
|
* <li>
|
|
6315
6219
|
* <p>
|
|
@@ -6318,8 +6222,8 @@ export interface StackSetOperationResultSummary {
|
|
|
6318
6222
|
* </li>
|
|
6319
6223
|
* <li>
|
|
6320
6224
|
* <p>
|
|
6321
|
-
* <code>PENDING</code>: The operation in the specified account and Region has yet
|
|
6322
|
-
*
|
|
6225
|
+
* <code>PENDING</code>: The operation in the specified account and Region has yet to
|
|
6226
|
+
* start. </p>
|
|
6323
6227
|
* </li>
|
|
6324
6228
|
* <li>
|
|
6325
6229
|
* <p>
|
|
@@ -6358,9 +6262,9 @@ export interface ListStackSetOperationResultsOutput {
|
|
|
6358
6262
|
*/
|
|
6359
6263
|
Summaries?: StackSetOperationResultSummary[];
|
|
6360
6264
|
/**
|
|
6361
|
-
* <p>If the request doesn't return all results, <code>NextToken</code> is set to a token.
|
|
6362
|
-
*
|
|
6363
|
-
*
|
|
6265
|
+
* <p>If the request doesn't return all results, <code>NextToken</code> is set to a token. To
|
|
6266
|
+
* retrieve the next set of results, call <code>ListOperationResults</code> again and assign
|
|
6267
|
+
* that token to the request object's <code>NextToken</code> parameter. If there are no
|
|
6364
6268
|
* remaining results, <code>NextToken</code> is set to <code>null</code>.</p>
|
|
6365
6269
|
*/
|
|
6366
6270
|
NextToken?: string;
|
|
@@ -6420,8 +6324,7 @@ export declare namespace ListStackSetOperationsInput {
|
|
|
6420
6324
|
const filterSensitiveLog: (obj: ListStackSetOperationsInput) => any;
|
|
6421
6325
|
}
|
|
6422
6326
|
/**
|
|
6423
|
-
* <p>The structures that contain summary information about the specified
|
|
6424
|
-
* operation.</p>
|
|
6327
|
+
* <p>The structures that contain summary information about the specified operation.</p>
|
|
6425
6328
|
*/
|
|
6426
6329
|
export interface StackSetOperationSummary {
|
|
6427
6330
|
/**
|
|
@@ -6429,11 +6332,10 @@ export interface StackSetOperationSummary {
|
|
|
6429
6332
|
*/
|
|
6430
6333
|
OperationId?: string;
|
|
6431
6334
|
/**
|
|
6432
|
-
* <p>The type of operation: <code>CREATE</code>, <code>UPDATE</code>, or
|
|
6433
|
-
*
|
|
6434
|
-
*
|
|
6435
|
-
*
|
|
6436
|
-
* instances.</p>
|
|
6335
|
+
* <p>The type of operation: <code>CREATE</code>, <code>UPDATE</code>, or <code>DELETE</code>.
|
|
6336
|
+
* Create and delete operations affect only the specified stack instances that are associated
|
|
6337
|
+
* with the specified stack set. Update operations affect both the stack set itself as well as
|
|
6338
|
+
* <i>all</i> associated stack set instances.</p>
|
|
6437
6339
|
*/
|
|
6438
6340
|
Action?: StackSetOperationAction | string;
|
|
6439
6341
|
/**
|
|
@@ -6441,13 +6343,13 @@ export interface StackSetOperationSummary {
|
|
|
6441
6343
|
* <ul>
|
|
6442
6344
|
* <li>
|
|
6443
6345
|
* <p>
|
|
6444
|
-
* <code>FAILED</code>: The operation exceeded the specified failure tolerance.
|
|
6445
|
-
*
|
|
6446
|
-
*
|
|
6447
|
-
*
|
|
6448
|
-
*
|
|
6449
|
-
*
|
|
6450
|
-
*
|
|
6346
|
+
* <code>FAILED</code>: The operation exceeded the specified failure tolerance. The
|
|
6347
|
+
* failure tolerance value that you've set for an operation is applied for each Region
|
|
6348
|
+
* during stack create and update operations. If the number of failed stacks within a
|
|
6349
|
+
* Region exceeds the failure tolerance, the status of the operation in the Region is
|
|
6350
|
+
* set to <code>FAILED</code>. This in turn sets the status of the operation as a whole
|
|
6351
|
+
* to <code>FAILED</code>, and CloudFormation cancels the operation in any
|
|
6352
|
+
* remaining Regions.</p>
|
|
6451
6353
|
* </li>
|
|
6452
6354
|
* <li>
|
|
6453
6355
|
* <p>
|
|
@@ -6480,9 +6382,9 @@ export interface StackSetOperationSummary {
|
|
|
6480
6382
|
/**
|
|
6481
6383
|
* <p>The time at which the operation was initiated. Note that the creation times for the
|
|
6482
6384
|
* stack set operation might differ from the creation time of the individual stacks
|
|
6483
|
-
* themselves. This is because CloudFormation needs to perform preparatory work for
|
|
6484
|
-
* operation, such as dispatching the work to the requested Regions, before actually
|
|
6485
|
-
* the first stacks.</p>
|
|
6385
|
+
* themselves. This is because CloudFormation needs to perform preparatory work for
|
|
6386
|
+
* the operation, such as dispatching the work to the requested Regions, before actually
|
|
6387
|
+
* creating the first stacks.</p>
|
|
6486
6388
|
*/
|
|
6487
6389
|
CreationTimestamp?: Date;
|
|
6488
6390
|
/**
|
|
@@ -6505,9 +6407,9 @@ export interface ListStackSetOperationsOutput {
|
|
|
6505
6407
|
*/
|
|
6506
6408
|
Summaries?: StackSetOperationSummary[];
|
|
6507
6409
|
/**
|
|
6508
|
-
* <p>If the request doesn't return all results, <code>NextToken</code> is set to a token.
|
|
6509
|
-
*
|
|
6510
|
-
*
|
|
6410
|
+
* <p>If the request doesn't return all results, <code>NextToken</code> is set to a token. To
|
|
6411
|
+
* retrieve the next set of results, call <code>ListOperationResults</code> again and assign
|
|
6412
|
+
* that token to the request object's <code>NextToken</code> parameter. If there are no
|
|
6511
6413
|
* remaining results, <code>NextToken</code> is set to <code>null</code>.</p>
|
|
6512
6414
|
*/
|
|
6513
6415
|
NextToken?: string;
|
|
@@ -6536,8 +6438,7 @@ export interface ListStackSetsInput {
|
|
|
6536
6438
|
*/
|
|
6537
6439
|
MaxResults?: number;
|
|
6538
6440
|
/**
|
|
6539
|
-
* <p>The status of the stack sets that you want to get summary information
|
|
6540
|
-
* about.</p>
|
|
6441
|
+
* <p>The status of the stack sets that you want to get summary information about.</p>
|
|
6541
6442
|
*/
|
|
6542
6443
|
Status?: StackSetStatus | string;
|
|
6543
6444
|
/**
|
|
@@ -6567,8 +6468,7 @@ export declare namespace ListStackSetsInput {
|
|
|
6567
6468
|
const filterSensitiveLog: (obj: ListStackSetsInput) => any;
|
|
6568
6469
|
}
|
|
6569
6470
|
/**
|
|
6570
|
-
* <p>The structures that contain summary information about the specified stack
|
|
6571
|
-
* set.</p>
|
|
6471
|
+
* <p>The structures that contain summary information about the specified stack set.</p>
|
|
6572
6472
|
*/
|
|
6573
6473
|
export interface StackSetSummary {
|
|
6574
6474
|
/**
|
|
@@ -6646,6 +6546,11 @@ export interface StackSetSummary {
|
|
|
6646
6546
|
* detection has not yet been performed.</p>
|
|
6647
6547
|
*/
|
|
6648
6548
|
LastDriftCheckTimestamp?: Date;
|
|
6549
|
+
/**
|
|
6550
|
+
* <p>Describes whether StackSets performs non-conflicting operations concurrently and queues
|
|
6551
|
+
* conflicting operations.</p>
|
|
6552
|
+
*/
|
|
6553
|
+
ManagedExecution?: ManagedExecution;
|
|
6649
6554
|
}
|
|
6650
6555
|
export declare namespace StackSetSummary {
|
|
6651
6556
|
/**
|
|
@@ -6663,8 +6568,7 @@ export interface ListStackSetsOutput {
|
|
|
6663
6568
|
* <p>If the request doesn't return all of the remaining results, <code>NextToken</code> is
|
|
6664
6569
|
* set to a token. To retrieve the next set of results, call <code>ListStackInstances</code>
|
|
6665
6570
|
* again and assign that token to the request object's <code>NextToken</code> parameter. If
|
|
6666
|
-
* the request returns all results, <code>NextToken</code> is set to
|
|
6667
|
-
* <code>null</code>.</p>
|
|
6571
|
+
* the request returns all results, <code>NextToken</code> is set to <code>null</code>.</p>
|
|
6668
6572
|
*/
|
|
6669
6573
|
NextToken?: string;
|
|
6670
6574
|
}
|
|
@@ -6762,7 +6666,7 @@ export interface TypeFilters {
|
|
|
6762
6666
|
* </li>
|
|
6763
6667
|
* <li>
|
|
6764
6668
|
* <p>
|
|
6765
|
-
* <code>
|
|
6669
|
+
* <code>THIRD_PARTY</code>: Extensions available for use from publishers other than
|
|
6766
6670
|
* Amazon. This includes:</p>
|
|
6767
6671
|
* <ul>
|
|
6768
6672
|
* <li>
|
|
@@ -6776,7 +6680,7 @@ export interface TypeFilters {
|
|
|
6776
6680
|
* </li>
|
|
6777
6681
|
* <li>
|
|
6778
6682
|
* <p>
|
|
6779
|
-
* <code>
|
|
6683
|
+
* <code>AWS_TYPES</code>: Extensions available for use from Amazon.</p>
|
|
6780
6684
|
* </li>
|
|
6781
6685
|
* </ul>
|
|
6782
6686
|
*/
|
|
@@ -6784,7 +6688,7 @@ export interface TypeFilters {
|
|
|
6784
6688
|
/**
|
|
6785
6689
|
* <p>The id of the publisher of the extension. </p>
|
|
6786
6690
|
* <p>Extensions published by Amazon are not assigned a publisher ID. Use the
|
|
6787
|
-
* <code>
|
|
6691
|
+
* <code>AWS_TYPE</code> category to specify a list of types published by Amazon.</p>
|
|
6788
6692
|
*/
|
|
6789
6693
|
PublisherId?: string;
|
|
6790
6694
|
/**
|
|
@@ -6877,8 +6781,10 @@ export interface ListTypesInput {
|
|
|
6877
6781
|
Type?: RegistryType | string;
|
|
6878
6782
|
/**
|
|
6879
6783
|
* <p>Filter criteria to use in determining which extensions to return.</p>
|
|
6880
|
-
* <p>
|
|
6881
|
-
*
|
|
6784
|
+
* <p>Filters must be compatible with <code>Visibility</code> to return valid results. For
|
|
6785
|
+
* example, specifying <code>AWS_TYPES</code> for <code>Category</code> and
|
|
6786
|
+
* <code>PRIVATE</code> for <code>Visibility</code> returns an empty list of types, but
|
|
6787
|
+
* specifying <code>PUBLIC</code> for <code>Visibility</code> returns the desired list.</p>
|
|
6882
6788
|
*/
|
|
6883
6789
|
Filters?: TypeFilters;
|
|
6884
6790
|
/**
|
|
@@ -7204,8 +7110,8 @@ export interface PublishTypeInput {
|
|
|
7204
7110
|
* 2.0.0</a>.</p>
|
|
7205
7111
|
* <p>If you do not specify a version number, CloudFormation increments the version number by
|
|
7206
7112
|
* one minor version release.</p>
|
|
7207
|
-
* <p>
|
|
7208
|
-
*
|
|
7113
|
+
* <p>You cannot specify a version number the first time you publish a type. CloudFormation
|
|
7114
|
+
* automatically sets the first version number to be <code>1.0.0</code>.</p>
|
|
7209
7115
|
*/
|
|
7210
7116
|
PublicVersionNumber?: string;
|
|
7211
7117
|
}
|
|
@@ -7237,12 +7143,6 @@ export interface InvalidStateTransitionException extends __SmithyException, $Met
|
|
|
7237
7143
|
$fault: "client";
|
|
7238
7144
|
Message?: string;
|
|
7239
7145
|
}
|
|
7240
|
-
export declare namespace InvalidStateTransitionException {
|
|
7241
|
-
/**
|
|
7242
|
-
* @internal
|
|
7243
|
-
*/
|
|
7244
|
-
const filterSensitiveLog: (obj: InvalidStateTransitionException) => any;
|
|
7245
|
-
}
|
|
7246
7146
|
/**
|
|
7247
7147
|
* <p>Error reserved for use by the <a href="https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/what-is-cloudformation-cli.html">CloudFormation CLI</a>. CloudFormation does not return this error to
|
|
7248
7148
|
* users.</p>
|
|
@@ -7252,12 +7152,6 @@ export interface OperationStatusCheckFailedException extends __SmithyException,
|
|
|
7252
7152
|
$fault: "client";
|
|
7253
7153
|
Message?: string;
|
|
7254
7154
|
}
|
|
7255
|
-
export declare namespace OperationStatusCheckFailedException {
|
|
7256
|
-
/**
|
|
7257
|
-
* @internal
|
|
7258
|
-
*/
|
|
7259
|
-
const filterSensitiveLog: (obj: OperationStatusCheckFailedException) => any;
|
|
7260
|
-
}
|
|
7261
7155
|
export declare enum OperationStatus {
|
|
7262
7156
|
FAILED = "FAILED",
|
|
7263
7157
|
IN_PROGRESS = "IN_PROGRESS",
|
|
@@ -7490,7 +7384,8 @@ export interface RollbackStackInput {
|
|
|
7490
7384
|
*/
|
|
7491
7385
|
StackName: string | undefined;
|
|
7492
7386
|
/**
|
|
7493
|
-
* <p>The Amazon Resource Name (ARN) of an Identity and Access Management role that CloudFormation
|
|
7387
|
+
* <p>The Amazon Resource Name (ARN) of an Identity and Access Management role that CloudFormation
|
|
7388
|
+
* assumes to rollback the stack.</p>
|
|
7494
7389
|
*/
|
|
7495
7390
|
RoleARN?: string;
|
|
7496
7391
|
/**
|
|
@@ -7526,16 +7421,16 @@ export interface SetStackPolicyInput {
|
|
|
7526
7421
|
StackName: string | undefined;
|
|
7527
7422
|
/**
|
|
7528
7423
|
* <p>Structure containing the stack policy body. For more information, go to <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/protect-stack-resources.html"> Prevent Updates
|
|
7529
|
-
* to Stack Resources</a> in the CloudFormation User Guide. You can specify
|
|
7530
|
-
* the <code>StackPolicyBody</code> or the <code>StackPolicyURL</code> parameter, but
|
|
7531
|
-
* both.</p>
|
|
7424
|
+
* to Stack Resources</a> in the CloudFormation User Guide. You can specify
|
|
7425
|
+
* either the <code>StackPolicyBody</code> or the <code>StackPolicyURL</code> parameter, but
|
|
7426
|
+
* not both.</p>
|
|
7532
7427
|
*/
|
|
7533
7428
|
StackPolicyBody?: string;
|
|
7534
7429
|
/**
|
|
7535
|
-
* <p>Location of a file containing the stack policy. The URL must point to a policy
|
|
7536
|
-
*
|
|
7537
|
-
*
|
|
7538
|
-
*
|
|
7430
|
+
* <p>Location of a file containing the stack policy. The URL must point to a policy (maximum
|
|
7431
|
+
* size: 16 KB) located in an S3 bucket in the same Region as the stack. You can specify
|
|
7432
|
+
* either the <code>StackPolicyBody</code> or the <code>StackPolicyURL</code> parameter, but
|
|
7433
|
+
* not both.</p>
|
|
7539
7434
|
*/
|
|
7540
7435
|
StackPolicyURL?: string;
|
|
7541
7436
|
}
|
|
@@ -7661,15 +7556,15 @@ export interface SignalResourceInput {
|
|
|
7661
7556
|
*/
|
|
7662
7557
|
LogicalResourceId: string | undefined;
|
|
7663
7558
|
/**
|
|
7664
|
-
* <p>A unique ID of the signal. When you signal Amazon EC2 instances or Auto Scaling
|
|
7665
|
-
*
|
|
7666
|
-
*
|
|
7667
|
-
*
|
|
7559
|
+
* <p>A unique ID of the signal. When you signal Amazon EC2 instances or Auto Scaling groups,
|
|
7560
|
+
* specify the instance ID that you are signaling as the unique ID. If you send multiple
|
|
7561
|
+
* signals to a single resource (such as signaling a wait condition), each signal requires a
|
|
7562
|
+
* different unique ID.</p>
|
|
7668
7563
|
*/
|
|
7669
7564
|
UniqueId: string | undefined;
|
|
7670
7565
|
/**
|
|
7671
7566
|
* <p>The status of the signal, which is either success or failure. A failure signal causes
|
|
7672
|
-
*
|
|
7567
|
+
* CloudFormation to immediately fail the stack creation or update.</p>
|
|
7673
7568
|
*/
|
|
7674
7569
|
Status: ResourceSignalStatus | string | undefined;
|
|
7675
7570
|
}
|
|
@@ -7681,8 +7576,7 @@ export declare namespace SignalResourceInput {
|
|
|
7681
7576
|
}
|
|
7682
7577
|
export interface StopStackSetOperationInput {
|
|
7683
7578
|
/**
|
|
7684
|
-
* <p>The name or unique ID of the stack set that you want to stop the operation
|
|
7685
|
-
* for.</p>
|
|
7579
|
+
* <p>The name or unique ID of the stack set that you want to stop the operation for.</p>
|
|
7686
7580
|
*/
|
|
7687
7581
|
StackSetName: string | undefined;
|
|
7688
7582
|
/**
|
|
@@ -7807,8 +7701,8 @@ export interface UpdateStackInput {
|
|
|
7807
7701
|
*/
|
|
7808
7702
|
TemplateBody?: string;
|
|
7809
7703
|
/**
|
|
7810
|
-
* <p>Location of file containing the template body. The URL must point to a template that
|
|
7811
|
-
*
|
|
7704
|
+
* <p>Location of file containing the template body. The URL must point to a template that is
|
|
7705
|
+
* located in an Amazon S3 bucket or a Systems Manager document. For more information, go to
|
|
7812
7706
|
* <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html">Template Anatomy</a>
|
|
7813
7707
|
* in the CloudFormation User Guide.</p>
|
|
7814
7708
|
* <p>Conditional: You must specify only one of the following parameters:
|
|
@@ -7825,28 +7719,27 @@ export interface UpdateStackInput {
|
|
|
7825
7719
|
*/
|
|
7826
7720
|
UsePreviousTemplate?: boolean;
|
|
7827
7721
|
/**
|
|
7828
|
-
* <p>Structure containing the temporary overriding stack policy body. You can specify
|
|
7829
|
-
*
|
|
7830
|
-
*
|
|
7831
|
-
* <p>If you want to update protected resources, specify a temporary overriding stack
|
|
7832
|
-
*
|
|
7722
|
+
* <p>Structure containing the temporary overriding stack policy body. You can specify either
|
|
7723
|
+
* the <code>StackPolicyDuringUpdateBody</code> or the <code>StackPolicyDuringUpdateURL</code>
|
|
7724
|
+
* parameter, but not both.</p>
|
|
7725
|
+
* <p>If you want to update protected resources, specify a temporary overriding stack policy
|
|
7726
|
+
* during this update. If you do not specify a stack policy, the current policy that is
|
|
7833
7727
|
* associated with the stack will be used.</p>
|
|
7834
7728
|
*/
|
|
7835
7729
|
StackPolicyDuringUpdateBody?: string;
|
|
7836
7730
|
/**
|
|
7837
|
-
* <p>Location of a file containing the temporary overriding stack policy. The URL must
|
|
7838
|
-
*
|
|
7839
|
-
*
|
|
7840
|
-
* <code>
|
|
7841
|
-
*
|
|
7842
|
-
*
|
|
7843
|
-
* policy during this update. If you do not specify a stack policy, the current policy that is
|
|
7731
|
+
* <p>Location of a file containing the temporary overriding stack policy. The URL must point
|
|
7732
|
+
* to a policy (max size: 16KB) located in an S3 bucket in the same Region as the stack. You
|
|
7733
|
+
* can specify either the <code>StackPolicyDuringUpdateBody</code> or the
|
|
7734
|
+
* <code>StackPolicyDuringUpdateURL</code> parameter, but not both.</p>
|
|
7735
|
+
* <p>If you want to update protected resources, specify a temporary overriding stack policy
|
|
7736
|
+
* during this update. If you do not specify a stack policy, the current policy that is
|
|
7844
7737
|
* associated with the stack will be used.</p>
|
|
7845
7738
|
*/
|
|
7846
7739
|
StackPolicyDuringUpdateURL?: string;
|
|
7847
7740
|
/**
|
|
7848
|
-
* <p>A list of <code>Parameter</code> structures that specify input parameters for the
|
|
7849
|
-
*
|
|
7741
|
+
* <p>A list of <code>Parameter</code> structures that specify input parameters for the stack.
|
|
7742
|
+
* For more information, see the <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_Parameter.html">Parameter</a> data
|
|
7850
7743
|
* type.</p>
|
|
7851
7744
|
*/
|
|
7852
7745
|
Parameters?: Parameter[];
|
|
@@ -7858,8 +7751,8 @@ export interface UpdateStackInput {
|
|
|
7858
7751
|
* <p>
|
|
7859
7752
|
* <code>CAPABILITY_IAM</code> and <code>CAPABILITY_NAMED_IAM</code>
|
|
7860
7753
|
* </p>
|
|
7861
|
-
* <p>Some stack templates might include resources that can affect permissions in
|
|
7862
|
-
*
|
|
7754
|
+
* <p>Some stack templates might include resources that can affect permissions in your
|
|
7755
|
+
* Amazon Web Services account; for example, by creating new Identity and Access Management
|
|
7863
7756
|
* (IAM) users. For those stacks, you must explicitly acknowledge this by specifying one
|
|
7864
7757
|
* of these capabilities.</p>
|
|
7865
7758
|
* <p>The following IAM resources require you to specify either the
|
|
@@ -7878,9 +7771,8 @@ export interface UpdateStackInput {
|
|
|
7878
7771
|
* <code>InsufficientCapabilities</code> error.</p>
|
|
7879
7772
|
* </li>
|
|
7880
7773
|
* </ul>
|
|
7881
|
-
* <p>If your stack template contains these resources, we recommend that you review
|
|
7882
|
-
*
|
|
7883
|
-
* necessary.</p>
|
|
7774
|
+
* <p>If your stack template contains these resources, we recommend that you review all
|
|
7775
|
+
* permissions associated with them and edit their permissions if necessary.</p>
|
|
7884
7776
|
* <ul>
|
|
7885
7777
|
* <li>
|
|
7886
7778
|
* <p>
|
|
@@ -7956,21 +7848,22 @@ export interface UpdateStackInput {
|
|
|
7956
7848
|
*/
|
|
7957
7849
|
Capabilities?: (Capability | string)[];
|
|
7958
7850
|
/**
|
|
7959
|
-
* <p>The template resource types that you have permissions to work with for this update
|
|
7960
|
-
*
|
|
7851
|
+
* <p>The template resource types that you have permissions to work with for this update stack
|
|
7852
|
+
* action, such as <code>AWS::EC2::Instance</code>, <code>AWS::EC2::*</code>, or
|
|
7961
7853
|
* <code>Custom::MyCustomInstance</code>.</p>
|
|
7962
|
-
* <p>If the list of resource types doesn't include a resource that you're updating, the
|
|
7963
|
-
*
|
|
7964
|
-
*
|
|
7854
|
+
* <p>If the list of resource types doesn't include a resource that you're updating, the stack
|
|
7855
|
+
* update fails. By default, CloudFormation grants permissions to all resource types.
|
|
7856
|
+
* Identity and Access Management (IAM) uses this parameter for CloudFormation-specific
|
|
7857
|
+
* condition keys in IAM policies. For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html">Controlling Access with
|
|
7858
|
+
* Identity and Access Management</a>.</p>
|
|
7965
7859
|
*/
|
|
7966
7860
|
ResourceTypes?: string[];
|
|
7967
7861
|
/**
|
|
7968
|
-
* <p>The Amazon Resource Name (ARN) of an Identity and Access Management (IAM) role
|
|
7969
|
-
*
|
|
7970
|
-
*
|
|
7971
|
-
*
|
|
7972
|
-
*
|
|
7973
|
-
* Ensure that the role grants least privilege.</p>
|
|
7862
|
+
* <p>The Amazon Resource Name (ARN) of an Identity and Access Management (IAM) role that CloudFormation assumes to update the stack. CloudFormation uses the role's
|
|
7863
|
+
* credentials to make calls on your behalf. CloudFormation always uses this role for
|
|
7864
|
+
* all future operations on the stack. As long as users have permission to operate on the
|
|
7865
|
+
* stack, CloudFormation uses this role even if the users don't have permission to
|
|
7866
|
+
* pass it. Ensure that the role grants least privilege.</p>
|
|
7974
7867
|
* <p>If you don't specify a value, CloudFormation uses the role that was previously
|
|
7975
7868
|
* associated with the stack. If no role is available, CloudFormation uses a temporary
|
|
7976
7869
|
* session that is generated from your user credentials.</p>
|
|
@@ -7985,25 +7878,24 @@ export interface UpdateStackInput {
|
|
|
7985
7878
|
* <p>Structure containing a new stack policy body. You can specify either the
|
|
7986
7879
|
* <code>StackPolicyBody</code> or the <code>StackPolicyURL</code> parameter, but not
|
|
7987
7880
|
* both.</p>
|
|
7988
|
-
* <p>You might update the stack policy, for example, in order to protect a new resource
|
|
7989
|
-
*
|
|
7990
|
-
*
|
|
7881
|
+
* <p>You might update the stack policy, for example, in order to protect a new resource that
|
|
7882
|
+
* you created during a stack update. If you do not specify a stack policy, the current policy
|
|
7883
|
+
* that is associated with the stack is unchanged.</p>
|
|
7991
7884
|
*/
|
|
7992
7885
|
StackPolicyBody?: string;
|
|
7993
7886
|
/**
|
|
7994
|
-
* <p>Location of a file containing the updated stack policy. The URL must point to a
|
|
7995
|
-
*
|
|
7996
|
-
*
|
|
7997
|
-
*
|
|
7998
|
-
* <p>You might update the stack policy, for example, in order to protect a new resource
|
|
7999
|
-
*
|
|
8000
|
-
*
|
|
7887
|
+
* <p>Location of a file containing the updated stack policy. The URL must point to a policy
|
|
7888
|
+
* (max size: 16KB) located in an S3 bucket in the same Region as the stack. You can specify
|
|
7889
|
+
* either the <code>StackPolicyBody</code> or the <code>StackPolicyURL</code> parameter, but
|
|
7890
|
+
* not both.</p>
|
|
7891
|
+
* <p>You might update the stack policy, for example, in order to protect a new resource that
|
|
7892
|
+
* you created during a stack update. If you do not specify a stack policy, the current policy
|
|
7893
|
+
* that is associated with the stack is unchanged.</p>
|
|
8001
7894
|
*/
|
|
8002
7895
|
StackPolicyURL?: string;
|
|
8003
7896
|
/**
|
|
8004
|
-
* <p>Amazon Simple Notification Service topic Amazon Resource Names (ARNs) that
|
|
8005
|
-
*
|
|
8006
|
-
* topics.</p>
|
|
7897
|
+
* <p>Amazon Simple Notification Service topic Amazon Resource Names (ARNs) that CloudFormation associates with the stack. Specify an empty list to remove all
|
|
7898
|
+
* notification topics.</p>
|
|
8007
7899
|
*/
|
|
8008
7900
|
NotificationARNs?: string[];
|
|
8009
7901
|
/**
|
|
@@ -8022,15 +7914,15 @@ export interface UpdateStackInput {
|
|
|
8022
7914
|
*/
|
|
8023
7915
|
DisableRollback?: boolean;
|
|
8024
7916
|
/**
|
|
8025
|
-
* <p>A unique identifier for this <code>UpdateStack</code> request. Specify this token if
|
|
8026
|
-
*
|
|
7917
|
+
* <p>A unique identifier for this <code>UpdateStack</code> request. Specify this token if you
|
|
7918
|
+
* plan to retry requests so that CloudFormation knows that you're not attempting to
|
|
8027
7919
|
* update a stack with the same name. You might retry <code>UpdateStack</code> requests to
|
|
8028
7920
|
* ensure that CloudFormation successfully received them.</p>
|
|
8029
7921
|
* <p>All events triggered by a given stack operation are assigned the same client request
|
|
8030
7922
|
* token, which you can use to track operations. For example, if you execute a
|
|
8031
|
-
*
|
|
8032
|
-
*
|
|
8033
|
-
*
|
|
7923
|
+
* <code>CreateStack</code> operation with the token <code>token1</code>, then all the
|
|
7924
|
+
* <code>StackEvents</code> generated by that operation will have
|
|
7925
|
+
* <code>ClientRequestToken</code> set as <code>token1</code>.</p>
|
|
8034
7926
|
* <p>In the console, stack operations display the client request token on the Events tab.
|
|
8035
7927
|
* Stack operations that are initiated from the console use the token format
|
|
8036
7928
|
* <i>Console-StackOperation-ID</i>, which helps you easily identify the
|
|
@@ -8067,10 +7959,11 @@ export interface UpdateStackInstancesInput {
|
|
|
8067
7959
|
*/
|
|
8068
7960
|
StackSetName: string | undefined;
|
|
8069
7961
|
/**
|
|
8070
|
-
* <p>[Self-managed permissions] The names of one or more Amazon Web Services accounts for
|
|
8071
|
-
*
|
|
8072
|
-
* in the specified accounts and Regions.</p>
|
|
8073
|
-
* <p>You can specify <code>Accounts</code> or <code>DeploymentTargets</code>, but not
|
|
7962
|
+
* <p>[Self-managed permissions] The names of one or more Amazon Web Services accounts for
|
|
7963
|
+
* which you want to update parameter values for stack instances. The overridden parameter
|
|
7964
|
+
* values will be applied to all stack instances in the specified accounts and Regions.</p>
|
|
7965
|
+
* <p>You can specify <code>Accounts</code> or <code>DeploymentTargets</code>, but not
|
|
7966
|
+
* both.</p>
|
|
8074
7967
|
*/
|
|
8075
7968
|
Accounts?: string[];
|
|
8076
7969
|
/**
|
|
@@ -8084,39 +7977,37 @@ export interface UpdateStackInstancesInput {
|
|
|
8084
7977
|
*/
|
|
8085
7978
|
DeploymentTargets?: DeploymentTargets;
|
|
8086
7979
|
/**
|
|
8087
|
-
* <p>The names of one or more Regions in which you want to update parameter values for
|
|
8088
|
-
*
|
|
8089
|
-
*
|
|
7980
|
+
* <p>The names of one or more Regions in which you want to update parameter values for stack
|
|
7981
|
+
* instances. The overridden parameter values will be applied to all stack instances in the
|
|
7982
|
+
* specified accounts and Regions.</p>
|
|
8090
7983
|
*/
|
|
8091
7984
|
Regions: string[] | undefined;
|
|
8092
7985
|
/**
|
|
8093
7986
|
* <p> A list of input parameters whose values you want to update for the specified stack
|
|
8094
7987
|
* instances. </p>
|
|
8095
|
-
* <p>Any overridden parameter values will be applied to all stack instances in the
|
|
8096
|
-
*
|
|
8097
|
-
* how CloudFormation sets parameter values during stack instance update
|
|
8098
|
-
* operations:</p>
|
|
7988
|
+
* <p>Any overridden parameter values will be applied to all stack instances in the specified
|
|
7989
|
+
* accounts and Regions. When specifying parameters and their values, be aware of how CloudFormation sets parameter values during stack instance update operations:</p>
|
|
8099
7990
|
* <ul>
|
|
8100
7991
|
* <li>
|
|
8101
|
-
* <p>To override the current value for a parameter, include the parameter and
|
|
8102
|
-
*
|
|
7992
|
+
* <p>To override the current value for a parameter, include the parameter and specify
|
|
7993
|
+
* its value.</p>
|
|
8103
7994
|
* </li>
|
|
8104
7995
|
* <li>
|
|
8105
|
-
* <p>To leave an overridden parameter set to its present value, include the parameter
|
|
8106
|
-
* <code>true</code>. (You cannot specify
|
|
8107
|
-
* <code>UsePreviousValue</code> to <code>true</code>.)</p>
|
|
7996
|
+
* <p>To leave an overridden parameter set to its present value, include the parameter
|
|
7997
|
+
* and specify <code>UsePreviousValue</code> as <code>true</code>. (You cannot specify
|
|
7998
|
+
* both a value and set <code>UsePreviousValue</code> to <code>true</code>.)</p>
|
|
8108
7999
|
* </li>
|
|
8109
8000
|
* <li>
|
|
8110
8001
|
* <p>To set an overridden parameter back to the value specified in the stack set,
|
|
8111
8002
|
* specify a parameter list but do not include the parameter in the list.</p>
|
|
8112
8003
|
* </li>
|
|
8113
8004
|
* <li>
|
|
8114
|
-
* <p>To leave all parameters set to their present values, do not specify this
|
|
8115
|
-
*
|
|
8005
|
+
* <p>To leave all parameters set to their present values, do not specify this property
|
|
8006
|
+
* at all.</p>
|
|
8116
8007
|
* </li>
|
|
8117
8008
|
* </ul>
|
|
8118
|
-
* <p>During stack set updates, any parameter values overridden for a stack instance are
|
|
8119
|
-
*
|
|
8009
|
+
* <p>During stack set updates, any parameter values overridden for a stack instance are not
|
|
8010
|
+
* updated, but retain their overridden value.</p>
|
|
8120
8011
|
* <p>You can only override the parameter <i>values</i> that are specified in
|
|
8121
8012
|
* the stack set; to add or delete a parameter itself, use <code>UpdateStackSet</code> to
|
|
8122
8013
|
* update the stack set template. If you add a parameter to a template, before you can
|
|
@@ -8132,10 +8023,8 @@ export interface UpdateStackInstancesInput {
|
|
|
8132
8023
|
OperationPreferences?: StackSetOperationPreferences;
|
|
8133
8024
|
/**
|
|
8134
8025
|
* <p>The unique identifier for this stack set operation. </p>
|
|
8135
|
-
* <p>The operation ID also functions as an idempotency token, to ensure that
|
|
8136
|
-
*
|
|
8137
|
-
* multiple times. You might retry stack set operation requests to ensure that
|
|
8138
|
-
* CloudFormation successfully received them.</p>
|
|
8026
|
+
* <p>The operation ID also functions as an idempotency token, to ensure that CloudFormation performs the stack set operation only once, even if you retry the request
|
|
8027
|
+
* multiple times. You might retry stack set operation requests to ensure that CloudFormation successfully received them.</p>
|
|
8139
8028
|
* <p>If you don't specify an operation ID, the SDK generates one automatically.
|
|
8140
8029
|
* </p>
|
|
8141
8030
|
*/
|
|
@@ -8227,8 +8116,8 @@ export interface UpdateStackSetInput {
|
|
|
8227
8116
|
* <p>
|
|
8228
8117
|
* <code>CAPABILITY_IAM</code> and <code>CAPABILITY_NAMED_IAM</code>
|
|
8229
8118
|
* </p>
|
|
8230
|
-
* <p>Some stack templates might include resources that can affect permissions in
|
|
8231
|
-
*
|
|
8119
|
+
* <p>Some stack templates might include resources that can affect permissions in your
|
|
8120
|
+
* Amazon Web Services account; for example, by creating new Identity and Access Management
|
|
8232
8121
|
* (IAM) users. For those stacks sets, you must explicitly acknowledge this by
|
|
8233
8122
|
* specifying one of these capabilities.</p>
|
|
8234
8123
|
* <p>The following IAM resources require you to specify either the
|
|
@@ -8247,9 +8136,8 @@ export interface UpdateStackSetInput {
|
|
|
8247
8136
|
* <code>InsufficientCapabilities</code> error.</p>
|
|
8248
8137
|
* </li>
|
|
8249
8138
|
* </ul>
|
|
8250
|
-
* <p>If your stack template contains these resources, we recommend that you review
|
|
8251
|
-
*
|
|
8252
|
-
* necessary.</p>
|
|
8139
|
+
* <p>If your stack template contains these resources, we recommend that you review all
|
|
8140
|
+
* permissions associated with them and edit their permissions if necessary.</p>
|
|
8253
8141
|
* <ul>
|
|
8254
8142
|
* <li>
|
|
8255
8143
|
* <p>
|
|
@@ -8317,8 +8205,8 @@ export interface UpdateStackSetInput {
|
|
|
8317
8205
|
Capabilities?: (Capability | string)[];
|
|
8318
8206
|
/**
|
|
8319
8207
|
* <p>The key-value pairs to associate with this stack set and the stacks created from it.
|
|
8320
|
-
*
|
|
8321
|
-
* the stacks. You can specify a maximum number of 50 tags.</p>
|
|
8208
|
+
* CloudFormation also propagates these tags to supported resources that are
|
|
8209
|
+
* created in the stacks. You can specify a maximum number of 50 tags.</p>
|
|
8322
8210
|
* <p>If you specify tags for this parameter, those tags replace any list of tags that are
|
|
8323
8211
|
* currently associated with this stack set. This means:</p>
|
|
8324
8212
|
* <ul>
|
|
@@ -8339,11 +8227,10 @@ export interface UpdateStackSetInput {
|
|
|
8339
8227
|
* associated tags.</p>
|
|
8340
8228
|
* </li>
|
|
8341
8229
|
* </ul>
|
|
8342
|
-
* <p>If you specify new tags as part of an <code>UpdateStackSet</code> action,
|
|
8343
|
-
*
|
|
8344
|
-
*
|
|
8345
|
-
*
|
|
8346
|
-
* and checks to see if you have permission to untag resources. If you don't have the
|
|
8230
|
+
* <p>If you specify new tags as part of an <code>UpdateStackSet</code> action, CloudFormation checks to see if you have the required IAM permission to tag resources.
|
|
8231
|
+
* If you omit tags that are currently associated with the stack set from the list of tags you
|
|
8232
|
+
* specify, CloudFormation assumes that you want to remove those tags from the stack
|
|
8233
|
+
* set, and checks to see if you have permission to untag resources. If you don't have the
|
|
8347
8234
|
* necessary permission(s), the entire <code>UpdateStackSet</code> action fails with an
|
|
8348
8235
|
* <code>access denied</code> error, and the stack set is not updated.</p>
|
|
8349
8236
|
*/
|
|
@@ -8420,14 +8307,12 @@ export interface UpdateStackSetInput {
|
|
|
8420
8307
|
AutoDeployment?: AutoDeployment;
|
|
8421
8308
|
/**
|
|
8422
8309
|
* <p>The unique ID for this stack set operation. </p>
|
|
8423
|
-
* <p>The operation ID also functions as an idempotency token, to ensure that
|
|
8424
|
-
*
|
|
8425
|
-
* multiple times. You might retry stack set operation requests to ensure that
|
|
8426
|
-
* CloudFormation successfully received them.</p>
|
|
8310
|
+
* <p>The operation ID also functions as an idempotency token, to ensure that CloudFormation performs the stack set operation only once, even if you retry the request
|
|
8311
|
+
* multiple times. You might retry stack set operation requests to ensure that CloudFormation successfully received them.</p>
|
|
8427
8312
|
* <p>If you don't specify an operation ID, CloudFormation generates one
|
|
8428
8313
|
* automatically.</p>
|
|
8429
|
-
* <p>Repeating this stack set operation with a new operation ID retries all stack
|
|
8430
|
-
*
|
|
8314
|
+
* <p>Repeating this stack set operation with a new operation ID retries all stack instances
|
|
8315
|
+
* whose status is <code>OUTDATED</code>. </p>
|
|
8431
8316
|
*/
|
|
8432
8317
|
OperationId?: string;
|
|
8433
8318
|
/**
|
|
@@ -8478,6 +8363,11 @@ export interface UpdateStackSetInput {
|
|
|
8478
8363
|
* </ul>
|
|
8479
8364
|
*/
|
|
8480
8365
|
CallAs?: CallAs | string;
|
|
8366
|
+
/**
|
|
8367
|
+
* <p>Describes whether StackSets performs non-conflicting operations concurrently and queues
|
|
8368
|
+
* conflicting operations.</p>
|
|
8369
|
+
*/
|
|
8370
|
+
ManagedExecution?: ManagedExecution;
|
|
8481
8371
|
}
|
|
8482
8372
|
export declare namespace UpdateStackSetInput {
|
|
8483
8373
|
/**
|
|
@@ -8595,10 +8485,10 @@ export interface ValidateTemplateOutput {
|
|
|
8595
8485
|
*/
|
|
8596
8486
|
Description?: string;
|
|
8597
8487
|
/**
|
|
8598
|
-
* <p>The capabilities found within the template. If your template contains IAM resources,
|
|
8599
|
-
*
|
|
8600
|
-
*
|
|
8601
|
-
*
|
|
8488
|
+
* <p>The capabilities found within the template. If your template contains IAM resources, you
|
|
8489
|
+
* must specify the CAPABILITY_IAM or CAPABILITY_NAMED_IAM value for this parameter when you
|
|
8490
|
+
* use the <a>CreateStack</a> or <a>UpdateStack</a> actions with your
|
|
8491
|
+
* template; otherwise, those actions return an InsufficientCapabilities error.</p>
|
|
8602
8492
|
* <p>For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html#capabilities">Acknowledging IAM Resources in CloudFormation Templates</a>.</p>
|
|
8603
8493
|
*/
|
|
8604
8494
|
Capabilities?: (Capability | string)[];
|