aws-sdk-cloudformation 1.65.0 → 1.68.0

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

@@ -47,6 +47,11 @@ module Aws::CloudFormation
     CausingEntity = Shapes::StringShape.new(name: 'CausingEntity')
     Change = Shapes::StructureShape.new(name: 'Change')
     ChangeAction = Shapes::StringShape.new(name: 'ChangeAction')
+    ChangeSetHook = Shapes::StructureShape.new(name: 'ChangeSetHook')
+    ChangeSetHookResourceTargetDetails = Shapes::StructureShape.new(name: 'ChangeSetHookResourceTargetDetails')
+    ChangeSetHookTargetDetails = Shapes::StructureShape.new(name: 'ChangeSetHookTargetDetails')
+    ChangeSetHooks = Shapes::ListShape.new(name: 'ChangeSetHooks')
+    ChangeSetHooksStatus = Shapes::StringShape.new(name: 'ChangeSetHooksStatus')
     ChangeSetId = Shapes::StringShape.new(name: 'ChangeSetId')
     ChangeSetName = Shapes::StringShape.new(name: 'ChangeSetName')
     ChangeSetNameOrId = Shapes::StringShape.new(name: 'ChangeSetNameOrId')
@@ -91,6 +96,8 @@ module Aws::CloudFormation
     DeregisterTypeOutput = Shapes::StructureShape.new(name: 'DeregisterTypeOutput')
     DescribeAccountLimitsInput = Shapes::StructureShape.new(name: 'DescribeAccountLimitsInput')
     DescribeAccountLimitsOutput = Shapes::StructureShape.new(name: 'DescribeAccountLimitsOutput')
+    DescribeChangeSetHooksInput = Shapes::StructureShape.new(name: 'DescribeChangeSetHooksInput')
+    DescribeChangeSetHooksOutput = Shapes::StructureShape.new(name: 'DescribeChangeSetHooksOutput')
     DescribeChangeSetInput = Shapes::StructureShape.new(name: 'DescribeChangeSetInput')
     DescribeChangeSetOutput = Shapes::StructureShape.new(name: 'DescribeChangeSetOutput')
     DescribePublisherInput = Shapes::StructureShape.new(name: 'DescribePublisherInput')
@@ -152,6 +159,17 @@ module Aws::CloudFormation
     GetTemplateSummaryInput = Shapes::StructureShape.new(name: 'GetTemplateSummaryInput')
     GetTemplateSummaryOutput = Shapes::StructureShape.new(name: 'GetTemplateSummaryOutput')
     HandlerErrorCode = Shapes::StringShape.new(name: 'HandlerErrorCode')
+    HookFailureMode = Shapes::StringShape.new(name: 'HookFailureMode')
+    HookInvocationCount = Shapes::IntegerShape.new(name: 'HookInvocationCount')
+    HookInvocationPoint = Shapes::StringShape.new(name: 'HookInvocationPoint')
+    HookStatus = Shapes::StringShape.new(name: 'HookStatus')
+    HookStatusReason = Shapes::StringShape.new(name: 'HookStatusReason')
+    HookTargetType = Shapes::StringShape.new(name: 'HookTargetType')
+    HookTargetTypeName = Shapes::StringShape.new(name: 'HookTargetTypeName')
+    HookType = Shapes::StringShape.new(name: 'HookType')
+    HookTypeConfigurationVersionId = Shapes::StringShape.new(name: 'HookTypeConfigurationVersionId')
+    HookTypeName = Shapes::StringShape.new(name: 'HookTypeName')
+    HookTypeVersionId = Shapes::StringShape.new(name: 'HookTypeVersionId')
     IdentityProvider = Shapes::StringShape.new(name: 'IdentityProvider')
     ImportStacksToStackSetInput = Shapes::StructureShape.new(name: 'ImportStacksToStackSetInput')
     ImportStacksToStackSetOutput = Shapes::StructureShape.new(name: 'ImportStacksToStackSetOutput')
@@ -514,9 +532,29 @@ module Aws::CloudFormation
     Capabilities.member = Shapes::ShapeRef.new(shape: Capability)
 
     Change.add_member(:type, Shapes::ShapeRef.new(shape: ChangeType, location_name: "Type"))
