aws-sdk-cloudformation 1.41.0 → 1.131.0

data/lib/aws-sdk-cloudformation/stack.rb

@@ -3,7 +3,7 @@
 # WARNING ABOUT GENERATED CODE
 #
 # This file is generated. See the contributing guide for more information:
-# https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
+# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
 #
 # WARNING ABOUT GENERATED CODE
 
@@ -78,7 +78,7 @@ module Aws::CloudFormation
       data[:last_updated_time]
     end
 
-    # The rollback triggers for AWS CloudFormation to monitor during stack
+    # The rollback triggers for CloudFormation to monitor during stack
     # creation and updating operations, and for the specified monitoring
     # period afterwards.
     # @return [Types::RollbackConfiguration]
@@ -100,15 +100,16 @@ module Aws::CloudFormation
 
     # Boolean to enable or disable rollback on stack creation failures:
     #
-    # * `true`\: disable rollback
+    # * `true`: disable rollback.
     #
-    # * `false`\: enable rollback
+    # * `false`: enable rollback.
     # @return [Boolean]
     def disable_rollback
       data[:disable_rollback]
     end
 
-    # SNS topic ARNs to which stack related events are published.
+    # Amazon SNS topic Amazon Resource Names (ARNs) to which stack related
+    # events are published.
     # @return [Array<String>]
     def notification_arns
       data[:notification_arns]
@@ -132,10 +133,9 @@ module Aws::CloudFormation
       data[:outputs]
     end
 
-    # The Amazon Resource Name (ARN) of an AWS Identity and Access
-    # Management (IAM) role that is associated with the stack. During a
-    # stack operation, AWS CloudFormation uses this role's credentials to
-    # make calls on your behalf.
+    # The Amazon Resource Name (ARN) of an IAM role that's associated with
+    # the stack. During a stack operation, CloudFormation uses this role's
+    # credentials to make calls on your behalf.
     # @return [String]
     def role_arn
       data[:role_arn]
@@ -150,14 +150,14 @@ module Aws::CloudFormation
     # Whether termination protection is enabled for the stack.
     #
     # For [nested stacks][1], termination protection is set on the root
-    # stack and cannot be changed directly on the nested stack. For more
-    # information, see [Protecting a Stack From Being Deleted][2] in the
-    # *AWS CloudFormation User Guide*.
+    # stack and can't be changed directly on the nested stack. For more
+    # information, see [Protect a CloudFormation stack from being
+    # deleted][2] in the *CloudFormation User Guide*.
     #
     #
     #
-    # [1]: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-nested-stacks.html
-    # [2]: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-protect-stacks.html
+    # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-nested-stacks.html
+    # [2]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-protect-stacks.html
     # @return [Boolean]
     def enable_termination_protection
       data[:enable_termination_protection]
@@ -167,12 +167,12 @@ module Aws::CloudFormation
     # stack ID of the direct parent of this stack. For the first level of
     # nested stacks, the root stack is also the parent stack.
     #
-    # For more information, see [Working with Nested Stacks][1] in the *AWS
-    # CloudFormation User Guide*.
+    # For more information, see [Embed stacks within other stacks using
+    # nested stacks][1] in the *CloudFormation User Guide*.
     #
     #
     #
-    # [1]: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-nested-stacks.html
+    # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-nested-stacks.html
     # @return [String]
     def parent_id
       data[:parent_id]
@@ -182,31 +182,69 @@ module Aws::CloudFormation
     # stack ID of the top-level stack to which the nested stack ultimately
     # belongs.
     #
-    # For more information, see [Working with Nested Stacks][1] in the *AWS
-    # CloudFormation User Guide*.
+    # For more information, see [Embed stacks within other stacks using
+    # nested stacks][1] in the *CloudFormation User Guide*.
     #
     #
     #
-    # [1]: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-nested-stacks.html
+    # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-nested-stacks.html
     # @return [String]
     def root_id
       data[:root_id]
     end
 
-    # Information on whether a stack's actual configuration differs, or has
-    # *drifted*, from it's expected configuration, as defined in the stack
-    # template and any values specified as template parameters. For more
-    # information, see [Detecting Unregulated Configuration Changes to
-    # Stacks and Resources][1].
+    # Information about whether a stack's actual configuration differs, or
+    # has *drifted*, from its expected configuration, as defined in the
+    # stack template and any values specified as template parameters. For
+    # more information, see [Detect unmanaged configuration changes to
+    # stacks and resources with drift detection][1].
     #
     #
     #
-    # [1]: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-stack-drift.html
+    # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-stack-drift.html
     # @return [Types::StackDriftInformation]
     def drift_information
       data[:drift_information]
     end
 
+    # When set to `true`, newly created resources are deleted when the
+    # operation rolls back. This includes newly created resources marked
+    # with a deletion policy of `Retain`.
+    #
+    # Default: `false`
+    # @return [Boolean]
+    def retain_except_on_create
+      data[:retain_except_on_create]
+    end
+
+    # Specifies the deletion mode for the stack. Possible values are:
+    #
+    # * `STANDARD` - Use the standard behavior. Specifying this value is the
+    #   same as not specifying this parameter.
+    #
+    # * `FORCE_DELETE_STACK` - Delete the stack if it's stuck in a
+    #   `DELETE_FAILED` state due to resource deletion failure.
+    # @return [String]
+    def deletion_mode
+      data[:deletion_mode]
+    end
+
+    # The detailed status of the resource or stack. If
+    # `CONFIGURATION_COMPLETE` is present, the resource or resource
+    # configuration phase has completed and the stabilization of the
+    # resources is in progress. The stack sets `CONFIGURATION_COMPLETE` when
+    # all of the resources in the stack have reached that event. For more
+    # information, see [Understand CloudFormation stack creation events][1]
+    # in the *CloudFormation User Guide*.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stack-resource-configuration-complete.html
+    # @return [String]
+    def detailed_status
+      data[:detailed_status]
+    end
+
     # @!endgroup
 
     # @return [Client]
