aws-sdk-cloudformation 1.99.0 → 1.100.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -737,7 +737,8 @@ module Aws::CloudFormation
737
737
  # must point to a template (max size: 460,800 bytes) that's located
738
738
  # in an Amazon S3 bucket or a Systems Manager document. CloudFormation
739
739
  # generates the change set by comparing this template with the stack
740
- # that you specified.
740
+ # that you specified. The location for an Amazon S3 bucket must start
741
+ # with `https://`.
741
742
  #
742
743
  # Conditional: You must specify only `TemplateBody` or `TemplateURL`.
743
744
  # @return [String]
@@ -780,19 +781,19 @@ module Aws::CloudFormation
780
781
  # you review all permissions associated with them and edit their
781
782
  # permissions if necessary.
782
783
  #
783
- # * [ AWS::IAM::AccessKey][1]
784
+ # * [ `AWS::IAM::AccessKey` ][1]
784
785
  #
785
- # * [ AWS::IAM::Group][2]
786
+ # * [ `AWS::IAM::Group` ][2]
786
787
  #
787
- # * [AWS::IAM::InstanceProfile][3]
788
+ # * [ `AWS::IAM::InstanceProfile` ][3]
788
789
  #
789
- # * [ AWS::IAM::Policy][4]
790
+ # * [ `AWS::IAM::Policy` ][4]
790
791
  #
791
- # * [ AWS::IAM::Role][5]
792
+ # * [ `AWS::IAM::Role` ][5]
792
793
  #
793
- # * [ AWS::IAM::User][6]
794
+ # * [ `AWS::IAM::User` ][6]
794
795
  #
795
- # * [AWS::IAM::UserToGroupAddition][7]
796
+ # * [ `AWS::IAM::UserToGroupAddition` ][7]
796
797
  #
797
798
  # For more information, see [Acknowledging IAM resources in
798
799
  # CloudFormation templates][8].
@@ -808,9 +809,9 @@ module Aws::CloudFormation
808
809
  # your stack template contains one or more macros, and you choose to
809
810
  # create a stack directly from the processed template, without first
810
811
  # reviewing the resulting changes in a change set, you must
811
- # acknowledge this capability. This includes the [AWS::Include][9]
812
- # and [AWS::Serverless][10] transforms, which are macros hosted by
813
- # CloudFormation.
812
+ # acknowledge this capability. This includes the [ `AWS::Include`
813
+ # ][9] and [ `AWS::Serverless` ][10] transforms, which are macros
814
+ # hosted by CloudFormation.
814
815
  #
815
816
  # <note markdown="1"> This capacity doesn't apply to creating change sets, and
816
817
  # specifying it when creating change sets has no effect.
@@ -956,8 +957,8 @@ module Aws::CloudFormation
956
957
  # @!attribute [rw] on_stack_failure
957
958
  # Determines what action will be taken if stack creation fails. If
958
959
  # this parameter is specified, the `DisableRollback` parameter to the
959
- # [ExecuteChangeSet][1] API operation must not be specified. This must
960
- # be one of these values:
960
+ # [ `ExecuteChangeSet` ][1] API operation must not be specified. This
961
+ # must be one of these values:
961
962
  #
962
963
  # * `DELETE` - Deletes the change set if the stack creation fails.
963
964
  # This is only valid when the `ChangeSetType` parameter is set to
@@ -966,11 +967,11 @@ module Aws::CloudFormation
966
967
  #
967
968
  # * `DO_NOTHING` - if the stack creation fails, do nothing. This is
968
969
  # equivalent to specifying `true` for the `DisableRollback`
969
- # parameter to the [ExecuteChangeSet][1] API operation.
970
+ # parameter to the [ `ExecuteChangeSet` ][1] API operation.
970
971
  #
971
972
  # * `ROLLBACK` - if the stack creation fails, roll back the stack.
972
973
  # This is equivalent to specifying `false` for the `DisableRollback`
973
- # parameter to the [ExecuteChangeSet][1] API operation.
974
+ # parameter to the [ `ExecuteChangeSet` ][1] API operation.
974
975
  #
975
976
  # For nested stacks, when the `OnStackFailure` parameter is set to
976
977
  # `DELETE` for the change set for the parent stack, any failure in a
@@ -1121,7 +1122,8 @@ module Aws::CloudFormation
1121
1122
  # Location of file containing the template body. The URL must point to
1122
1123
  # a template (max size: 460,800 bytes) that's located in an Amazon S3
1123
1124
  # bucket or a Systems Manager document. For more information, go to
1124
- # the [Template anatomy][1] in the *CloudFormation User Guide*.
1125
+ # the [Template anatomy][1] in the *CloudFormation User Guide*. The
1126
+ # location for an Amazon S3 bucket must start with `https://`.
1125
1127
  #
1126
1128
  # Conditional: You must specify either the `TemplateBody` or the
1127
1129
  # `TemplateURL` parameter, but not both.
@@ -1133,7 +1135,8 @@ module Aws::CloudFormation
1133
1135
  #
1134
1136
  # @!attribute [rw] parameters
1135
1137
  # A list of `Parameter` structures that specify input parameters for
1136
- # the stack. For more information, see the [Parameter][1] data type.
1138
+ # the stack. For more information, see the [ `Parameter` ][1] data
1139
+ # type.
1137
1140
  #
1138
1141
  #
1139
1142
  #
@@ -1195,19 +1198,19 @@ module Aws::CloudFormation
1195
1198
  # you review all permissions associated with them and edit their
1196
1199
  # permissions if necessary.
1197
1200
  #
