aws-sdk-cloudformation 1.0.0.rc2 → 1.0.0.rc3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 059c7f26a85a3d4e31f17d36feb3c026c17019fd
-  data.tar.gz: b5ca64bd857e406dbdd7f596a7caf27ffe0026e3
+  metadata.gz: 9d0ccd7fd0851980334f9cfeaf3d4a58f28e0efa
+  data.tar.gz: b28a547465776c8c25564a94d648bc7a77f0788a
 SHA512:
-  metadata.gz: de31aac45bedd1b559df2c33d39e6f6ad326bc11a865e9923df619955fac7779befb7605bde0838a9af7a6a6102d8f8e060254c0ca6ee155d0d41b9ef65e1c49
-  data.tar.gz: 5693763247b0fc7006dc50a6b4d182766c26c3d53863985545dffe6b5559f5a8b1b753c6f5d91fc6a1230356a8e599870d2a5802659e372d82e2a62ace8f064d
+  metadata.gz: 29e14964fe6b4e438ebea8ae094e14a247cdc87962d6a83ef947730c571775515b6d7cd3c5aae1fb59e4fc7611da10ccfb7e2c2718937779ca72332361117480
+  data.tar.gz: 0d051aacded4a91b0760c1d5e3ebca3f87e728aeef463a7996a9f4d4f9bac118e03a0f4fe75c1fa2f591d6c93127b99c7dbac594cbc47c6f3891928f9f1dcce9

data/lib/aws-sdk-cloudformation.rb

@@ -47,6 +47,6 @@ require_relative 'aws-sdk-cloudformation/customizations'
 # @service
 module Aws::CloudFormation
 
-  GEM_VERSION = '1.0.0.rc2'
+  GEM_VERSION = '1.0.0.rc3'
 
 end

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

@@ -156,12 +156,20 @@ module Aws::CloudFormation
     # @option params [required, String] :stack_name
     #   The name or the unique stack ID that is associated with the stack.
     #
+    # @option params [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.
+    #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
     # @example Request syntax with placeholder values
     #
     #   resp = client.cancel_update_stack({
     #     stack_name: "StackName", # required
+    #     client_request_token: "ClientRequestToken",
     #   })
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CancelUpdateStack AWS API Documentation
@@ -245,15 +253,22 @@ module Aws::CloudFormation
     #   to skip the dependent resources.
     #
     #   To specify resources in a nested stack, use the following format:
-    #   `NestedStackName.ResourceLogicalID`. You can specify a nested stack
-    #   resource (the logical ID of an `AWS::CloudFormation::Stack` resource)
-    #   only if it's in one of the following states: `DELETE_IN_PROGRESS`,
-    #   `DELETE_COMPLETE`, or `DELETE_FAILED`.
+    #   `NestedStackName.ResourceLogicalID`. If the `ResourceLogicalID` is a
+    #   stack resource (`Type: AWS::CloudFormation::Stack`), it must be in one
+    #   of the following states: `DELETE_IN_PROGRESS`, `DELETE_COMPLETE`, or
+    #   `DELETE_FAILED`.
     #
     #
     #
     #   [1]: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/troubleshooting.html#troubleshooting-errors-update-rollback-failed
     #
+    # @option params [String] :client_request_token
+    #   A unique identifier for this `ContinueUpdateRollback` request. Specify
+    #   this token if you plan to retry requests so that AWS CloudFormation
+    #   knows that you're not attempting to continue the rollback to a stack
+    #   with the same name. You might retry `ContinueUpdateRollback` requests
+    #   to ensure that AWS CloudFormation successfully received them.
+    #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
     # @example Request syntax with placeholder values
@@ -262,6 +277,7 @@ module Aws::CloudFormation
     #     stack_name: "StackNameOrId", # required
     #     role_arn: "RoleARN",
     #     resources_to_skip: ["ResourceToSkip"],
+    #     client_request_token: "ClientRequestToken",
     #   })
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/ContinueUpdateRollback AWS API Documentation
@@ -273,21 +289,28 @@ module Aws::CloudFormation
       req.send_request(options)
     end
 