+    Change.add_member(:hook_invocation_count, Shapes::ShapeRef.new(shape: HookInvocationCount, location_name: "HookInvocationCount"))
     Change.add_member(:resource_change, Shapes::ShapeRef.new(shape: ResourceChange, location_name: "ResourceChange"))
     Change.struct_class = Types::Change
 
+    ChangeSetHook.add_member(:invocation_point, Shapes::ShapeRef.new(shape: HookInvocationPoint, location_name: "InvocationPoint"))
+    ChangeSetHook.add_member(:failure_mode, Shapes::ShapeRef.new(shape: HookFailureMode, location_name: "FailureMode"))
+    ChangeSetHook.add_member(:type_name, Shapes::ShapeRef.new(shape: HookTypeName, location_name: "TypeName"))
+    ChangeSetHook.add_member(:type_version_id, Shapes::ShapeRef.new(shape: HookTypeVersionId, location_name: "TypeVersionId"))
+    ChangeSetHook.add_member(:type_configuration_version_id, Shapes::ShapeRef.new(shape: HookTypeConfigurationVersionId, location_name: "TypeConfigurationVersionId"))
+    ChangeSetHook.add_member(:target_details, Shapes::ShapeRef.new(shape: ChangeSetHookTargetDetails, location_name: "TargetDetails"))
+    ChangeSetHook.struct_class = Types::ChangeSetHook
+
+    ChangeSetHookResourceTargetDetails.add_member(:logical_resource_id, Shapes::ShapeRef.new(shape: LogicalResourceId, location_name: "LogicalResourceId"))
+    ChangeSetHookResourceTargetDetails.add_member(:resource_type, Shapes::ShapeRef.new(shape: HookTargetTypeName, location_name: "ResourceType"))
+    ChangeSetHookResourceTargetDetails.add_member(:resource_action, Shapes::ShapeRef.new(shape: ChangeAction, location_name: "ResourceAction"))
+    ChangeSetHookResourceTargetDetails.struct_class = Types::ChangeSetHookResourceTargetDetails
+
+    ChangeSetHookTargetDetails.add_member(:target_type, Shapes::ShapeRef.new(shape: HookTargetType, location_name: "TargetType"))
+    ChangeSetHookTargetDetails.add_member(:resource_target_details, Shapes::ShapeRef.new(shape: ChangeSetHookResourceTargetDetails, location_name: "ResourceTargetDetails"))
+    ChangeSetHookTargetDetails.struct_class = Types::ChangeSetHookTargetDetails
+
+    ChangeSetHooks.member = Shapes::ShapeRef.new(shape: ChangeSetHook)
+
     ChangeSetNotFoundException.struct_class = Types::ChangeSetNotFoundException
 
     ChangeSetSummaries.member = Shapes::ShapeRef.new(shape: ChangeSetSummary)
@@ -683,6 +721,21 @@ module Aws::CloudFormation
     DescribeAccountLimitsOutput.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "NextToken"))
     DescribeAccountLimitsOutput.struct_class = Types::DescribeAccountLimitsOutput
 