1198
- # * [ AWS::IAM::AccessKey][1]
1201
+ # * [ `AWS::IAM::AccessKey` AWS::IAM::AccessKey][1]
1199
1202
  #
1200
- # * [ AWS::IAM::Group][2]
1203
+ # * [ `AWS::IAM::Group` ][2]
1201
1204
  #
1202
- # * [AWS::IAM::InstanceProfile][3]
1205
+ # * [ `AWS::IAM::InstanceProfile` ][3]
1203
1206
  #
1204
- # * [ AWS::IAM::Policy][4]
1207
+ # * [ `AWS::IAM::Policy` ][4]
1205
1208
  #
1206
- # * [ AWS::IAM::Role][5]
1209
+ # * [ `AWS::IAM::Role` ][5]
1207
1210
  #
1208
- # * [ AWS::IAM::User][6]
1211
+ # * [ `AWS::IAM::User` ][6]
1209
1212
  #
1210
- # * [AWS::IAM::UserToGroupAddition][7]
1213
+ # * [ `AWS::IAM::UserToGroupAddition` ][7]
1211
1214
  #
1212
1215
  # For more information, see [Acknowledging IAM Resources in
1213
1216
  # CloudFormation Templates][8].
@@ -1223,9 +1226,9 @@ module Aws::CloudFormation
1223
1226
  # your stack template contains one or more macros, and you choose to
1224
1227
  # create a stack directly from the processed template, without first
1225
1228
  # reviewing the resulting changes in a change set, you must
1226
- # acknowledge this capability. This includes the [AWS::Include][9]
1227
- # and [AWS::Serverless][10] transforms, which are macros hosted by
1228
- # CloudFormation.
1229
+ # acknowledge this capability. This includes the [ `AWS::Include`
1230
+ # ][9] and [ `AWS::Serverless` ][10] transforms, which are macros
1231
+ # hosted by CloudFormation.
1229
1232
  #
1230
1233
  # If you want to create a stack from a stack template that contains
1231
1234
  # macros *and* nested stacks, you must create the stack directly
@@ -1329,8 +1332,9 @@ module Aws::CloudFormation
1329
1332
  # @!attribute [rw] stack_policy_url
1330
1333
  # Location of a file containing the stack policy. The URL must point
1331
1334
  # to a policy (maximum size: 16 KB) located in an S3 bucket in the
1332
- # same Region as the stack. You can specify either the
1333
- # `StackPolicyBody` or the `StackPolicyURL` parameter, but not both.
1335
+ # same Region as the stack. The location for an Amazon S3 bucket must
1336
+ # start with `https://`. You can specify either the `StackPolicyBody`
1337
+ # or the `StackPolicyURL` parameter, but not both.
1334
1338
  # @return [String]
1335
1339
  #
1336
1340
  # @!attribute [rw] tags
@@ -1466,8 +1470,8 @@ module Aws::CloudFormation
1466
1470
  # stack instance aren't updated, but retain their overridden value.
1467
1471
  #
1468
1472
  # You can only override the parameter *values* that are specified in
1469
- # the stack set; to add or delete a parameter itself, use
1470
- # [UpdateStackSet][1] to update the stack set template.
1473
+ # the stack set; to add or delete a parameter itself, use [
1474
+ # `UpdateStackSet` ][1] to update the stack set template.
1471
1475
  #
1472
1476
  #
1473
1477
  #
@@ -1644,19 +1648,19 @@ module Aws::CloudFormation
1644
1648
  # you review all permissions associated with them and edit their
1645
1649
  # permissions if necessary.
1646
1650
  #
1647
- # * [ AWS::IAM::AccessKey][1]
1651
+ # * [ `AWS::IAM::AccessKey` ][1]
1648
1652
  #
1649
- # * [ AWS::IAM::Group][2]
1653
+ # * [ `AWS::IAM::Group` ][2]
1650
1654
  #
1651
- # * [AWS::IAM::InstanceProfile][3]
1655
+ # * [ `AWS::IAM::InstanceProfile` ][3]
1652
1656
  #
1653
- # * [ AWS::IAM::Policy][4]
1657
+ # * [ `AWS::IAM::Policy` ][4]
1654
1658
  #
1655
- # * [ AWS::IAM::Role][5]
1659
+ # * [ `AWS::IAM::Role` ][5]
1656
1660
  #
1657
- # * [ AWS::IAM::User][6]
1661
+ # * [ `AWS::IAM::User` ][6]
1658
1662
  #
1659
- # * [AWS::IAM::UserToGroupAddition][7]
1663
+ # * [ `AWS::IAM::UserToGroupAddition` ][7]
1660
1664
  #
1661
1665
  # For more information, see [Acknowledging IAM Resources in
1662
1666
  # CloudFormation Templates][8].
@@ -1672,11 +1676,11 @@ module Aws::CloudFormation
1672
1676
  # Processing on Templates][9].
1673
1677
  #
1674
1678
  # Stack sets with service-managed permissions don't currently
1675
- # support the use of macros in templates. (This includes the
1676
- # [AWS::Include][10] and [AWS::Serverless][11] transforms, which are
1677
- # macros hosted by CloudFormation.) Even if you specify this
1678
- # capability for a stack set with service-managed permissions, if
1679
- # you reference a macro in your template the stack set operation
1679
+ # support the use of macros in templates. (This includes the [
1680
+ # `AWS::Include` ][10] and [ `AWS::Serverless` ][11] transforms,
1681
+ # which are macros hosted by CloudFormation.) Even if you specify
1682
+ # this capability for a stack set with service-managed permissions,
1683
+ # if you reference a macro in your template the stack set operation
1680
1684
  # will fail.