-    # Creates a list of changes for a stack. AWS CloudFormation generates
-    # the change set by comparing the template's information with the
-    # information that you submit. A change set can help you understand
-    # which resources AWS CloudFormation will change, and how it will change
-    # them, before you update your stack. Change sets allow you to check
-    # before making a change to avoid deleting or replacing critical
-    # resources.
-    #
-    # AWS CloudFormation doesn't make any changes to the stack when you
-    # create a change set. To make the specified changes, you must execute
-    # the change set by using the ExecuteChangeSet action.
-    #
-    # After the call successfully completes, AWS CloudFormation starts
-    # creating the change set. To check the status of the change set, use
-    # the DescribeChangeSet action.
+    # Creates a list of changes that will be applied to a stack so that you
+    # can review the changes before executing them. You can create a change
+    # set for a stack that doesn't exist or an existing stack. If you
+    # create a change set for a stack that doesn't exist, the change set
+    # shows all of the resources that AWS CloudFormation will create. If you
+    # create a change set for an existing stack, AWS CloudFormation compares
+    # the stack's information with the information that you submit in the
+    # change set and lists the differences. Use change sets to understand
+    # which resources AWS CloudFormation will create or change, and how it
+    # will change resources in an existing stack, before you create or
+    # update a stack.
+    #
+    # To create a change set for a stack that doesn't exist, for the
+    # `ChangeSetType` parameter, specify `CREATE`. To create a change set
+    # for an existing stack, specify `UPDATE` for the `ChangeSetType`
+    # parameter. After the `CreateChangeSet` call successfully completes,
+    # AWS CloudFormation starts creating the change set. To check the status
+    # of the change set or to review it, use the DescribeChangeSet action.
+    #
+    # When you are satisfied with the changes the change set will make,
+    # execute the change set by using the ExecuteChangeSet action. AWS
+    # CloudFormation doesn't make changes until you execute the change set.
     #
     # @option params [required, String] :stack_name
     #   The name or the unique ID of the stack for which you are creating a
@@ -547,12 +570,8 @@ module Aws::CloudFormation
     #
     # @option params [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][1] or your Command Line Interface (CLI).
-    #
-    #
-    #
-    #   [1]: https://console.aws.amazon.com/sns
+    #   related events. You can find your SNS topic ARNs using the SNS console
+    #   or your Command Line Interface (CLI).
     #
     # @option params [Array<String>] :capabilities
     #   A list of values that you must specify before AWS CloudFormation can
@@ -654,6 +673,13 @@ module Aws::CloudFormation
     #   propagates these tags to the resources created in the stack. A maximum
     #   number of 10 tags can be specified.
     #
+    # @option params [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
+    #   you're not attempting to create a stack with the same name. You might
+    #   retry `CreateStack` requests to ensure that AWS CloudFormation
+    #   successfully received them.
+    #
     # @return [Types::CreateStackOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::CreateStackOutput#stack_id #stack_id} => String
@@ -686,6 +712,7 @@ module Aws::CloudFormation
     #         value: "TagValue",
     #       },
     #     ],
+    #     client_request_token: "ClientRequestToken",
     #   })
     #
     # @example Response structure
@@ -760,6 +787,13 @@ module Aws::CloudFormation
     #   CloudFormation uses a temporary session that is generated from your
     #   user credentials.
     #
+    # @option params [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
+    #   you're not attempting to delete a stack with the same name. You might
+    #   retry `DeleteStack` requests to ensure that AWS CloudFormation
+    #   successfully received them.
+    #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
     # @example Request syntax with placeholder values
@@ -768,6 +802,7 @@ module Aws::CloudFormation
     #     stack_name: "StackName", # required
     #     retain_resources: ["LogicalResourceId"],
     #     role_arn: "RoleARN",
+    #     client_request_token: "ClientRequestToken",
     #   })
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/DeleteStack AWS API Documentation
@@ -962,6 +997,7 @@ module Aws::CloudFormation
     #   resp.stack_events[0].resource_status #=> String, one of "CREATE_IN_PROGRESS", "CREATE_FAILED", "CREATE_COMPLETE", "DELETE_IN_PROGRESS", "DELETE_FAILED", "DELETE_COMPLETE", "DELETE_SKIPPED", "UPDATE_IN_PROGRESS", "UPDATE_FAILED", "UPDATE_COMPLETE"
     #   resp.stack_events[0].resource_status_reason #=> String
     #   resp.stack_events[0].resource_properties #=> String
+    #   resp.stack_events[0].client_request_token #=> String
     #   resp.next_token #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/DescribeStackEvents AWS API Documentation
@@ -1282,6 +1318,13 @@ module Aws::CloudFormation
     #   If you specified the name of a change set, specify the stack name or
     #   ID (ARN) that is associated with the change set you want to execute.
     #
+    # @option params [String] :client_request_token
+    #   A unique identifier for this `ExecuteChangeSet` request. Specify this
+    #   token if you plan to retry requests so that AWS CloudFormation knows
+    #   that you're not attempting to execute a change set to update a stack
+    #   with the same name. You might retry `ExecuteChangeSet` requests to
+    #   ensure that AWS CloudFormation successfully received them.
+    #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
     # @example Request syntax with placeholder values
@@ -1289,6 +1332,7 @@ module Aws::CloudFormation
     #   resp = client.execute_change_set({
     #     change_set_name: "ChangeSetNameOrId", # required
     #     stack_name: "StackNameOrId",
