aws-sdk-cloudformation 1.119.0 → 1.121.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 +241 -308
- data/lib/aws-sdk-cloudformation/event.rb +6 -4
- data/lib/aws-sdk-cloudformation/resource.rb +35 -46
- data/lib/aws-sdk-cloudformation/stack.rb +78 -102
- data/lib/aws-sdk-cloudformation/stack_resource.rb +6 -5
- data/lib/aws-sdk-cloudformation/stack_resource_summary.rb +5 -4
- data/lib/aws-sdk-cloudformation/types.rb +312 -407
- data/lib/aws-sdk-cloudformation.rb +3 -1
- metadata +2 -2
@@ -36,8 +36,6 @@ require 'aws-sdk-core/plugins/telemetry.rb'
|
|
36
36
|
require 'aws-sdk-core/plugins/sign.rb'
|
37
37
|
require 'aws-sdk-core/plugins/protocols/query.rb'
|
38
38
|
|
39
|
-
Aws::Plugins::GlobalConfiguration.add_identifier(:cloudformation)
|
40
|
-
|
41
39
|
module Aws::CloudFormation
|
42
40
|
# An API client for CloudFormation. To construct a client, you need to configure a `:region` and `:credentials`.
|
43
41
|
#
|
@@ -465,20 +463,16 @@ module Aws::CloudFormation
|
|
465
463
|
end
|
466
464
|
|
467
465
|
# Activates a public third-party extension, making it available for use
|
468
|
-
# in stack templates.
|
469
|
-
#
|
470
|
-
#
|
471
|
-
#
|
472
|
-
#
|
473
|
-
# properties for the extension. For more information, see [Configuring
|
474
|
-
# extensions at the account level][3] in the *CloudFormation User
|
475
|
-
# Guide*.
|
466
|
+
# in stack templates. Once you have activated a public third-party
|
467
|
+
# extension in your account and Region, use [SetTypeConfiguration][1] to
|
468
|
+
# specify configuration properties for the extension. For more
|
469
|
+
# information, see [Using public extensions][2] in the *CloudFormation
|
470
|
+
# User Guide*.
|
476
471
|
#
|
477
472
|
#
|
478
473
|
#
|
479
|
-
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/
|
480
|
-
# [2]: https://docs.aws.amazon.com/AWSCloudFormation/latest/
|
481
|
-
# [3]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/registry-private.html#registry-set-configuration
|
474
|
+
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_SetTypeConfiguration.html
|
475
|
+
# [2]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/registry-public.html
|
482
476
|
#
|
483
477
|
# @option params [String] :type
|
484
478
|
# The extension type.
|
@@ -587,12 +581,12 @@ module Aws::CloudFormation
|
|
587
581
|
# extensions, from the CloudFormation registry for the account and
|
588
582
|
# Region.
|
589
583
|
#
|
590
|
-
# For more information, see [
|
591
|
-
#
|
584
|
+
# For more information, see [Edit configuration data for extensions in
|
585
|
+
# your account][1] in the *CloudFormation User Guide*.
|
592
586
|
#
|
593
587
|
#
|
594
588
|
#
|
595
|
-
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/registry-
|
589
|
+
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/registry-set-configuration.html
|
596
590
|
#
|
597
591
|
# @option params [required, Array<Types::TypeConfigurationIdentifier>] :type_configuration_identifiers
|
598
592
|
# The list of identifiers for the desired extension configurations.
|
@@ -702,7 +696,7 @@ module Aws::CloudFormation
|
|
702
696
|
|
703
697
|
# For a specified stack that's in the `UPDATE_ROLLBACK_FAILED` state,
|
704
698
|
# continues rolling it back to the `UPDATE_ROLLBACK_COMPLETE` state.
|
705
|
-
# Depending on the cause of the failure, you can manually [
|
699
|
+
# Depending on the cause of the failure, you can manually [fix the
|
706
700
|
# error][1] and continue the rollback. By continuing the rollback, you
|
707
701
|
# can return your stack to a working state (the
|
708
702
|
# `UPDATE_ROLLBACK_COMPLETE` state), and then try to update the stack
|
@@ -732,13 +726,13 @@ module Aws::CloudFormation
|
|
732
726
|
# </note>
|
733
727
|
#
|
734
728
|
# @option params [String] :role_arn
|
735
|
-
# The Amazon Resource Name (ARN) of an
|
736
|
-
#
|
737
|
-
#
|
738
|
-
#
|
739
|
-
#
|
740
|
-
#
|
741
|
-
#
|
729
|
+
# The Amazon Resource Name (ARN) of an IAM role that CloudFormation
|
730
|
+
# assumes to roll back the stack. CloudFormation uses the role's
|
731
|
+
# credentials to make calls on your behalf. CloudFormation always uses
|
732
|
+
# this role for all future operations on the stack. Provided that users
|
733
|
+
# have permission to operate on the stack, CloudFormation uses this role
|
734
|
+
# even if the users don't have permission to pass it. Ensure that the
|
735
|
+
# role grants least permission.
|
742
736
|
#
|
743
737
|
# If you don't specify a value, CloudFormation uses the role that was
|
744
738
|
# previously associated with the stack. If no role is available,
|
@@ -779,8 +773,8 @@ module Aws::CloudFormation
|
|
779
773
|
#
|
780
774
|
# <note markdown="1"> Don't confuse a child stack's name with its corresponding logical ID
|
781
775
|
# defined in the parent stack. For an example of a continue update
|
782
|
-
# rollback operation with nested stacks, see [
|
783
|
-
#
|
776
|
+
# rollback operation with nested stacks, see [Continue rolling back from
|
777
|
+
# failed nested stack updates][2].
|
784
778
|
#
|
785
779
|
# </note>
|
786
780
|
#
|
@@ -885,9 +879,8 @@ module Aws::CloudFormation
|
|
885
879
|
#
|
886
880
|
# Some stack templates might include resources that can affect
|
887
881
|
# permissions in your Amazon Web Services account; for example, by
|
888
|
-
# creating new
|
889
|
-
#
|
890
|
-
# these capabilities.
|
882
|
+
# creating new IAM users. For those stacks, you must explicitly
|
883
|
+
# acknowledge this by specifying one of these capabilities.
|
891
884
|
#
|
892
885
|
# The following IAM resources require you to specify either the
|
893
886
|
# `CAPABILITY_IAM` or `CAPABILITY_NAMED_IAM` capability.
|
@@ -946,8 +939,8 @@ module Aws::CloudFormation
|
|
946
939
|
#
|
947
940
|
# </note>
|
948
941
|
#
|
949
|
-
# For more information about macros, see [
|
950
|
-
#
|
942
|
+
# For more information about macros, see [Perform custom processing on
|
943
|
+
# CloudFormation templates with template macros][11].
|
951
944
|
#
|
952
945
|
# <note markdown="1"> Only one of the `Capabilities` and `ResourceType` parameters can be
|
953
946
|
# specified.
|
@@ -956,14 +949,14 @@ module Aws::CloudFormation
|
|
956
949
|
#
|
957
950
|
#
|
958
951
|
#
|
959
|
-
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-
|
960
|
-
# [2]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-
|
952
|
+
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-accesskey.html
|
953
|
+
# [2]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-group.html
|
961
954
|
# [3]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-instanceprofile.html
|
962
|
-
# [4]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-
|
955
|
+
# [4]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-policy.html
|
963
956
|
# [5]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-role.html
|
964
|
-
# [6]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-
|
965
|
-
# [7]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-
|
966
|
-
# [8]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html#capabilities
|
957
|
+
# [6]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-user.html
|
958
|
+
# [7]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-usertogroupaddition.html
|
959
|
+
# [8]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html#using-iam-capabilities
|
967
960
|
# [9]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/create-reusable-transform-function-snippets-and-add-to-your-template-with-aws-include-transform.html
|
968
961
|
# [10]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/transform-aws-serverless.html
|
969
962
|
# [11]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-macros.html
|
@@ -975,11 +968,10 @@ module Aws::CloudFormation
|
|
975
968
|
#
|
976
969
|
# If the list of resource types doesn't include a resource type that
|
977
970
|
# you're updating, the stack update fails. By default, CloudFormation
|
978
|
-
# grants permissions to all resource types.
|
979
|
-
#
|
980
|
-
#
|
981
|
-
#
|
982
|
-
# User Guide*.
|
971
|
+
# grants permissions to all resource types. IAM uses this parameter for
|
972
|
+
# condition keys in IAM policies for CloudFormation. For more
|
973
|
+
# information, see [Control access with Identity and Access
|
974
|
+
# Management][1] in the *CloudFormation User Guide*.
|
983
975
|
#
|
984
976
|
# <note markdown="1"> Only one of the `Capabilities` and `ResourceType` parameters can be
|
985
977
|
# specified.
|
@@ -991,13 +983,13 @@ module Aws::CloudFormation
|
|
991
983
|
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html
|
992
984
|
#
|
993
985
|
# @option params [String] :role_arn
|
994
|
-
# The Amazon Resource Name (ARN) of an
|
995
|
-
#
|
996
|
-
#
|
997
|
-
#
|
998
|
-
#
|
999
|
-
#
|
1000
|
-
#
|
986
|
+
# The Amazon Resource Name (ARN) of an IAM role that CloudFormation
|
987
|
+
# assumes when executing the change set. CloudFormation uses the role's
|
988
|
+
# credentials to make calls on your behalf. CloudFormation uses this
|
989
|
+
# role for all future operations on the stack. Provided that users have
|
990
|
+
# permission to operate on the stack, CloudFormation uses this role even
|
991
|
+
# if the users don't have permission to pass it. Ensure that the role
|
992
|
+
# grants least permission.
|
1001
993
|
#
|
1002
994
|
# If you don't specify a value, CloudFormation uses the role that was
|
1003
995
|
# previously associated with the stack. If no role is available,
|
@@ -1010,9 +1002,9 @@ module Aws::CloudFormation
|
|
1010
1002
|
# period afterwards.
|
1011
1003
|
#
|
1012
1004
|
# @option params [Array<String>] :notification_arns
|
1013
|
-
# The Amazon Resource Names (ARNs) of Amazon
|
1014
|
-
#
|
1015
|
-
#
|
1005
|
+
# The Amazon Resource Names (ARNs) of Amazon SNS topics that
|
1006
|
+
# CloudFormation associates with the stack. To remove all associated
|
1007
|
+
# notification topics, specify an empty list.
|
1016
1008
|
#
|
1017
1009
|
# @option params [Array<Types::Tag>] :tags
|
1018
1010
|
# Key-value pairs to associate with this stack. CloudFormation also
|
@@ -1045,17 +1037,13 @@ module Aws::CloudFormation
|
|
1045
1037
|
#
|
1046
1038
|
# If you create a change set for a new stack, CloudFormation creates a
|
1047
1039
|
# stack with a unique stack ID, but no template or resources. The stack
|
1048
|
-
# will be in the
|
1049
|
-
#
|
1040
|
+
# will be in the `REVIEW_IN_PROGRESS` state until you execute the change
|
1041
|
+
# set.
|
1050
1042
|
#
|
1051
1043
|
# By default, CloudFormation specifies `UPDATE`. You can't use the
|
1052
1044
|
# `UPDATE` type to create a change set for a new stack or the `CREATE`
|
1053
1045
|
# type to create a change set for an existing stack.
|
1054
1046
|
#
|
1055
|
-
#
|
1056
|
-
#
|
1057
|
-
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-describing-stacks.html#d0e11995
|
1058
|
-
#
|
1059
1047
|
# @option params [Array<Types::ResourceToImport>] :resources_to_import
|
1060
1048
|
# The resources to import into your stack.
|
1061
1049
|
#
|
@@ -1099,8 +1087,9 @@ module Aws::CloudFormation
|
|
1099
1087
|
# templates. For more information, see [name type][1] in the
|
1100
1088
|
# *CloudFormation User Guide*. To import resources that do not accept
|
1101
1089
|
# custom names, such as EC2 instances, use the resource import feature
|
1102
|
-
# instead. For more information, see [
|
1103
|
-
# CloudFormation
|
1090
|
+
# instead. For more information, see [Import Amazon Web Services
|
1091
|
+
# resources into a CloudFormation stack with a resource import][2] in
|
1092
|
+
# the *CloudFormation User Guide*.
|
1104
1093
|
#
|
1105
1094
|
# </note>
|
1106
1095
|
#
|
@@ -1272,6 +1261,14 @@ module Aws::CloudFormation
|
|
1272
1261
|
# successfully, the stack creation starts. You can check the status of
|
1273
1262
|
# the stack through the DescribeStacks operation.
|
1274
1263
|
#
|
1264
|
+
# For more information about creating a stack and monitoring stack
|
1265
|
+
# progress, see [Managing Amazon Web Services resources as a single unit
|
1266
|
+
# with CloudFormation stacks][1] in the *CloudFormation User Guide*.
|
1267
|
+
#
|
1268
|
+
#
|
1269
|
+
#
|
1270
|
+
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacks.html
|
1271
|
+
#
|
1275
1272
|
# @option params [required, String] :stack_name
|
1276
1273
|
# The name that's associated with the stack. The name must be unique in
|
1277
1274
|
# the Region in which you are creating the stack.
|
@@ -1284,30 +1281,20 @@ module Aws::CloudFormation
|
|
1284
1281
|
#
|
1285
1282
|
# @option params [String] :template_body
|
1286
1283
|
# Structure containing the template body with a minimum length of 1 byte
|
1287
|
-
# and a maximum length of 51,200 bytes.
|
1288
|
-
# [Template anatomy][1] in the *CloudFormation User Guide*.
|
1284
|
+
# and a maximum length of 51,200 bytes.
|
1289
1285
|
#
|
1290
1286
|
# Conditional: You must specify either the `TemplateBody` or the
|
1291
1287
|
# `TemplateURL` parameter, but not both.
|
1292
1288
|
#
|
1293
|
-
#
|
1294
|
-
#
|
1295
|
-
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html
|
1296
|
-
#
|
1297
1289
|
# @option params [String] :template_url
|
1298
1290
|
# Location of file containing the template body. The URL must point to a
|
1299
1291
|
# template (max size: 460,800 bytes) that's located in an Amazon S3
|
1300
|
-
# bucket or a Systems Manager document.
|
1301
|
-
#
|
1302
|
-
# for an Amazon S3 bucket must start with `https://`.
|
1292
|
+
# bucket or a Systems Manager document. The location for an Amazon S3
|
1293
|
+
# bucket must start with `https://`.
|
1303
1294
|
#
|
1304
1295
|
# Conditional: You must specify either the `TemplateBody` or the
|
1305
1296
|
# `TemplateURL` parameter, but not both.
|
1306
1297
|
#
|
1307
|
-
#
|
1308
|
-
#
|
1309
|
-
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html
|
1310
|
-
#
|
1311
1298
|
# @option params [Array<Types::Parameter>] :parameters
|
1312
1299
|
# A list of `Parameter` structures that specify input parameters for the
|
1313
1300
|
# stack. For more information, see the [Parameter][1] data type.
|
@@ -1334,9 +1321,9 @@ module Aws::CloudFormation
|
|
1334
1321
|
# the stack will be rolled back.
|
1335
1322
|
#
|
1336
1323
|
# @option params [Array<String>] :notification_arns
|
1337
|
-
# The Amazon
|
1338
|
-
#
|
1339
|
-
#
|
1324
|
+
# The Amazon SNS topic ARNs to publish stack related events. You can
|
1325
|
+
# find your Amazon SNS topic ARNs using the Amazon SNS console or your
|
1326
|
+
# Command Line Interface (CLI).
|
1340
1327
|
#
|
1341
1328
|
# @option params [Array<String>] :capabilities
|
1342
1329
|
# In some cases, you must explicitly acknowledge that your stack
|
@@ -1347,9 +1334,8 @@ module Aws::CloudFormation
|
|
1347
1334
|
#
|
1348
1335
|
# Some stack templates might include resources that can affect
|
1349
1336
|
# permissions in your Amazon Web Services account; for example, by
|
1350
|
-
# creating new
|
1351
|
-
#
|
1352
|
-
# these capabilities.
|
1337
|
+
# creating new IAM users. For those stacks, you must explicitly
|
1338
|
+
# acknowledge this by specifying one of these capabilities.
|
1353
1339
|
#
|
1354
1340
|
# The following IAM resources require you to specify either the
|
1355
1341
|
# `CAPABILITY_IAM` or `CAPABILITY_NAMED_IAM` capability.
|
@@ -1380,8 +1366,8 @@ module Aws::CloudFormation
|
|
1380
1366
|
#
|
1381
1367
|
# * [AWS::IAM::UserToGroupAddition][7]
|
1382
1368
|
#
|
1383
|
-
# For more information, see [Acknowledging IAM
|
1384
|
-
# CloudFormation
|
1369
|
+
# For more information, see [Acknowledging IAM resources in
|
1370
|
+
# CloudFormation templates][8].
|
1385
1371
|
#
|
1386
1372
|
# * `CAPABILITY_AUTO_EXPAND`
|
1387
1373
|
#
|
@@ -1410,8 +1396,8 @@ module Aws::CloudFormation
|
|
1410
1396
|
# can update the function operation without CloudFormation being
|
1411
1397
|
# notified.
|
1412
1398
|
#
|
1413
|
-
# For more information, see [
|
1414
|
-
#
|
1399
|
+
# For more information, see [Perform custom processing on
|
1400
|
+
# CloudFormation templates with template macros][11].
|
1415
1401
|
#
|
1416
1402
|
# <note markdown="1"> Only one of the `Capabilities` and `ResourceType` parameters can be
|
1417
1403
|
# specified.
|
@@ -1420,14 +1406,14 @@ module Aws::CloudFormation
|
|
1420
1406
|
#
|
1421
1407
|
#
|
1422
1408
|
#
|
1423
|
-
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-
|
1424
|
-
# [2]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-
|
1409
|
+
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-accesskey.html
|
1410
|
+
# [2]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-group.html
|
1425
1411
|
# [3]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-instanceprofile.html
|
1426
|
-
# [4]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-
|
1412
|
+
# [4]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-policy.html
|
1427
1413
|
# [5]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-role.html
|
1428
|
-
# [6]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-
|
1429
|
-
# [7]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-
|
1430
|
-
# [8]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html#capabilities
|
1414
|
+
# [6]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-user.html
|
1415
|
+
# [7]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-usertogroupaddition.html
|
1416
|
+
# [8]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html#using-iam-capabilities
|
1431
1417
|
# [9]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/create-reusable-transform-function-snippets-and-add-to-your-template-with-aws-include-transform.html
|
1432
1418
|
# [10]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/transform-aws-serverless.html
|
1433
1419
|
# [11]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-macros.html
|
@@ -1445,10 +1431,10 @@ module Aws::CloudFormation
|
|
1445
1431
|
#
|
1446
1432
|
# If the list of resource types doesn't include a resource that you're
|
1447
1433
|
# creating, the stack creation fails. By default, CloudFormation grants
|
1448
|
-
# permissions to all resource types.
|
1449
|
-
#
|
1450
|
-
#
|
1451
|
-
#
|
1434
|
+
# permissions to all resource types. IAM uses this parameter for
|
1435
|
+
# CloudFormation-specific condition keys in IAM policies. For more
|
1436
|
+
# information, see [Control access with Identity and Access
|
1437
|
+
# Management][1].
|
1452
1438
|
#
|
1453
1439
|
# <note markdown="1"> Only one of the `Capabilities` and `ResourceType` parameters can be
|
1454
1440
|
# specified.
|
@@ -1460,13 +1446,13 @@ module Aws::CloudFormation
|
|
1460
1446
|
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html
|
1461
1447
|
#
|
1462
1448
|
# @option params [String] :role_arn
|
1463
|
-
# The Amazon Resource Name (ARN) of an
|
1464
|
-
#
|
1465
|
-
#
|
1466
|
-
#
|
1467
|
-
#
|
1468
|
-
#
|
1469
|
-
#
|
1449
|
+
# The Amazon Resource Name (ARN) of an IAM role that CloudFormation
|
1450
|
+
# assumes to create the stack. CloudFormation uses the role's
|
1451
|
+
# credentials to make calls on your behalf. CloudFormation always uses
|
1452
|
+
# this role for all future operations on the stack. Provided that users
|
1453
|
+
# have permission to operate on the stack, CloudFormation uses this role
|
1454
|
+
# even if the users don't have permission to pass it. Ensure that the
|
1455
|
+
# role grants least privilege.
|
1470
1456
|
#
|
1471
1457
|
# If you don't specify a value, CloudFormation uses the role that was
|
1472
1458
|
# previously associated with the stack. If no role is available,
|
@@ -1481,9 +1467,9 @@ module Aws::CloudFormation
|
|
1481
1467
|
# Default: `ROLLBACK`
|
1482
1468
|
#
|
1483
1469
|
# @option params [String] :stack_policy_body
|
1484
|
-
# Structure containing the stack policy body. For more information,
|
1485
|
-
#
|
1486
|
-
#
|
1470
|
+
# Structure containing the stack policy body. For more information, see
|
1471
|
+
# [Prevent updates to stack resources][1] in the *CloudFormation User
|
1472
|
+
# Guide*. You can specify either the `StackPolicyBody` or the
|
1487
1473
|
# `StackPolicyURL` parameter, but not both.
|
1488
1474
|
#
|
1489
1475
|
#
|
@@ -1527,9 +1513,9 @@ module Aws::CloudFormation
|
|
1527
1513
|
# Whether to enable termination protection on the specified stack. If a
|
1528
1514
|
# user attempts to delete a stack with termination protection enabled,
|
1529
1515
|
# the operation fails and the stack remains unchanged. For more
|
1530
|
-
# information, see [
|
1531
|
-
# *CloudFormation User Guide*. Termination protection is
|
1532
|
-
# stacks by default.
|
1516
|
+
# information, see [Protect CloudFormation stacks from being deleted][1]
|
1517
|
+
# in the *CloudFormation User Guide*. Termination protection is
|
1518
|
+
# deactivated on stacks by default.
|
1533
1519
|
#
|
1534
1520
|
# For [nested stacks][2], termination protection is set on the root
|
1535
1521
|
# stack and can't be changed directly on the nested stack.
|
@@ -1780,30 +1766,19 @@ module Aws::CloudFormation
|
|
1780
1766
|
#
|
1781
1767
|
# @option params [String] :template_body
|
1782
1768
|
# The structure that contains the template body, with a minimum length
|
1783
|
-
# of 1 byte and a maximum length of 51,200 bytes.
|
1784
|
-
# see [Template Anatomy][1] in the *CloudFormation User Guide*.
|
1769
|
+
# of 1 byte and a maximum length of 51,200 bytes.
|
1785
1770
|
#
|
1786
1771
|
# Conditional: You must specify either the TemplateBody or the
|
1787
1772
|
# TemplateURL parameter, but not both.
|
1788
1773
|
#
|
1789
|
-
#
|
1790
|
-
#
|
1791
|
-
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html
|
1792
|
-
#
|
1793
1774
|
# @option params [String] :template_url
|
1794
1775
|
# The location of the file that contains the template body. The URL must
|
1795
1776
|
# point to a template (maximum size: 460,800 bytes) that's located in
|
1796
|
-
# an Amazon S3 bucket or a Systems Manager document.
|
1797
|
-
# information, see [Template Anatomy][1] in the *CloudFormation User
|
1798
|
-
# Guide*.
|
1777
|
+
# an Amazon S3 bucket or a Systems Manager document.
|
1799
1778
|
#
|
1800
1779
|
# Conditional: You must specify either the TemplateBody or the
|
1801
1780
|
# TemplateURL parameter, but not both.
|
1802
1781
|
#
|
1803
|
-
#
|
1804
|
-
#
|
1805
|
-
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html
|
1806
|
-
#
|
1807
1782
|
# @option params [String] :stack_id
|
1808
1783
|
# The stack ID you are importing into a new stack set. Specify the
|
1809
1784
|
# Amazon Resource Name (ARN) of the stack.
|
@@ -1820,9 +1795,8 @@ module Aws::CloudFormation
|
|
1820
1795
|
#
|
1821
1796
|
# Some stack templates might include resources that can affect
|
1822
1797
|
# permissions in your Amazon Web Services account; for example, by
|
1823
|
-
# creating new
|
1824
|
-
#
|
1825
|
-
# of these capabilities.
|
1798
|
+
# creating new IAM users. For those stack sets, you must explicitly
|
1799
|
+
# acknowledge this by specifying one of these capabilities.
|
1826
1800
|
#
|
1827
1801
|
# The following IAM resources require you to specify either the
|
1828
1802
|
# `CAPABILITY_IAM` or `CAPABILITY_NAMED_IAM` capability.
|
@@ -1853,8 +1827,8 @@ module Aws::CloudFormation
|
|
1853
1827
|
#
|
1854
1828
|
# * [AWS::IAM::UserToGroupAddition][7]
|
1855
1829
|
#
|
1856
|
-
# For more information, see [Acknowledging IAM
|
1857
|
-
# CloudFormation
|
1830
|
+
# For more information, see [Acknowledging IAM resources in
|
1831
|
+
# CloudFormation templates][8].
|
1858
1832
|
#
|
1859
1833
|
# * `CAPABILITY_AUTO_EXPAND`
|
1860
1834
|
#
|
@@ -1876,14 +1850,14 @@ module Aws::CloudFormation
|
|
1876
1850
|
#
|
1877
1851
|
#
|
1878
1852
|
#
|
1879
|
-
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-
|
1880
|
-
# [2]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-
|
1853
|
+
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-accesskey.html
|
1854
|
+
# [2]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-group.html
|
1881
1855
|
# [3]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-instanceprofile.html
|
1882
|
-
# [4]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-
|
1856
|
+
# [4]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-policy.html
|
1883
1857
|
# [5]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-role.html
|
1884
|
-
# [6]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-
|
1885
|
-
# [7]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-
|
1886
|
-
# [8]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html#capabilities
|
1858
|
+
# [6]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-user.html
|
1859
|
+
# [7]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-usertogroupaddition.html
|
1860
|
+
# [8]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html#using-iam-capabilities
|
1887
1861
|
# [9]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-macros.html
|
1888
1862
|
# [10]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/create-reusable-transform-function-snippets-and-add-to-your-template-with-aws-include-transform.html
|
1889
1863
|
# [11]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/transform-aws-serverless.html
|
@@ -2176,6 +2150,13 @@ module Aws::CloudFormation
|
|
2176
2150
|
# deletion starts. Deleted stacks don't show up in the DescribeStacks
|
2177
2151
|
# operation if the deletion has been completed successfully.
|
2178
2152
|
#
|
2153
|
+
# For more information about deleting a stack, see [Delete a stack from
|
2154
|
+
# the CloudFormation console][1] in the *CloudFormation User Guide*.
|
2155
|
+
#
|
2156
|
+
#
|
2157
|
+
#
|
2158
|
+
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-console-delete-stack.html
|
2159
|
+
#
|
2179
2160
|
# @option params [required, String] :stack_name
|
2180
2161
|
# The name or the unique stack ID that's associated with the stack.
|
2181
2162
|
#
|
@@ -2189,10 +2170,9 @@ module Aws::CloudFormation
|
|
2189
2170
|
# as a non-empty S3 bucket, but you want to delete the stack.
|
2190
2171
|
#
|
2191
2172
|
# @option params [String] :role_arn
|
2192
|
-
# The Amazon Resource Name (ARN) of an
|
2193
|
-
#
|
2194
|
-
#
|
2195
|
-
# behalf.
|
2173
|
+
# The Amazon Resource Name (ARN) of an IAM role that CloudFormation
|
2174
|
+
# assumes to delete the stack. CloudFormation uses the role's
|
2175
|
+
# credentials to make calls on your behalf.
|
2196
2176
|
#
|
2197
2177
|
# If you don't specify a value, CloudFormation uses the role that was
|
2198
2178
|
# previously associated with the stack. If no role is available,
|
@@ -2285,7 +2265,7 @@ module Aws::CloudFormation
|
|
2285
2265
|
#
|
2286
2266
|
#
|
2287
2267
|
#
|
2288
|
-
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/
|
2268
|
+
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/what-is-cfnstacksets.html#stackset-ops-options
|
2289
2269
|
#
|
2290
2270
|
# @option params [String] :operation_id
|
2291
2271
|
# The unique identifier for this stack set operation.
|
@@ -2483,8 +2463,8 @@ module Aws::CloudFormation
|
|
2483
2463
|
|
2484
2464
|
# Retrieves your account's CloudFormation limits, such as the maximum
|
2485
2465
|
# number of stacks that you can create in your account. For more
|
2486
|
-
# information about account limits, see [CloudFormation
|
2487
|
-
# the *CloudFormation User Guide*.
|
2466
|
+
# information about account limits, see [Understand CloudFormation
|
2467
|
+
# quotas][1] in the *CloudFormation User Guide*.
|
2488
2468
|
#
|
2489
2469
|
#
|
2490
2470
|
#
|
@@ -2525,8 +2505,8 @@ module Aws::CloudFormation
|
|
2525
2505
|
|
2526
2506
|
# Returns the inputs for the change set and a list of changes that
|
2527
2507
|
# CloudFormation will make if you execute the change set. For more
|
2528
|
-
# information, see [
|
2529
|
-
# *CloudFormation User Guide*.
|
2508
|
+
# information, see [Update CloudFormation stacks using change sets][1]
|
2509
|
+
# in the *CloudFormation User Guide*.
|
2530
2510
|
#
|
2531
2511
|
#
|
2532
2512
|
#
|
@@ -2881,7 +2861,7 @@ module Aws::CloudFormation
|
|
2881
2861
|
# * [RegisterPublisher][1]
|
2882
2862
|
#
|
2883
2863
|
# * [Publishing extensions to make them available for public use][2] in
|
2884
|
-
# the *CloudFormation CLI User Guide*
|
2864
|
+
# the *CloudFormation Command Line Interface (CLI) User Guide*
|
2885
2865
|
#
|
2886
2866
|
#
|
2887
2867
|
#
|
@@ -3070,8 +3050,9 @@ module Aws::CloudFormation
|
|
3070
3050
|
# configuration, as defined in the stack template and any values
|
3071
3051
|
# specified as template parameters. A stack is considered to have
|
3072
3052
|
# drifted if one or more of its resources have drifted. For more
|
3073
|
-
# information about stack and resource drift, see [
|
3074
|
-
#
|
3053
|
+
# information about stack and resource drift, see [Detect unmanaged
|
3054
|
+
# configuration changes to stacks and resources with drift
|
3055
|
+
# detection][1].
|
3075
3056
|
#
|
3076
3057
|
# Use DetectStackDrift to initiate a stack drift detection operation.
|
3077
3058
|
# `DetectStackDrift` returns a `StackDriftDetectionId` you can use to
|
@@ -3129,8 +3110,8 @@ module Aws::CloudFormation
|
|
3129
3110
|
|
3130
3111
|
# Returns all stack related events for a specified stack in reverse
|
3131
3112
|
# chronological order. For more information about a stack's event
|
3132
|
-
# history, see [CloudFormation stack creation events][1] in
|
3133
|
-
# *CloudFormation User Guide*.
|
3113
|
+
# history, see [Understand CloudFormation stack creation events][1] in
|
3114
|
+
# the *CloudFormation User Guide*.
|
3134
3115
|
#
|
3135
3116
|
# <note markdown="1"> You can list events for stacks that have failed to create or have been
|
3136
3117
|
# deleted by specifying the unique stack identifier (stack ID).
|
@@ -3350,7 +3331,7 @@ module Aws::CloudFormation
|
|
3350
3331
|
# haven't yet been checked for drift aren't included. Resources that
|
3351
3332
|
# don't currently support drift detection aren't checked, and so not
|
3352
3333
|
# included. For a list of resources that support drift detection, see
|
3353
|
-
# [
|
3334
|
+
# [Resource type support for imports and drift detection][1].
|
3354
3335
|
#
|
3355
3336
|
# Use DetectStackResourceDrift to detect drift on individual resources,
|
3356
3337
|
# or DetectStackDrift to detect drift on all supported resources for a
|
@@ -3358,7 +3339,7 @@ module Aws::CloudFormation
|
|
3358
3339
|
#
|
3359
3340
|
#
|
3360
3341
|
#
|
3361
|
-
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/
|
3342
|
+
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/resource-import-supported-resources.html
|
3362
3343
|
#
|
3363
3344
|
# @option params [required, String] :stack_name
|
3364
3345
|
# The name of the stack for which you want drift information.
|
@@ -3453,8 +3434,8 @@ module Aws::CloudFormation
|
|
3453
3434
|
# You must specify either `StackName` or `PhysicalResourceId`, but not
|
3454
3435
|
# both. In addition, you can specify `LogicalResourceId` to filter the
|
3455
3436
|
# returned result. For more information about resources, the
|
3456
|
-
# `LogicalResourceId` and `PhysicalResourceId`,
|
3457
|
-
#
|
3437
|
+
# `LogicalResourceId` and `PhysicalResourceId`, see the [CloudFormation
|
3438
|
+
# User Guide][1].
|
3458
3439
|
#
|
3459
3440
|
# <note markdown="1"> A `ValidationError` is returned if you specify both `StackName` and
|
3460
3441
|
# `PhysicalResourceId` in the same request.
|
@@ -3710,8 +3691,8 @@ module Aws::CloudFormation
|
|
3710
3691
|
|
3711
3692
|
# Returns the description for the specified stack; if no stack name was
|
3712
3693
|
# specified, then it returns the description for all the stacks created.
|
3713
|
-
# For more information about a stack's event history, see
|
3714
|
-
#
|
3694
|
+
# For more information about a stack's event history, see [Understand
|
3695
|
+
# CloudFormation stack creation events][1] in the *CloudFormation User
|
3715
3696
|
# Guide*.
|
3716
3697
|
#
|
3717
3698
|
# <note markdown="1"> If the stack doesn't exist, a `ValidationError` is returned.
|
@@ -4019,15 +4000,16 @@ module Aws::CloudFormation
|
|
4019
4000
|
# template configuration. Only resource properties explicitly defined in
|
4020
4001
|
# the stack template are checked for drift. A stack is considered to
|
4021
4002
|
# have drifted if one or more of its resources differ from their
|
4022
|
-
# expected template configurations. For more information, see [
|
4023
|
-
#
|
4003
|
+
# expected template configurations. For more information, see [Detect
|
4004
|
+
# unmanaged configuration changes to stacks and resources with drift
|
4005
|
+
# detection][1].
|
4024
4006
|
#
|
4025
4007
|
# Use `DetectStackDrift` to detect drift on all supported resources for
|
4026
4008
|
# a given stack, or DetectStackResourceDrift to detect drift on
|
4027
4009
|
# individual resources.
|
4028
4010
|
#
|
4029
4011
|
# For a list of stack resources that currently support drift detection,
|
4030
|
-
# see [
|
4012
|
+
# see [Resource type support for imports and drift detection][2].
|
4031
4013
|
#
|
4032
4014
|
# `DetectStackDrift` can take up to several minutes, depending on the
|
4033
4015
|
# number of resources contained within the stack. Use
|
@@ -4043,7 +4025,7 @@ module Aws::CloudFormation
|
|
4043
4025
|
#
|
4044
4026
|
#
|
4045
4027
|
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-stack-drift.html
|
4046
|
-
# [2]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/
|
4028
|
+
# [2]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/resource-import-supported-resources.html
|
4047
4029
|
#
|
4048
4030
|
# @option params [required, String] :stack_name
|
4049
4031
|
# The name of the stack for which you want to detect drift.
|
@@ -4082,8 +4064,8 @@ module Aws::CloudFormation
|
|
4082
4064
|
# resources in which CloudFormation detects drift. Only resource
|
4083
4065
|
# properties explicitly defined in the stack template are checked for
|
4084
4066
|
# drift. For more information about stack and resource drift, see
|
4085
|
-
# [
|
4086
|
-
#
|
4067
|
+
# [Detect unmanaged configuration changes to stacks and resources with
|
4068
|
+
# drift detection][1].
|
4087
4069
|
#
|
4088
4070
|
# Use `DetectStackResourceDrift` to detect drift on individual
|
4089
4071
|
# resources, or DetectStackDrift to detect drift on all resources in a
|
@@ -4091,12 +4073,12 @@ module Aws::CloudFormation
|
|
4091
4073
|
#
|
4092
4074
|
# Resources that don't currently support drift detection can't be
|
4093
4075
|
# checked. For a list of resources that support drift detection, see
|
4094
|
-
# [
|
4076
|
+
# [Resource type support for imports and drift detection][2].
|
4095
4077
|
#
|
4096
4078
|
#
|
4097
4079
|
#
|
4098
4080
|
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-stack-drift.html
|
4099
|
-
# [2]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/
|
4081
|
+
# [2]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/resource-import-supported-resources.html
|
4100
4082
|
#
|
4101
4083
|
# @option params [required, String] :stack_name
|
4102
4084
|
# The name of the stack to which the resource belongs.
|
@@ -4201,7 +4183,7 @@ module Aws::CloudFormation
|
|
4201
4183
|
#
|
4202
4184
|
#
|
4203
4185
|
#
|
4204
|
-
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/
|
4186
|
+
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/what-is-cfnstacksets.html#stackset-ops-options
|
4205
4187
|
#
|
4206
4188
|
# @option params [String] :operation_id
|
4207
4189
|
# *The ID of the stack set operation.*
|
@@ -4271,30 +4253,20 @@ module Aws::CloudFormation
|
|
4271
4253
|
#
|
4272
4254
|
# @option params [String] :template_body
|
4273
4255
|
# Structure containing the template body with a minimum length of 1 byte
|
4274
|
-
# and a maximum length of 51,200 bytes.
|
4275
|
-
# [Template Anatomy][1] in the *CloudFormation User Guide*.)
|
4256
|
+
# and a maximum length of 51,200 bytes.
|
4276
4257
|
#
|
4277
4258
|
# Conditional: You must pass `TemplateBody` or `TemplateURL`. If both
|
4278
4259
|
# are passed, only `TemplateBody` is used.
|
4279
4260
|
#
|
4280
|
-
#
|
4281
|
-
#
|
4282
|
-
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html
|
4283
|
-
#
|
4284
4261
|
# @option params [String] :template_url
|
4285
4262
|
# Location of file containing the template body. The URL must point to a
|
4286
4263
|
# template that's located in an Amazon S3 bucket or a Systems Manager
|
4287
|
-
# document.
|
4288
|
-
#
|
4289
|
-
# start with `https://`.
|
4264
|
+
# document. The location for an Amazon S3 bucket must start with
|
4265
|
+
# `https://`.
|
4290
4266
|
#
|
4291
4267
|
# Conditional: You must pass `TemplateURL` or `TemplateBody`. If both
|
4292
4268
|
# are passed, only `TemplateBody` is used.
|
4293
4269
|
#
|
4294
|
-
#
|
4295
|
-
#
|
4296
|
-
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html
|
4297
|
-
#
|
4298
4270
|
# @option params [Array<Types::Parameter>] :parameters
|
4299
4271
|
# A list of `Parameter` structures that specify input parameters.
|
4300
4272
|
#
|
@@ -4597,32 +4569,20 @@ module Aws::CloudFormation
|
|
4597
4569
|
#
|
4598
4570
|
# @option params [String] :template_body
|
4599
4571
|
# Structure containing the template body with a minimum length of 1 byte
|
4600
|
-
# and a maximum length of 51,200 bytes.
|
4601
|
-
# templates, see [Template anatomy][1] in the *CloudFormation User
|
4602
|
-
# Guide*.
|
4572
|
+
# and a maximum length of 51,200 bytes.
|
4603
4573
|
#
|
4604
4574
|
# Conditional: You must specify only one of the following parameters:
|
4605
4575
|
# `StackName`, `StackSetName`, `TemplateBody`, or `TemplateURL`.
|
4606
4576
|
#
|
4607
|
-
#
|
4608
|
-
#
|
4609
|
-
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html
|
4610
|
-
#
|
4611
4577
|
# @option params [String] :template_url
|
4612
4578
|
# Location of file containing the template body. The URL must point to a
|
4613
4579
|
# template (max size: 460,800 bytes) that's located in an Amazon S3
|
4614
|
-
# bucket or a Systems Manager document.
|
4615
|
-
#
|
4616
|
-
# Guide*. The location for an Amazon S3 bucket must start with
|
4617
|
-
# `https://`.
|
4580
|
+
# bucket or a Systems Manager document. The location for an Amazon S3
|
4581
|
+
# bucket must start with `https://`.
|
4618
4582
|
#
|
4619
4583
|
# Conditional: You must specify only one of the following parameters:
|
4620
4584
|
# `StackName`, `StackSetName`, `TemplateBody`, or `TemplateURL`.
|
4621
4585
|
#
|
4622
|
-
#
|
4623
|
-
#
|
4624
|
-
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html
|
4625
|
-
#
|
4626
4586
|
# @option params [String] :stack_name
|
4627
4587
|
# The name or the stack ID that's associated with the stack, which
|
4628
4588
|
# aren't always interchangeable. For running stacks, you can specify
|
@@ -4762,7 +4722,7 @@ module Aws::CloudFormation
|
|
4762
4722
|
#
|
4763
4723
|
#
|
4764
4724
|
#
|
4765
|
-
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/
|
4725
|
+
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/what-is-cfnstacksets.html#stackset-ops-options
|
4766
4726
|
#
|
4767
4727
|
# @option params [String] :operation_id
|
4768
4728
|
# A unique, user defined, identifier for the stack set operation.
|
@@ -4873,8 +4833,8 @@ module Aws::CloudFormation
|
|
4873
4833
|
# values that you can import into other stacks. To import values, use
|
4874
4834
|
# the [ Fn::ImportValue][1] function.
|
4875
4835
|
#
|
4876
|
-
# For more information, see [
|
4877
|
-
#
|
4836
|
+
# For more information, see [Get exported outputs from a deployed
|
4837
|
+
# CloudFormation stack][2].
|
4878
4838
|
#
|
4879
4839
|
#
|
4880
4840
|
#
|
@@ -6362,7 +6322,8 @@ module Aws::CloudFormation
|
|
6362
6322
|
# public extension in this Region. Public extensions are available for
|
6363
6323
|
# use by all CloudFormation users. For more information about publishing
|
6364
6324
|
# extensions, see [Publishing extensions to make them available for
|
6365
|
-
# public use][1] in the *CloudFormation
|
6325
|
+
# public use][1] in the *CloudFormation Command Line Interface (CLI)
|
6326
|
+
# User Guide*.
|
6366
6327
|
#
|
6367
6328
|
# To publish an extension, you must be registered as a publisher with
|
6368
6329
|
# CloudFormation. For more information, see [RegisterPublisher][2].
|
@@ -6521,8 +6482,9 @@ module Aws::CloudFormation
|
|
6521
6482
|
# all Amazon Web Services Regions.
|
6522
6483
|
#
|
6523
6484
|
# For information about requirements for registering as a public
|
6524
|
-
# extension publisher, see [Registering your account to
|
6525
|
-
# CloudFormation extensions][1] in the *CloudFormation
|
6485
|
+
# extension publisher, see [Prerequisite: Registering your account to
|
6486
|
+
# publish CloudFormation extensions][1] in the *CloudFormation Command
|
6487
|
+
# Line Interface (CLI) User Guide*.
|
6526
6488
|
#
|
6527
6489
|
#
|
6528
6490
|
#
|
@@ -6547,8 +6509,9 @@ module Aws::CloudFormation
|
|
6547
6509
|
# verification, the Amazon Resource Name (ARN) for your connection to
|
6548
6510
|
# that account.
|
6549
6511
|
#
|
6550
|
-
# For more information, see [Registering your account to
|
6551
|
-
# CloudFormation extensions][1] in the *CloudFormation
|
6512
|
+
# For more information, see [Prerequisite: Registering your account to
|
6513
|
+
# publish CloudFormation extensions][1] in the *CloudFormation Command
|
6514
|
+
# Line Interface (CLI) User Guide*.
|
6552
6515
|
#
|
6553
6516
|
#
|
6554
6517
|
#
|
@@ -6590,8 +6553,9 @@ module Aws::CloudFormation
|
|
6590
6553
|
# * Making the extension available for use in your account.
|
6591
6554
|
#
|
6592
6555
|
# For more information about how to develop extensions and ready them
|
6593
|
-
# for registration, see [Creating
|
6594
|
-
#
|
6556
|
+
# for registration, see [Creating resource types using the
|
6557
|
+
# CloudFormation CLI][1] in the *CloudFormation Command Line Interface
|
6558
|
+
# (CLI) User Guide*.
|
6595
6559
|
#
|
6596
6560
|
# You can have a maximum of 50 resource extension versions registered at
|
6597
6561
|
# a time. This maximum is per account and per Region. Use
|
@@ -6604,16 +6568,16 @@ module Aws::CloudFormation
|
|
6604
6568
|
#
|
6605
6569
|
# Once you have registered a private extension in your account and
|
6606
6570
|
# Region, use [SetTypeConfiguration][3] to specify configuration
|
6607
|
-
# properties for the extension. For more information, see [
|
6608
|
-
# extensions
|
6609
|
-
# Guide*.
|
6571
|
+
# properties for the extension. For more information, see [Edit
|
6572
|
+
# configuration data for extensions in your account][4] in the
|
6573
|
+
# *CloudFormation User Guide*.
|
6610
6574
|
#
|
6611
6575
|
#
|
6612
6576
|
#
|
6613
6577
|
# [1]: https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/resource-types.html
|
6614
6578
|
# [2]: https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_DeregisterType.html
|
6615
6579
|
# [3]: https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_SetTypeConfiguration.html
|
6616
|
-
# [4]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/registry-
|
6580
|
+
# [4]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/registry-set-configuration.html
|
6617
6581
|
#
|
6618
6582
|
# @option params [String] :type
|
6619
6583
|
# The kind of extension.
|
@@ -6623,11 +6587,11 @@ module Aws::CloudFormation
|
|
6623
6587
|
#
|
6624
6588
|
# We suggest that extension names adhere to the following patterns:
|
6625
6589
|
#
|
6626
|
-
# * For resource types,
|
6590
|
+
# * For resource types, `company_or_organization::service::type`.
|
6627
6591
|
#
|
6628
|
-
# * For modules,
|
6592
|
+
# * For modules, `company_or_organization::service::type::MODULE`.
|
6629
6593
|
#
|
6630
|
-
# * For hooks,
|
6594
|
+
# * For hooks, `MyCompany::Testing::MyTestHook`.
|
6631
6595
|
#
|
6632
6596
|
# <note markdown="1"> The following organization namespaces are reserved and can't be used
|
6633
6597
|
# in your extension names:
|
@@ -6652,7 +6616,7 @@ module Aws::CloudFormation
|
|
6652
6616
|
#
|
6653
6617
|
# For information about generating a schema handler package for the
|
6654
6618
|
# extension you want to register, see [submit][1] in the *CloudFormation
|
6655
|
-
# CLI User Guide*.
|
6619
|
+
# Command Line Interface (CLI) User Guide*.
|
6656
6620
|
#
|
6657
6621
|
# <note markdown="1"> The user registering the extension must be able to access the package
|
6658
6622
|
# in the S3 bucket. That's, the user needs to have [GetObject][2]
|
@@ -6759,8 +6723,8 @@ module Aws::CloudFormation
|
|
6759
6723
|
# The name that's associated with the stack.
|
6760
6724
|
#
|
6761
6725
|
# @option params [String] :role_arn
|
6762
|
-
# The Amazon Resource Name (ARN) of an
|
6763
|
-
#
|
6726
|
+
# The Amazon Resource Name (ARN) of an IAM role that CloudFormation
|
6727
|
+
# assumes to rollback the stack.
|
6764
6728
|
#
|
6765
6729
|
# @option params [String] :client_request_token
|
6766
6730
|
# A unique identifier for this `RollbackStack` request.
|
@@ -6804,9 +6768,9 @@ module Aws::CloudFormation
|
|
6804
6768
|
# The name or unique stack ID that you want to associate a policy with.
|
6805
6769
|
#
|
6806
6770
|
# @option params [String] :stack_policy_body
|
6807
|
-
# Structure containing the stack policy body. For more information,
|
6808
|
-
#
|
6809
|
-
#
|
6771
|
+
# Structure containing the stack policy body. For more information, see
|
6772
|
+
# [Prevent updates to stack resources][1] in the *CloudFormation User
|
6773
|
+
# Guide*. You can specify either the `StackPolicyBody` or the
|
6810
6774
|
# `StackPolicyURL` parameter, but not both.
|
6811
6775
|
#
|
6812
6776
|
#
|
@@ -6844,19 +6808,20 @@ module Aws::CloudFormation
|
|
6844
6808
|
#
|
6845
6809
|
# To view the current configuration data for an extension, refer to the
|
6846
6810
|
# `ConfigurationSchema` element of [DescribeType][1]. For more
|
6847
|
-
# information, see [
|
6848
|
-
# the *CloudFormation User Guide*.
|
6811
|
+
# information, see [Edit configuration data for extensions in your
|
6812
|
+
# account][2] in the *CloudFormation User Guide*.
|
6849
6813
|
#
|
6850
6814
|
# It's strongly recommended that you use dynamic references to restrict
|
6851
6815
|
# sensitive configuration definitions, such as third-party credentials.
|
6852
|
-
# For more details on dynamic references, see [
|
6853
|
-
#
|
6816
|
+
# For more details on dynamic references, see [Specify values stored in
|
6817
|
+
# other services using dynamic references][3] in the *CloudFormation
|
6818
|
+
# User Guide*.
|
6854
6819
|
#
|
6855
6820
|
#
|
6856
6821
|
#
|
6857
6822
|
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_DescribeType.html
|
6858
|
-
# [2]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/registry-
|
6859
|
-
# [3]: https://docs.aws.amazon.com/
|
6823
|
+
# [2]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/registry-set-configuration.html
|
6824
|
+
# [3]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/dynamic-references.html
|
6860
6825
|
#
|
6861
6826
|
# @option params [String] :type_arn
|
6862
6827
|
# The Amazon Resource Name (ARN) for the extension, in this account and
|
@@ -6881,9 +6846,9 @@ module Aws::CloudFormation
|
|
6881
6846
|
#
|
6882
6847
|
# The configuration data must be formatted as JSON, and validate against
|
6883
6848
|
# the schema returned in the `ConfigurationSchema` response element of
|
6884
|
-
# [DescribeType][1]. For more information, see [Defining
|
6885
|
-
# configuration
|
6886
|
-
# User Guide*.
|
6849
|
+
# [DescribeType][1]. For more information, see [Defining the
|
6850
|
+
# account-level configuration of an extension][2] in the *CloudFormation
|
6851
|
+
# Command Line Interface (CLI) User Guide*.
|
6887
6852
|
#
|
6888
6853
|
#
|
6889
6854
|
#
|
@@ -7132,8 +7097,9 @@ module Aws::CloudFormation
|
|
7132
7097
|
# * For modules, this includes determining if the module's model meets
|
7133
7098
|
# all necessary requirements.
|
7134
7099
|
#
|
7135
|
-
# For more information, see [Testing your public extension
|
7136
|
-
# publishing][1] in the *CloudFormation
|
7100
|
+
# For more information, see [Testing your public extension before
|
7101
|
+
# publishing][1] in the *CloudFormation Command Line Interface (CLI)
|
7102
|
+
# User Guide*.
|
7137
7103
|
#
|
7138
7104
|
# If you don't specify a version, CloudFormation uses the default
|
7139
7105
|
# version of the extension in your account and Region for testing.
|
@@ -7149,8 +7115,8 @@ module Aws::CloudFormation
|
|
7149
7115
|
#
|
7150
7116
|
# An extension must have a test status of `PASSED` before it can be
|
7151
7117
|
# published. For more information, see [Publishing extensions to make
|
7152
|
-
# them available for public use][4] in the *CloudFormation
|
7153
|
-
# Guide*.
|
7118
|
+
# them available for public use][4] in the *CloudFormation Command Line
|
7119
|
+
# Interface (CLI) User Guide*.
|
7154
7120
|
#
|
7155
7121
|
#
|
7156
7122
|
#
|
@@ -7200,8 +7166,7 @@ module Aws::CloudFormation
|
|
7200
7166
|
# * `PutObject`
|
7201
7167
|
#
|
7202
7168
|
# For more information, see [Actions, Resources, and Condition Keys for
|
7203
|
-
# Amazon S3][1] in the *
|
7204
|
-
# Management User Guide*.
|
7169
|
+
# Amazon S3][1] in the *Identity and Access Management User Guide*.
|
7205
7170
|
#
|
7206
7171
|
#
|
7207
7172
|
#
|
@@ -7369,45 +7334,36 @@ module Aws::CloudFormation
|
|
7369
7334
|
# To get a copy of the template for an existing stack, you can use the
|
7370
7335
|
# GetTemplate action.
|
7371
7336
|
#
|
7372
|
-
# For more information about
|
7373
|
-
#
|
7374
|
-
#
|
7337
|
+
# For more information about updating a stack and monitoring the
|
7338
|
+
# progress of the update, see [Managing Amazon Web Services resources as
|
7339
|
+
# a single unit with CloudFormation stacks][1] in the *CloudFormation
|
7340
|
+
# User Guide*.
|
7375
7341
|
#
|
7376
7342
|
#
|
7377
7343
|
#
|
7378
|
-
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/
|
7344
|
+
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacks.html
|
7379
7345
|
#
|
7380
7346
|
# @option params [required, String] :stack_name
|
7381
7347
|
# The name or unique stack ID of the stack to update.
|
7382
7348
|
#
|
7383
7349
|
# @option params [String] :template_body
|
7384
7350
|
# Structure containing the template body with a minimum length of 1 byte
|
7385
|
-
# and a maximum length of 51,200 bytes.
|
7386
|
-
# [Template Anatomy][1] in the *CloudFormation User Guide*.)
|
7351
|
+
# and a maximum length of 51,200 bytes.
|
7387
7352
|
#
|
7388
7353
|
# Conditional: You must specify only one of the following parameters:
|
7389
7354
|
# `TemplateBody`, `TemplateURL`, or set the `UsePreviousTemplate` to
|
7390
7355
|
# `true`.
|
7391
7356
|
#
|
7392
|
-
#
|
7393
|
-
#
|
7394
|
-
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html
|
7395
|
-
#
|
7396
7357
|
# @option params [String] :template_url
|
7397
7358
|
# Location of file containing the template body. The URL must point to a
|
7398
7359
|
# template that's located in an Amazon S3 bucket or a Systems Manager
|
7399
|
-
# document.
|
7400
|
-
#
|
7401
|
-
# start with `https://`.
|
7360
|
+
# document. The location for an Amazon S3 bucket must start with
|
7361
|
+
# `https://`.
|
7402
7362
|
#
|
7403
7363
|
# Conditional: You must specify only one of the following parameters:
|
7404
7364
|
# `TemplateBody`, `TemplateURL`, or set the `UsePreviousTemplate` to
|
7405
7365
|
# `true`.
|
7406
7366
|
#
|
7407
|
-
#
|
7408
|
-
#
|
7409
|
-
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html
|
7410
|
-
#
|
7411
7367
|
# @option params [Boolean] :use_previous_template
|
7412
7368
|
# Reuse the existing template that is associated with the stack that you
|
7413
7369
|
# are updating.
|
@@ -7455,10 +7411,9 @@ module Aws::CloudFormation
|
|
7455
7411
|
# * `CAPABILITY_IAM` and `CAPABILITY_NAMED_IAM`
|
7456
7412
|
#
|
7457
7413
|
# Some stack templates might include resources that can affect
|
7458
|
-
# permissions in your Amazon Web Services account
|
7459
|
-
# creating new
|
7460
|
-
#
|
7461
|
-
# these capabilities.
|
7414
|
+
# permissions in your Amazon Web Services account, for example, by
|
7415
|
+
# creating new IAM users. For those stacks, you must explicitly
|
7416
|
+
# acknowledge this by specifying one of these capabilities.
|
7462
7417
|
#
|
7463
7418
|
# The following IAM resources require you to specify either the
|
7464
7419
|
# `CAPABILITY_IAM` or `CAPABILITY_NAMED_IAM` capability.
|
@@ -7489,8 +7444,8 @@ module Aws::CloudFormation
|
|
7489
7444
|
#
|
7490
7445
|
# * [AWS::IAM::UserToGroupAddition][7]
|
7491
7446
|
#
|
7492
|
-
# For more information, see [Acknowledging IAM
|
7493
|
-
# CloudFormation
|
7447
|
+
# For more information, see [Acknowledging IAM resources in
|
7448
|
+
# CloudFormation templates][8].
|
7494
7449
|
#
|
7495
7450
|
# * `CAPABILITY_AUTO_EXPAND`
|
7496
7451
|
#
|
@@ -7519,8 +7474,8 @@ module Aws::CloudFormation
|
|
7519
7474
|
# can update the function operation without CloudFormation being
|
7520
7475
|
# notified.
|
7521
7476
|
#
|
7522
|
-
# For more information, see [
|
7523
|
-
#
|
7477
|
+
# For more information, see [Perform custom processing on
|
7478
|
+
# CloudFormation templates with template macros][11].
|
7524
7479
|
#
|
7525
7480
|
# <note markdown="1"> Only one of the `Capabilities` and `ResourceType` parameters can be
|
7526
7481
|
# specified.
|
@@ -7529,14 +7484,14 @@ module Aws::CloudFormation
|
|
7529
7484
|
#
|
7530
7485
|
#
|
7531
7486
|
#
|
7532
|
-
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-
|
7533
|
-
# [2]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-
|
7487
|
+
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-accesskey.html
|
7488
|
+
# [2]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-group.html
|
7534
7489
|
# [3]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-instanceprofile.html
|
7535
|
-
# [4]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-
|
7490
|
+
# [4]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-policy.html
|
7536
7491
|
# [5]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-role.html
|
7537
|
-
# [6]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-
|
7538
|
-
# [7]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-
|
7539
|
-
# [8]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html#capabilities
|
7492
|
+
# [6]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-user.html
|
7493
|
+
# [7]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-usertogroupaddition.html
|
7494
|
+
# [8]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html#using-iam-capabilities
|
7540
7495
|
# [9]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/create-reusable-transform-function-snippets-and-add-to-your-template-with-aws-include-transform.html
|
7541
7496
|
# [10]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/transform-aws-serverless.html
|
7542
7497
|
# [11]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-macros.html
|
@@ -7548,10 +7503,10 @@ module Aws::CloudFormation
|
|
7548
7503
|
#
|
7549
7504
|
# If the list of resource types doesn't include a resource that you're
|
7550
7505
|
# updating, the stack update fails. By default, CloudFormation grants
|
7551
|
-
# permissions to all resource types.
|
7552
|
-
#
|
7553
|
-
#
|
7554
|
-
#
|
7506
|
+
# permissions to all resource types. IAM uses this parameter for
|
7507
|
+
# CloudFormation-specific condition keys in IAM policies. For more
|
7508
|
+
# information, see [Control access with Identity and Access
|
7509
|
+
# Management][1].
|
7555
7510
|
#
|
7556
7511
|
# <note markdown="1"> Only one of the `Capabilities` and `ResourceType` parameters can be
|
7557
7512
|
# specified.
|
@@ -7563,13 +7518,13 @@ module Aws::CloudFormation
|
|
7563
7518
|
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html
|
7564
7519
|
#
|
7565
7520
|
# @option params [String] :role_arn
|
7566
|
-
# The Amazon Resource Name (ARN) of an
|
7567
|
-
#
|
7568
|
-
#
|
7569
|
-
#
|
7570
|
-
#
|
7571
|
-
#
|
7572
|
-
#
|
7521
|
+
# The Amazon Resource Name (ARN) of an IAM role that CloudFormation
|
7522
|
+
# assumes to update the stack. CloudFormation uses the role's
|
7523
|
+
# credentials to make calls on your behalf. CloudFormation always uses
|
7524
|
+
# this role for all future operations on the stack. Provided that users
|
7525
|
+
# have permission to operate on the stack, CloudFormation uses this role
|
7526
|
+
# even if the users don't have permission to pass it. Ensure that the
|
7527
|
+
# role grants least privilege.
|
7573
7528
|
#
|
7574
7529
|
# If you don't specify a value, CloudFormation uses the role that was
|
7575
7530
|
# previously associated with the stack. If no role is available,
|
@@ -7912,30 +7867,19 @@ module Aws::CloudFormation
|
|
7912
7867
|
#
|
7913
7868
|
# @option params [String] :template_body
|
7914
7869
|
# The structure that contains the template body, with a minimum length
|
7915
|
-
# of 1 byte and a maximum length of 51,200 bytes.
|
7916
|
-
# see [Template Anatomy][1] in the *CloudFormation User Guide*.
|
7870
|
+
# of 1 byte and a maximum length of 51,200 bytes.
|
7917
7871
|
#
|
7918
7872
|
# Conditional: You must specify only one of the following parameters:
|
7919
7873
|
# `TemplateBody` or `TemplateURL`—or set `UsePreviousTemplate` to true.
|
7920
7874
|
#
|
7921
|
-
#
|
7922
|
-
#
|
7923
|
-
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html
|
7924
|
-
#
|
7925
7875
|
# @option params [String] :template_url
|
7926
7876
|
# The location of the file that contains the template body. The URL must
|
7927
7877
|
# point to a template (maximum size: 460,800 bytes) that is located in
|
7928
|
-
# an Amazon S3 bucket or a Systems Manager document.
|
7929
|
-
# information, see [Template Anatomy][1] in the *CloudFormation User
|
7930
|
-
# Guide*.
|
7878
|
+
# an Amazon S3 bucket or a Systems Manager document.
|
7931
7879
|
#
|
7932
7880
|
# Conditional: You must specify only one of the following parameters:
|
7933
7881
|
# `TemplateBody` or `TemplateURL`—or set `UsePreviousTemplate` to true.
|
7934
7882
|
#
|
7935
|
-
#
|
7936
|
-
#
|
7937
|
-
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html
|
7938
|
-
#
|
7939
7883
|
# @option params [Boolean] :use_previous_template
|
7940
7884
|
# Use the existing template that's associated with the stack set that
|
7941
7885
|
# you're updating.
|
@@ -7954,10 +7898,9 @@ module Aws::CloudFormation
|
|
7954
7898
|
# * `CAPABILITY_IAM` and `CAPABILITY_NAMED_IAM`
|
7955
7899
|
#
|
7956
7900
|
# Some stack templates might include resources that can affect
|
7957
|
-
# permissions in your Amazon Web Services account
|
7958
|
-
# creating new
|
7959
|
-
#
|
7960
|
-
# of these capabilities.
|
7901
|
+
# permissions in your Amazon Web Services account, for example, by
|
7902
|
+
# creating new IAM users. For those stacks sets, you must explicitly
|
7903
|
+
# acknowledge this by specifying one of these capabilities.
|
7961
7904
|
#
|
7962
7905
|
# The following IAM resources require you to specify either the
|
7963
7906
|
# `CAPABILITY_IAM` or `CAPABILITY_NAMED_IAM` capability.
|
@@ -7988,8 +7931,8 @@ module Aws::CloudFormation
|
|
7988
7931
|
#
|
7989
7932
|
# * [AWS::IAM::UserToGroupAddition][7]
|
7990
7933
|
#
|
7991
|
-
# For more information, see [Acknowledging IAM
|
7992
|
-
# CloudFormation
|
7934
|
+
# For more information, see [Acknowledging IAM resources in
|
7935
|
+
# CloudFormation templates][8].
|
7993
7936
|
#
|
7994
7937
|
# * `CAPABILITY_AUTO_EXPAND`
|
7995
7938
|
#
|
@@ -8011,14 +7954,14 @@ module Aws::CloudFormation
|
|
8011
7954
|
#
|
8012
7955
|
#
|
8013
7956
|
#
|
8014
|
-
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-
|
8015
|
-
# [2]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-
|
7957
|
+
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-accesskey.html
|
7958
|
+
# [2]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-group.html
|
8016
7959
|
# [3]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-instanceprofile.html
|
8017
|
-
# [4]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-
|
7960
|
+
# [4]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-policy.html
|
8018
7961
|
# [5]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-role.html
|
8019
|
-
# [6]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-
|
8020
|
-
# [7]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-
|
8021
|
-
# [8]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html#capabilities
|
7962
|
+
# [6]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-user.html
|
7963
|
+
# [7]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-usertogroupaddition.html
|
7964
|
+
# [8]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html#using-iam-capabilities
|
8022
7965
|
# [9]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-macros.html
|
8023
7966
|
# [10]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/create-reusable-transform-function-snippets-and-add-to-your-template-with-aws-include-transform.html
|
8024
7967
|
# [11]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/transform-aws-serverless.html
|
@@ -8290,8 +8233,8 @@ module Aws::CloudFormation
|
|
8290
8233
|
# Updates termination protection for the specified stack. If a user
|
8291
8234
|
# attempts to delete a stack with termination protection enabled, the
|
8292
8235
|
# operation fails and the stack remains unchanged. For more information,
|
8293
|
-
# see [
|
8294
|
-
# User Guide*.
|
8236
|
+
# see [Protect a CloudFormation stack from being deleted][1] in the
|
8237
|
+
# *CloudFormation User Guide*.
|
8295
8238
|
#
|
8296
8239
|
# For [nested stacks][2], termination protection is set on the root
|
8297
8240
|
# stack and can't be changed directly on the nested stack.
|
@@ -8339,30 +8282,20 @@ module Aws::CloudFormation
|
|
8339
8282
|
#
|
8340
8283
|
# @option params [String] :template_body
|
8341
8284
|
# Structure containing the template body with a minimum length of 1 byte
|
8342
|
-
# and a maximum length of 51,200 bytes.
|
8343
|
-
# [Template Anatomy][1] in the *CloudFormation User Guide*.
|
8285
|
+
# and a maximum length of 51,200 bytes.
|
8344
8286
|
#
|
8345
8287
|
# Conditional: You must pass `TemplateURL` or `TemplateBody`. If both
|
8346
8288
|
# are passed, only `TemplateBody` is used.
|
8347
8289
|
#
|
8348
|
-
#
|
8349
|
-
#
|
8350
|
-
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html
|
8351
|
-
#
|
8352
8290
|
# @option params [String] :template_url
|
8353
8291
|
# Location of file containing the template body. The URL must point to a
|
8354
8292
|
# template (max size: 460,800 bytes) that is located in an Amazon S3
|
8355
|
-
# bucket or a Systems Manager document.
|
8356
|
-
#
|
8357
|
-
# for an Amazon S3 bucket must start with `https://`.
|
8293
|
+
# bucket or a Systems Manager document. The location for an Amazon S3
|
8294
|
+
# bucket must start with `https://`.
|
8358
8295
|
#
|
8359
8296
|
# Conditional: You must pass `TemplateURL` or `TemplateBody`. If both
|
8360
8297
|
# are passed, only `TemplateBody` is used.
|
8361
8298
|
#
|
8362
|
-
#
|
8363
|
-
#
|
8364
|
-
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html
|
8365
|
-
#
|
8366
8299
|
# @return [Types::ValidateTemplateOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
8367
8300
|
#
|
8368
8301
|
# * {Types::ValidateTemplateOutput#parameters #parameters} => Array<Types::TemplateParameter>
|
@@ -8419,7 +8352,7 @@ module Aws::CloudFormation
|
|
8419
8352
|
tracer: tracer
|
8420
8353
|
)
|
8421
8354
|
context[:gem_name] = 'aws-sdk-cloudformation'
|
8422
|
-
context[:gem_version] = '1.
|
8355
|
+
context[:gem_version] = '1.121.0'
|
8423
8356
|
Seahorse::Client::Request.new(handlers, context)
|
8424
8357
|
end
|
8425
8358
|
|