1681
1685
  #
1682
1686
  #
@@ -2412,7 +2416,7 @@ module Aws::CloudFormation
2412
2416
  # @!attribute [rw] parameters
2413
2417
  # A list of `Parameter` structures that describes the input parameters
2414
2418
  # and their values used to create the change set. For more
2415
- # information, see the [Parameter][1] data type.
2419
+ # information, see the [ `Parameter` ][1] data type.
2416
2420
  #
2417
2421
  #
2418
2422
  #
@@ -2491,8 +2495,8 @@ module Aws::CloudFormation
2491
2495
  # @!attribute [rw] on_stack_failure
2492
2496
  # Determines what action will be taken if stack creation fails. When
2493
2497
  # this parameter is specified, the `DisableRollback` parameter to the
2494
- # [ExecuteChangeSet][1] API operation must not be specified. This must
2495
- # be one of these values:
2498
+ # [ `ExecuteChangeSet` ][1] API operation must not be specified. This
2499
+ # must be one of these values:
2496
2500
  #
2497
2501
  # * `DELETE` - Deletes the change set if the stack creation fails.
2498
2502
  # This is only valid when the `ChangeSetType` parameter is set to
@@ -2501,11 +2505,11 @@ module Aws::CloudFormation
2501
2505
  #
2502
2506
  # * `DO_NOTHING` - if the stack creation fails, do nothing. This is
2503
2507
  # equivalent to specifying `true` for the `DisableRollback`
2504
- # parameter to the [ExecuteChangeSet][1] API operation.
2508
+ # parameter to the [ `ExecuteChangeSet` ][1] API operation.
2505
2509
  #
2506
2510
  # * `ROLLBACK` - if the stack creation fails, roll back the stack.
2507
2511
  # This is equivalent to specifying `false` for the `DisableRollback`
2508
- # parameter to the [ExecuteChangeSet][1] API operation.
2512
+ # parameter to the [ `ExecuteChangeSet` ][1] API operation.
2509
2513
  #
2510
2514
  #
2511
2515
  #
@@ -3467,7 +3471,7 @@ module Aws::CloudFormation
3467
3471
  #
3468
3472
  # If the extension is a public third-party type you have activated
3469
3473
  # with a type name alias, CloudFormation returns the type name alias.
3470
- # For more information, see [ActivateType][1].
3474
+ # For more information, see [ `ActivateType` ][1].
3471
3475
  #
3472
3476
  #
3473
3477
  #
@@ -3481,7 +3485,7 @@ module Aws::CloudFormation
3481
3485
  # This applies only to private extensions you have registered in your
3482
3486
  # account. For public extensions, both those provided by Amazon Web
3483
3487
  # Services and published by third parties, CloudFormation returns
3484
- # `null`. For more information, see [RegisterType][1].
3488
+ # `null`. For more information, see [ `RegisterType` ][1].
3485
3489
  #
3486
3490
  # To set the default version of an extension, use
3487
3491
  # SetTypeDefaultVersion.
@@ -3600,7 +3604,7 @@ module Aws::CloudFormation
3600
3604
  # This applies only to private extensions you have registered in your
3601
3605
  # account. For public extensions, both those provided by Amazon Web
3602
3606
  # Services and published by third parties, CloudFormation returns
3603
- # `null`. For more information, see [RegisterType][1].
3607
+ # `null`. For more information, see [ `RegisterType` ][1].
3604
3608
  #
3605
3609
  #
3606
3610
  #
@@ -3616,8 +3620,8 @@ module Aws::CloudFormation
3616
3620
  # @!attribute [rw] execution_role_arn
3617
3621
  # The Amazon Resource Name (ARN) of the IAM execution role used to
3618
3622
  # register the extension. This applies only to private extensions you
3619
- # have registered in your account. For more information, see
3620
- # [RegisterType][1].
3623
+ # have registered in your account. For more information, see [
3624
+ # `RegisterType` ][1].
3621
3625
  #
3622
3626
  # If the registered extension calls any Amazon Web Services APIs, you
3623
3627
  # must create an <i> <a
@@ -3660,11 +3664,11 @@ module Aws::CloudFormation
3660
3664
  # only to:
3661
3665
  #
3662
3666
  # * Private extensions you have registered in your account. For more
3663
- # information, see [RegisterType][1].
3667
+ # information, see [ `RegisterType` ][1].
3664
3668
  #
3665
3669
  # * Public extensions you have activated in your account with
3666
- # auto-update specified. For more information, see
3667
- # [ActivateType][2].
3670
+ # auto-update specified. For more information, see [ `ActivateType`
3671
+ # ][2].
3668
3672
  #
3669
3673
  #
3670
3674
  #
@@ -3681,8 +3685,8 @@ module Aws::CloudFormation
3681
3685
  # A JSON string that represent the current configuration data for the
3682
3686
  # extension in this account and Region.
3683
3687
  #
3684
- # To set the configuration data for an extension, use
3685
- # [SetTypeConfiguration][1]. For more information, see [Configuring
3688
+ # To set the configuration data for an extension, use [
3689
+ # `SetTypeConfiguration` ][1]. For more information, see [Configuring
3686
3690
  # extensions at the account level][2] in the *CloudFormation User
3687
3691
  # Guide*.
3688
3692
  #
@@ -4000,7 +4004,8 @@ module Aws::CloudFormation
4000
4004
  # Location of file containing the template body. The URL must point to
4001
4005
  # a template that's located in an Amazon S3 bucket or a Systems
4002
4006
  # Manager document. For more information, go to [Template Anatomy][1]