+    #     client_request_token: "ClientRequestToken",
     #   })
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/ExecuteChangeSet AWS API Documentation
@@ -1845,8 +1889,9 @@ module Aws::CloudFormation
     #   and a maximum length of 51,200 bytes. (For more information, go to
     #   [Template Anatomy][1] in the AWS CloudFormation User Guide.)
     #
-    #   Conditional: You must specify either the `TemplateBody` or the
-    #   `TemplateURL` parameter, but not both.
+    #   Conditional: You must specify only one of the following parameters:
+    #   `TemplateBody`, `TemplateURL`, or set the `UsePreviousTemplate` to
+    #   `true`.
     #
     #
     #
@@ -1857,8 +1902,9 @@ module Aws::CloudFormation
     #   template that is located in an Amazon S3 bucket. For more information,
     #   go to [Template Anatomy][1] in the AWS CloudFormation User Guide.
     #
-    #   Conditional: You must specify either the `TemplateBody` or the
-    #   `TemplateURL` parameter, but not both.
+    #   Conditional: You must specify only one of the following parameters:
+    #   `TemplateBody`, `TemplateURL`, or set the `UsePreviousTemplate` to
+    #   `true`.
     #
     #
     #
@@ -1868,6 +1914,10 @@ module Aws::CloudFormation
     #   Reuse the existing template that is associated with the stack that you
     #   are updating.
     #
+    #   Conditional: You must specify only one of the following parameters:
+    #   `TemplateBody`, `TemplateURL`, or set the `UsePreviousTemplate` to
+    #   `true`.
+    #
     # @option params [String] :stack_policy_during_update_body
     #   Structure containing the temporary overriding stack policy body. You
     #   can specify either the `StackPolicyDuringUpdateBody` or the
@@ -1999,6 +2049,13 @@ module Aws::CloudFormation
     #   modify the stack's tags. If you specify an empty value, AWS
     #   CloudFormation removes all associated tags.
     #
+    # @option params [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
+    #   you're not attempting to update a stack with the same name. You might
+    #   retry `UpdateStack` requests to ensure that AWS CloudFormation
+    #   successfully received them.
+    #
     # @return [Types::UpdateStackOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::UpdateStackOutput#stack_id #stack_id} => String
@@ -2031,6 +2088,7 @@ module Aws::CloudFormation
     #         value: "TagValue",
     #       },
     #     ],
+    #     client_request_token: "ClientRequestToken",
     #   })
     #
     # @example Response structure
@@ -2127,7 +2185,7 @@ module Aws::CloudFormation
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-cloudformation'
-      context[:gem_version] = '1.0.0.rc2'
+      context[:gem_version] = '1.0.0.rc3'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -35,6 +35,7 @@ module Aws::CloudFormation
     ChangeSource = Shapes::StringShape.new(name: 'ChangeSource')
     ChangeType = Shapes::StringShape.new(name: 'ChangeType')
     Changes = Shapes::ListShape.new(name: 'Changes')
+    ClientRequestToken = Shapes::StringShape.new(name: 'ClientRequestToken')
     ClientToken = Shapes::StringShape.new(name: 'ClientToken')
     ContinueUpdateRollbackInput = Shapes::StructureShape.new(name: 'ContinueUpdateRollbackInput')
     ContinueUpdateRollbackOutput = Shapes::StructureShape.new(name: 'ContinueUpdateRollbackOutput')
@@ -171,6 +172,7 @@ module Aws::CloudFormation
     TemplateURL = Shapes::StringShape.new(name: 'TemplateURL')
     TimeoutMinutes = Shapes::IntegerShape.new(name: 'TimeoutMinutes')
     Timestamp = Shapes::TimestampShape.new(name: 'Timestamp')
+    TokenAlreadyExistsException = Shapes::StructureShape.new(name: 'TokenAlreadyExistsException')
     TransformName = Shapes::StringShape.new(name: 'TransformName')
     TransformsList = Shapes::ListShape.new(name: 'TransformsList')
     UpdateStackInput = Shapes::StructureShape.new(name: 'UpdateStackInput')
@@ -191,6 +193,7 @@ module Aws::CloudFormation
     AllowedValues.member = Shapes::ShapeRef.new(shape: AllowedValue)
 
     CancelUpdateStackInput.add_member(:stack_name, Shapes::ShapeRef.new(shape: StackName, required: true, location_name: "StackName"))
+    CancelUpdateStackInput.add_member(:client_request_token, Shapes::ShapeRef.new(shape: ClientRequestToken, location_name: "ClientRequestToken"))
     CancelUpdateStackInput.struct_class = Types::CancelUpdateStackInput
 
     Capabilities.member = Shapes::ShapeRef.new(shape: Capability)
