@aws-sdk/client-cloudformation 3.373.0 → 3.376.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/README.md +8 -0
- package/dist-cjs/CloudFormation.js +2 -0
- package/dist-cjs/commands/ListStackInstanceResourceDriftsCommand.js +46 -0
- package/dist-cjs/commands/index.js +1 -0
- package/dist-cjs/models/models_0.js +1 -0
- package/dist-cjs/protocols/Aws_query.js +143 -3
- package/dist-es/CloudFormation.js +2 -0
- package/dist-es/commands/ListStackInstanceResourceDriftsCommand.js +42 -0
- package/dist-es/commands/index.js +1 -0
- package/dist-es/models/models_0.js +1 -0
- package/dist-es/protocols/Aws_query.js +138 -0
- package/dist-types/CloudFormation.d.ts +7 -0
- package/dist-types/CloudFormationClient.d.ts +3 -2
- package/dist-types/commands/ListStackInstanceResourceDriftsCommand.d.ts +121 -0
- package/dist-types/commands/ListStackInstancesCommand.d.ts +1 -1
- package/dist-types/commands/index.d.ts +1 -0
- package/dist-types/models/models_0.d.ts +234 -67
- package/dist-types/protocols/Aws_query.d.ts +9 -0
- package/dist-types/ts3.4/CloudFormation.d.ts +17 -0
- package/dist-types/ts3.4/CloudFormationClient.d.ts +6 -0
- package/dist-types/ts3.4/commands/ListStackInstanceResourceDriftsCommand.d.ts +42 -0
- package/dist-types/ts3.4/commands/index.d.ts +1 -0
- package/dist-types/ts3.4/models/models_0.d.ts +25 -0
- package/dist-types/ts3.4/protocols/Aws_query.d.ts +12 -0
- package/package.json +1 -1
|
@@ -1279,8 +1279,8 @@ export interface RollbackTrigger {
|
|
|
1279
1279
|
* and for the specified monitoring period afterwards.</p>
|
|
1280
1280
|
* <p>Rollback triggers enable you to have CloudFormation monitor the state of your application during stack creation and
|
|
1281
1281
|
* updating, and to roll back that operation if the application breaches the threshold of any of the alarms you've
|
|
1282
|
-
* specified. For more information, see <a href="
|
|
1283
|
-
*
|
|
1282
|
+
* specified. For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-rollback-triggers.html">Monitor and Roll Back Stack
|
|
1283
|
+
* Operations</a>.</p>
|
|
1284
1284
|
*/
|
|
1285
1285
|
export interface RollbackConfiguration {
|
|
1286
1286
|
/**
|
|
@@ -1440,8 +1440,8 @@ export interface CreateChangeSetInput {
|
|
|
1440
1440
|
* </p>
|
|
1441
1441
|
* </li>
|
|
1442
1442
|
* </ul>
|
|
1443
|
-
* <p>For more information, see <a href="
|
|
1444
|
-
*
|
|
1443
|
+
* <p>For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html#capabilities">Acknowledging IAM
|
|
1444
|
+
* resources in CloudFormation templates</a>.</p>
|
|
1445
1445
|
* </li>
|
|
1446
1446
|
* <li>
|
|
1447
1447
|
* <p>
|
|
@@ -1452,8 +1452,8 @@ export interface CreateChangeSetInput {
|
|
|
1452
1452
|
* users typically create a change set from the processed template, so that they can review the changes resulting from
|
|
1453
1453
|
* the macros before actually creating the stack. If your stack template contains one or more macros, and you choose
|
|
1454
1454
|
* to create a stack directly from the processed template, without first reviewing the resulting changes in a change
|
|
1455
|
-
* set, you must acknowledge this capability. This includes the <a href="
|
|
1456
|
-
*
|
|
1455
|
+
* set, you must acknowledge this capability. This includes the <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/create-reusable-transform-function-snippets-and-add-to-your-template-with-aws-include-transform.html">AWS::Include</a> and <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/transform-aws-serverless.html">AWS::Serverless</a> transforms, which
|
|
1456
|
+
* are macros hosted by CloudFormation.</p>
|
|
1457
1457
|
* <note>
|
|
1458
1458
|
* <p>This capacity doesn't apply to creating change sets, and specifying it when creating change sets has no
|
|
1459
1459
|
* effect.</p>
|
|
@@ -1461,7 +1461,8 @@ export interface CreateChangeSetInput {
|
|
|
1461
1461
|
* stacks, you must create or update the stack directly from the template using the <a>CreateStack</a> or
|
|
1462
1462
|
* <a>UpdateStack</a> action, and specifying this capability.</p>
|
|
1463
1463
|
* </note>
|
|
1464
|
-
* <p>For more information about macros, see <a href="
|
|
1464
|
+
* <p>For more information about macros, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-macros.html">Using CloudFormation macros to perform custom
|
|
1465
|
+
* processing on templates</a>.</p>
|
|
1465
1466
|
* </li>
|
|
1466
1467
|
* </ul>
|
|
1467
1468
|
*/
|
|
@@ -1753,8 +1754,8 @@ export interface CreateStackInput {
|
|
|
1753
1754
|
* </p>
|
|
1754
1755
|
* </li>
|
|
1755
1756
|
* </ul>
|
|
1756
|
-
* <p>For more information, see <a href="
|
|
1757
|
-
*
|
|
1757
|
+
* <p>For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html#capabilities">Acknowledging IAM
|
|
1758
|
+
* Resources in CloudFormation Templates</a>.</p>
|
|
1758
1759
|
* </li>
|
|
1759
1760
|
* <li>
|
|
1760
1761
|
* <p>
|
|
@@ -1765,8 +1766,8 @@ export interface CreateStackInput {
|
|
|
1765
1766
|
* users typically create a change set from the processed template, so that they can review the changes resulting from
|
|
1766
1767
|
* the macros before actually creating the stack. If your stack template contains one or more macros, and you choose
|
|
1767
1768
|
* to create a stack directly from the processed template, without first reviewing the resulting changes in a change
|
|
1768
|
-
* set, you must acknowledge this capability. This includes the <a href="
|
|
1769
|
-
*
|
|
1769
|
+
* set, you must acknowledge this capability. This includes the <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/create-reusable-transform-function-snippets-and-add-to-your-template-with-aws-include-transform.html">AWS::Include</a> and <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/transform-aws-serverless.html">AWS::Serverless</a> transforms, which
|
|
1770
|
+
* are macros hosted by CloudFormation.</p>
|
|
1770
1771
|
* <p>If you want to create a stack from a stack template that contains macros <i>and</i> nested
|
|
1771
1772
|
* stacks, you must create the stack directly from the template using this capability.</p>
|
|
1772
1773
|
* <important>
|
|
@@ -1776,8 +1777,8 @@ export interface CreateStackInput {
|
|
|
1776
1777
|
* aware that the Lambda function owner can update the function operation without CloudFormation being
|
|
1777
1778
|
* notified.</p>
|
|
1778
1779
|
* </important>
|
|
1779
|
-
* <p>For more information, see <a href="
|
|
1780
|
-
*
|
|
1780
|
+
* <p>For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-macros.html">Using CloudFormation macros to perform custom
|
|
1781
|
+
* processing on templates</a>.</p>
|
|
1781
1782
|
* </li>
|
|
1782
1783
|
* </ul>
|
|
1783
1784
|
*/
|
|
@@ -1849,10 +1850,12 @@ export interface CreateStackInput {
|
|
|
1849
1850
|
ClientRequestToken?: string;
|
|
1850
1851
|
/**
|
|
1851
1852
|
* <p>Whether to enable termination protection on the specified stack. If a user attempts to delete a stack with
|
|
1852
|
-
* termination protection enabled, the operation fails and the stack remains unchanged. For more information, see <a href="
|
|
1853
|
-
*
|
|
1854
|
-
*
|
|
1855
|
-
*
|
|
1853
|
+
* termination protection enabled, the operation fails and the stack remains unchanged. For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-protect-stacks.html">Protecting a Stack From
|
|
1854
|
+
* Being Deleted</a> in the <i>CloudFormation User Guide</i>. Termination protection is deactivated on stacks
|
|
1855
|
+
* by default.</p>
|
|
1856
|
+
* <p>For <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-nested-stacks.html">nested
|
|
1857
|
+
* stacks</a>, termination protection is set on the root stack and can't be changed directly on the nested
|
|
1858
|
+
* stack.</p>
|
|
1856
1859
|
*/
|
|
1857
1860
|
EnableTerminationProtection?: boolean;
|
|
1858
1861
|
}
|
|
@@ -2290,8 +2293,7 @@ export interface CreateStackSetInput {
|
|
|
2290
2293
|
* </p>
|
|
2291
2294
|
* </li>
|
|
2292
2295
|
* </ul>
|
|
2293
|
-
* <p>For more information, see <a href="
|
|
2294
|
-
* IAM Resources in CloudFormation Templates</a>.</p>
|
|
2296
|
+
* <p>For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/using-iam-template.html#capabilities">Acknowledging IAM Resources in CloudFormation Templates</a>.</p>
|
|
2295
2297
|
* </li>
|
|
2296
2298
|
* <li>
|
|
2297
2299
|
* <p>
|
|
@@ -2299,13 +2301,13 @@ export interface CreateStackSetInput {
|
|
|
2299
2301
|
* </p>
|
|
2300
2302
|
* <p>Some templates reference macros. If your stack set template references one or more macros, you must create the
|
|
2301
2303
|
* stack set directly from the processed template, without first reviewing the resulting changes in a change set. To
|
|
2302
|
-
* create the stack set directly, you must acknowledge this capability. For more information, see <a href="
|
|
2303
|
-
*
|
|
2304
|
+
* create the stack set directly, you must acknowledge this capability. For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/template-macros.html">Using CloudFormation Macros to Perform
|
|
2305
|
+
* Custom Processing on Templates</a>.</p>
|
|
2304
2306
|
* <important>
|
|
2305
2307
|
* <p>Stack sets with service-managed permissions don't currently support the use of macros in templates. (This
|
|
2306
|
-
* includes the <a href="
|
|
2307
|
-
*
|
|
2308
|
-
*
|
|
2308
|
+
* includes the <a href="https://docs.aws.amazon.com/AWSCloudFormation/create-reusable-transform-function-snippets-and-add-to-your-template-with-aws-include-transform.html">AWS::Include</a> and <a href="https://docs.aws.amazon.com/AWSCloudFormation/transform-aws-serverless.html">AWS::Serverless</a> transforms, which are macros hosted by CloudFormation.) Even if you specify this capability for a
|
|
2309
|
+
* stack set with service-managed permissions, if you reference a macro in your template the stack set operation will
|
|
2310
|
+
* fail.</p>
|
|
2309
2311
|
* </important>
|
|
2310
2312
|
* </li>
|
|
2311
2313
|
* </ul>
|
|
@@ -2324,8 +2326,8 @@ export interface CreateStackSetInput {
|
|
|
2324
2326
|
/**
|
|
2325
2327
|
* <p>The Amazon Resource Name (ARN) of the IAM role to use to create this stack set.</p>
|
|
2326
2328
|
* <p>Specify an IAM role only if you are using customized administrator roles to control which users
|
|
2327
|
-
* or groups can manage specific stack sets within the same administrator account. For more information, see <a href="
|
|
2328
|
-
* the <i>CloudFormation User Guide</i>.</p>
|
|
2329
|
+
* or groups can manage specific stack sets within the same administrator account. For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/stacksets-prereqs.html">Prerequisites: Granting Permissions for Stack Set
|
|
2330
|
+
* Operations</a> in the <i>CloudFormation User Guide</i>.</p>
|
|
2329
2331
|
*/
|
|
2330
2332
|
AdministrationRoleARN?: string;
|
|
2331
2333
|
/**
|
|
@@ -3670,8 +3672,7 @@ export interface StackResourceDetail {
|
|
|
3670
3672
|
/**
|
|
3671
3673
|
* <p>Information about whether the resource's actual configuration differs, or has <i>drifted</i>, from
|
|
3672
3674
|
* its expected configuration, as defined in the stack template and any values specified as template parameters. For
|
|
3673
|
-
* more information, see <a href="
|
|
3674
|
-
* Changes to Stacks and Resources</a>.</p>
|
|
3675
|
+
* more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-stack-drift.html">Detecting Unregulated Configuration Changes to Stacks and Resources</a>.</p>
|
|
3675
3676
|
*/
|
|
3676
3677
|
DriftInformation?: StackResourceDriftInformation;
|
|
3677
3678
|
/**
|
|
@@ -3810,8 +3811,8 @@ export interface PropertyDifference {
|
|
|
3810
3811
|
* stack template are checked for drift. For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-stack-drift.html">Detecting Unregulated Configuration Changes to
|
|
3811
3812
|
* Stacks and Resources</a>.</p>
|
|
3812
3813
|
* <p>Resources that don't currently support drift detection can't be checked. For a list of resources that support
|
|
3813
|
-
* drift detection, see <a href="
|
|
3814
|
-
*
|
|
3814
|
+
* drift detection, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-stack-drift-resource-list.html">Resources that Support Drift
|
|
3815
|
+
* Detection</a>.</p>
|
|
3815
3816
|
* <p>Use <a>DetectStackResourceDrift</a> to detect drift on individual resources, or <a>DetectStackDrift</a> to detect drift on all resources in a given stack that support drift detection.</p>
|
|
3816
3817
|
*/
|
|
3817
3818
|
export interface StackResourceDrift {
|
|
@@ -3993,8 +3994,7 @@ export interface StackResource {
|
|
|
3993
3994
|
/**
|
|
3994
3995
|
* <p>Information about whether the resource's actual configuration differs, or has <i>drifted</i>, from
|
|
3995
3996
|
* its expected configuration, as defined in the stack template and any values specified as template parameters. For
|
|
3996
|
-
* more information, see <a href="
|
|
3997
|
-
* Changes to Stacks and Resources</a>.</p>
|
|
3997
|
+
* more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-stack-drift.html">Detecting Unregulated Configuration Changes to Stacks and Resources</a>.</p>
|
|
3998
3998
|
*/
|
|
3999
3999
|
DriftInformation?: StackResourceDriftInformation;
|
|
4000
4000
|
/**
|
|
@@ -4229,30 +4229,30 @@ export interface Stack {
|
|
|
4229
4229
|
Tags?: Tag[];
|
|
4230
4230
|
/**
|
|
4231
4231
|
* <p>Whether termination protection is enabled for the stack.</p>
|
|
4232
|
-
* <p>For <a href="
|
|
4233
|
-
* on the root stack and can't be changed directly on the nested stack.
|
|
4234
|
-
*
|
|
4232
|
+
* <p>For <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-nested-stacks.html">nested
|
|
4233
|
+
* stacks</a>, termination protection is set on the root stack and can't be changed directly on the nested stack.
|
|
4234
|
+
* For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-protect-stacks.html">Protecting a Stack From Being Deleted</a>
|
|
4235
|
+
* in the <i>CloudFormation User Guide</i>.</p>
|
|
4235
4236
|
*/
|
|
4236
4237
|
EnableTerminationProtection?: boolean;
|
|
4237
4238
|
/**
|
|
4238
4239
|
* <p>For nested stacks--stacks created as resources for another stack--the stack ID of the direct parent of this
|
|
4239
4240
|
* stack. For the first level of nested stacks, the root stack is also the parent stack.</p>
|
|
4240
|
-
* <p>For more information, see <a href="
|
|
4241
|
-
*
|
|
4241
|
+
* <p>For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-nested-stacks.html">Working with Nested Stacks</a> in the
|
|
4242
|
+
* <i>CloudFormation User Guide</i>.</p>
|
|
4242
4243
|
*/
|
|
4243
4244
|
ParentId?: string;
|
|
4244
4245
|
/**
|
|
4245
4246
|
* <p>For nested stacks--stacks created as resources for another stack--the stack ID of the top-level stack to which
|
|
4246
4247
|
* the nested stack ultimately belongs.</p>
|
|
4247
|
-
* <p>For more information, see <a href="
|
|
4248
|
-
*
|
|
4248
|
+
* <p>For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-nested-stacks.html">Working with Nested Stacks</a> in the
|
|
4249
|
+
* <i>CloudFormation User Guide</i>.</p>
|
|
4249
4250
|
*/
|
|
4250
4251
|
RootId?: string;
|
|
4251
4252
|
/**
|
|
4252
4253
|
* <p>Information about whether a stack's actual configuration differs, or has <i>drifted</i>, from its
|
|
4253
4254
|
* expected configuration, as defined in the stack template and any values specified as template parameters. For more
|
|
4254
|
-
* information, see <a href="
|
|
4255
|
-
* Stacks and Resources</a>.</p>
|
|
4255
|
+
* information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-stack-drift.html">Detecting Unregulated Configuration Changes to Stacks and Resources</a>.</p>
|
|
4256
4256
|
*/
|
|
4257
4257
|
DriftInformation?: StackDriftInformation;
|
|
4258
4258
|
}
|
|
@@ -4492,8 +4492,8 @@ export interface StackSet {
|
|
|
4492
4492
|
/**
|
|
4493
4493
|
* <p>The Amazon Resource Name (ARN) of the IAM role used to create or update the stack set.</p>
|
|
4494
4494
|
* <p>Use customized administrator roles to control which users or groups can manage specific stack sets within the
|
|
4495
|
-
* same administrator account. For more information, see <a href="
|
|
4496
|
-
* <i>CloudFormation User Guide</i>.</p>
|
|
4495
|
+
* same administrator account. For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/stacksets-prereqs.html">Prerequisites: Granting Permissions for Stack Set Operations</a>
|
|
4496
|
+
* in the <i>CloudFormation User Guide</i>.</p>
|
|
4497
4497
|
*/
|
|
4498
4498
|
AdministrationRoleARN?: string;
|
|
4499
4499
|
/**
|
|
@@ -4692,8 +4692,8 @@ export interface StackSetOperation {
|
|
|
4692
4692
|
/**
|
|
4693
4693
|
* <p>The Amazon Resource Name (ARN) of the IAM role used to perform this stack set operation.</p>
|
|
4694
4694
|
* <p>Use customized administrator roles to control which users or groups can manage specific stack sets within the
|
|
4695
|
-
* same administrator account. For more information, see <a href="
|
|
4696
|
-
*
|
|
4695
|
+
* same administrator account. For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/stacksets-prereqs.html">Define Permissions for Multiple Administrators</a> in the
|
|
4696
|
+
* <i>CloudFormation User Guide</i>.</p>
|
|
4697
4697
|
*/
|
|
4698
4698
|
AdministrationRoleARN?: string;
|
|
4699
4699
|
/**
|
|
@@ -5797,12 +5797,180 @@ export interface ListImportsOutput {
|
|
|
5797
5797
|
*/
|
|
5798
5798
|
NextToken?: string;
|
|
5799
5799
|
}
|
|
5800
|
+
/**
|
|
5801
|
+
* @public
|
|
5802
|
+
*/
|
|
5803
|
+
export interface ListStackInstanceResourceDriftsInput {
|
|
5804
|
+
/**
|
|
5805
|
+
* <p>The name or unique ID of the stack set that you want to list drifted resources
|
|
5806
|
+
* for.</p>
|
|
5807
|
+
*/
|
|
5808
|
+
StackSetName: string | undefined;
|
|
5809
|
+
/**
|
|
5810
|
+
* <p>If the previous paginated request didn't return all of the remaining results, the
|
|
5811
|
+
* response object's <code>NextToken</code> parameter value is set to a token. To retrieve the
|
|
5812
|
+
* next set of results, call this action again and assign that token to the request object's
|
|
5813
|
+
* <code>NextToken</code> parameter. If there are no remaining results, the previous
|
|
5814
|
+
* response object's <code>NextToken</code> parameter is set to <code>null</code>.</p>
|
|
5815
|
+
*/
|
|
5816
|
+
NextToken?: string;
|
|
5817
|
+
/**
|
|
5818
|
+
* <p>The maximum number of results to be returned with a single call. If the number of
|
|
5819
|
+
* available results exceeds this maximum, the response includes a <code>NextToken</code>
|
|
5820
|
+
* value that you can assign to the <code>NextToken</code> request parameter to get the next
|
|
5821
|
+
* set of results.</p>
|
|
5822
|
+
*/
|
|
5823
|
+
MaxResults?: number;
|
|
5824
|
+
/**
|
|
5825
|
+
* <p>The resource drift status of the stack instance. </p>
|
|
5826
|
+
* <ul>
|
|
5827
|
+
* <li>
|
|
5828
|
+
* <p>
|
|
5829
|
+
* <code>DELETED</code>: The resource differs from its expected template
|
|
5830
|
+
* configuration in that the resource has been deleted.</p>
|
|
5831
|
+
* </li>
|
|
5832
|
+
* <li>
|
|
5833
|
+
* <p>
|
|
5834
|
+
* <code>MODIFIED</code>: One or more resource properties differ from their expected
|
|
5835
|
+
* template values.</p>
|
|
5836
|
+
* </li>
|
|
5837
|
+
* <li>
|
|
5838
|
+
* <p>
|
|
5839
|
+
* <code>IN_SYNC</code>: The resource's actual configuration matches its expected
|
|
5840
|
+
* template configuration.</p>
|
|
5841
|
+
* </li>
|
|
5842
|
+
* <li>
|
|
5843
|
+
* <p>
|
|
5844
|
+
* <code>NOT_CHECKED</code>: CloudFormation doesn't currently return this value.</p>
|
|
5845
|
+
* </li>
|
|
5846
|
+
* </ul>
|
|
5847
|
+
*/
|
|
5848
|
+
StackInstanceResourceDriftStatuses?: (StackResourceDriftStatus | string)[];
|
|
5849
|
+
/**
|
|
5850
|
+
* <p>The name of the Amazon Web Services account that you want to list resource drifts for.</p>
|
|
5851
|
+
*/
|
|
5852
|
+
StackInstanceAccount: string | undefined;
|
|
5853
|
+
/**
|
|
5854
|
+
* <p>The name of the Region where you want to list resource drifts.</p>
|
|
5855
|
+
*/
|
|
5856
|
+
StackInstanceRegion: string | undefined;
|
|
5857
|
+
/**
|
|
5858
|
+
* <p>The unique ID of the drift operation.</p>
|
|
5859
|
+
*/
|
|
5860
|
+
OperationId: string | undefined;
|
|
5861
|
+
/**
|
|
5862
|
+
* <p>[Service-managed permissions] Specifies whether you are acting as an account
|
|
5863
|
+
* administrator in the organization's management account or as a delegated
|
|
5864
|
+
* administrator in a member account.</p>
|
|
5865
|
+
* <p>By default, <code>SELF</code> is specified. Use <code>SELF</code> for stack sets with
|
|
5866
|
+
* self-managed permissions.</p>
|
|
5867
|
+
* <ul>
|
|
5868
|
+
* <li>
|
|
5869
|
+
* <p>If you are signed in to the management account, specify
|
|
5870
|
+
* <code>SELF</code>.</p>
|
|
5871
|
+
* </li>
|
|
5872
|
+
* <li>
|
|
5873
|
+
* <p>If you are signed in to a delegated administrator account, specify
|
|
5874
|
+
* <code>DELEGATED_ADMIN</code>.</p>
|
|
5875
|
+
* <p>Your Amazon Web Services account must be registered as a delegated administrator in
|
|
5876
|
+
* 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>
|
|
5877
|
+
* </li>
|
|
5878
|
+
* </ul>
|
|
5879
|
+
*/
|
|
5880
|
+
CallAs?: CallAs | string;
|
|
5881
|
+
}
|
|
5882
|
+
/**
|
|
5883
|
+
* @public
|
|
5884
|
+
* <p>The structure containing summary information about resource drifts for a stack
|
|
5885
|
+
* instance.</p>
|
|
5886
|
+
*/
|
|
5887
|
+
export interface StackInstanceResourceDriftsSummary {
|
|
5888
|
+
/**
|
|
5889
|
+
* <p>The ID of the stack instance.</p>
|
|
5890
|
+
*/
|
|
5891
|
+
StackId: string | undefined;
|
|
5892
|
+
/**
|
|
5893
|
+
* <p>The logical name of the resource specified in the template.</p>
|
|
5894
|
+
*/
|
|
5895
|
+
LogicalResourceId: string | undefined;
|
|
5896
|
+
/**
|
|
5897
|
+
* <p>The name or unique identifier that corresponds to a physical instance ID of a resource
|
|
5898
|
+
* supported by CloudFormation.</p>
|
|
5899
|
+
*/
|
|
5900
|
+
PhysicalResourceId?: string;
|
|
5901
|
+
/**
|
|
5902
|
+
* <p>Context information that enables CloudFormation to uniquely identify a resource. CloudFormation uses
|
|
5903
|
+
* context key-value pairs in cases where a resource's logical and physical IDs aren't enough
|
|
5904
|
+
* to uniquely identify that resource. Each context key-value pair specifies a unique resource
|
|
5905
|
+
* that contains the targeted resource.</p>
|
|
5906
|
+
*/
|
|
5907
|
+
PhysicalResourceIdContext?: PhysicalResourceIdContextKeyValuePair[];
|
|
5908
|
+
/**
|
|
5909
|
+
* <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
|
|
5910
|
+
* Guide.</p>
|
|
5911
|
+
*/
|
|
5912
|
+
ResourceType: string | undefined;
|
|
5913
|
+
/**
|
|
5914
|
+
* <p>Status of the actual configuration of the resource compared to its expected
|
|
5915
|
+
* configuration. These will be present only for resources whose
|
|
5916
|
+
* <code>StackInstanceResourceDriftStatus</code> is <code>MODIFIED</code>. </p>
|
|
5917
|
+
*/
|
|
5918
|
+
PropertyDifferences?: PropertyDifference[];
|
|
5919
|
+
/**
|
|
5920
|
+
* <p>The drift status of the resource in a stack instance.</p>
|
|
5921
|
+
* <ul>
|
|
5922
|
+
* <li>
|
|
5923
|
+
* <p>
|
|
5924
|
+
* <code>DELETED</code>: The resource differs from its expected template
|
|
5925
|
+
* configuration in that the resource has been deleted.</p>
|
|
5926
|
+
* </li>
|
|
5927
|
+
* <li>
|
|
5928
|
+
* <p>
|
|
5929
|
+
* <code>MODIFIED</code>: One or more resource properties differ from their expected
|
|
5930
|
+
* template values.</p>
|
|
5931
|
+
* </li>
|
|
5932
|
+
* <li>
|
|
5933
|
+
* <p>
|
|
5934
|
+
* <code>IN_SYNC</code>: The resource's actual configuration matches its expected
|
|
5935
|
+
* template configuration.</p>
|
|
5936
|
+
* </li>
|
|
5937
|
+
* <li>
|
|
5938
|
+
* <p>
|
|
5939
|
+
* <code>NOT_CHECKED</code>: CloudFormation doesn't currently return this value.</p>
|
|
5940
|
+
* </li>
|
|
5941
|
+
* </ul>
|
|
5942
|
+
*/
|
|
5943
|
+
StackResourceDriftStatus: StackResourceDriftStatus | string | undefined;
|
|
5944
|
+
/**
|
|
5945
|
+
* <p>Time at which the stack instance drift detection operation was initiated.</p>
|
|
5946
|
+
*/
|
|
5947
|
+
Timestamp: Date | undefined;
|
|
5948
|
+
}
|
|
5949
|
+
/**
|
|
5950
|
+
* @public
|
|
5951
|
+
*/
|
|
5952
|
+
export interface ListStackInstanceResourceDriftsOutput {
|
|
5953
|
+
/**
|
|
5954
|
+
* <p>A list of <code>StackInstanceResourceDriftSummary</code> structures that contain
|
|
5955
|
+
* information about the specified stack instances.</p>
|
|
5956
|
+
*/
|
|
5957
|
+
Summaries?: StackInstanceResourceDriftsSummary[];
|
|
5958
|
+
/**
|
|
5959
|
+
* <p>If the previous paginated request didn't return all of the remaining results, the
|
|
5960
|
+
* response object's <code>NextToken</code> parameter value is set to a token. To retrieve the
|
|
5961
|
+
* next set of results, call this action again and assign that token to the request object's
|
|
5962
|
+
* <code>NextToken</code> parameter. If there are no remaining results, the previous
|
|
5963
|
+
* response object's <code>NextToken</code> parameter is set to <code>null</code>.</p>
|
|
5964
|
+
*/
|
|
5965
|
+
NextToken?: string;
|
|
5966
|
+
}
|
|
5800
5967
|
/**
|
|
5801
5968
|
* @public
|
|
5802
5969
|
* @enum
|
|
5803
5970
|
*/
|
|
5804
5971
|
export declare const StackInstanceFilterName: {
|
|
5805
5972
|
readonly DETAILED_STATUS: "DETAILED_STATUS";
|
|
5973
|
+
readonly DRIFT_STATUS: "DRIFT_STATUS";
|
|
5806
5974
|
readonly LAST_OPERATION_ID: "LAST_OPERATION_ID";
|
|
5807
5975
|
};
|
|
5808
5976
|
/**
|
|
@@ -6089,8 +6257,7 @@ export interface StackResourceSummary {
|
|
|
6089
6257
|
/**
|
|
6090
6258
|
* <p>Information about whether the resource's actual configuration differs, or has <i>drifted</i>, from
|
|
6091
6259
|
* its expected configuration, as defined in the stack template and any values specified as template parameters. For
|
|
6092
|
-
* more information, see <a href="
|
|
6093
|
-
* Changes to Stacks and Resources</a>.</p>
|
|
6260
|
+
* more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-stack-drift.html">Detecting Unregulated Configuration Changes to Stacks and Resources</a>.</p>
|
|
6094
6261
|
*/
|
|
6095
6262
|
DriftInformation?: StackResourceDriftInformationSummary;
|
|
6096
6263
|
/**
|
|
@@ -6208,21 +6375,22 @@ export interface StackSummary {
|
|
|
6208
6375
|
/**
|
|
6209
6376
|
* <p>For nested stacks--stacks created as resources for another stack--the stack ID of the direct parent of this
|
|
6210
6377
|
* stack. For the first level of nested stacks, the root stack is also the parent stack.</p>
|
|
6211
|
-
* <p>For more information, see <a href="
|
|
6212
|
-
*
|
|
6378
|
+
* <p>For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-nested-stacks.html">Working with Nested Stacks</a> in the
|
|
6379
|
+
* <i>CloudFormation User Guide</i>.</p>
|
|
6213
6380
|
*/
|
|
6214
6381
|
ParentId?: string;
|
|
6215
6382
|
/**
|
|
6216
6383
|
* <p>For nested stacks--stacks created as resources for another stack--the stack ID of the top-level stack to which
|
|
6217
6384
|
* the nested stack ultimately belongs.</p>
|
|
6218
|
-
* <p>For more information, see <a href="
|
|
6219
|
-
*
|
|
6385
|
+
* <p>For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-nested-stacks.html">Working with Nested Stacks</a> in the
|
|
6386
|
+
* <i>CloudFormation User Guide</i>.</p>
|
|
6220
6387
|
*/
|
|
6221
6388
|
RootId?: string;
|
|
6222
6389
|
/**
|
|
6223
6390
|
* <p>Summarizes information about whether a stack's actual configuration differs, or has
|
|
6224
6391
|
* <i>drifted</i>, from its expected configuration, as defined in the stack template and any values
|
|
6225
|
-
* specified as template parameters. For more information, see <a href="
|
|
6392
|
+
* specified as template parameters. For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-stack-drift.html">Detecting Unregulated Configuration Changes to
|
|
6393
|
+
* Stacks and Resources</a>.</p>
|
|
6226
6394
|
*/
|
|
6227
6395
|
DriftInformation?: StackDriftInformationSummary;
|
|
6228
6396
|
}
|
|
@@ -7788,8 +7956,8 @@ export interface UpdateStackInput {
|
|
|
7788
7956
|
* </p>
|
|
7789
7957
|
* </li>
|
|
7790
7958
|
* </ul>
|
|
7791
|
-
* <p>For more information, see <a href="
|
|
7792
|
-
*
|
|
7959
|
+
* <p>For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html#capabilities">Acknowledging IAM
|
|
7960
|
+
* Resources in CloudFormation Templates</a>.</p>
|
|
7793
7961
|
* </li>
|
|
7794
7962
|
* <li>
|
|
7795
7963
|
* <p>
|
|
@@ -7800,8 +7968,8 @@ export interface UpdateStackInput {
|
|
|
7800
7968
|
* users typically create a change set from the processed template, so that they can review the changes resulting from
|
|
7801
7969
|
* the macros before actually updating the stack. If your stack template contains one or more macros, and you choose
|
|
7802
7970
|
* to update a stack directly from the processed template, without first reviewing the resulting changes in a change
|
|
7803
|
-
* set, you must acknowledge this capability. This includes the <a href="
|
|
7804
|
-
*
|
|
7971
|
+
* set, you must acknowledge this capability. This includes the <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/create-reusable-transform-function-snippets-and-add-to-your-template-with-aws-include-transform.html">AWS::Include</a> and <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/transform-aws-serverless.html">AWS::Serverless</a> transforms, which
|
|
7972
|
+
* are macros hosted by CloudFormation.</p>
|
|
7805
7973
|
* <p>If you want to update a stack from a stack template that contains macros <i>and</i> nested
|
|
7806
7974
|
* stacks, you must update the stack directly from the template using this capability.</p>
|
|
7807
7975
|
* <important>
|
|
@@ -7811,8 +7979,8 @@ export interface UpdateStackInput {
|
|
|
7811
7979
|
* aware that the Lambda function owner can update the function operation without CloudFormation being
|
|
7812
7980
|
* notified.</p>
|
|
7813
7981
|
* </important>
|
|
7814
|
-
* <p>For more information, see <a href="
|
|
7815
|
-
*
|
|
7982
|
+
* <p>For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-macros.html">Using CloudFormation Macros to Perform Custom
|
|
7983
|
+
* Processing on Templates</a>.</p>
|
|
7816
7984
|
* </li>
|
|
7817
7985
|
* </ul>
|
|
7818
7986
|
*/
|
|
@@ -8112,8 +8280,7 @@ export interface UpdateStackSetInput {
|
|
|
8112
8280
|
* </p>
|
|
8113
8281
|
* </li>
|
|
8114
8282
|
* </ul>
|
|
8115
|
-
* <p>For more information, see <a href="
|
|
8116
|
-
* IAM Resources in CloudFormation Templates</a>.</p>
|
|
8283
|
+
* <p>For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/using-iam-template.html#capabilities">Acknowledging IAM Resources in CloudFormation Templates</a>.</p>
|
|
8117
8284
|
* </li>
|
|
8118
8285
|
* <li>
|
|
8119
8286
|
* <p>
|
|
@@ -8121,13 +8288,13 @@ export interface UpdateStackSetInput {
|
|
|
8121
8288
|
* </p>
|
|
8122
8289
|
* <p>Some templates reference macros. If your stack set template references one or more macros, you must update the
|
|
8123
8290
|
* stack set directly from the processed template, without first reviewing the resulting changes in a change set. To
|
|
8124
|
-
* update the stack set directly, you must acknowledge this capability. For more information, see <a href="
|
|
8125
|
-
*
|
|
8291
|
+
* update the stack set directly, you must acknowledge this capability. For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/template-macros.html">Using CloudFormation Macros to Perform
|
|
8292
|
+
* Custom Processing on Templates</a>.</p>
|
|
8126
8293
|
* <important>
|
|
8127
8294
|
* <p>Stack sets with service-managed permissions do not currently support the use of macros in templates. (This
|
|
8128
|
-
* includes the <a href="
|
|
8129
|
-
*
|
|
8130
|
-
*
|
|
8295
|
+
* includes the <a href="https://docs.aws.amazon.com/AWSCloudFormation/create-reusable-transform-function-snippets-and-add-to-your-template-with-aws-include-transform.html">AWS::Include</a> and <a href="https://docs.aws.amazon.com/AWSCloudFormation/transform-aws-serverless.html">AWS::Serverless</a> transforms, which are macros hosted by CloudFormation.) Even if you specify this capability for a
|
|
8296
|
+
* stack set with service-managed permissions, if you reference a macro in your template the stack set operation will
|
|
8297
|
+
* fail.</p>
|
|
8131
8298
|
* </important>
|
|
8132
8299
|
* </li>
|
|
8133
8300
|
* </ul>
|
|
@@ -8168,8 +8335,8 @@ export interface UpdateStackSetInput {
|
|
|
8168
8335
|
/**
|
|
8169
8336
|
* <p>The Amazon Resource Name (ARN) of the IAM role to use to update this stack set.</p>
|
|
8170
8337
|
* <p>Specify an IAM role only if you are using customized administrator roles to control which users
|
|
8171
|
-
* or groups can manage specific stack sets within the same administrator account. For more information, see <a href="
|
|
8172
|
-
*
|
|
8338
|
+
* or groups can manage specific stack sets within the same administrator account. For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/stacksets-prereqs.html">Granting Permissions for Stack Set
|
|
8339
|
+
* Operations</a> in the <i>CloudFormation User Guide</i>.</p>
|
|
8173
8340
|
* <p>If you specified a customized administrator role when you created the stack set, you must specify a customized
|
|
8174
8341
|
* administrator role, even if it is the same customized administrator role used with this stack set previously.</p>
|
|
8175
8342
|
*/
|
|
@@ -44,6 +44,7 @@ import { ImportStacksToStackSetCommandInput, ImportStacksToStackSetCommandOutput
|
|
|
44
44
|
import { ListChangeSetsCommandInput, ListChangeSetsCommandOutput } from "../commands/ListChangeSetsCommand";
|
|
45
45
|
import { ListExportsCommandInput, ListExportsCommandOutput } from "../commands/ListExportsCommand";
|
|
46
46
|
import { ListImportsCommandInput, ListImportsCommandOutput } from "../commands/ListImportsCommand";
|
|
47
|
+
import { ListStackInstanceResourceDriftsCommandInput, ListStackInstanceResourceDriftsCommandOutput } from "../commands/ListStackInstanceResourceDriftsCommand";
|
|
47
48
|
import { ListStackInstancesCommandInput, ListStackInstancesCommandOutput } from "../commands/ListStackInstancesCommand";
|
|
48
49
|
import { ListStackResourcesCommandInput, ListStackResourcesCommandOutput } from "../commands/ListStackResourcesCommand";
|
|
49
50
|
import { ListStacksCommandInput, ListStacksCommandOutput } from "../commands/ListStacksCommand";
|
|
@@ -245,6 +246,10 @@ export declare const se_ListExportsCommand: (input: ListExportsCommandInput, con
|
|
|
245
246
|
* serializeAws_queryListImportsCommand
|
|
246
247
|
*/
|
|
247
248
|
export declare const se_ListImportsCommand: (input: ListImportsCommandInput, context: __SerdeContext) => Promise<__HttpRequest>;
|
|
249
|
+
/**
|
|
250
|
+
* serializeAws_queryListStackInstanceResourceDriftsCommand
|
|
251
|
+
*/
|
|
252
|
+
export declare const se_ListStackInstanceResourceDriftsCommand: (input: ListStackInstanceResourceDriftsCommandInput, context: __SerdeContext) => Promise<__HttpRequest>;
|
|
248
253
|
/**
|
|
249
254
|
* serializeAws_queryListStackInstancesCommand
|
|
250
255
|
*/
|
|
@@ -521,6 +526,10 @@ export declare const de_ListExportsCommand: (output: __HttpResponse, context: __
|
|
|
521
526
|
* deserializeAws_queryListImportsCommand
|
|
522
527
|
*/
|
|
523
528
|
export declare const de_ListImportsCommand: (output: __HttpResponse, context: __SerdeContext) => Promise<ListImportsCommandOutput>;
|
|
529
|
+
/**
|
|
530
|
+
* deserializeAws_queryListStackInstanceResourceDriftsCommand
|
|
531
|
+
*/
|
|
532
|
+
export declare const de_ListStackInstanceResourceDriftsCommand: (output: __HttpResponse, context: __SerdeContext) => Promise<ListStackInstanceResourceDriftsCommandOutput>;
|
|
524
533
|
/**
|
|
525
534
|
* deserializeAws_queryListStackInstancesCommand
|
|
526
535
|
*/
|
|
@@ -176,6 +176,10 @@ import {
|
|
|
176
176
|
ListImportsCommandInput,
|
|
177
177
|
ListImportsCommandOutput,
|
|
178
178
|
} from "./commands/ListImportsCommand";
|
|
179
|
+
import {
|
|
180
|
+
ListStackInstanceResourceDriftsCommandInput,
|
|
181
|
+
ListStackInstanceResourceDriftsCommandOutput,
|
|
182
|
+
} from "./commands/ListStackInstanceResourceDriftsCommand";
|
|
179
183
|
import {
|
|
180
184
|
ListStackInstancesCommandInput,
|
|
181
185
|
ListStackInstancesCommandOutput,
|
|
@@ -855,6 +859,19 @@ export interface CloudFormation {
|
|
|
855
859
|
options: __HttpHandlerOptions,
|
|
856
860
|
cb: (err: any, data?: ListImportsCommandOutput) => void
|
|
857
861
|
): void;
|
|
862
|
+
listStackInstanceResourceDrifts(
|
|
863
|
+
args: ListStackInstanceResourceDriftsCommandInput,
|
|
864
|
+
options?: __HttpHandlerOptions
|
|
865
|
+
): Promise<ListStackInstanceResourceDriftsCommandOutput>;
|
|
866
|
+
listStackInstanceResourceDrifts(
|
|
867
|
+
args: ListStackInstanceResourceDriftsCommandInput,
|
|
868
|
+
cb: (err: any, data?: ListStackInstanceResourceDriftsCommandOutput) => void
|
|
869
|
+
): void;
|
|
870
|
+
listStackInstanceResourceDrifts(
|
|
871
|
+
args: ListStackInstanceResourceDriftsCommandInput,
|
|
872
|
+
options: __HttpHandlerOptions,
|
|
873
|
+
cb: (err: any, data?: ListStackInstanceResourceDriftsCommandOutput) => void
|
|
874
|
+
): void;
|
|
858
875
|
listStackInstances(
|
|
859
876
|
args: ListStackInstancesCommandInput,
|
|
860
877
|
options?: __HttpHandlerOptions
|
|
@@ -220,6 +220,10 @@ import {
|
|
|
220
220
|
ListImportsCommandInput,
|
|
221
221
|
ListImportsCommandOutput,
|
|
222
222
|
} from "./commands/ListImportsCommand";
|
|
223
|
+
import {
|
|
224
|
+
ListStackInstanceResourceDriftsCommandInput,
|
|
225
|
+
ListStackInstanceResourceDriftsCommandOutput,
|
|
226
|
+
} from "./commands/ListStackInstanceResourceDriftsCommand";
|
|
223
227
|
import {
|
|
224
228
|
ListStackInstancesCommandInput,
|
|
225
229
|
ListStackInstancesCommandOutput,
|
|
@@ -371,6 +375,7 @@ export type ServiceInputTypes =
|
|
|
371
375
|
| ListChangeSetsCommandInput
|
|
372
376
|
| ListExportsCommandInput
|
|
373
377
|
| ListImportsCommandInput
|
|
378
|
+
| ListStackInstanceResourceDriftsCommandInput
|
|
374
379
|
| ListStackInstancesCommandInput
|
|
375
380
|
| ListStackResourcesCommandInput
|
|
376
381
|
| ListStackSetOperationResultsCommandInput
|
|
@@ -441,6 +446,7 @@ export type ServiceOutputTypes =
|
|
|
441
446
|
| ListChangeSetsCommandOutput
|
|
442
447
|
| ListExportsCommandOutput
|
|
443
448
|
| ListImportsCommandOutput
|
|
449
|
+
| ListStackInstanceResourceDriftsCommandOutput
|
|
444
450
|
| ListStackInstancesCommandOutput
|
|
445
451
|
| ListStackResourcesCommandOutput
|
|
446
452
|
| ListStackSetOperationResultsCommandOutput
|