@@ -221,7 +259,9 @@ module Aws::CloudFormation
     #
     # @return [self]
     def load
-      resp = @client.describe_stacks(stack_name: @name)
+      resp = Aws::Plugins::UserAgent.metric('RESOURCE_MODEL') do
+        @client.describe_stacks(stack_name: @name)
+      end
       @data = resp.stacks[0]
       self
     end
@@ -266,7 +306,9 @@ module Aws::CloudFormation
       options, params = separate_params_and_options(options)
       waiter = Waiters::StackExists.new(options)
       yield_waiter_and_warn(waiter, &block) if block_given?
-      waiter.wait(params.merge(stack_name: @name))
+      Aws::Plugins::UserAgent.metric('RESOURCE_MODEL') do
+        waiter.wait(params.merge(stack_name: @name))
+      end
       Stack.new({
         name: @name,
         client: @client
@@ -367,7 +409,9 @@ module Aws::CloudFormation
           :retry
         end
       end
-      Aws::Waiters::Waiter.new(options).wait({})
+      Aws::Plugins::UserAgent.metric('RESOURCE_MODEL') do
+        Aws::Waiters::Waiter.new(options).wait({})
+      end
     end
 
     # @!group Actions
@@ -380,14 +424,16 @@ module Aws::CloudFormation
     # @param [Hash] options ({})
     # @option options [String] :client_request_token
     #   A unique identifier for this `CancelUpdateStack` request. Specify this
-    #   token if you plan to retry requests so that AWS CloudFormation knows
-    #   that you're not attempting to cancel an update on a stack with the
-    #   same name. You might retry `CancelUpdateStack` requests to ensure that
-    #   AWS CloudFormation successfully received them.
+    #   token if you plan to retry requests so that CloudFormation knows that
+    #   you're not attempting to cancel an update on a stack with the same
+    #   name. You might retry `CancelUpdateStack` requests to ensure that
+    #   CloudFormation successfully received them.
     # @return [EmptyStructure]
     def cancel_update(options = {})
       options = options.merge(stack_name: @name)
-      resp = @client.cancel_update_stack(options)
+      resp = Aws::Plugins::UserAgent.metric('RESOURCE_MODEL') do
+        @client.cancel_update_stack(options)
+      end
       resp.data
     end
 
@@ -430,31 +476,23 @@ module Aws::CloudFormation
     #     ],
     #     client_request_token: "ClientRequestToken",
     #     enable_termination_protection: false,
+    #     retain_except_on_create: false,
     #   })
     # @param [Hash] options ({})
     # @option options [String] :template_body
     #   Structure containing the template body with a minimum length of 1 byte
-    #   and a maximum length of 51,200 bytes. For more information, go to
-    #   [Template Anatomy][1] in the AWS CloudFormation User Guide.
+    #   and a maximum length of 51,200 bytes.
     #
     #   Conditional: You must specify either the `TemplateBody` or the
     #   `TemplateURL` parameter, but not both.
-    #
-    #
-    #
-    #   [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html
     # @option options [String] :template_url
-    #   Location of file containing the template body. The URL must point to a
-    #   template (max size: 460,800 bytes) that is located in an Amazon S3
-    #   bucket. For more information, go to the [Template Anatomy][1] in the
-    #   AWS CloudFormation User Guide.
+    #   The URL of a file containing the template body. The URL must point to
+    #   a template (max size: 1 MB) that's located in an Amazon S3 bucket or
+    #   a Systems Manager document. The location for an Amazon S3 bucket must
+    #   start with `https://`.
     #
     #   Conditional: You must specify either the `TemplateBody` or the
     #   `TemplateURL` parameter, but not both.
-    #
-    #
-    #
-    #   [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html
     # @option options [Array<Types::Parameter>] :parameters
     #   A list of `Parameter` structures that specify input parameters for the
     #   stack. For more information, see the [Parameter][1] data type.
@@ -469,29 +507,28 @@ module Aws::CloudFormation
     #
     #   Default: `false`
     # @option options [Types::RollbackConfiguration] :rollback_configuration
-    #   The rollback triggers for AWS CloudFormation to monitor during stack
+    #   The rollback triggers for CloudFormation to monitor during stack
     #   creation and updating operations, and for the specified monitoring
     #   period afterwards.
     # @option options [Integer] :timeout_in_minutes
     #   The amount of time that can pass before the stack status becomes
-    #   CREATE\_FAILED; if `DisableRollback` is not set or is set to `false`,
+    #   `CREATE_FAILED`; if `DisableRollback` is not set or is set to `false`,
     #   the stack will be rolled back.
     # @option options [Array<String>] :notification_arns
-    #   The Simple Notification Service (SNS) topic ARNs to publish stack
-    #   related events. You can find your SNS topic ARNs using the SNS console
-    #   or your Command Line Interface (CLI).
+    #   The Amazon SNS topic ARNs to publish stack related events. You can
+    #   find your Amazon SNS topic ARNs using the Amazon SNS console or your
+    #   Command Line Interface (CLI).
     # @option options [Array<String>] :capabilities
     #   In some cases, you must explicitly acknowledge that your stack
-    #   template contains certain capabilities in order for AWS CloudFormation
-    #   to create the stack.
+    #   template contains certain capabilities in order for CloudFormation to
+    #   create the stack.
     #
     #   * `CAPABILITY_IAM` and `CAPABILITY_NAMED_IAM`
     #
     #     Some stack templates might include resources that can affect
-    #     permissions in your AWS account; for example, by creating new AWS
-    #     Identity and Access Management (IAM) users. For those stacks, you
-    #     must explicitly acknowledge this by specifying one of these
-    #     capabilities.
+    #     permissions in your Amazon Web Services account; for example, by
+    #     creating new IAM users. For those stacks, you must explicitly
+    #     acknowledge this by specifying one of these capabilities.
     #
     #     The following IAM resources require you to specify either the
     #     `CAPABILITY_IAM` or `CAPABILITY_NAMED_IAM` capability.
@@ -501,29 +538,29 @@ module Aws::CloudFormation
     #     * If you have IAM resources with custom names, you *must* specify
     #       `CAPABILITY_NAMED_IAM`.
     #
-    #     * If you don't specify either of these capabilities, AWS
-    #       CloudFormation returns an `InsufficientCapabilities` error.
-    #
+    #     * If you don't specify either of these capabilities, CloudFormation
+    #       returns an `InsufficientCapabilities` error.
     #     If your stack template contains these resources, we recommend that
     #     you review all permissions associated with them and edit their
     #     permissions if necessary.
     #
-    #     * [ AWS::IAM::AccessKey][1]
+    #     * [AWS::IAM::AccessKey][1]
     #
-    #     * [ AWS::IAM::Group][2]
+    #     * [AWS::IAM::Group][2]
     #
-    #     * [ AWS::IAM::InstanceProfile][3]
+    #     * [AWS::IAM::InstanceProfile][3]
     #
-    #     * [ AWS::IAM::Policy][4]
+    #     * [ AWS::IAM::ManagedPolicy][4]
     #
-    #     * [ AWS::IAM::Role][5]
+    #     * [AWS::IAM::Policy][5]
     #
-    #     * [ AWS::IAM::User][6]
+    #     * [AWS::IAM::Role][6]
     #
-    #     * [ AWS::IAM::UserToGroupAddition][7]
+    #     * [AWS::IAM::User][7]
     #
-    #     For more information, see [Acknowledging IAM Resources in AWS
-    #     CloudFormation Templates][8].
+    #     * [AWS::IAM::UserToGroupAddition][8]
+    #     For more information, see [Acknowledging IAM resources in
+    #     CloudFormation templates][9].
     #
     #   * `CAPABILITY_AUTO_EXPAND`
     #
@@ -536,83 +573,93 @@ module Aws::CloudFormation
     #     your stack template contains one or more macros, and you choose to
     #     create a stack directly from the processed template, without first
     #     reviewing the resulting changes in a change set, you must
-    #     acknowledge this capability. This includes the [AWS::Include][9] and
-    #     [AWS::Serverless][10] transforms, which are macros hosted by AWS
+    #     acknowledge this capability. This includes the [AWS::Include][10]
+    #     and [AWS::Serverless][11] transforms, which are macros hosted by
     #     CloudFormation.
     #
-    #     Change sets do not currently support nested stacks. If you want to
-    #     create a stack from a stack template that contains macros *and*
-    #     nested stacks, you must create the stack directly from the template
-    #     using this capability.
+    #     If you want to create a stack from a stack template that contains
+    #     macros *and* nested stacks, you must create the stack directly from
+    #     the template using this capability.
     #
     #     You should only create stacks directly from a stack template that
     #     contains macros if you know what processing the macro performs.
     #
     #      Each macro relies on an underlying Lambda service function for
     #     processing stack templates. Be aware that the Lambda function owner
-    #     can update the function operation without AWS CloudFormation being
+    #     can update the function operation without CloudFormation being
     #     notified.
     #
-    #     For more information, see [Using AWS CloudFormation Macros to
-    #     Perform Custom Processing on Templates][11].
+    #     For more information, see [Perform custom processing on
+    #     CloudFormation templates with template macros][12].
+    #
+    #   <note markdown="1"> Only one of the `Capabilities` and `ResourceType` parameters can be
+    #   specified.
     #
+    #    </note>
     #
     #
-    #   [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-accesskey.html
-    #   [2]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-group.html
+    #
+    #   [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-accesskey.html
+    #   [2]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-group.html
     #   [3]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-instanceprofile.html
-    #   [4]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-policy.html
-    #   [5]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-role.html
-    #   [6]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-user.html
-    #   [7]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-addusertogroup.html
-    #   [8]: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html#capabilities
-    #   [9]: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/create-reusable-transform-function-snippets-and-add-to-your-template-with-aws-include-transform.html
-    #   [10]: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/transform-aws-serverless.html
-    #   [11]: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-macros.html
+    #   [4]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-managedpolicy.html
+    #   [5]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-policy.html
+    #   [6]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-role.html
+    #   [7]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-user.html
+    #   [8]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-usertogroupaddition.html
+    #   [9]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/control-access-with-iam.html#using-iam-capabilities
+    #   [10]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/transform-aws-include.html
+    #   [11]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/transform-aws-serverless.html
+    #   [12]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-macros.html
     # @option options [Array<String>] :resource_types
     #   The template resource types that you have permissions to work with for
     #   this create stack action, such as `AWS::EC2::Instance`, `AWS::EC2::*`,
     #   or `Custom::MyCustomInstance`. Use the following syntax to describe
-    #   template resource types: `AWS::*` (for all AWS resource), `Custom::*`
-    #   (for all custom resources), `Custom::logical_ID ` (for a specific
-    #   custom resource), `AWS::service_name::*` (for all resources of a
-    #   particular AWS service), and `AWS::service_name::resource_logical_ID `
-    #   (for a specific AWS resource).
+    #   template resource types: `AWS::*` (for all Amazon Web Services
+    #   resources), `Custom::*` (for all custom resources),
+    #   `Custom::logical_ID ` (for a specific custom resource),
+    #   `AWS::service_name::*` (for all resources of a particular Amazon Web
+    #   Services service), and `AWS::service_name::resource_logical_ID ` (for
+    #   a specific Amazon Web Services resource).
     #
     #   If the list of resource types doesn't include a resource that you're
-    #   creating, the stack creation fails. By default, AWS CloudFormation
-    #   grants permissions to all resource types. AWS Identity and Access
-    #   Management (IAM) uses this parameter for AWS CloudFormation-specific
-    #   condition keys in IAM policies. For more information, see [Controlling
-    #   Access with AWS Identity and Access Management][1].
+    #   creating, the stack creation fails. By default, CloudFormation grants
+    #   permissions to all resource types. IAM uses this parameter for
+    #   CloudFormation-specific condition keys in IAM policies. For more
+    #   information, see [Control access with Identity and Access
+    #   Management][1].
+    #
+    #   <note markdown="1"> Only one of the `Capabilities` and `ResourceType` parameters can be
+    #   specified.
     #
+    #    </note>
     #
     #
-    #   [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html
+    #
+    #   [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/control-access-with-iam.html
     # @option options [String] :role_arn
-    #   The Amazon Resource Name (ARN) of an AWS Identity and Access
-    #   Management (IAM) role that AWS CloudFormation assumes to create the
-    #   stack. AWS CloudFormation uses the role's credentials to make calls
-    #   on your behalf. AWS CloudFormation always uses this role for all
-    #   future operations on the stack. As long as users have permission to
-    #   operate on the stack, AWS CloudFormation uses this role even if the
-    #   users don't have permission to pass it. Ensure that the role grants
-    #   least privilege.
-    #
-    #   If you don't specify a value, AWS CloudFormation uses the role that
-    #   was previously associated with the stack. If no role is available, AWS
-    #   CloudFormation uses a temporary session that is generated from your
+    #   The Amazon Resource Name (ARN) of an IAM role that CloudFormation
+    #   assumes to create the stack. CloudFormation uses the role's
+    #   credentials to make calls on your behalf. CloudFormation always uses
+    #   this role for all future operations on the stack. Provided that users
+    #   have permission to operate on the stack, CloudFormation uses this role
+    #   even if the users don't have permission to pass it. Ensure that the
+    #   role grants least privilege.
+    #
+    #   If you don't specify a value, CloudFormation uses the role that was
+    #   previously associated with the stack. If no role is available,
+    #   CloudFormation uses a temporary session that's generated from your
     #   user credentials.
     # @option options [String] :on_failure
     #   Determines what action will be taken if stack creation fails. This
-    #   must be one of: DO\_NOTHING, ROLLBACK, or DELETE. You can specify
+    #   must be one of: `DO_NOTHING`, `ROLLBACK`, or `DELETE`. You can specify
     #   either `OnFailure` or `DisableRollback`, but not both.
     #
     #   Default: `ROLLBACK`
     # @option options [String] :stack_policy_body
-    #   Structure containing the stack policy body. For more information, go
-    #   to [ Prevent Updates to Stack Resources][1] in the *AWS CloudFormation
-    #   User Guide*. You can specify either the `StackPolicyBody` or the
+    #   Structure containing the stack policy body. For more information, see
+    #   [Prevent updates to stack resources][1] in the *CloudFormation User
+    #   Guide*. You can specify either the `StackPolicyBody` or the
     #   `StackPolicyURL` parameter, but not both.
     #
     #
@@ -621,20 +668,21 @@ module Aws::CloudFormation
     # @option options [String] :stack_policy_url
     #   Location of a file containing the stack policy. The URL must point to
     #   a policy (maximum size: 16 KB) located in an S3 bucket in the same
-    #   Region as the stack. You can specify either the `StackPolicyBody` or
-    #   the `StackPolicyURL` parameter, but not both.
+    #   Region as the stack. The location for an Amazon S3 bucket must start
+    #   with `https://`. You can specify either the `StackPolicyBody` or the
+    #   `StackPolicyURL` parameter, but not both.
     # @option options [Array<Types::Tag>] :tags
-    #   Key-value pairs to associate with this stack. AWS CloudFormation also
+    #   Key-value pairs to associate with this stack. CloudFormation also
     #   propagates these tags to the resources created in the stack. A maximum
     #   number of 50 tags can be specified.
     # @option options [String] :client_request_token
     #   A unique identifier for this `CreateStack` request. Specify this token
-    #   if you plan to retry requests so that AWS CloudFormation knows that
+    #   if you plan to retry requests so that CloudFormation knows that
     #   you're not attempting to create a stack with the same name. You might
-    #   retry `CreateStack` requests to ensure that AWS CloudFormation
+    #   retry `CreateStack` requests to ensure that CloudFormation
     #   successfully received them.
     #
-    #   All events triggered by a given stack operation are assigned the same
+    #   All events initiated by a given stack operation are assigned the same
     #   client request token, which you can use to track operations. For
     #   example, if you execute a `CreateStack` operation with the token
     #   `token1`, then all the `StackEvents` generated by that operation will
@@ -651,21 +699,29 @@ module Aws::CloudFormation
     #   Whether to enable termination protection on the specified stack. If a
     #   user attempts to delete a stack with termination protection enabled,
     #   the operation fails and the stack remains unchanged. For more
-    #   information, see [Protecting a Stack From Being Deleted][1] in the
-    #   *AWS CloudFormation User Guide*. Termination protection is disabled on
-    #   stacks by default.
+    #   information, see [Protect CloudFormation stacks from being deleted][1]
+    #   in the *CloudFormation User Guide*. Termination protection is
+    #   deactivated on stacks by default.
     #
     #   For [nested stacks][2], termination protection is set on the root
-    #   stack and cannot be changed directly on the nested stack.
+    #   stack and can't be changed directly on the nested stack.
     #
     #
     #
-    #   [1]: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-protect-stacks.html
-    #   [2]: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-nested-stacks.html
+    #   [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-protect-stacks.html
+    #   [2]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-nested-stacks.html
+    # @option options [Boolean] :retain_except_on_create
+    #   When set to `true`, newly created resources are deleted when the
+    #   operation rolls back. This includes newly created resources marked
+    #   with a deletion policy of `Retain`.
+    #
+    #   Default: `false`
     # @return [Types::CreateStackOutput]
     def create(options = {})
       options = options.merge(stack_name: @name)
-      resp = @client.create_stack(options)
+      resp = Aws::Plugins::UserAgent.metric('RESOURCE_MODEL') do
+        @client.create_stack(options)
+      end
       resp.data
     end
 
@@ -675,34 +731,34 @@ module Aws::CloudFormation
     #     retain_resources: ["LogicalResourceId"],
     #     role_arn: "RoleARN",
     #     client_request_token: "ClientRequestToken",
+    #     deletion_mode: "STANDARD", # accepts STANDARD, FORCE_DELETE_STACK
     #   })
     # @param [Hash] options ({})
     # @option options [Array<String>] :retain_resources
     #   For stacks in the `DELETE_FAILED` state, a list of resource logical
     #   IDs that are associated with the resources you want to retain. During
-    #   deletion, AWS CloudFormation deletes the stack but does not delete the
+    #   deletion, CloudFormation deletes the stack but doesn't delete the
     #   retained resources.
     #
-    #   Retaining resources is useful when you cannot delete a resource, such
+    #   Retaining resources is useful when you can't delete a resource, such
     #   as a non-empty S3 bucket, but you want to delete the stack.
     # @option options [String] :role_arn
-    #   The Amazon Resource Name (ARN) of an AWS Identity and Access
-    #   Management (IAM) role that AWS CloudFormation assumes to delete the
-    #   stack. AWS CloudFormation uses the role's credentials to make calls
-    #   on your behalf.
+    #   The Amazon Resource Name (ARN) of an IAM role that CloudFormation
+    #   assumes to delete the stack. CloudFormation uses the role's
+    #   credentials to make calls on your behalf.
     #
-    #   If you don't specify a value, AWS CloudFormation uses the role that
-    #   was previously associated with the stack. If no role is available, AWS
-    #   CloudFormation uses a temporary session that is generated from your
+    #   If you don't specify a value, CloudFormation uses the role that was
+    #   previously associated with the stack. If no role is available,
+    #   CloudFormation uses a temporary session that's generated from your
     #   user credentials.
     # @option options [String] :client_request_token
     #   A unique identifier for this `DeleteStack` request. Specify this token
-    #   if you plan to retry requests so that AWS CloudFormation knows that
+    #   if you plan to retry requests so that CloudFormation knows that
     #   you're not attempting to delete a stack with the same name. You might
-    #   retry `DeleteStack` requests to ensure that AWS CloudFormation
+    #   retry `DeleteStack` requests to ensure that CloudFormation
     #   successfully received them.
     #
-    #   All events triggered by a given stack operation are assigned the same
+    #   All events initiated by a given stack operation are assigned the same
     #   client request token, which you can use to track operations. For
     #   example, if you execute a `CreateStack` operation with the token
     #   `token1`, then all the `StackEvents` generated by that operation will
@@ -715,10 +771,20 @@ module Aws::CloudFormation
     #   stack using the console, each stack event would be assigned the same
     #   token in the following format:
     #   `Console-CreateStack-7f59c3cf-00d2-40c7-b2ff-e75db0987002`.
+    # @option options [String] :deletion_mode
+    #   Specifies the deletion mode for the stack. Possible values are:
+    #
+    #   * `STANDARD` - Use the standard behavior. Specifying this value is the
+    #     same as not specifying this parameter.
+    #
+    #   * `FORCE_DELETE_STACK` - Delete the stack if it's stuck in a
+    #     `DELETE_FAILED` state due to resource deletion failure.
     # @return [EmptyStructure]
     def delete(options = {})
       options = options.merge(stack_name: @name)
-      resp = @client.delete_stack(options)
+      resp = Aws::Plugins::UserAgent.metric('RESOURCE_MODEL') do
+        @client.delete_stack(options)
+      end
       resp.data
     end
 
@@ -759,33 +825,27 @@ module Aws::CloudFormation
     #         value: "TagValue", # required
     #       },
     #     ],
+    #     disable_rollback: false,
     #     client_request_token: "ClientRequestToken",
+    #     retain_except_on_create: false,
     #   })
     # @param [Hash] options ({})
     # @option options [String] :template_body
     #   Structure containing the template body with a minimum length of 1 byte
-    #   and a maximum length of 51,200 bytes. (For more information, go to
-    #   [Template Anatomy][1] in the AWS CloudFormation User Guide.)
+    #   and a maximum length of 51,200 bytes.
     #
     #   Conditional: You must specify only one of the following parameters:
     #   `TemplateBody`, `TemplateURL`, or set the `UsePreviousTemplate` to
     #   `true`.
-    #
-    #
-    #
-    #   [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html
     # @option options [String] :template_url
-    #   Location of file containing the template body. The URL must point to a
-    #   template that is located in an Amazon S3 bucket. For more information,
-    #   go to [Template Anatomy][1] in the AWS CloudFormation User Guide.
+    #   The URL of a file containing the template body. The URL must point to
+    #   a template that's located in an Amazon S3 bucket or a Systems Manager
+    #   document. The location for an Amazon S3 bucket must start with
+    #   `https://`.
     #
     #   Conditional: You must specify only one of the following parameters:
     #   `TemplateBody`, `TemplateURL`, or set the `UsePreviousTemplate` to
     #   `true`.
-    #
-    #
-    #
-    #   [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html
     # @option options [Boolean] :use_previous_template
     #   Reuse the existing template that is associated with the stack that you
     #   are updating.
@@ -799,18 +859,19 @@ module Aws::CloudFormation
     #   `StackPolicyDuringUpdateURL` parameter, but not both.
     #
     #   If you want to update protected resources, specify a temporary
-    #   overriding stack policy during this update. If you do not specify a
+    #   overriding stack policy during this update. If you don't specify a
     #   stack policy, the current policy that is associated with the stack
     #   will be used.
     # @option options [String] :stack_policy_during_update_url
     #   Location of a file containing the temporary overriding stack policy.
     #   The URL must point to a policy (max size: 16KB) located in an S3
-    #   bucket in the same Region as the stack. You can specify either the
+    #   bucket in the same Region as the stack. The location for an Amazon S3
+    #   bucket must start with `https://`. You can specify either the
     #   `StackPolicyDuringUpdateBody` or the `StackPolicyDuringUpdateURL`
     #   parameter, but not both.
     #
     #   If you want to update protected resources, specify a temporary
-    #   overriding stack policy during this update. If you do not specify a
+    #   overriding stack policy during this update. If you don't specify a
     #   stack policy, the current policy that is associated with the stack
     #   will be used.
     # @option options [Array<Types::Parameter>] :parameters
@@ -822,16 +883,15 @@ module Aws::CloudFormation
     #   [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_Parameter.html
     # @option options [Array<String>] :capabilities
     #   In some cases, you must explicitly acknowledge that your stack
-    #   template contains certain capabilities in order for AWS CloudFormation
-    #   to update the stack.
+    #   template contains certain capabilities in order for CloudFormation to
+    #   update the stack.
     #
     #   * `CAPABILITY_IAM` and `CAPABILITY_NAMED_IAM`
     #
     #     Some stack templates might include resources that can affect
-    #     permissions in your AWS account; for example, by creating new AWS
-    #     Identity and Access Management (IAM) users. For those stacks, you
-    #     must explicitly acknowledge this by specifying one of these
-    #     capabilities.
+    #     permissions in your Amazon Web Services account, for example, by
+    #     creating new IAM users. For those stacks, you must explicitly
+    #     acknowledge this by specifying one of these capabilities.
     #
     #     The following IAM resources require you to specify either the
     #     `CAPABILITY_IAM` or `CAPABILITY_NAMED_IAM` capability.
@@ -841,29 +901,29 @@ module Aws::CloudFormation
     #     * If you have IAM resources with custom names, you *must* specify
     #       `CAPABILITY_NAMED_IAM`.
     #
-    #     * If you don't specify either of these capabilities, AWS
-    #       CloudFormation returns an `InsufficientCapabilities` error.
-    #
-    #     If your stack template contains these resources, we recommend that
-    #     you review all permissions associated with them and edit their
+    #     * If you don't specify either of these capabilities, CloudFormation
+    #       returns an `InsufficientCapabilities` error.
+    #     If your stack template contains these resources, we suggest that you
+    #     review all permissions associated with them and edit their
     #     permissions if necessary.
     #
     #     * [ AWS::IAM::AccessKey][1]
     #
     #     * [ AWS::IAM::Group][2]
     #
-    #     * [ AWS::IAM::InstanceProfile][3]
+    #     * [AWS::IAM::InstanceProfile][3]
     #
-    #     * [ AWS::IAM::Policy][4]
+    #     * [ AWS::IAM::ManagedPolicy][4]
     #
-    #     * [ AWS::IAM::Role][5]
+    #     * [AWS::IAM::Policy][5]
     #
-    #     * [ AWS::IAM::User][6]
+    #     * [ AWS::IAM::Role][6]
     #
-    #     * [ AWS::IAM::UserToGroupAddition][7]
+    #     * [ AWS::IAM::User][7]
     #
-    #     For more information, see [Acknowledging IAM Resources in AWS
-    #     CloudFormation Templates][8].
+    #     * [AWS::IAM::UserToGroupAddition][8]
+    #     For more information, see [Acknowledging IAM resources in
+    #     CloudFormation templates][9].
     #
     #   * `CAPABILITY_AUTO_EXPAND`
     #
@@ -876,70 +936,79 @@ module Aws::CloudFormation
     #     your stack template contains one or more macros, and you choose to
     #     update a stack directly from the processed template, without first
     #     reviewing the resulting changes in a change set, you must
-    #     acknowledge this capability. This includes the [AWS::Include][9] and
-    #     [AWS::Serverless][10] transforms, which are macros hosted by AWS
+    #     acknowledge this capability. This includes the [AWS::Include][10]
+    #     and [AWS::Serverless][11] transforms, which are macros hosted by
     #     CloudFormation.
     #
-    #     Change sets do not currently support nested stacks. If you want to
-    #     update a stack from a stack template that contains macros *and*
-    #     nested stacks, you must update the stack directly from the template
-    #     using this capability.
+    #     If you want to update a stack from a stack template that contains
+    #     macros *and* nested stacks, you must update the stack directly from
+    #     the template using this capability.
     #
     #     You should only update stacks directly from a stack template that
     #     contains macros if you know what processing the macro performs.
     #
     #      Each macro relies on an underlying Lambda service function for
     #     processing stack templates. Be aware that the Lambda function owner
-    #     can update the function operation without AWS CloudFormation being
+    #     can update the function operation without CloudFormation being
     #     notified.
     #
-    #     For more information, see [Using AWS CloudFormation Macros to
-    #     Perform Custom Processing on Templates][11].
+    #     For more information, see [Perform custom processing on
+    #     CloudFormation templates with template macros][12].
     #
+    #   <note markdown="1"> Only one of the `Capabilities` and `ResourceType` parameters can be
+    #   specified.
     #
+    #    </note>
     #
-    #   [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-accesskey.html
-    #   [2]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-group.html
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-accesskey.html
+    #   [2]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-group.html
     #   [3]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-instanceprofile.html
-    #   [4]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-policy.html
-    #   [5]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-role.html
-    #   [6]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-user.html
-    #   [7]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-addusertogroup.html
-    #   [8]: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html#capabilities
-    #   [9]: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/create-reusable-transform-function-snippets-and-add-to-your-template-with-aws-include-transform.html
-    #   [10]: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/transform-aws-serverless.html
-    #   [11]: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-macros.html
+    #   [4]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-managedpolicy.html
+    #   [5]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-policy.html
+    #   [6]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-role.html
+    #   [7]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-user.html
+    #   [8]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-usertogroupaddition.html
+    #   [9]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/control-access-with-iam.html#using-iam-capabilities
+    #   [10]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/transform-aws-include.html
+    #   [11]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/transform-aws-serverless.html
+    #   [12]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-macros.html
     # @option options [Array<String>] :resource_types
     #   The template resource types that you have permissions to work with for
     #   this update stack action, such as `AWS::EC2::Instance`, `AWS::EC2::*`,
     #   or `Custom::MyCustomInstance`.
     #
     #   If the list of resource types doesn't include a resource that you're
-    #   updating, the stack update fails. By default, AWS CloudFormation
-    #   grants permissions to all resource types. AWS Identity and Access
-    #   Management (IAM) uses this parameter for AWS CloudFormation-specific
-    #   condition keys in IAM policies. For more information, see [Controlling
-    #   Access with AWS Identity and Access Management][1].
+    #   updating, the stack update fails. By default, CloudFormation grants
+    #   permissions to all resource types. IAM uses this parameter for
+    #   CloudFormation-specific condition keys in IAM policies. For more
+    #   information, see [Control access with Identity and Access
+    #   Management][1].
+    #
+    #   <note markdown="1"> Only one of the `Capabilities` and `ResourceType` parameters can be
+    #   specified.
+    #
+    #    </note>
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html
+    #   [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/control-access-with-iam.html
     # @option options [String] :role_arn
-    #   The Amazon Resource Name (ARN) of an AWS Identity and Access
-    #   Management (IAM) role that AWS CloudFormation assumes to update the
-    #   stack. AWS CloudFormation uses the role's credentials to make calls
-    #   on your behalf. AWS CloudFormation always uses this role for all
-    #   future operations on the stack. As long as users have permission to
-    #   operate on the stack, AWS CloudFormation uses this role even if the
-    #   users don't have permission to pass it. Ensure that the role grants
-    #   least privilege.
-    #
-    #   If you don't specify a value, AWS CloudFormation uses the role that
-    #   was previously associated with the stack. If no role is available, AWS
+    #   The Amazon Resource Name (ARN) of an IAM role that CloudFormation
+    #   assumes to update the stack. CloudFormation uses the role's
+    #   credentials to make calls on your behalf. CloudFormation always uses
+    #   this role for all future operations on the stack. Provided that users
+    #   have permission to operate on the stack, CloudFormation uses this role
+    #   even if the users don't have permission to pass it. Ensure that the
+    #   role grants least privilege.
+    #
+    #   If you don't specify a value, CloudFormation uses the role that was
+    #   previously associated with the stack. If no role is available,
     #   CloudFormation uses a temporary session that is generated from your
     #   user credentials.
     # @option options [Types::RollbackConfiguration] :rollback_configuration
-    #   The rollback triggers for AWS CloudFormation to monitor during stack
+    #   The rollback triggers for CloudFormation to monitor during stack
     #   creation and updating operations, and for the specified monitoring
     #   period afterwards.
     # @option options [String] :stack_policy_body
@@ -947,36 +1016,42 @@ module Aws::CloudFormation
     #   the `StackPolicyBody` or the `StackPolicyURL` parameter, but not both.
     #
     #   You might update the stack policy, for example, in order to protect a
-    #   new resource that you created during a stack update. If you do not
+    #   new resource that you created during a stack update. If you don't
     #   specify a stack policy, the current policy that is associated with the
     #   stack is unchanged.
     # @option options [String] :stack_policy_url
     #   Location of a file containing the updated stack policy. The URL must
     #   point to a policy (max size: 16KB) located in an S3 bucket in the same
-    #   Region as the stack. You can specify either the `StackPolicyBody` or
-    #   the `StackPolicyURL` parameter, but not both.
+    #   Region as the stack. The location for an Amazon S3 bucket must start
+    #   with `https://`. You can specify either the `StackPolicyBody` or the
+    #   `StackPolicyURL` parameter, but not both.
     #
     #   You might update the stack policy, for example, in order to protect a
-    #   new resource that you created during a stack update. If you do not
+    #   new resource that you created during a stack update. If you don't
     #   specify a stack policy, the current policy that is associated with the
     #   stack is unchanged.
     # @option options [Array<String>] :notification_arns
     #   Amazon Simple Notification Service topic Amazon Resource Names (ARNs)
-    #   that AWS CloudFormation associates with the stack. Specify an empty
-    #   list to remove all notification topics.
+    #   that CloudFormation associates with the stack. Specify an empty list
+    #   to remove all notification topics.
     # @option options [Array<Types::Tag>] :tags
-    #   Key-value pairs to associate with this stack. AWS CloudFormation also
+    #   Key-value pairs to associate with this stack. CloudFormation also
     #   propagates these tags to supported resources in the stack. You can
     #   specify a maximum number of 50 tags.
     #
-    #   If you don't specify this parameter, AWS CloudFormation doesn't
-    #   modify the stack's tags. If you specify an empty value, AWS
-    #   CloudFormation removes all associated tags.
+    #   If you don't specify this parameter, CloudFormation doesn't modify
+    #   the stack's tags. If you specify an empty value, CloudFormation
+    #   removes all associated tags.
+    # @option options [Boolean] :disable_rollback
+    #   Preserve the state of previously provisioned resources when an
+    #   operation fails.
+    #
+    #   Default: `False`
     # @option options [String] :client_request_token
     #   A unique identifier for this `UpdateStack` request. Specify this token
-    #   if you plan to retry requests so that AWS CloudFormation knows that
+    #   if you plan to retry requests so that CloudFormation knows that
     #   you're not attempting to update a stack with the same name. You might
-    #   retry `UpdateStack` requests to ensure that AWS CloudFormation
+    #   retry `UpdateStack` requests to ensure that CloudFormation
     #   successfully received them.
     #
     #   All events triggered by a given stack operation are assigned the same
@@ -992,10 +1067,18 @@ module Aws::CloudFormation
     #   stack using the console, each stack event would be assigned the same
     #   token in the following format:
     #   `Console-CreateStack-7f59c3cf-00d2-40c7-b2ff-e75db0987002`.
+    # @option options [Boolean] :retain_except_on_create
+    #   When set to `true`, newly created resources are deleted when the
+    #   operation rolls back. This includes newly created resources marked
+    #   with a deletion policy of `Retain`.
+    #
+    #   Default: `false`
     # @return [Types::UpdateStackOutput]
     def update(options = {})
       options = options.merge(stack_name: @name)
-      resp = @client.update_stack(options)
+      resp = Aws::Plugins::UserAgent.metric('RESOURCE_MODEL') do
+        @client.update_stack(options)
+      end
       resp.data
     end
 
@@ -1009,7 +1092,9 @@ module Aws::CloudFormation
     def events(options = {})
       batches = Enumerator.new do |y|
         options = options.merge(stack_name: @name)
-        resp = @client.describe_stack_events(options)
+        resp = Aws::Plugins::UserAgent.metric('RESOURCE_MODEL') do
+          @client.describe_stack_events(options)
+        end
         resp.each_page do |page|
           batch = []
           page.data.stack_events.each do |s|
@@ -1043,7 +1128,9 @@ module Aws::CloudFormation
     def resource_summaries(options = {})
       batches = Enumerator.new do |y|
         options = options.merge(stack_name: @name)
-        resp = @client.list_stack_resources(options)
+        resp = Aws::Plugins::UserAgent.metric('RESOURCE_MODEL') do
+          @client.list_stack_resources(options)
+        end
         resp.each_page do |page|
           batch = []
           page.data.stack_resource_summaries.each do |s|