@@ -217,6 +220,7 @@ module Aws::CloudFormation
     ContinueUpdateRollbackInput.add_member(:stack_name, Shapes::ShapeRef.new(shape: StackNameOrId, required: true, location_name: "StackName"))
     ContinueUpdateRollbackInput.add_member(:role_arn, Shapes::ShapeRef.new(shape: RoleARN, location_name: "RoleARN"))
     ContinueUpdateRollbackInput.add_member(:resources_to_skip, Shapes::ShapeRef.new(shape: ResourcesToSkip, location_name: "ResourcesToSkip"))
+    ContinueUpdateRollbackInput.add_member(:client_request_token, Shapes::ShapeRef.new(shape: ClientRequestToken, location_name: "ClientRequestToken"))
     ContinueUpdateRollbackInput.struct_class = Types::ContinueUpdateRollbackInput
 
     ContinueUpdateRollbackOutput.struct_class = Types::ContinueUpdateRollbackOutput
@@ -255,6 +259,7 @@ module Aws::CloudFormation
     CreateStackInput.add_member(:stack_policy_body, Shapes::ShapeRef.new(shape: StackPolicyBody, location_name: "StackPolicyBody"))
     CreateStackInput.add_member(:stack_policy_url, Shapes::ShapeRef.new(shape: StackPolicyURL, location_name: "StackPolicyURL"))
     CreateStackInput.add_member(:tags, Shapes::ShapeRef.new(shape: Tags, location_name: "Tags"))
+    CreateStackInput.add_member(:client_request_token, Shapes::ShapeRef.new(shape: ClientRequestToken, location_name: "ClientRequestToken"))
     CreateStackInput.struct_class = Types::CreateStackInput
 
     CreateStackOutput.add_member(:stack_id, Shapes::ShapeRef.new(shape: StackId, location_name: "StackId"))
@@ -269,6 +274,7 @@ module Aws::CloudFormation
     DeleteStackInput.add_member(:stack_name, Shapes::ShapeRef.new(shape: StackName, required: true, location_name: "StackName"))
     DeleteStackInput.add_member(:retain_resources, Shapes::ShapeRef.new(shape: RetainResources, location_name: "RetainResources"))
     DeleteStackInput.add_member(:role_arn, Shapes::ShapeRef.new(shape: RoleARN, location_name: "RoleARN"))
+    DeleteStackInput.add_member(:client_request_token, Shapes::ShapeRef.new(shape: ClientRequestToken, location_name: "ClientRequestToken"))
     DeleteStackInput.struct_class = Types::DeleteStackInput
 
     DescribeAccountLimitsInput.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "NextToken"))
@@ -341,6 +347,7 @@ module Aws::CloudFormation
 
     ExecuteChangeSetInput.add_member(:change_set_name, Shapes::ShapeRef.new(shape: ChangeSetNameOrId, required: true, location_name: "ChangeSetName"))
     ExecuteChangeSetInput.add_member(:stack_name, Shapes::ShapeRef.new(shape: StackNameOrId, location_name: "StackName"))
+    ExecuteChangeSetInput.add_member(:client_request_token, Shapes::ShapeRef.new(shape: ClientRequestToken, location_name: "ClientRequestToken"))
     ExecuteChangeSetInput.struct_class = Types::ExecuteChangeSetInput
 
     ExecuteChangeSetOutput.struct_class = Types::ExecuteChangeSetOutput
@@ -521,6 +528,7 @@ module Aws::CloudFormation
     StackEvent.add_member(:resource_status, Shapes::ShapeRef.new(shape: ResourceStatus, location_name: "ResourceStatus"))
     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.struct_class = Types::StackEvent
 
     StackEvents.member = Shapes::ShapeRef.new(shape: StackEvent)
@@ -608,6 +616,7 @@ module Aws::CloudFormation
     UpdateStackInput.add_member(:stack_policy_url, Shapes::ShapeRef.new(shape: StackPolicyURL, location_name: "StackPolicyURL"))
     UpdateStackInput.add_member(:notification_arns, Shapes::ShapeRef.new(shape: NotificationARNs, location_name: "NotificationARNs"))
     UpdateStackInput.add_member(:tags, Shapes::ShapeRef.new(shape: Tags, location_name: "Tags"))
+    UpdateStackInput.add_member(:client_request_token, Shapes::ShapeRef.new(shape: ClientRequestToken, location_name: "ClientRequestToken"))
     UpdateStackInput.struct_class = Types::UpdateStackInput
 
     UpdateStackOutput.add_member(:stack_id, Shapes::ShapeRef.new(shape: StackId, location_name: "StackId"))