+    DescribeChangeSetHooksInput.add_member(:change_set_name, Shapes::ShapeRef.new(shape: ChangeSetNameOrId, required: true, location_name: "ChangeSetName"))
+    DescribeChangeSetHooksInput.add_member(:stack_name, Shapes::ShapeRef.new(shape: StackNameOrId, location_name: "StackName"))
+    DescribeChangeSetHooksInput.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "NextToken"))
+    DescribeChangeSetHooksInput.add_member(:logical_resource_id, Shapes::ShapeRef.new(shape: LogicalResourceId, location_name: "LogicalResourceId"))
+    DescribeChangeSetHooksInput.struct_class = Types::DescribeChangeSetHooksInput
+
+    DescribeChangeSetHooksOutput.add_member(:change_set_id, Shapes::ShapeRef.new(shape: ChangeSetId, location_name: "ChangeSetId"))
+    DescribeChangeSetHooksOutput.add_member(:change_set_name, Shapes::ShapeRef.new(shape: ChangeSetName, location_name: "ChangeSetName"))
+    DescribeChangeSetHooksOutput.add_member(:hooks, Shapes::ShapeRef.new(shape: ChangeSetHooks, location_name: "Hooks"))
+    DescribeChangeSetHooksOutput.add_member(:status, Shapes::ShapeRef.new(shape: ChangeSetHooksStatus, location_name: "Status"))
+    DescribeChangeSetHooksOutput.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "NextToken"))
+    DescribeChangeSetHooksOutput.add_member(:stack_id, Shapes::ShapeRef.new(shape: StackId, location_name: "StackId"))
+    DescribeChangeSetHooksOutput.add_member(:stack_name, Shapes::ShapeRef.new(shape: StackName, location_name: "StackName"))
+    DescribeChangeSetHooksOutput.struct_class = Types::DescribeChangeSetHooksOutput
+
     DescribeChangeSetInput.add_member(:change_set_name, Shapes::ShapeRef.new(shape: ChangeSetNameOrId, required: true, location_name: "ChangeSetName"))
     DescribeChangeSetInput.add_member(:stack_name, Shapes::ShapeRef.new(shape: StackNameOrId, location_name: "StackName"))
     DescribeChangeSetInput.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "NextToken"))
@@ -1326,6 +1379,11 @@ module Aws::CloudFormation
     StackEvent.add_member(:resource_status_reason, Shapes::ShapeRef.new(shape: ResourceStatusReason, location_name: "ResourceStatusReason"))
     StackEvent.add_member(:resource_properties, Shapes::ShapeRef.new(shape: ResourceProperties, location_name: "ResourceProperties"))
     StackEvent.add_member(:client_request_token, Shapes::ShapeRef.new(shape: ClientRequestToken, location_name: "ClientRequestToken"))
+    StackEvent.add_member(:hook_type, Shapes::ShapeRef.new(shape: HookType, location_name: "HookType"))
+    StackEvent.add_member(:hook_status, Shapes::ShapeRef.new(shape: HookStatus, location_name: "HookStatus"))
+    StackEvent.add_member(:hook_status_reason, Shapes::ShapeRef.new(shape: HookStatusReason, location_name: "HookStatusReason"))
+    StackEvent.add_member(:hook_invocation_point, Shapes::ShapeRef.new(shape: HookInvocationPoint, location_name: "HookInvocationPoint"))
+    StackEvent.add_member(:hook_failure_mode, Shapes::ShapeRef.new(shape: HookFailureMode, location_name: "HookFailureMode"))
     StackEvent.struct_class = Types::StackEvent
 
     StackEvents.member = Shapes::ShapeRef.new(shape: StackEvent)
@@ -1907,6 +1965,15 @@ module Aws::CloudFormation
         o.errors << Shapes::ShapeRef.new(shape: ChangeSetNotFoundException)
       end)
 