4003
- # in the *CloudFormation User Guide*.
4007
+ # in the *CloudFormation User Guide*. The location for an Amazon S3
4008
+ # bucket must start with `https://`.
4004
4009
  #
4005
4010
  # Conditional: You must pass `TemplateURL` or `TemplateBody`. If both
4006
4011
  # are passed, only `TemplateBody` is used.
@@ -4063,16 +4068,16 @@ module Aws::CloudFormation
4063
4068
  # @!attribute [rw] disable_rollback
4064
4069
  # Preserves the state of previously provisioned resources when an
4065
4070
  # operation fails. This parameter can't be specified when the
4066
- # `OnStackFailure` parameter to the [CreateChangeSet][1] API operation
4067
- # was specified.
4071
+ # `OnStackFailure` parameter to the [ `CreateChangeSet` ][1] API
4072
+ # operation was specified.
4068
4073
  #
4069
4074
  # * `True` - if the stack creation fails, do nothing. This is
4070
4075
  # equivalent to specifying `DO_NOTHING` for the `OnStackFailure`
4071
- # parameter to the [CreateChangeSet][1] API operation.
4076
+ # parameter to the [ `CreateChangeSet` ][1] API operation.
4072
4077
  #
4073
4078
  # * `False` - if the stack creation fails, roll back the stack. This
4074
4079
  # is equivalent to specifying `ROLLBACK` for the `OnStackFailure`
4075
- # parameter to the [CreateChangeSet][1] API operation.
4080
+ # parameter to the [ `CreateChangeSet` ][1] API operation.
4076
4081
  #
4077
4082
  # Default: `True`
4078
4083
  #
@@ -4332,7 +4337,8 @@ module Aws::CloudFormation
4332
4337
  # a template (max size: 460,800 bytes) that's located in an Amazon S3
4333
4338
  # bucket or a Systems Manager document. For more information about
4334
4339
  # templates, see [Template anatomy][1] in the *CloudFormation User
4335
- # Guide*.
4340
+ # Guide*. The location for an Amazon S3 bucket must start with
4341
+ # `https://`.
4336
4342
  #
4337
4343
  # Conditional: You must specify only one of the following parameters:
4338
4344
  # `StackName`, `StackSetName`, `TemplateBody`, or `TemplateURL`.
@@ -6656,7 +6662,7 @@ module Aws::CloudFormation
6656
6662
  #
6657
6663
  #
6658
6664
  #
6659
- # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/generate-IaC-supported-resources.html
6665
+ # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/resource-import-supported-resources.html
6660
6666
  # @return [String]
6661
6667
  #
6662
6668
  # @!attribute [rw] logical_resource_id
@@ -6699,7 +6705,7 @@ module Aws::CloudFormation
6699
6705
  #
6700
6706
  #
6701
6707
  #
6702
- # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/generate-IaC-supported-resources.html
6708
+ # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/resource-import-supported-resources.html
6703
6709
  # @return [String]
6704
6710
  #
6705
6711
  # @!attribute [rw] logical_resource_id
@@ -7002,8 +7008,8 @@ module Aws::CloudFormation
7002
7008
  # triggers, CloudFormation still waits the specified period of time
7003
7009
  # before cleaning up old resources after update operations. You can
7004
7010
  # use this monitoring period to perform any manual stack validation
7005
- # desired, and manually cancel the stack creation or update (using
7006
- # [CancelUpdateStack][1], for example) as necessary.
7011
+ # desired, and manually cancel the stack creation or update (using [
7012
+ # `CancelUpdateStack` ][1], for example) as necessary.
7007
7013
  #
7008
7014
  # If you specify 0 for this parameter, CloudFormation still monitors
7009
7015
  # the specified rollback triggers during stack creation and update
@@ -7082,9 +7088,9 @@ module Aws::CloudFormation
7082
7088
  # @return [String]
7083
7089
  #
7084
7090
  # @!attribute [rw] type
7085
- # The resource type of the rollback trigger. Specify either
7086
- # [AWS::CloudWatch::Alarm][1] or [AWS::CloudWatch::CompositeAlarm][2]
7087
- # resource types.
7091
+ # The resource type of the rollback trigger. Specify either [
7092
+ # `AWS::CloudWatch::Alarm` ][1] or [ `AWS::CloudWatch::CompositeAlarm`
7093
+ # ][2] resource types.
7088
7094
  #
7089
7095
  #
7090
7096
  #
@@ -7106,12 +7112,12 @@ module Aws::CloudFormation
7106
7112
  #
7107
7113
  # @!attribute [rw] resource_type
7108
7114
  # The type of the resource, such as `AWS::DynamoDB::Table`. For the
7109
- # list of supported resources, see [IaC generator supported resource
7110
- # types][1] In the *CloudFormation User Guide*
7115
+ # list of supported resources, see [Resource type support][1] In the
7116
+ # *CloudFormation User Guide*
7111
7117
  #
7112
7118
  #
7113
7119
  #
7114
- # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/generate-IaC-supported-resources.html
7120
+ # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/resource-import-supported-resources.html
7115
7121
  # @return [String]
7116
7122
  #
7117
7123
  # @!attribute [rw] resource_identifier
@@ -7151,11 +7157,11 @@ module Aws::CloudFormation
7151
7157
  # @!attribute [rw] resource_type
7152
7158
  # The type of the resource, such as `AWS::DynamoDB::Table`. For the
7153
7159
  # list of supported resources, see [IaC generator supported resource
7154
- # types][1] In the *CloudFormation User Guide*
7160
+ # types][1] In the *CloudFormation User Guide*.
7155
7161
  #