@@ -644,6 +653,7 @@ module Aws::CloudFormation
         o.http_request_uri = "/"
         o.input = Shapes::ShapeRef.new(shape: CancelUpdateStackInput)
         o.output = Shapes::ShapeRef.new(shape: Shapes::StructureShape.new(struct_class: Aws::EmptyStructure))
+        o.errors << Shapes::ShapeRef.new(shape: TokenAlreadyExistsException)
       end)
 
       api.add_operation(:continue_update_rollback, Seahorse::Model::Operation.new.tap do |o|
@@ -652,6 +662,7 @@ module Aws::CloudFormation
         o.http_request_uri = "/"
         o.input = Shapes::ShapeRef.new(shape: ContinueUpdateRollbackInput)
         o.output = Shapes::ShapeRef.new(shape: ContinueUpdateRollbackOutput)
+        o.errors << Shapes::ShapeRef.new(shape: TokenAlreadyExistsException)
       end)
 
       api.add_operation(:create_change_set, Seahorse::Model::Operation.new.tap do |o|
@@ -673,6 +684,7 @@ module Aws::CloudFormation
         o.output = Shapes::ShapeRef.new(shape: CreateStackOutput)
         o.errors << Shapes::ShapeRef.new(shape: LimitExceededException)
         o.errors << Shapes::ShapeRef.new(shape: AlreadyExistsException)
+        o.errors << Shapes::ShapeRef.new(shape: TokenAlreadyExistsException)
         o.errors << Shapes::ShapeRef.new(shape: InsufficientCapabilitiesException)
       end)
 
@@ -691,6 +703,7 @@ module Aws::CloudFormation
         o.http_request_uri = "/"
         o.input = Shapes::ShapeRef.new(shape: DeleteStackInput)
         o.output = Shapes::ShapeRef.new(shape: Shapes::StructureShape.new(struct_class: Aws::EmptyStructure))