+      api.add_operation(:describe_change_set_hooks, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "DescribeChangeSetHooks"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: DescribeChangeSetHooksInput)
+        o.output = Shapes::ShapeRef.new(shape: DescribeChangeSetHooksOutput)
+        o.errors << Shapes::ShapeRef.new(shape: ChangeSetNotFoundException)
+      end)
+
       api.add_operation(:describe_publisher, Seahorse::Model::Operation.new.tap do |o|
         o.name = "DescribePublisher"
         o.http_method = "POST"

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

@@ -115,6 +115,42 @@ module Aws::CloudFormation
       data[:client_request_token]
     end
 
+    # The name of the hook.
+    # @return [String]
+    def hook_type
+      data[:hook_type]
+    end
+
+    # Provides the status of the change set hook.
+    # @return [String]
+    def hook_status
+      data[:hook_status]
+    end
+
+    # Provides the reason for the hook status.
+    # @return [String]
+    def hook_status_reason
+      data[:hook_status_reason]
+    end
+
+    # Invocation points are points in provisioning logic where hooks are
+    # initiated.
+    # @return [String]
+    def hook_invocation_point
+      data[:hook_invocation_point]
+    end
+
+    # Specify the hook failure mode for non-compliant resources in the
+    # followings ways.
+    #
+    # * `FAIL` Stops provisioning resources.
+    #
+    # * `WARN` Allows provisioning to continue with a warning message.
+    # @return [String]
+    def hook_failure_mode
+      data[:hook_failure_mode]
+    end
+
     # @!endgroup
 
     # @return [Client]

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

@@ -78,18 +78,18 @@ module Aws::CloudFormation
     #   })
     # @param [Hash] options ({})
     # @option options [required, String] :stack_name
-    #   The name that is associated with the stack. The name must be unique in
+    #   The name that's associated with the stack. The name must be unique in
     #   the Region in which you are creating the stack.
     #
     #   <note markdown="1"> A stack name can contain only alphanumeric characters (case sensitive)
-    #   and hyphens. It must start with an alphabetical character and cannot
+    #   and hyphens. It must start with an alphabetical character and can't
     #   be longer than 128 characters.
     #
     #    </note>
     # @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 CloudFormation User Guide.
+    #   [Template anatomy][1] in the CloudFormation User Guide.
     #
     #   Conditional: You must specify either the `TemplateBody` or the
     #   `TemplateURL` parameter, but not both.
@@ -99,9 +99,9 @@ module Aws::CloudFormation
     #   [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
+    #   template (max size: 460,800 bytes) that's located in an Amazon S3
     #   bucket or a Systems Manager document. For more information, go to the
-    #   [Template Anatomy][1] in the CloudFormation User Guide.
+    #   [Template anatomy][1] in the CloudFormation User Guide.
     #
     #   Conditional: You must specify either the `TemplateBody` or the
     #   `TemplateURL` parameter, but not both.
@@ -131,9 +131,9 @@ module Aws::CloudFormation
     #   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 Simple Notification Service (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 CloudFormation to
@@ -166,7 +166,7 @@ module Aws::CloudFormation
     #
     #     * [ AWS::IAM::Group][2]
     #
-    #     * [ AWS::IAM::InstanceProfile][3]
+    #     * [AWS::IAM::InstanceProfile][3]
     #
     #     * [ AWS::IAM::Policy][4]
     #
@@ -174,7 +174,7 @@ module Aws::CloudFormation
     #
     #     * [ AWS::IAM::User][6]
     #
-    #     * [ AWS::IAM::UserToGroupAddition][7]
+    #     * [AWS::IAM::UserToGroupAddition][7]
     #
     #     For more information, see [Acknowledging IAM Resources in
     #     CloudFormation Templates][8].
@@ -206,8 +206,8 @@ module Aws::CloudFormation
     #     can update the function operation without CloudFormation being
     #     notified.
     #
-    #     For more information, see [Using CloudFormation Macros to Perform
-    #     Custom Processing on Templates][11].
+    #     For more information, see [Using CloudFormation macros to perform
+    #     custom processing on templates][11].
     #
     #
     #
@@ -248,17 +248,17 @@ module Aws::CloudFormation
     #   (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. As long as users have permission to operate on the
+    #   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
+    #   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`
@@ -287,7 +287,7 @@ module 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
@@ -305,11 +305,11 @@ module Aws::CloudFormation
     #   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
-    #   *CloudFormation User Guide*. Termination protection is disabled on
+    #   *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.
     #
     #
     #
@@ -351,8 +351,8 @@ module Aws::CloudFormation
     #   })
     # @param [Hash] options ({})
     # @option options [String] :stack_name
-    #   The name or the unique stack ID that is associated with the stack,
-    #   which are not always interchangeable:
+    #   The name or the unique stack ID that's associated with the stack,
+    #   which aren't always interchangeable:
     #
     #   * Running stacks: You can specify either the stack's name or its
     #     unique stack ID.

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

@@ -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]
@@ -133,7 +134,7 @@ module Aws::CloudFormation
     end
 
     # The Amazon Resource Name (ARN) of an Identity and Access Management
-    # (IAM) role that is associated with the stack. During a stack
+    # (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]
@@ -435,7 +436,7 @@ module Aws::CloudFormation
     # @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 CloudFormation User Guide.
+    #   [Template anatomy][1] in the CloudFormation User Guide.
     #
     #   Conditional: You must specify either the `TemplateBody` or the
     #   `TemplateURL` parameter, but not both.