7156
7162
  #
7157
7163
  #
7158
- # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/generate-IaC-supported-resources.html
7164
+ # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/resource-import-supported-resources.html
7159
7165
  # @return [String]
7160
7166
  #
7161
7167
  # @!attribute [rw] resource_identifier
@@ -7205,7 +7211,8 @@ module Aws::CloudFormation
7205
7211
  # @!attribute [rw] stack_policy_url
7206
7212
  # Location of a file containing the stack policy. The URL must point
7207
7213
  # to a policy (maximum size: 16 KB) located in an Amazon S3 bucket in
7208
- # the same Amazon Web Services Region as the stack. You can specify
7214
+ # the same Amazon Web Services Region as the stack. The location for
7215
+ # an Amazon S3 bucket must start with `https://`. You can specify
7209
7216
  # either the `StackPolicyBody` or the `StackPolicyURL` parameter, but
7210
7217
  # not both.
7211
7218
  # @return [String]
@@ -7224,10 +7231,10 @@ module Aws::CloudFormation
7224
7231
  # The Amazon Resource Name (ARN) for the extension, in this account
7225
7232
  # and Region.
7226
7233
  #
7227
- # For public extensions, this will be the ARN assigned when you
7228
- # [activate the type][1] in this account and Region. For private
7229
- # extensions, this will be the ARN assigned when you [register the
7230
- # type][2] in this account and Region.
7234
+ # For public extensions, this will be the ARN assigned when you call
7235
+ # the [ `ActivateType` ][1] API operation in this account and Region.
7236
+ # For private extensions, this will be the ARN assigned when you call
7237
+ # the [ `RegisterType` ][2] API operation in this account and Region.
7231
7238
  #
7232
7239
  # Do not include the extension versions suffix at the end of the ARN.
7233
7240
  # You can set the configuration for an extension, but not for a
@@ -7245,9 +7252,9 @@ module Aws::CloudFormation
7245
7252
  #
7246
7253
  # The configuration data must be formatted as JSON, and validate
7247
7254
  # against the schema returned in the `ConfigurationSchema` response
7248
- # element of [DescribeType][1]. For more information, see [Defining
7249
- # account-level configuration data for an extension][2] in the
7250
- # *CloudFormation CLI User Guide*.
7255
+ # element of [ `DescribeType` ][1]. For more information, see
7256
+ # [Defining account-level configuration data for an extension][2] in
7257
+ # the *CloudFormation CLI User Guide*.
7251
7258
  #
7252
7259
  #
7253
7260
  #
@@ -7530,6 +7537,20 @@ module Aws::CloudFormation
7530
7537
  # Default: `false`
7531
7538
  # @return [Boolean]
7532
7539
  #
7540
+ # @!attribute [rw] detailed_status
7541
+ # The detailed status of the resource or stack. If
7542
+ # `CONFIGURATION_COMPLETE` is present, the resource or resource
7543
+ # configuration phase has completed and the stabilization of the
7544
+ # resources is in progress. The stack sets `CONFIGURATION_COMPLETE`
7545
+ # when all of the resources in the stack have reached that event. For
7546
+ # more information, see [CloudFormation stack deployment][1] in the
7547
+ # *CloudFormation User Guide*.
7548
+ #
7549
+ #
7550
+ #
7551
+ # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stack-resource-configuration-complete.html
7552
+ # @return [String]
7553
+ #
7533
7554
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/Stack AWS API Documentation
7534
7555
  #
7535
7556
  class Stack < Struct.new(
@@ -7555,7 +7576,8 @@ module Aws::CloudFormation
7555
7576
  :parent_id,
7556
7577
  :root_id,
7557
7578
  :drift_information,
7558
- :retain_except_on_create)
7579
+ :retain_except_on_create,
7580
+ :detailed_status)
7559
7581
  SENSITIVE = []
7560
7582
  include Aws::Structure
7561
7583
  end
@@ -7728,6 +7750,28 @@ module Aws::CloudFormation
7728
7750
  # * `WARN` Allows provisioning to continue with a warning message.
7729
7751
  # @return [String]
7730
7752
  #
7753
+ # @!attribute [rw] detailed_status
7754
+ # An optional field containing information about the detailed status
7755
+ # of the stack event.
7756
+ #
7757
+ # * `CONFIGURATION_COMPLETE` - all of the resources in the stack have
7758
+ # reached that event. For more information, see [CloudFormation
7759
+ # stack deployment][1] in the *CloudFormation User Guide*.
7760
+ #
7761
+ # ^
7762
+ # ^
7763
+ #
7764
+ # * `VALIDATION_FAILED` - template validation failed because of
7765
+ # invalid properties in the template. The `ResourceStatusReason`
7766
+ # field shows what properties are defined incorrectly.
7767
+ #
7768
+ # ^
7769
+ #
7770
+ #
7771
+ #
7772
+ # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stack-resource-configuration-complete.html
7773
+ # @return [String]
7774
+ #
7731
7775
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/StackEvent AWS API Documentation
7732
7776
  #
7733
7777
  class StackEvent < Struct.new(
@@ -7746,7 +7790,8 @@ module Aws::CloudFormation
7746
7790
  :hook_status,
7747
7791
  :hook_status_reason,
7748
7792
  :hook_invocation_point,
7749
- :hook_failure_mode)
7793
+ :hook_failure_mode,
7794
+ :detailed_status)
7750
7795
  SENSITIVE = []
7751
7796
  include Aws::Structure
7752
7797
  end
@@ -7793,7 +7838,12 @@ module Aws::CloudFormation
7793
7838
  # excluded from further `UpdateStackSet` operations. You might need