+        o.errors << Shapes::ShapeRef.new(shape: TokenAlreadyExistsException)
       end)
 
       api.add_operation(:describe_account_limits, Seahorse::Model::Operation.new.tap do |o|
@@ -769,6 +782,7 @@ module Aws::CloudFormation
         o.errors << Shapes::ShapeRef.new(shape: InvalidChangeSetStatusException)
         o.errors << Shapes::ShapeRef.new(shape: ChangeSetNotFoundException)
         o.errors << Shapes::ShapeRef.new(shape: InsufficientCapabilitiesException)
+        o.errors << Shapes::ShapeRef.new(shape: TokenAlreadyExistsException)
       end)
 
       api.add_operation(:get_stack_policy, Seahorse::Model::Operation.new.tap do |o|
@@ -879,6 +893,7 @@ module Aws::CloudFormation
         o.input = Shapes::ShapeRef.new(shape: UpdateStackInput)
         o.output = Shapes::ShapeRef.new(shape: UpdateStackOutput)
         o.errors << Shapes::ShapeRef.new(shape: InsufficientCapabilitiesException)
+        o.errors << Shapes::ShapeRef.new(shape: TokenAlreadyExistsException)
       end)
 
       api.add_operation(:validate_template, Seahorse::Model::Operation.new.tap do |o|

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

@@ -91,6 +91,16 @@ module Aws::CloudFormation
       data.resource_properties
     end
 
+    # The token passed to the operation that generated this event.
+    #
+    # For example, if you execute a `CreateStack` operation with the token
+    # `token1`, then all the `StackEvents` generated by that operation will
+    # have `ClientRequestToken` set as `token1`.
+    # @return [String]
+    def client_request_token
+      data.client_request_token
+    end
+
     # @!endgroup
 
     # @return [Client]

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

@@ -49,6 +49,7 @@ module Aws::CloudFormation
     #         value: "TagValue",
     #       },
     #     ],
+    #     client_request_token: "ClientRequestToken",
     #   })
     # @param [Hash] options ({})
     # @option options [required, String] :stack_name
@@ -102,12 +103,8 @@ module Aws::CloudFormation
     #   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][1] or your Command Line Interface (CLI).
-    #
-    #
-    #
-    #   [1]: https://console.aws.amazon.com/sns
+    #   related events. You can find your SNS topic ARNs using the SNS console
+    #   or your Command Line Interface (CLI).
     # @option options [Array<String>] :capabilities
     #   A list of values that you must specify before AWS CloudFormation can
     #   create certain stacks. Some stack templates might include resources
@@ -201,6 +198,12 @@ module Aws::CloudFormation
     #   Key-value pairs to associate with this stack. AWS CloudFormation also
     #   propagates these tags to the resources created in the stack. A maximum
     #   number of 10 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
+    #   you're not attempting to create a stack with the same name. You might
+    #   retry `CreateStack` requests to ensure that AWS CloudFormation
+    #   successfully received them.
     # @return [Stack]
     def create_stack(options = {})
       resp = @client.create_stack(options)

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

@@ -199,8 +199,16 @@ module Aws::CloudFormation
 
     # @example Request syntax with placeholder values
     #
-    #   stack.cancel_update()
+    #   stack.cancel_update({
+    #     client_request_token: "ClientRequestToken",
+    #   })
     # @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.
     # @return [EmptyStructure]
     def cancel_update(options = {})
       options = options.merge(stack_name: @name)
@@ -235,6 +243,7 @@ module Aws::CloudFormation
     #         value: "TagValue",
     #       },
     #     ],
+    #     client_request_token: "ClientRequestToken",
     #   })
     # @param [Hash] options ({})
     # @option options [String] :template_body
@@ -279,12 +288,8 @@ module Aws::CloudFormation
     #   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][1] or your Command Line Interface (CLI).
-    #
-    #
-    #
-    #   [1]: https://console.aws.amazon.com/sns
+    #   related events. You can find your SNS topic ARNs using the SNS console
+    #   or your Command Line Interface (CLI).
     # @option options [Array<String>] :capabilities
     #   A list of values that you must specify before AWS CloudFormation can
     #   create certain stacks. Some stack templates might include resources
@@ -378,6 +383,12 @@ module Aws::CloudFormation
     #   Key-value pairs to associate with this stack. AWS CloudFormation also
     #   propagates these tags to the resources created in the stack. A maximum
     #   number of 10 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
+    #   you're not attempting to create a stack with the same name. You might
+    #   retry `CreateStack` requests to ensure that AWS CloudFormation
+    #   successfully received them.
     # @return [Types::CreateStackOutput]
     def create(options = {})
       options = options.merge(stack_name: @name)
@@ -390,6 +401,7 @@ module Aws::CloudFormation
     #   stack.delete({
     #     retain_resources: ["LogicalResourceId"],
     #     role_arn: "RoleARN",
+    #     client_request_token: "ClientRequestToken",
     #   })
     # @param [Hash] options ({})
     # @option options [Array<String>] :retain_resources
@@ -410,6 +422,12 @@ module Aws::CloudFormation
     #   was previously associated with the stack. If no role is available, AWS
     #   CloudFormation uses a temporary session that is 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
+    #   you're not attempting to delete a stack with the same name. You might
+    #   retry `DeleteStack` requests to ensure that AWS CloudFormation
+    #   successfully received them.
     # @return [EmptyStructure]
     def delete(options = {})
       options = options.merge(stack_name: @name)
@@ -444,6 +462,7 @@ module Aws::CloudFormation
     #         value: "TagValue",
     #       },
     #     ],
+    #     client_request_token: "ClientRequestToken",
     #   })
     # @param [Hash] options ({})
     # @option options [String] :template_body
@@ -451,8 +470,9 @@ module Aws::CloudFormation
     #   and a maximum length of 51,200 bytes. (For more information, go to
     #   [Template Anatomy][1] in the AWS CloudFormation User Guide.)
     #
-    #   Conditional: You must specify either the `TemplateBody` or the
-    #   `TemplateURL` parameter, but not both.
+    #   Conditional: You must specify only one of the following parameters:
+    #   `TemplateBody`, `TemplateURL`, or set the `UsePreviousTemplate` to
+    #   `true`.
     #
     #
     #
@@ -462,8 +482,9 @@ module Aws::CloudFormation
     #   template that is located in an Amazon S3 bucket. For more information,
     #   go to [Template Anatomy][1] in the AWS CloudFormation User Guide.
     #
-    #   Conditional: You must specify either the `TemplateBody` or the
-    #   `TemplateURL` parameter, but not both.
+    #   Conditional: You must specify only one of the following parameters:
+    #   `TemplateBody`, `TemplateURL`, or set the `UsePreviousTemplate` to
+    #   `true`.
     #
     #
     #
@@ -471,6 +492,10 @@ module Aws::CloudFormation
     # @option options [Boolean] :use_previous_template
     #   Reuse the existing template that is associated with the stack that you
     #   are updating.
+    #
+    #   Conditional: You must specify only one of the following parameters:
+    #   `TemplateBody`, `TemplateURL`, or set the `UsePreviousTemplate` to
+    #   `true`.
     # @option options [String] :stack_policy_during_update_body
     #   Structure containing the temporary overriding stack policy body. You
     #   can specify either the `StackPolicyDuringUpdateBody` or the
@@ -592,6 +617,12 @@ module Aws::CloudFormation
     #   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.
+    # @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
+    #   you're not attempting to update a stack with the same name. You might
+    #   retry `UpdateStack` requests to ensure that AWS CloudFormation
+    #   successfully received them.
     # @return [Types::UpdateStackOutput]
     def update(options = {})
       options = options.merge(stack_name: @name)

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

@@ -34,16 +34,26 @@ module Aws::CloudFormation
     #
     #       {
     #         stack_name: "StackName", # required
+    #         client_request_token: "ClientRequestToken",
     #       }
     #
     # @!attribute [rw] stack_name
     #   The name or the unique stack ID that is associated with the stack.
     #   @return [String]
     #
+    # @!attribute [rw] 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.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CancelUpdateStackInput AWS API Documentation
     #
     class CancelUpdateStackInput < Struct.new(
-      :stack_name)
+      :stack_name,
+      :client_request_token)
       include Aws::Structure
     end
 