@@ -445,9 +446,9 @@ module Aws::CloudFormation
     #   [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
+    #   template (max size: 460,800 bytes) that's located in an Amazon S3
     #   bucket or a Systems Manager document. For more information, go to the
-    #   [Template Anatomy][1] in the CloudFormation User Guide.
+    #   [Template anatomy][1] in the CloudFormation User Guide.
     #
     #   Conditional: You must specify either the `TemplateBody` or the
     #   `TemplateURL` parameter, but not both.
@@ -477,9 +478,9 @@ module Aws::CloudFormation
     #   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 Simple Notification Service (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 CloudFormation to
@@ -512,7 +513,7 @@ module Aws::CloudFormation
     #
     #     * [ AWS::IAM::Group][2]
     #
-    #     * [ AWS::IAM::InstanceProfile][3]
+    #     * [AWS::IAM::InstanceProfile][3]
     #
     #     * [ AWS::IAM::Policy][4]
     #
@@ -520,7 +521,7 @@ module Aws::CloudFormation
     #
     #     * [ AWS::IAM::User][6]
     #
-    #     * [ AWS::IAM::UserToGroupAddition][7]
+    #     * [AWS::IAM::UserToGroupAddition][7]
     #
     #     For more information, see [Acknowledging IAM Resources in
     #     CloudFormation Templates][8].
@@ -552,8 +553,8 @@ module Aws::CloudFormation
     #     can update the function operation without CloudFormation being
     #     notified.
     #
-    #     For more information, see [Using CloudFormation Macros to Perform
-    #     Custom Processing on Templates][11].
+    #     For more information, see [Using CloudFormation macros to perform
+    #     custom processing on templates][11].
     #
     #
     #
@@ -594,17 +595,17 @@ module Aws::CloudFormation
     #   (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. As long as users have permission to operate on the
+    #   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
+    #   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`
@@ -633,7 +634,7 @@ module 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,11 +652,11 @@ module Aws::CloudFormation
     #   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
-    #   *CloudFormation User Guide*. Termination protection is disabled on
+    #   *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.
     #
     #
     #
@@ -679,10 +680,10 @@ module Aws::CloudFormation
     # @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, 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 Identity and Access Management
@@ -692,7 +693,7 @@ module Aws::CloudFormation
     #
     #   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
+    #   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
@@ -701,7 +702,7 @@ module 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
@@ -776,7 +777,7 @@ module Aws::CloudFormation
     #   [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 or a Systems Manager
+    #   template that's located in an Amazon S3 bucket or a Systems Manager
     #   document. For more information, go to [Template Anatomy][1] in the
     #   CloudFormation User Guide.
     #
@@ -853,7 +854,7 @@ module Aws::CloudFormation
     #
     #     * [ AWS::IAM::Group][2]
     #
-    #     * [ AWS::IAM::InstanceProfile][3]
+    #     * [AWS::IAM::InstanceProfile][3]
     #
     #     * [ AWS::IAM::Policy][4]
     #
@@ -861,7 +862,7 @@ module Aws::CloudFormation
     #
     #     * [ AWS::IAM::User][6]
     #
-    #     * [ AWS::IAM::UserToGroupAddition][7]
+    #     * [AWS::IAM::UserToGroupAddition][7]
     #
     #     For more information, see [Acknowledging IAM Resources in
     #     CloudFormation Templates][8].
@@ -929,7 +930,7 @@ module Aws::CloudFormation
     #   (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. As long as users have permission to operate on the
+    #   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.
     #
@@ -946,7 +947,7 @@ 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
@@ -956,7 +957,7 @@ module Aws::CloudFormation
     #   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

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

@@ -56,8 +56,8 @@ module Aws::CloudFormation
       data[:physical_resource_id]
     end
 
-    # Type of resource. ((For more information, go to [Amazon Web Services
-    # Resource Types Reference][1] in the CloudFormation User Guide.)
+    # Type of resource. For more information, go to [Amazon Web Services
+    # Resource Types Reference][1] in the CloudFormation User Guide.
     #
     #
     #