7794
7839
  # to perform a `DeleteStackInstances` operation, with `RetainStacks`
7795
7840
  # set to `true`, to delete the stack instance, and then delete the
7796
- # stack manually.
7841
+ # stack manually. `INOPERABLE` can be returned here when the cause
7842
+ # is a failed import. If it's due to a failed import, the operation
7843
+ # can be retried once the failures are fixed. To see if this is due
7844
+ # to a failed import, look at the `DetailedStatus` member in the
7845
+ # `StackInstanceSummary` member that is a peer to this `Status`
7846
+ # member.
7797
7847
  #
7798
7848
  # * `OUTDATED`: The stack isn't currently up to date with the stack
7799
7849
  # set because:
@@ -7819,8 +7869,8 @@ module Aws::CloudFormation
7819
7869
  #
7820
7870
  # @!attribute [rw] organizational_unit_id
7821
7871
  # \[Service-managed permissions\] The organization root ID or
7822
- # organizational unit (OU) IDs that you specified for
7823
- # [DeploymentTargets][1].
7872
+ # organizational unit (OU) IDs that you specified for [
7873
+ # `DeploymentTargets` ][1].
7824
7874
  #
7825
7875
  #
7826
7876
  #
@@ -7889,6 +7939,13 @@ module Aws::CloudFormation
7889
7939
  # a Region, the failure tolerance for the stack set operation as a
7890
7940
  # whole might be exceeded.
7891
7941
  #
7942
+ # * `FAILED_IMPORT`: The import of the stack instance in the specified
7943
+ # account and Region failed and left the stack in an unstable state.
7944
+ # Once the issues causing the failure are fixed, the import
7945
+ # operation can be retried. If enough stack set operations fail in
7946
+ # enough accounts within a Region, the failure tolerance for the
7947
+ # stack set operation as a whole might be exceeded.
7948
+ #
7892
7949
  # * `INOPERABLE`: A `DeleteStackInstances` operation has failed and
7893
7950
  # left the stack in an unstable state. Stacks in this state are
7894
7951
  # excluded from further `UpdateStackSet` operations. You might need
@@ -8049,7 +8106,12 @@ module Aws::CloudFormation
8049
8106
  # excluded from further `UpdateStackSet` operations. You might need
8050
8107
  # to perform a `DeleteStackInstances` operation, with `RetainStacks`
8051
8108
  # set to `true`, to delete the stack instance, and then delete the
8052
- # stack manually.
8109
+ # stack manually. `INOPERABLE` can be returned here when the cause
8110
+ # is a failed import. If it's due to a failed import, the operation
8111
+ # can be retried once the failures are fixed. To see if this is due
8112
+ # to a failed import, call the DescribeStackInstance API operation,
8113
+ # look at the `DetailedStatus` member returned in the
8114
+ # `StackInstanceSummary` member.
8053
8115
  #
8054
8116
  # * `OUTDATED`: The stack isn't currently up to date with the stack
8055
8117
  # set because:
@@ -8075,8 +8137,8 @@ module Aws::CloudFormation
8075
8137
  #
8076
8138
  # @!attribute [rw] organizational_unit_id
8077
8139
  # \[Service-managed permissions\] The organization root ID or
8078
- # organizational unit (OU) IDs that you specified for
8079
- # [DeploymentTargets][1].
8140
+ # organizational unit (OU) IDs that you specified for [
8141
+ # `DeploymentTargets` ][1].
8080
8142
  #
8081
8143
  #
8082
8144
  #
@@ -8691,8 +8753,8 @@ module Aws::CloudFormation
8691
8753
  #
8692
8754
  # @!attribute [rw] organizational_unit_ids
8693
8755
  # \[Service-managed permissions\] The organization root ID or
8694
- # organizational unit (OU) IDs that you specified for
8695
- # [DeploymentTargets][1].
8756
+ # organizational unit (OU) IDs that you specified for [
8757
+ # `DeploymentTargets` ][1].
8696
8758
  #
8697
8759
  #
8698
8760
  #
@@ -9187,8 +9249,8 @@ module Aws::CloudFormation
9187
9249
  #
9188
9250
  # @!attribute [rw] organizational_unit_id
9189
9251
  # \[Service-managed permissions\] The organization root ID or
9190
- # organizational unit (OU) IDs that you specified for
9191
- # [DeploymentTargets][1].
9252
+ # organizational unit (OU) IDs that you specified for [
9253
+ # `DeploymentTargets` ][1].
9192
9254
  #
9193
9255
  #
9194
9256
  #
@@ -9925,10 +9987,10 @@ module Aws::CloudFormation
9925
9987
  # The Amazon Resource Name (ARN) for the extension, in this account
9926
9988
  # and Region.
9927
9989
  #
9928
- # For public extensions, this will be the ARN assigned when you
9929
- # [activate the type][1] in this account and Region. For private
9930
- # extensions, this will be the ARN assigned when you [register the
9931
- # type][2] in this account and Region.
9990
+ # For public extensions, this will be the ARN assigned when you call
9991
+ # the [ `ActivateType` ][1] API operation in this account and Region.
9992
+ # For private extensions, this will be the ARN assigned when you call
9993
+ # the [ `RegisterType` ][2] API operation in this account and Region.
9932
9994
  #
9933
9995
  #
9934
9996
  #
@@ -9966,10 +10028,10 @@ module Aws::CloudFormation
9966
10028
  # The Amazon Resource Name (ARN) for the extension, in this account
9967
10029
  # and Region.
9968
10030
  #