@@ -138,6 +148,7 @@ module Aws::CloudFormation
     #         stack_name: "StackNameOrId", # required
     #         role_arn: "RoleARN",
     #         resources_to_skip: ["ResourceToSkip"],
+    #         client_request_token: "ClientRequestToken",
     #       }
     #
     # @!attribute [rw] stack_name
@@ -195,22 +206,32 @@ module Aws::CloudFormation
     #   necessary to skip the dependent resources.
     #
     #   To specify resources in a nested stack, use the following format:
-    #   `NestedStackName.ResourceLogicalID`. You can specify a nested stack
-    #   resource (the logical ID of an `AWS::CloudFormation::Stack`
-    #   resource) only if it's in one of the following states:
-    #   `DELETE_IN_PROGRESS`, `DELETE_COMPLETE`, or `DELETE_FAILED`.
+    #   `NestedStackName.ResourceLogicalID`. If the `ResourceLogicalID` is a
+    #   stack resource (`Type: AWS::CloudFormation::Stack`), it must be in
+    #   one of the following states: `DELETE_IN_PROGRESS`,
+    #   `DELETE_COMPLETE`, or `DELETE_FAILED`.
     #
     #
     #
     #   [1]: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/troubleshooting.html#troubleshooting-errors-update-rollback-failed
     #   @return [Array<String>]
     #
+    # @!attribute [rw] client_request_token
+    #   A unique identifier for this `ContinueUpdateRollback` request.
+    #   Specify this token if you plan to retry requests so that AWS
+    #   CloudFormation knows that you're not attempting to continue the
+    #   rollback to a stack with the same name. You might retry
+    #   `ContinueUpdateRollback` requests to ensure that AWS CloudFormation
+    #   successfully received them.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/ContinueUpdateRollbackInput AWS API Documentation
     #
     class ContinueUpdateRollbackInput < Struct.new(
       :stack_name,
       :role_arn,
-      :resources_to_skip)
+      :resources_to_skip,
+      :client_request_token)
       include Aws::Structure
     end
 
@@ -487,6 +508,7 @@ module Aws::CloudFormation
     #             value: "TagValue",
     #           },
     #         ],
+    #         client_request_token: "ClientRequestToken",
     #       }
     #
     # @!attribute [rw] stack_name
@@ -552,12 +574,8 @@ module Aws::CloudFormation
     #
     # @!attribute [rw] 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][1] or your Command Line Interface (CLI).
-    #
-    #
-    #
-    #   [1]: https://console.aws.amazon.com/sns
+    #   related events. You can find your SNS topic ARNs using the SNS
+    #   console or your Command Line Interface (CLI).
     #   @return [Array<String>]
     #
     # @!attribute [rw] capabilities
@@ -670,6 +688,14 @@ module Aws::CloudFormation
     #   maximum number of 10 tags can be specified.
     #   @return [Array<Types::Tag>]
     #
+    # @!attribute [rw] 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 you're not attempting to create a stack with the same name.
+    #   You might retry `CreateStack` requests to ensure that AWS
+    #   CloudFormation successfully received them.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateStackInput AWS API Documentation
     #
     class CreateStackInput < Struct.new(
@@ -686,7 +712,8 @@ module Aws::CloudFormation
       :on_failure,
       :stack_policy_body,
       :stack_policy_url,
-      :tags)
+      :tags,
+      :client_request_token)
       include Aws::Structure
     end
 
@@ -746,6 +773,7 @@ module Aws::CloudFormation
     #         stack_name: "StackName", # required
     #         retain_resources: ["LogicalResourceId"],
     #         role_arn: "RoleARN",
+    #         client_request_token: "ClientRequestToken",
     #       }
     #
     # @!attribute [rw] stack_name
@@ -774,12 +802,21 @@ module Aws::CloudFormation
     #   your user credentials.
     #   @return [String]
     #
+    # @!attribute [rw] 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 you're not attempting to delete a stack with the same name.
+    #   You might retry `DeleteStack` requests to ensure that AWS
+    #   CloudFormation successfully received them.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/DeleteStackInput AWS API Documentation
     #
     class DeleteStackInput < Struct.new(
       :stack_name,
       :retain_resources,
-      :role_arn)
+      :role_arn,
+      :client_request_token)
       include Aws::Structure
     end
 
