aws-sdk-cloudformation 1.86.0 → 1.88.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.
- checksums.yaml +4 -4
- data/CHANGELOG.md +10 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-cloudformation/client.rb +197 -26
- data/lib/aws-sdk-cloudformation/client_api.rb +47 -0
- data/lib/aws-sdk-cloudformation/endpoints.rb +14 -0
- data/lib/aws-sdk-cloudformation/plugins/endpoints.rb +2 -0
- data/lib/aws-sdk-cloudformation/resource.rb +18 -6
- data/lib/aws-sdk-cloudformation/stack.rb +54 -15
- data/lib/aws-sdk-cloudformation/stack_resource.rb +1 -1
- data/lib/aws-sdk-cloudformation/stack_resource_summary.rb +1 -1
- data/lib/aws-sdk-cloudformation/types.rb +301 -44
- data/lib/aws-sdk-cloudformation.rb +1 -1
- metadata +2 -2
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 4dfec2692a79a91a154928b6e345e4f4984b47f4de15923176a2c5b3951cabc3
|
4
|
+
data.tar.gz: d067aebb34ff4fa54287e141eac9c422518c2743f0fe5e84095562a4504a993f
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 01ce8f110fa6b080e0546d1453699b6f53775d21785d2789292e94077eef7f1c4d82b993fff8a6f9a7394858942e083ab65c8296af4703fd5e4afad0366ba4c2
|
7
|
+
data.tar.gz: 29681523066befa41cbc23fc2735809bac07e00e27ff3a750b528df39a7ecd9d85cb158a5089b5d99457661425913a2b4cdc26f5642c8a4b54a364757bcdc8e4
|
data/CHANGELOG.md
CHANGED
@@ -1,6 +1,16 @@
|
|
1
1
|
Unreleased Changes
|
2
2
|
------------------
|
3
3
|
|
4
|
+
1.88.0 (2023-07-28)
|
5
|
+
------------------
|
6
|
+
|
7
|
+
* Feature - This SDK release is for the feature launch of AWS CloudFormation RetainExceptOnCreate. It adds a new parameter retainExceptOnCreate in the following APIs: CreateStack, UpdateStack, RollbackStack, ExecuteChangeSet.
|
8
|
+
|
9
|
+
1.87.0 (2023-07-24)
|
10
|
+
------------------
|
11
|
+
|
12
|
+
* Feature - This release supports filtering by DRIFT_STATUS for existing API ListStackInstances and adds support for a new API ListStackInstanceResourceDrifts. Customers can now view resource drift information from their StackSet management accounts.
|
13
|
+
|
4
14
|
1.86.0 (2023-07-19)
|
5
15
|
------------------
|
6
16
|
|
data/VERSION
CHANGED
@@ -1 +1 @@
|
|
1
|
-
1.
|
1
|
+
1.88.0
|
@@ -896,10 +896,10 @@ module Aws::CloudFormation
|
|
896
896
|
# [5]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-role.html
|
897
897
|
# [6]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-user.html
|
898
898
|
# [7]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-addusertogroup.html
|
899
|
-
# [8]:
|
900
|
-
# [9]:
|
901
|
-
# [10]:
|
902
|
-
# [11]:
|
899
|
+
# [8]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html#capabilities
|
900
|
+
# [9]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/create-reusable-transform-function-snippets-and-add-to-your-template-with-aws-include-transform.html
|
901
|
+
# [10]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/transform-aws-serverless.html
|
902
|
+
# [11]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-macros.html
|
903
903
|
#
|
904
904
|
# @option params [Array<String>] :resource_types
|
905
905
|
# The template resource types that you have permissions to work with if
|
@@ -1243,10 +1243,10 @@ module Aws::CloudFormation
|
|
1243
1243
|
# [5]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-role.html
|
1244
1244
|
# [6]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-user.html
|
1245
1245
|
# [7]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-addusertogroup.html
|
1246
|
-
# [8]:
|
1247
|
-
# [9]:
|
1248
|
-
# [10]:
|
1249
|
-
# [11]:
|
1246
|
+
# [8]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html#capabilities
|
1247
|
+
# [9]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/create-reusable-transform-function-snippets-and-add-to-your-template-with-aws-include-transform.html
|
1248
|
+
# [10]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/transform-aws-serverless.html
|
1249
|
+
# [11]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-macros.html
|
1250
1250
|
#
|
1251
1251
|
# @option params [Array<String>] :resource_types
|
1252
1252
|
# The template resource types that you have permissions to work with for
|
@@ -1346,8 +1346,20 @@ module Aws::CloudFormation
|
|
1346
1346
|
#
|
1347
1347
|
#
|
1348
1348
|
#
|
1349
|
-
# [1]:
|
1350
|
-
# [2]:
|
1349
|
+
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-protect-stacks.html
|
1350
|
+
# [2]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-nested-stacks.html
|
1351
|
+
#
|
1352
|
+
# @option params [Boolean] :retain_except_on_create
|
1353
|
+
# This deletion policy deletes newly created resources, but retains
|
1354
|
+
# existing resources, when a stack operation is rolled back. This
|
1355
|
+
# ensures new, empty, and unused resources are deleted, while critical
|
1356
|
+
# resources and their data are retained. `RetainExceptOnCreate` can be
|
1357
|
+
# specified for any resource that supports the [ DeletionPolicy][1]
|
1358
|
+
# attribute.
|
1359
|
+
#
|
1360
|
+
#
|
1361
|
+
#
|
1362
|
+
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-attribute-deletionpolicy.html
|
1351
1363
|
#
|
1352
1364
|
# @return [Types::CreateStackOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
1353
1365
|
#
|
@@ -1393,6 +1405,7 @@ module Aws::CloudFormation
|
|
1393
1405
|
# ],
|
1394
1406
|
# client_request_token: "ClientRequestToken",
|
1395
1407
|
# enable_termination_protection: false,
|
1408
|
+
# retain_except_on_create: false,
|
1396
1409
|
# })
|
1397
1410
|
#
|
1398
1411
|
# @example Response structure
|
@@ -1684,10 +1697,10 @@ module Aws::CloudFormation
|
|
1684
1697
|
# [5]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-role.html
|
1685
1698
|
# [6]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-user.html
|
1686
1699
|
# [7]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-addusertogroup.html
|
1687
|
-
# [8]:
|
1688
|
-
# [9]:
|
1689
|
-
# [10]:
|
1690
|
-
# [11]:
|
1700
|
+
# [8]: https://docs.aws.amazon.com/AWSCloudFormation/using-iam-template.html#capabilities
|
1701
|
+
# [9]: https://docs.aws.amazon.com/AWSCloudFormation/template-macros.html
|
1702
|
+
# [10]: https://docs.aws.amazon.com/AWSCloudFormation/create-reusable-transform-function-snippets-and-add-to-your-template-with-aws-include-transform.html
|
1703
|
+
# [11]: https://docs.aws.amazon.com/AWSCloudFormation/transform-aws-serverless.html
|
1691
1704
|
#
|
1692
1705
|
# @option params [Array<Types::Tag>] :tags
|
1693
1706
|
# The key-value pairs to associate with this stack set and the stacks
|
@@ -1712,7 +1725,7 @@ module Aws::CloudFormation
|
|
1712
1725
|
#
|
1713
1726
|
#
|
1714
1727
|
#
|
1715
|
-
# [1]:
|
1728
|
+
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/stacksets-prereqs.html
|
1716
1729
|
#
|
1717
1730
|
# @option params [String] :execution_role_name
|
1718
1731
|
# The name of the IAM execution role to use to create the stack set. If
|
@@ -3305,6 +3318,7 @@ module Aws::CloudFormation
|
|
3305
3318
|
# resp.stacks[0].root_id #=> String
|
3306
3319
|
# resp.stacks[0].drift_information.stack_drift_status #=> String, one of "DRIFTED", "IN_SYNC", "UNKNOWN", "NOT_CHECKED"
|
3307
3320
|
# resp.stacks[0].drift_information.last_check_timestamp #=> Time
|
3321
|
+
# resp.stacks[0].retain_except_on_create #=> Boolean
|
3308
3322
|
# resp.next_token #=> String
|
3309
3323
|
#
|
3310
3324
|
#
|
@@ -3871,6 +3885,18 @@ module Aws::CloudFormation
|
|
3871
3885
|
#
|
3872
3886
|
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_CreateChangeSet.html
|
3873
3887
|
#
|
3888
|
+
# @option params [Boolean] :retain_except_on_create
|
3889
|
+
# This deletion policy deletes newly created resources, but retains
|
3890
|
+
# existing resources, when a stack operation is rolled back. This
|
3891
|
+
# ensures new, empty, and unused resources are deleted, while critical
|
3892
|
+
# resources and their data are retained. `RetainExceptOnCreate` can be
|
3893
|
+
# specified for any resource that supports the [ DeletionPolicy][1]
|
3894
|
+
# attribute.
|
3895
|
+
#
|
3896
|
+
#
|
3897
|
+
#
|
3898
|
+
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-attribute-deletionpolicy.html
|
3899
|
+
#
|
3874
3900
|
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
3875
3901
|
#
|
3876
3902
|
# @example Request syntax with placeholder values
|
@@ -3880,6 +3906,7 @@ module Aws::CloudFormation
|
|
3880
3906
|
# stack_name: "StackNameOrId",
|
3881
3907
|
# client_request_token: "ClientRequestToken",
|
3882
3908
|
# disable_rollback: false,
|
3909
|
+
# retain_except_on_create: false,
|
3883
3910
|
# })
|
3884
3911
|
#
|
3885
3912
|
# @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/ExecuteChangeSet AWS API Documentation
|
@@ -4363,6 +4390,124 @@ module Aws::CloudFormation
|
|
4363
4390
|
req.send_request(options)
|
4364
4391
|
end
|
4365
4392
|
|
4393
|
+
# Returns drift information for resources in a stack instance.
|
4394
|
+
#
|
4395
|
+
# <note markdown="1"> `ListStackInstanceResourceDrifts` returns drift information for the
|
4396
|
+
# most recent drift detection operation. If an operation is in progress,
|
4397
|
+
# it may only return partial results.
|
4398
|
+
#
|
4399
|
+
# </note>
|
4400
|
+
#
|
4401
|
+
# @option params [required, String] :stack_set_name
|
4402
|
+
# The name or unique ID of the stack set that you want to list drifted
|
4403
|
+
# resources for.
|
4404
|
+
#
|
4405
|
+
# @option params [String] :next_token
|
4406
|
+
# If the previous paginated request didn't return all of the remaining
|
4407
|
+
# results, the response object's `NextToken` parameter value is set to
|
4408
|
+
# a token. To retrieve the next set of results, call this action again
|
4409
|
+
# and assign that token to the request object's `NextToken` parameter.
|
4410
|
+
# If there are no remaining results, the previous response object's
|
4411
|
+
# `NextToken` parameter is set to `null`.
|
4412
|
+
#
|
4413
|
+
# @option params [Integer] :max_results
|
4414
|
+
# The maximum number of results to be returned with a single call. If
|
4415
|
+
# the number of available results exceeds this maximum, the response
|
4416
|
+
# includes a `NextToken` value that you can assign to the `NextToken`
|
4417
|
+
# request parameter to get the next set of results.
|
4418
|
+
#
|
4419
|
+
# @option params [Array<String>] :stack_instance_resource_drift_statuses
|
4420
|
+
# The resource drift status of the stack instance.
|
4421
|
+
#
|
4422
|
+
# * `DELETED`: The resource differs from its expected template
|
4423
|
+
# configuration in that the resource has been deleted.
|
4424
|
+
#
|
4425
|
+
# * `MODIFIED`: One or more resource properties differ from their
|
4426
|
+
# expected template values.
|
4427
|
+
#
|
4428
|
+
# * `IN_SYNC`: The resource's actual configuration matches its expected
|
4429
|
+
# template configuration.
|
4430
|
+
#
|
4431
|
+
# * `NOT_CHECKED`: CloudFormation doesn't currently return this value.
|
4432
|
+
#
|
4433
|
+
# @option params [required, String] :stack_instance_account
|
4434
|
+
# The name of the Amazon Web Services account that you want to list
|
4435
|
+
# resource drifts for.
|
4436
|
+
#
|
4437
|
+
# @option params [required, String] :stack_instance_region
|
4438
|
+
# The name of the Region where you want to list resource drifts.
|
4439
|
+
#
|
4440
|
+
# @option params [required, String] :operation_id
|
4441
|
+
# The unique ID of the drift operation.
|
4442
|
+
#
|
4443
|
+
# @option params [String] :call_as
|
4444
|
+
# \[Service-managed permissions\] Specifies whether you are acting as an
|
4445
|
+
# account administrator in the organization's management account or as
|
4446
|
+
# a delegated administrator in a member account.
|
4447
|
+
#
|
4448
|
+
# By default, `SELF` is specified. Use `SELF` for stack sets with
|
4449
|
+
# self-managed permissions.
|
4450
|
+
#
|
4451
|
+
# * If you are signed in to the management account, specify `SELF`.
|
4452
|
+
#
|
4453
|
+
# * If you are signed in to a delegated administrator account, specify
|
4454
|
+
# `DELEGATED_ADMIN`.
|
4455
|
+
#
|
4456
|
+
# Your Amazon Web Services account must be registered as a delegated
|
4457
|
+
# administrator in the management account. For more information, see
|
4458
|
+
# [Register a delegated administrator][1] in the *CloudFormation User
|
4459
|
+
# Guide*.
|
4460
|
+
#
|
4461
|
+
#
|
4462
|
+
#
|
4463
|
+
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-orgs-delegated-admin.html
|
4464
|
+
#
|
4465
|
+
# @return [Types::ListStackInstanceResourceDriftsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
4466
|
+
#
|
4467
|
+
# * {Types::ListStackInstanceResourceDriftsOutput#summaries #summaries} => Array<Types::StackInstanceResourceDriftsSummary>
|
4468
|
+
# * {Types::ListStackInstanceResourceDriftsOutput#next_token #next_token} => String
|
4469
|
+
#
|
4470
|
+
# @example Request syntax with placeholder values
|
4471
|
+
#
|
4472
|
+
# resp = client.list_stack_instance_resource_drifts({
|
4473
|
+
# stack_set_name: "StackSetNameOrId", # required
|
4474
|
+
# next_token: "NextToken",
|
4475
|
+
# max_results: 1,
|
4476
|
+
# stack_instance_resource_drift_statuses: ["IN_SYNC"], # accepts IN_SYNC, MODIFIED, DELETED, NOT_CHECKED
|
4477
|
+
# stack_instance_account: "Account", # required
|
4478
|
+
# stack_instance_region: "Region", # required
|
4479
|
+
# operation_id: "ClientRequestToken", # required
|
4480
|
+
# call_as: "SELF", # accepts SELF, DELEGATED_ADMIN
|
4481
|
+
# })
|
4482
|
+
#
|
4483
|
+
# @example Response structure
|
4484
|
+
#
|
4485
|
+
# resp.summaries #=> Array
|
4486
|
+
# resp.summaries[0].stack_id #=> String
|
4487
|
+
# resp.summaries[0].logical_resource_id #=> String
|
4488
|
+
# resp.summaries[0].physical_resource_id #=> String
|
4489
|
+
# resp.summaries[0].physical_resource_id_context #=> Array
|
4490
|
+
# resp.summaries[0].physical_resource_id_context[0].key #=> String
|
4491
|
+
# resp.summaries[0].physical_resource_id_context[0].value #=> String
|
4492
|
+
# resp.summaries[0].resource_type #=> String
|
4493
|
+
# resp.summaries[0].property_differences #=> Array
|
4494
|
+
# resp.summaries[0].property_differences[0].property_path #=> String
|
4495
|
+
# resp.summaries[0].property_differences[0].expected_value #=> String
|
4496
|
+
# resp.summaries[0].property_differences[0].actual_value #=> String
|
4497
|
+
# resp.summaries[0].property_differences[0].difference_type #=> String, one of "ADD", "REMOVE", "NOT_EQUAL"
|
4498
|
+
# resp.summaries[0].stack_resource_drift_status #=> String, one of "IN_SYNC", "MODIFIED", "DELETED", "NOT_CHECKED"
|
4499
|
+
# resp.summaries[0].timestamp #=> Time
|
4500
|
+
# resp.next_token #=> String
|
4501
|
+
#
|
4502
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/ListStackInstanceResourceDrifts AWS API Documentation
|
4503
|
+
#
|
4504
|
+
# @overload list_stack_instance_resource_drifts(params = {})
|
4505
|
+
# @param [Hash] params ({})
|
4506
|
+
def list_stack_instance_resource_drifts(params = {}, options = {})
|
4507
|
+
req = build_request(:list_stack_instance_resource_drifts, params)
|
4508
|
+
req.send_request(options)
|
4509
|
+
end
|
4510
|
+
|
4366
4511
|
# Returns summary information about stack instances that are associated
|
4367
4512
|
# with the specified stack set. You can filter for stack instances that
|
4368
4513
|
# are associated with a specific Amazon Web Services account name or
|
@@ -4433,7 +4578,7 @@ module Aws::CloudFormation
|
|
4433
4578
|
# max_results: 1,
|
4434
4579
|
# filters: [
|
4435
4580
|
# {
|
4436
|
-
# name: "DETAILED_STATUS", # accepts DETAILED_STATUS, LAST_OPERATION_ID
|
4581
|
+
# name: "DETAILED_STATUS", # accepts DETAILED_STATUS, LAST_OPERATION_ID, DRIFT_STATUS
|
4437
4582
|
# values: "StackInstanceFilterValues",
|
4438
4583
|
# },
|
4439
4584
|
# ],
|
@@ -5561,6 +5706,18 @@ module Aws::CloudFormation
|
|
5561
5706
|
# @option params [String] :client_request_token
|
5562
5707
|
# A unique identifier for this `RollbackStack` request.
|
5563
5708
|
#
|
5709
|
+
# @option params [Boolean] :retain_except_on_create
|
5710
|
+
# This deletion policy deletes newly created resources, but retains
|
5711
|
+
# existing resources, when a stack operation is rolled back. This
|
5712
|
+
# ensures new, empty, and unused resources are deleted, while critical
|
5713
|
+
# resources and their data are retained. `RetainExceptOnCreate` can be
|
5714
|
+
# specified for any resource that supports the [ DeletionPolicy][1]
|
5715
|
+
# attribute.
|
5716
|
+
#
|
5717
|
+
#
|
5718
|
+
#
|
5719
|
+
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-attribute-deletionpolicy.html
|
5720
|
+
#
|
5564
5721
|
# @return [Types::RollbackStackOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
5565
5722
|
#
|
5566
5723
|
# * {Types::RollbackStackOutput#stack_id #stack_id} => String
|
@@ -5571,6 +5728,7 @@ module Aws::CloudFormation
|
|
5571
5728
|
# stack_name: "StackNameOrId", # required
|
5572
5729
|
# role_arn: "RoleARN",
|
5573
5730
|
# client_request_token: "ClientRequestToken",
|
5731
|
+
# retain_except_on_create: false,
|
5574
5732
|
# })
|
5575
5733
|
#
|
5576
5734
|
# @example Response structure
|
@@ -6144,10 +6302,10 @@ module Aws::CloudFormation
|
|
6144
6302
|
# [5]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-role.html
|
6145
6303
|
# [6]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-user.html
|
6146
6304
|
# [7]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-addusertogroup.html
|
6147
|
-
# [8]:
|
6148
|
-
# [9]:
|
6149
|
-
# [10]:
|
6150
|
-
# [11]:
|
6305
|
+
# [8]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html#capabilities
|
6306
|
+
# [9]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/create-reusable-transform-function-snippets-and-add-to-your-template-with-aws-include-transform.html
|
6307
|
+
# [10]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/transform-aws-serverless.html
|
6308
|
+
# [11]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-macros.html
|
6151
6309
|
#
|
6152
6310
|
# @option params [Array<String>] :resource_types
|
6153
6311
|
# The template resource types that you have permissions to work with for
|
@@ -6245,6 +6403,18 @@ module Aws::CloudFormation
|
|
6245
6403
|
# token in the following format:
|
6246
6404
|
# `Console-CreateStack-7f59c3cf-00d2-40c7-b2ff-e75db0987002`.
|
6247
6405
|
#
|
6406
|
+
# @option params [Boolean] :retain_except_on_create
|
6407
|
+
# This deletion policy deletes newly created resources, but retains
|
6408
|
+
# existing resources, when a stack operation is rolled back. This
|
6409
|
+
# ensures new, empty, and unused resources are deleted, while critical
|
6410
|
+
# resources and their data are retained. `RetainExceptOnCreate` can be
|
6411
|
+
# specified for any resource that supports the [ DeletionPolicy][1]
|
6412
|
+
# attribute.
|
6413
|
+
#
|
6414
|
+
#
|
6415
|
+
#
|
6416
|
+
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-attribute-deletionpolicy.html
|
6417
|
+
#
|
6248
6418
|
# @return [Types::UpdateStackOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
6249
6419
|
#
|
6250
6420
|
# * {Types::UpdateStackOutput#stack_id #stack_id} => String
|
@@ -6289,6 +6459,7 @@ module Aws::CloudFormation
|
|
6289
6459
|
# ],
|
6290
6460
|
# disable_rollback: false,
|
6291
6461
|
# client_request_token: "ClientRequestToken",
|
6462
|
+
# retain_except_on_create: false,
|
6292
6463
|
# })
|
6293
6464
|
#
|
6294
6465
|
# @example Response structure
|
@@ -6611,10 +6782,10 @@ module Aws::CloudFormation
|
|
6611
6782
|
# [5]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-role.html
|
6612
6783
|
# [6]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-user.html
|
6613
6784
|
# [7]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-addusertogroup.html
|
6614
|
-
# [8]:
|
6615
|
-
# [9]:
|
6616
|
-
# [10]:
|
6617
|
-
# [11]:
|
6785
|
+
# [8]: https://docs.aws.amazon.com/AWSCloudFormation/using-iam-template.html#capabilities
|
6786
|
+
# [9]: https://docs.aws.amazon.com/AWSCloudFormation/template-macros.html
|
6787
|
+
# [10]: https://docs.aws.amazon.com/AWSCloudFormation/create-reusable-transform-function-snippets-and-add-to-your-template-with-aws-include-transform.html
|
6788
|
+
# [11]: https://docs.aws.amazon.com/AWSCloudFormation/transform-aws-serverless.html
|
6618
6789
|
#
|
6619
6790
|
# @option params [Array<Types::Tag>] :tags
|
6620
6791
|
# The key-value pairs to associate with this stack set and the stacks
|
@@ -6667,7 +6838,7 @@ module Aws::CloudFormation
|
|
6667
6838
|
#
|
6668
6839
|
#
|
6669
6840
|
#
|
6670
|
-
# [1]:
|
6841
|
+
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/stacksets-prereqs.html
|
6671
6842
|
#
|
6672
6843
|
# @option params [String] :execution_role_name
|
6673
6844
|
# The name of the IAM execution role to use to update the stack set. If
|
@@ -7005,7 +7176,7 @@ module Aws::CloudFormation
|
|
7005
7176
|
params: params,
|
7006
7177
|
config: config)
|
7007
7178
|
context[:gem_name] = 'aws-sdk-cloudformation'
|
7008
|
-
context[:gem_version] = '1.
|
7179
|
+
context[:gem_version] = '1.88.0'
|
7009
7180
|
Seahorse::Client::Request.new(handlers, context)
|
7010
7181
|
end
|
7011
7182
|
|
@@ -202,6 +202,8 @@ module Aws::CloudFormation
|
|
202
202
|
ListExportsOutput = Shapes::StructureShape.new(name: 'ListExportsOutput')
|
203
203
|
ListImportsInput = Shapes::StructureShape.new(name: 'ListImportsInput')
|
204
204
|
ListImportsOutput = Shapes::StructureShape.new(name: 'ListImportsOutput')
|
205
|
+
ListStackInstanceResourceDriftsInput = Shapes::StructureShape.new(name: 'ListStackInstanceResourceDriftsInput')
|
206
|
+
ListStackInstanceResourceDriftsOutput = Shapes::StructureShape.new(name: 'ListStackInstanceResourceDriftsOutput')
|
205
207
|
ListStackInstancesInput = Shapes::StructureShape.new(name: 'ListStackInstancesInput')
|
206
208
|
ListStackInstancesOutput = Shapes::StructureShape.new(name: 'ListStackInstancesOutput')
|
207
209
|
ListStackResourcesInput = Shapes::StructureShape.new(name: 'ListStackResourcesInput')
|
@@ -327,6 +329,7 @@ module Aws::CloudFormation
|
|
327
329
|
ResourceTypes = Shapes::ListShape.new(name: 'ResourceTypes')
|
328
330
|
ResourcesToImport = Shapes::ListShape.new(name: 'ResourcesToImport')
|
329
331
|
ResourcesToSkip = Shapes::ListShape.new(name: 'ResourcesToSkip')
|
332
|
+
RetainExceptOnCreate = Shapes::BooleanShape.new(name: 'RetainExceptOnCreate')
|
330
333
|
RetainResources = Shapes::ListShape.new(name: 'RetainResources')
|
331
334
|
RetainStacks = Shapes::BooleanShape.new(name: 'RetainStacks')
|
332
335
|
RetainStacksNullable = Shapes::BooleanShape.new(name: 'RetainStacksNullable')
|
@@ -367,6 +370,8 @@ module Aws::CloudFormation
|
|
367
370
|
StackInstanceFilterValues = Shapes::StringShape.new(name: 'StackInstanceFilterValues')
|
368
371
|
StackInstanceFilters = Shapes::ListShape.new(name: 'StackInstanceFilters')
|
369
372
|
StackInstanceNotFoundException = Shapes::StructureShape.new(name: 'StackInstanceNotFoundException')
|
373
|
+
StackInstanceResourceDriftsSummaries = Shapes::ListShape.new(name: 'StackInstanceResourceDriftsSummaries')
|
374
|
+
StackInstanceResourceDriftsSummary = Shapes::StructureShape.new(name: 'StackInstanceResourceDriftsSummary')
|
370
375
|
StackInstanceStatus = Shapes::StringShape.new(name: 'StackInstanceStatus')
|
371
376
|
StackInstanceSummaries = Shapes::ListShape.new(name: 'StackInstanceSummaries')
|
372
377
|
StackInstanceSummary = Shapes::StructureShape.new(name: 'StackInstanceSummary')
|
@@ -646,6 +651,7 @@ module Aws::CloudFormation
|
|
646
651
|
CreateStackInput.add_member(:tags, Shapes::ShapeRef.new(shape: Tags, location_name: "Tags"))
|
647
652
|
CreateStackInput.add_member(:client_request_token, Shapes::ShapeRef.new(shape: ClientRequestToken, location_name: "ClientRequestToken"))
|
648
653
|
CreateStackInput.add_member(:enable_termination_protection, Shapes::ShapeRef.new(shape: EnableTerminationProtection, location_name: "EnableTerminationProtection"))
|
654
|
+
CreateStackInput.add_member(:retain_except_on_create, Shapes::ShapeRef.new(shape: RetainExceptOnCreate, location_name: "RetainExceptOnCreate"))
|
649
655
|
CreateStackInput.struct_class = Types::CreateStackInput
|
650
656
|
|
651
657
|
CreateStackInstancesInput.add_member(:stack_set_name, Shapes::ShapeRef.new(shape: StackSetName, required: true, location_name: "StackSetName"))
|
@@ -964,6 +970,7 @@ module Aws::CloudFormation
|
|
964
970
|
ExecuteChangeSetInput.add_member(:stack_name, Shapes::ShapeRef.new(shape: StackNameOrId, location_name: "StackName"))
|
965
971
|
ExecuteChangeSetInput.add_member(:client_request_token, Shapes::ShapeRef.new(shape: ClientRequestToken, location_name: "ClientRequestToken"))
|
966
972
|
ExecuteChangeSetInput.add_member(:disable_rollback, Shapes::ShapeRef.new(shape: DisableRollback, location_name: "DisableRollback"))
|
973
|
+
ExecuteChangeSetInput.add_member(:retain_except_on_create, Shapes::ShapeRef.new(shape: RetainExceptOnCreate, location_name: "RetainExceptOnCreate"))
|
967
974
|
ExecuteChangeSetInput.struct_class = Types::ExecuteChangeSetInput
|
968
975
|
|
969
976
|
ExecuteChangeSetOutput.struct_class = Types::ExecuteChangeSetOutput
|
@@ -1057,6 +1064,20 @@ module Aws::CloudFormation
|
|
1057
1064
|
ListImportsOutput.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "NextToken"))
|
1058
1065
|
ListImportsOutput.struct_class = Types::ListImportsOutput
|
1059
1066
|
|
1067
|
+
ListStackInstanceResourceDriftsInput.add_member(:stack_set_name, Shapes::ShapeRef.new(shape: StackSetNameOrId, required: true, location_name: "StackSetName"))
|
1068
|
+
ListStackInstanceResourceDriftsInput.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "NextToken"))
|
1069
|
+
ListStackInstanceResourceDriftsInput.add_member(:max_results, Shapes::ShapeRef.new(shape: MaxResults, location_name: "MaxResults"))
|
1070
|
+
ListStackInstanceResourceDriftsInput.add_member(:stack_instance_resource_drift_statuses, Shapes::ShapeRef.new(shape: StackResourceDriftStatusFilters, location_name: "StackInstanceResourceDriftStatuses"))
|
1071
|
+
ListStackInstanceResourceDriftsInput.add_member(:stack_instance_account, Shapes::ShapeRef.new(shape: Account, required: true, location_name: "StackInstanceAccount"))
|
1072
|
+
ListStackInstanceResourceDriftsInput.add_member(:stack_instance_region, Shapes::ShapeRef.new(shape: Region, required: true, location_name: "StackInstanceRegion"))
|
1073
|
+
ListStackInstanceResourceDriftsInput.add_member(:operation_id, Shapes::ShapeRef.new(shape: ClientRequestToken, required: true, location_name: "OperationId"))
|
1074
|
+
ListStackInstanceResourceDriftsInput.add_member(:call_as, Shapes::ShapeRef.new(shape: CallAs, location_name: "CallAs"))
|
1075
|
+
ListStackInstanceResourceDriftsInput.struct_class = Types::ListStackInstanceResourceDriftsInput
|
1076
|
+
|
1077
|
+
ListStackInstanceResourceDriftsOutput.add_member(:summaries, Shapes::ShapeRef.new(shape: StackInstanceResourceDriftsSummaries, location_name: "Summaries"))
|
1078
|
+
ListStackInstanceResourceDriftsOutput.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "NextToken"))
|
1079
|
+
ListStackInstanceResourceDriftsOutput.struct_class = Types::ListStackInstanceResourceDriftsOutput
|
1080
|
+
|
1060
1081
|
ListStackInstancesInput.add_member(:stack_set_name, Shapes::ShapeRef.new(shape: StackSetName, required: true, location_name: "StackSetName"))
|
1061
1082
|
ListStackInstancesInput.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "NextToken"))
|
1062
1083
|
ListStackInstancesInput.add_member(:max_results, Shapes::ShapeRef.new(shape: MaxResults, location_name: "MaxResults"))
|
@@ -1338,6 +1359,7 @@ module Aws::CloudFormation
|
|
1338
1359
|
RollbackStackInput.add_member(:stack_name, Shapes::ShapeRef.new(shape: StackNameOrId, required: true, location_name: "StackName"))
|
1339
1360
|
RollbackStackInput.add_member(:role_arn, Shapes::ShapeRef.new(shape: RoleARN, location_name: "RoleARN"))
|
1340
1361
|
RollbackStackInput.add_member(:client_request_token, Shapes::ShapeRef.new(shape: ClientRequestToken, location_name: "ClientRequestToken"))
|
1362
|
+
RollbackStackInput.add_member(:retain_except_on_create, Shapes::ShapeRef.new(shape: RetainExceptOnCreate, location_name: "RetainExceptOnCreate"))
|
1341
1363
|
RollbackStackInput.struct_class = Types::RollbackStackInput
|
1342
1364
|
|
1343
1365
|
RollbackStackOutput.add_member(:stack_id, Shapes::ShapeRef.new(shape: StackId, location_name: "StackId"))
|
@@ -1402,6 +1424,7 @@ module Aws::CloudFormation
|
|
1402
1424
|
Stack.add_member(:parent_id, Shapes::ShapeRef.new(shape: StackId, location_name: "ParentId"))
|
1403
1425
|
Stack.add_member(:root_id, Shapes::ShapeRef.new(shape: StackId, location_name: "RootId"))
|
1404
1426
|
Stack.add_member(:drift_information, Shapes::ShapeRef.new(shape: StackDriftInformation, location_name: "DriftInformation"))
|
1427
|
+
Stack.add_member(:retain_except_on_create, Shapes::ShapeRef.new(shape: RetainExceptOnCreate, location_name: "RetainExceptOnCreate"))
|
1405
1428
|
Stack.struct_class = Types::Stack
|
1406
1429
|
|
1407
1430
|
StackDriftInformation.add_member(:stack_drift_status, Shapes::ShapeRef.new(shape: StackDriftStatus, required: true, location_name: "StackDriftStatus"))
|
@@ -1459,6 +1482,18 @@ module Aws::CloudFormation
|
|
1459
1482
|
|
1460
1483
|
StackInstanceNotFoundException.struct_class = Types::StackInstanceNotFoundException
|
1461
1484
|
|
1485
|
+
StackInstanceResourceDriftsSummaries.member = Shapes::ShapeRef.new(shape: StackInstanceResourceDriftsSummary)
|
1486
|
+
|
1487
|
+
StackInstanceResourceDriftsSummary.add_member(:stack_id, Shapes::ShapeRef.new(shape: StackId, required: true, location_name: "StackId"))
|
1488
|
+
StackInstanceResourceDriftsSummary.add_member(:logical_resource_id, Shapes::ShapeRef.new(shape: LogicalResourceId, required: true, location_name: "LogicalResourceId"))
|
1489
|
+
StackInstanceResourceDriftsSummary.add_member(:physical_resource_id, Shapes::ShapeRef.new(shape: PhysicalResourceId, location_name: "PhysicalResourceId"))
|
1490
|
+
StackInstanceResourceDriftsSummary.add_member(:physical_resource_id_context, Shapes::ShapeRef.new(shape: PhysicalResourceIdContext, location_name: "PhysicalResourceIdContext"))
|
1491
|
+
StackInstanceResourceDriftsSummary.add_member(:resource_type, Shapes::ShapeRef.new(shape: ResourceType, required: true, location_name: "ResourceType"))
|
1492
|
+
StackInstanceResourceDriftsSummary.add_member(:property_differences, Shapes::ShapeRef.new(shape: PropertyDifferences, location_name: "PropertyDifferences"))
|
1493
|
+
StackInstanceResourceDriftsSummary.add_member(:stack_resource_drift_status, Shapes::ShapeRef.new(shape: StackResourceDriftStatus, required: true, location_name: "StackResourceDriftStatus"))
|
1494
|
+
StackInstanceResourceDriftsSummary.add_member(:timestamp, Shapes::ShapeRef.new(shape: Timestamp, required: true, location_name: "Timestamp"))
|
1495
|
+
StackInstanceResourceDriftsSummary.struct_class = Types::StackInstanceResourceDriftsSummary
|
1496
|
+
|
1462
1497
|
StackInstanceSummaries.member = Shapes::ShapeRef.new(shape: StackInstanceSummary)
|
1463
1498
|
|
1464
1499
|
StackInstanceSummary.add_member(:stack_set_id, Shapes::ShapeRef.new(shape: StackSetId, location_name: "StackSetId"))
|
@@ -1777,6 +1812,7 @@ module Aws::CloudFormation
|
|
1777
1812
|
UpdateStackInput.add_member(:tags, Shapes::ShapeRef.new(shape: Tags, location_name: "Tags"))
|
1778
1813
|
UpdateStackInput.add_member(:disable_rollback, Shapes::ShapeRef.new(shape: DisableRollback, location_name: "DisableRollback"))
|
1779
1814
|
UpdateStackInput.add_member(:client_request_token, Shapes::ShapeRef.new(shape: ClientRequestToken, location_name: "ClientRequestToken"))
|
1815
|
+
UpdateStackInput.add_member(:retain_except_on_create, Shapes::ShapeRef.new(shape: RetainExceptOnCreate, location_name: "RetainExceptOnCreate"))
|
1780
1816
|
UpdateStackInput.struct_class = Types::UpdateStackInput
|
1781
1817
|
|
1782
1818
|
UpdateStackInstancesInput.add_member(:stack_set_name, Shapes::ShapeRef.new(shape: StackSetNameOrId, required: true, location_name: "StackSetName"))
|
@@ -2313,6 +2349,17 @@ module Aws::CloudFormation
|
|
2313
2349
|
)
|
2314
2350
|
end)
|
2315
2351
|
|
2352
|
+
api.add_operation(:list_stack_instance_resource_drifts, Seahorse::Model::Operation.new.tap do |o|
|
2353
|
+
o.name = "ListStackInstanceResourceDrifts"
|
2354
|
+
o.http_method = "POST"
|
2355
|
+
o.http_request_uri = "/"
|
2356
|
+
o.input = Shapes::ShapeRef.new(shape: ListStackInstanceResourceDriftsInput)
|
2357
|
+
o.output = Shapes::ShapeRef.new(shape: ListStackInstanceResourceDriftsOutput)
|
2358
|
+
o.errors << Shapes::ShapeRef.new(shape: StackSetNotFoundException)
|
2359
|
+
o.errors << Shapes::ShapeRef.new(shape: StackInstanceNotFoundException)
|
2360
|
+
o.errors << Shapes::ShapeRef.new(shape: OperationNotFoundException)
|
2361
|
+
end)
|
2362
|
+
|
2316
2363
|
api.add_operation(:list_stack_instances, Seahorse::Model::Operation.new.tap do |o|
|
2317
2364
|
o.name = "ListStackInstances"
|
2318
2365
|
o.http_method = "POST"
|
@@ -628,6 +628,20 @@ module Aws::CloudFormation
|
|
628
628
|
end
|
629
629
|
end
|
630
630
|
|
631
|
+
class ListStackInstanceResourceDrifts
|
632
|
+
def self.build(context)
|
633
|
+
unless context.config.regional_endpoint
|
634
|
+
endpoint = context.config.endpoint.to_s
|
635
|
+
end
|
636
|
+
Aws::CloudFormation::EndpointParameters.new(
|
637
|
+
region: context.config.region,
|
638
|
+
use_dual_stack: context.config.use_dualstack_endpoint,
|
639
|
+
use_fips: context.config.use_fips_endpoint,
|
640
|
+
endpoint: endpoint,
|
641
|
+
)
|
642
|
+
end
|
643
|
+
end
|
644
|
+
|
631
645
|
class ListStackInstances
|
632
646
|
def self.build(context)
|
633
647
|
unless context.config.regional_endpoint
|
@@ -144,6 +144,8 @@ module Aws::CloudFormation
|
|
144
144
|
Aws::CloudFormation::Endpoints::ListExports.build(context)
|
145
145
|
when :list_imports
|
146
146
|
Aws::CloudFormation::Endpoints::ListImports.build(context)
|
147
|
+
when :list_stack_instance_resource_drifts
|
148
|
+
Aws::CloudFormation::Endpoints::ListStackInstanceResourceDrifts.build(context)
|
147
149
|
when :list_stack_instances
|
148
150
|
Aws::CloudFormation::Endpoints::ListStackInstances.build(context)
|
149
151
|
when :list_stack_resources
|
@@ -75,6 +75,7 @@ module Aws::CloudFormation
|
|
75
75
|
# ],
|
76
76
|
# client_request_token: "ClientRequestToken",
|
77
77
|
# enable_termination_protection: false,
|
78
|
+
# retain_except_on_create: false,
|
78
79
|
# })
|
79
80
|
# @param [Hash] options ({})
|
80
81
|
# @option options [required, String] :stack_name
|
@@ -218,10 +219,10 @@ module Aws::CloudFormation
|
|
218
219
|
# [5]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-role.html
|
219
220
|
# [6]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-user.html
|
220
221
|
# [7]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-addusertogroup.html
|
221
|
-
# [8]:
|
222
|
-
# [9]:
|
223
|
-
# [10]:
|
224
|
-
# [11]:
|
222
|
+
# [8]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html#capabilities
|
223
|
+
# [9]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/create-reusable-transform-function-snippets-and-add-to-your-template-with-aws-include-transform.html
|
224
|
+
# [10]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/transform-aws-serverless.html
|
225
|
+
# [11]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-macros.html
|
225
226
|
# @option options [Array<String>] :resource_types
|
226
227
|
# The template resource types that you have permissions to work with for
|
227
228
|
# this create stack action, such as `AWS::EC2::Instance`, `AWS::EC2::*`,
|
@@ -313,8 +314,19 @@ module Aws::CloudFormation
|
|
313
314
|
#
|
314
315
|
#
|
315
316
|
#
|
316
|
-
# [1]:
|
317
|
-
# [2]:
|
317
|
+
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-protect-stacks.html
|
318
|
+
# [2]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-nested-stacks.html
|
319
|
+
# @option options [Boolean] :retain_except_on_create
|
320
|
+
# This deletion policy deletes newly created resources, but retains
|
321
|
+
# existing resources, when a stack operation is rolled back. This
|
322
|
+
# ensures new, empty, and unused resources are deleted, while critical
|
323
|
+
# resources and their data are retained. `RetainExceptOnCreate` can be
|
324
|
+
# specified for any resource that supports the [ DeletionPolicy][1]
|
325
|
+
# attribute.
|
326
|
+
#
|
327
|
+
#
|
328
|
+
#
|
329
|
+
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-attribute-deletionpolicy.html
|
318
330
|
# @return [Stack]
|
319
331
|
def create_stack(options = {})
|
320
332
|
Aws::Plugins::UserAgent.feature('resource') do
|