9969
- # For public extensions, this will be the ARN assigned when you
9970
- # [activate the type][1] in this account and Region. For private
9971
- # extensions, this will be the ARN assigned when you [register the
9972
- # type][2] in this account and Region.
10031
+ # For public extensions, this will be the ARN assigned when you call
10032
+ # the [ `ActivateType` ][1] API operation in this account and Region.
10033
+ # For private extensions, this will be the ARN assigned when you call
10034
+ # the [ `RegisterType` ][2] API operation in this account and Region.
9973
10035
  #
9974
10036
  #
9975
10037
  #
@@ -10073,9 +10135,9 @@ module Aws::CloudFormation
10073
10135
  # @!attribute [rw] type_name
10074
10136
  # The name of the extension.
10075
10137
  #
10076
- # If you specified a `TypeNameAlias` when you [activate this
10077
- # extension][1] in your account and Region, CloudFormation considers
10078
- # that alias as the type name.
10138
+ # If you specified a `TypeNameAlias` when you call the [
10139
+ # `ActivateType` ][1] API operation in your account and Region,
10140
+ # CloudFormation considers that alias as the type name.
10079
10141
  #
10080
10142
  #
10081
10143
  #
@@ -10089,7 +10151,7 @@ module Aws::CloudFormation
10089
10151
  # This applies only to private extensions you have registered in your
10090
10152
  # account. For public extensions, both those provided by Amazon and
10091
10153
  # published by third parties, CloudFormation returns `null`. For more
10092
- # information, see [RegisterType][1].
10154
+ # information, see [ `RegisterType` ][1].
10093
10155
  #
10094
10156
  # To set the default version of an extension, use
10095
10157
  # SetTypeDefaultVersion.
@@ -10108,11 +10170,11 @@ module Aws::CloudFormation
10108
10170
  # only to:
10109
10171
  #
10110
10172
  # * Private extensions you have registered in your account. For more
10111
- # information, see [RegisterType][1].
10173
+ # information, see [ `RegisterType` ][1].
10112
10174
  #
10113
10175
  # * Public extensions you have activated in your account with
10114
- # auto-update specified. For more information, see
10115
- # [ActivateType][2].
10176
+ # auto-update specified. For more information, see [ `ActivateType`
10177
+ # ][2].
10116
10178
  #
10117
10179
  # For all other extension types, CloudFormation returns `null`.
10118
10180
  #
@@ -10380,7 +10442,8 @@ module Aws::CloudFormation
10380
10442
  # Location of file containing the template body. The URL must point to
10381
10443
  # a template that's located in an Amazon S3 bucket or a Systems
10382
10444
  # Manager document. For more information, go to [Template Anatomy][1]
10383
- # in the *CloudFormation User Guide*.
10445
+ # in the *CloudFormation User Guide*. The location for an Amazon S3
10446
+ # bucket must start with `https://`.
10384
10447
  #
10385
10448
  # Conditional: You must specify only one of the following parameters:
10386
10449
  # `TemplateBody`, `TemplateURL`, or set the `UsePreviousTemplate` to
@@ -10414,7 +10477,8 @@ module Aws::CloudFormation
10414
10477
  # @!attribute [rw] stack_policy_during_update_url
10415
10478
  # Location of a file containing the temporary overriding stack policy.
10416
10479
  # The URL must point to a policy (max size: 16KB) located in an S3
10417
- # bucket in the same Region as the stack. You can specify either the
10480
+ # bucket in the same Region as the stack. The location for an Amazon
10481
+ # S3 bucket must start with `https://`. You can specify either the
10418
10482
  # `StackPolicyDuringUpdateBody` or the `StackPolicyDuringUpdateURL`
10419
10483
  # parameter, but not both.
10420
10484
  #
@@ -10426,7 +10490,8 @@ module Aws::CloudFormation
10426
10490
  #
10427
10491
  # @!attribute [rw] parameters
10428
10492
  # A list of `Parameter` structures that specify input parameters for
10429
- # the stack. For more information, see the [Parameter][1] data type.
10493
+ # the stack. For more information, see the [ `Parameter` ][1] data
10494
+ # type.
10430
10495
  #
10431
10496
  #
10432
10497
  #
@@ -10461,19 +10526,19 @@ module Aws::CloudFormation
10461
10526
  # you review all permissions associated with them and edit their
10462
10527
  # permissions if necessary.
10463
10528
  #
10464
- # * [ AWS::IAM::AccessKey][1]
10529
+ # * [ `AWS::IAM::AccessKey` ][1]
10465
10530
  #
10466
- # * [ AWS::IAM::Group][2]
10531
+ # * [ `AWS::IAM::Group` ][2]
10467
10532
  #
10468
- # * [AWS::IAM::InstanceProfile][3]
10533
+ # * [ `AWS::IAM::InstanceProfile` ][3]
10469
10534
  #
10470
- # * [ AWS::IAM::Policy][4]
10535
+ # * [ ` AWS::IAM::Policy` ][4]
10471
10536
  #
10472
- # * [ AWS::IAM::Role][5]
10537
+ # * [ `AWS::IAM::Role` ][5]
10473
10538
  #
10474
- # * [ AWS::IAM::User][6]
10539
+ # * [ `AWS::IAM::User` ][6]
10475
10540
  #
10476
- # * [AWS::IAM::UserToGroupAddition][7]
10541
+ # * [ `AWS::IAM::UserToGroupAddition` ][7]
10477
10542
  #
10478
10543
  # For more information, see [Acknowledging IAM Resources in
10479
10544
  # CloudFormation Templates][8].