@@ -1271,6 +1308,7 @@ module Aws::CloudFormation
     #       {
     #         change_set_name: "ChangeSetNameOrId", # required
     #         stack_name: "StackNameOrId",
+    #         client_request_token: "ClientRequestToken",
     #       }
     #
     # @!attribute [rw] change_set_name
@@ -1283,11 +1321,21 @@ module Aws::CloudFormation
     #   ID (ARN) that is associated with the change set you want to execute.
     #   @return [String]
     #
+    # @!attribute [rw] client_request_token
+    #   A unique identifier for this `ExecuteChangeSet` request. Specify
+    #   this token if you plan to retry requests so that AWS CloudFormation
+    #   knows that you're not attempting to execute a change set to update
+    #   a stack with the same name. You might retry `ExecuteChangeSet`
+    #   requests to ensure that AWS CloudFormation successfully received
+    #   them.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/ExecuteChangeSetInput AWS API Documentation
     #
     class ExecuteChangeSetInput < Struct.new(
       :change_set_name,
-      :stack_name)
+      :stack_name,
+      :client_request_token)
       include Aws::Structure
     end
 
@@ -2334,6 +2382,14 @@ module Aws::CloudFormation
     #   BLOB of the properties used to create the resource.
     #   @return [String]
     #
+    # @!attribute [rw] client_request_token
+    #   The token passed to the operation that generated this event.
+    #
+    #   For example, if you execute a `CreateStack` operation with the token
+    #   `token1`, then all the `StackEvents` generated by that operation
+    #   will have `ClientRequestToken` set as `token1`.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/StackEvent AWS API Documentation
     #
     class StackEvent < Struct.new(
@@ -2346,7 +2402,8 @@ module Aws::CloudFormation
       :timestamp,
       :resource_status,
       :resource_status_reason,
-      :resource_properties)
+      :resource_properties,
+      :client_request_token)
       include Aws::Structure
     end
 
@@ -2662,6 +2719,7 @@ module Aws::CloudFormation
     #             value: "TagValue",
     #           },
     #         ],
+    #         client_request_token: "ClientRequestToken",
     #       }
     #
     # @!attribute [rw] stack_name
@@ -2673,8 +2731,9 @@ module Aws::CloudFormation
     #   byte and a maximum length of 51,200 bytes. (For more information, go
     #   to [Template Anatomy][1] in the AWS CloudFormation User Guide.)
     #
-    #   Conditional: You must specify either the `TemplateBody` or the
-    #   `TemplateURL` parameter, but not both.
+    #   Conditional: You must specify only one of the following parameters:
+    #   `TemplateBody`, `TemplateURL`, or set the `UsePreviousTemplate` to
+    #   `true`.
     #
     #
     #
@@ -2687,8 +2746,9 @@ module Aws::CloudFormation
     #   information, go to [Template Anatomy][1] in the AWS CloudFormation
     #   User Guide.
     #
-    #   Conditional: You must specify either the `TemplateBody` or the
-    #   `TemplateURL` parameter, but not both.
+    #   Conditional: You must specify only one of the following parameters:
+    #   `TemplateBody`, `TemplateURL`, or set the `UsePreviousTemplate` to
+    #   `true`.
     #
     #
     #
@@ -2698,6 +2758,10 @@ module Aws::CloudFormation
     # @!attribute [rw] use_previous_template
     #   Reuse the existing template that is associated with the stack that
     #   you are updating.
+    #
+    #   Conditional: You must specify only one of the following parameters:
+    #   `TemplateBody`, `TemplateURL`, or set the `UsePreviousTemplate` to
+    #   `true`.
     #   @return [Boolean]
     #
     # @!attribute [rw] stack_policy_during_update_body
@@ -2844,6 +2908,14 @@ module Aws::CloudFormation
     #   CloudFormation removes all associated tags.
     #   @return [Array<Types::Tag>]
     #
+    # @!attribute [rw] 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 you're not attempting to update a stack with the same name.
+    #   You might retry `UpdateStack` requests to ensure that AWS
+    #   CloudFormation successfully received them.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/UpdateStackInput AWS API Documentation
     #
     class UpdateStackInput < Struct.new(
@@ -2860,7 +2932,8 @@ module Aws::CloudFormation
       :stack_policy_body,
       :stack_policy_url,
       :notification_arns,
-      :tags)
+      :tags,
+      :client_request_token)
       include Aws::Structure
     end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-cloudformation
 version: !ruby/object:Gem::Version
-  version: 1.0.0.rc2
+  version: 1.0.0.rc3
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-04-26 00:00:00.000000000 Z
+date: 2017-05-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core