@@ -10489,9 +10554,9 @@ module Aws::CloudFormation
10489
10554
  # your stack template contains one or more macros, and you choose to
10490
10555
  # update a stack directly from the processed template, without first
10491
10556
  # reviewing the resulting changes in a change set, you must
10492
- # acknowledge this capability. This includes the [AWS::Include][9]
10493
- # and [AWS::Serverless][10] transforms, which are macros hosted by
10494
- # CloudFormation.
10557
+ # acknowledge this capability. This includes the [ `AWS::Include`
10558
+ # ][9] and [ `AWS::Serverless` ][10] transforms, which are macros
10559
+ # hosted by CloudFormation.
10495
10560
  #
10496
10561
  # If you want to update a stack from a stack template that contains
10497
10562
  # macros *and* nested stacks, you must update the stack directly
@@ -10586,8 +10651,9 @@ module Aws::CloudFormation
10586
10651
  # @!attribute [rw] stack_policy_url
10587
10652
  # Location of a file containing the updated stack policy. The URL must
10588
10653
  # point to a policy (max size: 16KB) located in an S3 bucket in the
10589
- # same Region as the stack. You can specify either the
10590
- # `StackPolicyBody` or the `StackPolicyURL` parameter, but not both.
10654
+ # same Region as the stack. The location for an Amazon S3 bucket must
10655
+ # start with `https://`. You can specify either the `StackPolicyBody`
10656
+ # or the `StackPolicyURL` parameter, but not both.
10591
10657
  #
10592
10658
  # You might update the stack policy, for example, in order to protect
10593
10659
  # a new resource that you created during a stack update. If you don't
@@ -10737,11 +10803,11 @@ module Aws::CloudFormation
10737
10803
  # the stack set; to add or delete a parameter itself, use
10738
10804
  # `UpdateStackSet` to update the stack set template. If you add a
10739
10805
  # parameter to a template, before you can override the parameter value
10740
- # specified in the stack set you must first use [UpdateStackSet][1] to
10741
- # update all stack instances with the updated template and parameter
10742
- # value specified in the stack set. Once a stack instance has been
10743
- # updated with the new parameter, you can then override the parameter
10744
- # value using `UpdateStackInstances`.
10806
+ # specified in the stack set you must first use [ `UpdateStackSet`
10807
+ # ][1] to update all stack instances with the updated template and
10808
+ # parameter value specified in the stack set. Once a stack instance
10809
+ # has been updated with the new parameter, you can then override the
10810
+ # parameter value using `UpdateStackInstances`.
10745
10811
  #
10746
10812
  #
10747
10813
  #
@@ -10913,19 +10979,19 @@ module Aws::CloudFormation
10913
10979
  # you review all permissions associated with them and edit their
10914
10980
  # permissions if necessary.
10915
10981
  #
10916
- # * [ AWS::IAM::AccessKey][1]
10982
+ # * [ `AWS::IAM::AccessKey` ][1]
10917
10983
  #
10918
- # * [ AWS::IAM::Group][2]
10984
+ # * [ `AWS::IAM::Group` ][2]
10919
10985
  #
10920
- # * [ AWS::IAM::InstanceProfile][3]
10986
+ # * [ `AWS::IAM::InstanceProfile` ][3]
10921
10987
  #
10922
- # * [ AWS::IAM::Policy][4]
10988
+ # * [ `AWS::IAM::Policy` ][4]
10923
10989
  #
10924
- # * [ AWS::IAM::Role][5]
10990
+ # * [ `AWS::IAM::Role` ][5]
10925
10991
  #
10926
- # * [ AWS::IAM::User][6]
10992
+ # * [ `AWS::IAM::User` ][6]
10927
10993
  #
10928
- # * [ AWS::IAM::UserToGroupAddition][7]
10994
+ # * [ `AWS::IAM::UserToGroupAddition` ][7]
10929
10995
  #
10930
10996
  # For more information, see [Acknowledging IAM Resources in
10931
10997
  # CloudFormation Templates][8].
@@ -10941,11 +11007,11 @@ module Aws::CloudFormation
10941
11007
  # Processing on Templates][9].
10942
11008
  #
10943
11009
  # Stack sets with service-managed permissions do not currently
10944
- # support the use of macros in templates. (This includes the
10945
- # [AWS::Include][10] and [AWS::Serverless][11] transforms, which are
10946
- # macros hosted by CloudFormation.) Even if you specify this
10947
- # capability for a stack set with service-managed permissions, if
10948
- # you reference a macro in your template the stack set operation
11010
+ # support the use of macros in templates. (This includes the [
11011
+ # `AWS::Include` ][10] and [ `AWS::Serverless` ][11] transforms,
11012
+ # which are macros hosted by CloudFormation.) Even if you specify
11013
+ # this capability for a stack set with service-managed permissions,
11014
+ # if you reference a macro in your template the stack set operation
10949
11015
  # will fail.
10950
11016
  #
10951
11017
  #
@@ -11261,7 +11327,8 @@ module Aws::CloudFormation
11261
11327
  # Location of file containing the template body. The URL must point to
11262
11328
  # a template (max size: 460,800 bytes) that is located in an Amazon S3
11263
11329
  # bucket or a Systems Manager document. For more information, go to
11264
- # [Template Anatomy][1] in the *CloudFormation User Guide*.
11330
+ # [Template Anatomy][1] in the *CloudFormation User Guide*. The
11331
+ # location for an Amazon S3 bucket must start with `https://`.
11265
11332
  #
11266
11333
  # Conditional: You must pass `TemplateURL` or `TemplateBody`. If both
11267
11334
  # are passed, only `TemplateBody` is used.