aws-sdk-cloudformation 1.2.0 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: b9cf10e3312d639cd2da6e5deb373983993af918
-  data.tar.gz: 79e597c1a6e1aadc7b1b8d42dd3fa1c92837ad10
+  metadata.gz: 060aa2dd7926f49933ab1d888e1171a6b4c27b93
+  data.tar.gz: 8f3c02f5f639b9f34491ce7ed68bb4956f197596
 SHA512:
-  metadata.gz: d4abc371c00c356f137141608a2781af9017262d1235393f423e68e4e74010158aa9e6afed6c78eb539fe2b4c4bf5554be81643df5436da544f9a30eac2cdae5
-  data.tar.gz: a5feee862f1553c596aafdd566fb2d35269ab7e32ba681238c421e8963f392cca1ff01a7df7fe96d90865149828aaa9bce8a95f305e31a1d4ba7b6c10cdc5a28
+  metadata.gz: 63ac221fb9cdb3ea440507c574591cc257935dcf2ed012de224ca6e4c102e1d3eb1bfa5ee903b8e263460f7c11b586d3d377655e1f8061f3dbf5f23f600610ef
+  data.tar.gz: 742ca06823d948210cbe18544bfee791f88a9253536e175eb758f5b385e13f32ffa4c9d7b37a283d18c2ae696506d7277ffb4af4e394a18d17ba72ee47104276

data/lib/aws-sdk-cloudformation.rb

@@ -47,6 +47,6 @@ require_relative 'aws-sdk-cloudformation/customizations'
 # @service
 module Aws::CloudFormation
 
-  GEM_VERSION = '1.2.0'
+  GEM_VERSION = '1.3.0'
 
 end

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

@@ -491,6 +491,7 @@ module Aws::CloudFormation
     #         parameter_key: "ParameterKey",
     #         parameter_value: "ParameterValue",
     #         use_previous_value: false,
+    #         resolved_value: "ParameterValue",
     #       },
     #     ],
     #     capabilities: ["CAPABILITY_IAM"], # accepts CAPABILITY_IAM, CAPABILITY_NAMED_IAM
@@ -753,6 +754,7 @@ module Aws::CloudFormation
     #         parameter_key: "ParameterKey",
     #         parameter_value: "ParameterValue",
     #         use_previous_value: false,
+    #         resolved_value: "ParameterValue",
     #       },
     #     ],
     #     disable_rollback: false,
@@ -813,6 +815,45 @@ module Aws::CloudFormation
     #   The names of one or more regions where you want to create stack
     #   instances using the specified AWS account(s).
     #
+    # @option params [Array<Types::Parameter>] :parameter_overrides
+    #   A list of stack set parameters whose values you want to override in
+    #   the selected stack instances.
+    #
+    #   Any overridden parameter values will be applied to all stack instances
+    #   in the specified accounts and regions. When specifying parameters and
+    #   their values, be aware of how AWS CloudFormation sets parameter values
+    #   during stack instance operations:
+    #
+    #   * To override the current value for a parameter, include the parameter
+    #     and specify its value.
+    #
+    #   * To leave a parameter set to its present value, you can do one of the
+    #     following:
+    #
+    #     * Do not include the parameter in the list.
+    #
+    #     * Include the parameter and specify `UsePreviousValue` as `true`.
+    #       (You cannot specify both a value and set `UsePreviousValue` to
+    #       `true`.)
+    #
+    #   * To set all overridden parameter back to the values specified in the
+    #     stack set, specify a parameter list but do not include any
+    #     parameters.
+    #
+    #   * To leave all parameters set to their present values, do not specify
+    #     this property at all.
+    #
+    #   During stack set updates, any parameter values overridden for a stack
+    #   instance are not updated, but retain their overridden value.
+    #
+    #   You can only override the parameter *values* that are specified in the
+    #   stack set; to add or delete a parameter itself, use
+    #   [UpdateStackSet][1] to update the stack set template.
+    #
+    #
+    #
+    #   [1]: http://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_UpdateStackSet.html
+    #
     # @option params [Types::StackSetOperationPreferences] :operation_preferences
     #   Preferences for how AWS CloudFormation performs this stack set
     #   operation.
@@ -845,6 +886,14 @@ module Aws::CloudFormation
     #     stack_set_name: "StackSetName", # required
     #     accounts: ["Account"], # required
     #     regions: ["Region"], # required
+    #     parameter_overrides: [
+    #       {
+    #         parameter_key: "ParameterKey",
+    #         parameter_value: "ParameterValue",
+    #         use_previous_value: false,
+    #         resolved_value: "ParameterValue",
+    #       },
+    #     ],
     #     operation_preferences: {
     #       region_order: ["Region"],
     #       failure_tolerance_count: 1,
@@ -993,6 +1042,7 @@ module Aws::CloudFormation
     #         parameter_key: "ParameterKey",
     #         parameter_value: "ParameterValue",
     #         use_previous_value: false,
+    #         resolved_value: "ParameterValue",
     #       },
     #     ],
     #     capabilities: ["CAPABILITY_IAM"], # accepts CAPABILITY_IAM, CAPABILITY_NAMED_IAM
@@ -1317,6 +1367,7 @@ module Aws::CloudFormation
     #   resp.parameters[0].parameter_key #=> String
     #   resp.parameters[0].parameter_value #=> String
     #   resp.parameters[0].use_previous_value #=> Boolean
+    #   resp.parameters[0].resolved_value #=> String
     #   resp.creation_time #=> Time
     #   resp.execution_status #=> String, one of "UNAVAILABLE", "AVAILABLE", "EXECUTE_IN_PROGRESS", "EXECUTE_COMPLETE", "EXECUTE_FAILED", "OBSOLETE"
     #   resp.status #=> String, one of "CREATE_PENDING", "CREATE_IN_PROGRESS", "CREATE_COMPLETE", "DELETE_COMPLETE", "FAILED"
@@ -1458,6 +1509,11 @@ module Aws::CloudFormation
     #   resp.stack_instance.region #=> String
     #   resp.stack_instance.account #=> String
     #   resp.stack_instance.stack_id #=> String
+    #   resp.stack_instance.parameter_overrides #=> Array
+    #   resp.stack_instance.parameter_overrides[0].parameter_key #=> String
+    #   resp.stack_instance.parameter_overrides[0].parameter_value #=> String
+    #   resp.stack_instance.parameter_overrides[0].use_previous_value #=> Boolean
+    #   resp.stack_instance.parameter_overrides[0].resolved_value #=> String
     #   resp.stack_instance.status #=> String, one of "CURRENT", "OUTDATED", "INOPERABLE"
     #   resp.stack_instance.status_reason #=> String
     #
@@ -1647,6 +1703,7 @@ module Aws::CloudFormation
     #   resp.stack_set.parameters[0].parameter_key #=> String
     #   resp.stack_set.parameters[0].parameter_value #=> String
     #   resp.stack_set.parameters[0].use_previous_value #=> Boolean
+    #   resp.stack_set.parameters[0].resolved_value #=> String
     #   resp.stack_set.capabilities #=> Array
     #   resp.stack_set.capabilities[0] #=> String, one of "CAPABILITY_IAM", "CAPABILITY_NAMED_IAM"
     #   resp.stack_set.tags #=> Array
@@ -1753,6 +1810,7 @@ module Aws::CloudFormation
     #   resp.stacks[0].parameters[0].parameter_key #=> String
     #   resp.stacks[0].parameters[0].parameter_value #=> String
     #   resp.stacks[0].parameters[0].use_previous_value #=> Boolean
+    #   resp.stacks[0].parameters[0].resolved_value #=> String
     #   resp.stacks[0].creation_time #=> Time
     #   resp.stacks[0].deletion_time #=> Time
     #   resp.stacks[0].last_updated_time #=> Time
@@ -1836,6 +1894,7 @@ module Aws::CloudFormation
     #         parameter_key: "ParameterKey",
     #         parameter_value: "ParameterValue",
     #         use_previous_value: false,
+    #         resolved_value: "ParameterValue",
     #       },
     #     ],
     #   })
@@ -2914,6 +2973,7 @@ module Aws::CloudFormation
     #         parameter_key: "ParameterKey",
     #         parameter_value: "ParameterValue",
     #         use_previous_value: false,
+    #         resolved_value: "ParameterValue",
     #       },
     #     ],
     #     capabilities: ["CAPABILITY_IAM"], # accepts CAPABILITY_IAM, CAPABILITY_NAMED_IAM
@@ -2953,6 +3013,152 @@ module Aws::CloudFormation
       req.send_request(options)
     end
 
+    # Updates the parameter values for stack instances for the specified
+    # accounts, within the specified regions. A stack instance refers to a
+    # stack in a specific account and region.
+    #
+    # You can only update stack instances in regions and accounts where they
+    # already exist; to create additional stack instances, use
+    # [CreateStackInstances][1].
+    #
+    # During stack set updates, any parameters overridden for a stack
+    # instance are not updated, but retain their overridden value.
+    #
+    # You can only update the parameter *values* that are specified in the
+    # stack set; to add or delete a parameter itself, use
+    # [UpdateStackSet][2] to update the stack set template. If you add a
+    # parameter to a template, before you can override the parameter value
+    # specified in the stack set you must first use [UpdateStackSet][2] to
+    # update all stack instances with the updated template and parameter
+    # value specified in the stack set. Once a stack instance has been
+    # updated with the new parameter, you can then override the parameter
+    # value using `UpdateStackInstances`.
+    #
+    #
+    #
+    # [1]: http://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_CreateStackInstances.html
+    # [2]: http://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_UpdateStackSet.html
+    #
+    # @option params [required, String] :stack_set_name
+    #   The name or unique ID of the stack set associated with the stack
+    #   instances.
+    #
+    # @option params [required, Array<String>] :accounts
+    #   The names of one or more AWS accounts for which you want to update
+    #   parameter values for stack instances. The overridden parameter values
+    #   will be applied to all stack instances in the specified accounts and
+    #   regions.
+    #
+    # @option params [required, Array<String>] :regions
+    #   The names of one or more regions in which you want to update parameter
+    #   values for stack instances. The overridden parameter values will be
+    #   applied to all stack instances in the specified accounts and regions.
+    #
+    # @option params [Array<Types::Parameter>] :parameter_overrides
+    #   A list of input parameters whose values you want to update for the
+    #   specified stack instances.
+    #
+    #   Any overridden parameter values will be applied to all stack instances
+    #   in the specified accounts and regions. When specifying parameters and
+    #   their values, be aware of how AWS CloudFormation sets parameter values
+    #   during stack instance update operations:
+    #
+    #   * To override the current value for a parameter, include the parameter
+    #     and specify its value.
+    #
+    #   * To leave a parameter set to its present value, you can do one of the
+    #     following:
+    #
+    #     * Do not include the parameter in the list.
+    #
+    #     * Include the parameter and specify `UsePreviousValue` as `true`.
+    #       (You cannot specify both a value and set `UsePreviousValue` to
+    #       `true`.)
+    #
+    #   * To set all overridden parameter back to the values specified in the
+    #     stack set, specify a parameter list but do not include any
+    #     parameters.
+    #
+    #   * To leave all parameters set to their present values, do not specify
+    #     this property at all.
+    #
+    #   During stack set updates, any parameter values overridden for a stack
+    #   instance are not updated, but retain their overridden value.
+    #
+    #   You can only override the parameter *values* that are specified in the
+    #   stack set; to add or delete a parameter itself, use `UpdateStackSet`
+    #   to update the stack set template. If you add a parameter to a
+    #   template, before you can override the parameter value specified in the
+    #   stack set you must first use [UpdateStackSet][1] to update all stack
+    #   instances with the updated template and parameter value specified in
+    #   the stack set. Once a stack instance has been updated with the new
+    #   parameter, you can then override the parameter value using
+    #   `UpdateStackInstances`.
+    #
+    #
+    #
+    #   [1]: http://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_UpdateStackSet.html
+    #
+    # @option params [Types::StackSetOperationPreferences] :operation_preferences
+    #   Preferences for how AWS CloudFormation performs this stack set
+    #   operation.
+    #
+    # @option params [String] :operation_id
+    #   The unique identifier for this stack set operation.
+    #
+    #   The operation ID also functions as an idempotency token, to ensure
+    #   that AWS CloudFormation performs the stack set operation only once,
+    #   even if you retry the request multiple times. You might retry stack
+    #   set operation requests to ensure that AWS CloudFormation successfully
+    #   received them.
+    #
+    #   If you don't specify an operation ID, the SDK generates one
+    #   automatically.
+    #
+    #   **A suitable default value is auto-generated.** You should normally
+    #   not need to pass this option.**
+    #
+    # @return [Types::UpdateStackInstancesOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::UpdateStackInstancesOutput#operation_id #operation_id} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.update_stack_instances({
+    #     stack_set_name: "StackSetName", # required
+    #     accounts: ["Account"], # required
+    #     regions: ["Region"], # required
+    #     parameter_overrides: [
+    #       {
+    #         parameter_key: "ParameterKey",
+    #         parameter_value: "ParameterValue",
+    #         use_previous_value: false,
+    #         resolved_value: "ParameterValue",
+    #       },
+    #     ],
+    #     operation_preferences: {
+    #       region_order: ["Region"],
+    #       failure_tolerance_count: 1,
+    #       failure_tolerance_percentage: 1,
+    #       max_concurrent_count: 1,
+    #       max_concurrent_percentage: 1,
+    #     },
+    #     operation_id: "ClientRequestToken",
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.operation_id #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/UpdateStackInstances AWS API Documentation
+    #
+    # @overload update_stack_instances(params = {})
+    # @param [Hash] params ({})
+    def update_stack_instances(params = {}, options = {})
+      req = build_request(:update_stack_instances, params)
+      req.send_request(options)
+    end
+
     # Updates the stack set and *all* associated stack instances.
     #
     # Even if the stack set operation created by updating the stack set
@@ -3113,6 +3319,7 @@ module Aws::CloudFormation
     #         parameter_key: "ParameterKey",
     #         parameter_value: "ParameterValue",
     #         use_previous_value: false,
+    #         resolved_value: "ParameterValue",
     #       },
     #     ],
     #     capabilities: ["CAPABILITY_IAM"], # accepts CAPABILITY_IAM, CAPABILITY_NAMED_IAM
@@ -3271,7 +3478,7 @@ module Aws::CloudFormation
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-cloudformation'
-      context[:gem_version] = '1.2.0'
+      context[:gem_version] = '1.3.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -252,6 +252,8 @@ module Aws::CloudFormation
     TransformsList = Shapes::ListShape.new(name: 'TransformsList')
     Type = Shapes::StringShape.new(name: 'Type')
     UpdateStackInput = Shapes::StructureShape.new(name: 'UpdateStackInput')
+    UpdateStackInstancesInput = Shapes::StructureShape.new(name: 'UpdateStackInstancesInput')
+    UpdateStackInstancesOutput = Shapes::StructureShape.new(name: 'UpdateStackInstancesOutput')
     UpdateStackOutput = Shapes::StructureShape.new(name: 'UpdateStackOutput')
     UpdateStackSetInput = Shapes::StructureShape.new(name: 'UpdateStackSetInput')
     UpdateStackSetOutput = Shapes::StructureShape.new(name: 'UpdateStackSetOutput')
@@ -354,6 +356,7 @@ module Aws::CloudFormation
     CreateStackInstancesInput.add_member(:stack_set_name, Shapes::ShapeRef.new(shape: StackSetName, required: true, location_name: "StackSetName"))
     CreateStackInstancesInput.add_member(:accounts, Shapes::ShapeRef.new(shape: AccountList, required: true, location_name: "Accounts"))
     CreateStackInstancesInput.add_member(:regions, Shapes::ShapeRef.new(shape: RegionList, required: true, location_name: "Regions"))
+    CreateStackInstancesInput.add_member(:parameter_overrides, Shapes::ShapeRef.new(shape: Parameters, location_name: "ParameterOverrides"))
     CreateStackInstancesInput.add_member(:operation_preferences, Shapes::ShapeRef.new(shape: StackSetOperationPreferences, location_name: "OperationPreferences"))
     CreateStackInstancesInput.add_member(:operation_id, Shapes::ShapeRef.new(shape: ClientRequestToken, location_name: "OperationId", metadata: {"idempotencyToken"=>true}))
     CreateStackInstancesInput.struct_class = Types::CreateStackInstancesInput
@@ -633,6 +636,7 @@ module Aws::CloudFormation
     Parameter.add_member(:parameter_key, Shapes::ShapeRef.new(shape: ParameterKey, location_name: "ParameterKey"))
     Parameter.add_member(:parameter_value, Shapes::ShapeRef.new(shape: ParameterValue, location_name: "ParameterValue"))
     Parameter.add_member(:use_previous_value, Shapes::ShapeRef.new(shape: UsePreviousValue, location_name: "UsePreviousValue"))
+    Parameter.add_member(:resolved_value, Shapes::ShapeRef.new(shape: ParameterValue, location_name: "ResolvedValue"))
     Parameter.struct_class = Types::Parameter
 
     ParameterConstraints.add_member(:allowed_values, Shapes::ShapeRef.new(shape: AllowedValues, location_name: "AllowedValues"))
@@ -745,6 +749,7 @@ module Aws::CloudFormation
     StackInstance.add_member(:region, Shapes::ShapeRef.new(shape: Region, location_name: "Region"))
     StackInstance.add_member(:account, Shapes::ShapeRef.new(shape: Account, location_name: "Account"))
     StackInstance.add_member(:stack_id, Shapes::ShapeRef.new(shape: StackId, location_name: "StackId"))
+    StackInstance.add_member(:parameter_overrides, Shapes::ShapeRef.new(shape: Parameters, location_name: "ParameterOverrides"))
     StackInstance.add_member(:status, Shapes::ShapeRef.new(shape: StackInstanceStatus, location_name: "Status"))
     StackInstance.add_member(:status_reason, Shapes::ShapeRef.new(shape: Reason, location_name: "StatusReason"))
     StackInstance.struct_class = Types::StackInstance
@@ -907,6 +912,17 @@ module Aws::CloudFormation
     UpdateStackInput.add_member(:client_request_token, Shapes::ShapeRef.new(shape: ClientRequestToken, location_name: "ClientRequestToken"))
     UpdateStackInput.struct_class = Types::UpdateStackInput
 
+    UpdateStackInstancesInput.add_member(:stack_set_name, Shapes::ShapeRef.new(shape: StackSetName, required: true, location_name: "StackSetName"))
+    UpdateStackInstancesInput.add_member(:accounts, Shapes::ShapeRef.new(shape: AccountList, required: true, location_name: "Accounts"))
+    UpdateStackInstancesInput.add_member(:regions, Shapes::ShapeRef.new(shape: RegionList, required: true, location_name: "Regions"))
+    UpdateStackInstancesInput.add_member(:parameter_overrides, Shapes::ShapeRef.new(shape: Parameters, location_name: "ParameterOverrides"))
+    UpdateStackInstancesInput.add_member(:operation_preferences, Shapes::ShapeRef.new(shape: StackSetOperationPreferences, location_name: "OperationPreferences"))
+    UpdateStackInstancesInput.add_member(:operation_id, Shapes::ShapeRef.new(shape: ClientRequestToken, location_name: "OperationId", metadata: {"idempotencyToken"=>true}))
+    UpdateStackInstancesInput.struct_class = Types::UpdateStackInstancesInput
+
+    UpdateStackInstancesOutput.add_member(:operation_id, Shapes::ShapeRef.new(shape: ClientRequestToken, location_name: "OperationId"))
+    UpdateStackInstancesOutput.struct_class = Types::UpdateStackInstancesOutput
+
     UpdateStackOutput.add_member(:stack_id, Shapes::ShapeRef.new(shape: StackId, location_name: "StackId"))
     UpdateStackOutput.struct_class = Types::UpdateStackOutput
 
@@ -1331,6 +1347,20 @@ module Aws::CloudFormation
         o.errors << Shapes::ShapeRef.new(shape: TokenAlreadyExistsException)
       end)
 
+      api.add_operation(:update_stack_instances, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "UpdateStackInstances"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: UpdateStackInstancesInput)
+        o.output = Shapes::ShapeRef.new(shape: UpdateStackInstancesOutput)
+        o.errors << Shapes::ShapeRef.new(shape: StackSetNotFoundException)
+        o.errors << Shapes::ShapeRef.new(shape: StackInstanceNotFoundException)
+        o.errors << Shapes::ShapeRef.new(shape: OperationInProgressException)
+        o.errors << Shapes::ShapeRef.new(shape: OperationIdAlreadyExistsException)
+        o.errors << Shapes::ShapeRef.new(shape: StaleRequestException)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidOperationException)
+      end)
+
       api.add_operation(:update_stack_set, Seahorse::Model::Operation.new.tap do |o|
         o.name = "UpdateStackSet"
         o.http_method = "POST"

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

@@ -32,6 +32,7 @@ module Aws::CloudFormation
     #         parameter_key: "ParameterKey",
     #         parameter_value: "ParameterValue",
     #         use_previous_value: false,
+    #         resolved_value: "ParameterValue",
     #       },
     #     ],
     #     disable_rollback: false,

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

@@ -381,6 +381,7 @@ module Aws::CloudFormation
     #         parameter_key: "ParameterKey",
     #         parameter_value: "ParameterValue",
     #         use_previous_value: false,
+    #         resolved_value: "ParameterValue",
     #       },
     #     ],
     #     disable_rollback: false,
@@ -660,6 +661,7 @@ module Aws::CloudFormation
     #         parameter_key: "ParameterKey",
     #         parameter_value: "ParameterValue",
     #         use_previous_value: false,
+    #         resolved_value: "ParameterValue",
     #       },
     #     ],
     #     capabilities: ["CAPABILITY_IAM"], # accepts CAPABILITY_IAM, CAPABILITY_NAMED_IAM

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

@@ -329,6 +329,7 @@ module Aws::CloudFormation
     #             parameter_key: "ParameterKey",
     #             parameter_value: "ParameterValue",
     #             use_previous_value: false,
+    #             resolved_value: "ParameterValue",
     #           },
     #         ],
     #         capabilities: ["CAPABILITY_IAM"], # accepts CAPABILITY_IAM, CAPABILITY_NAMED_IAM
@@ -580,6 +581,7 @@ module Aws::CloudFormation
     #             parameter_key: "ParameterKey",
     #             parameter_value: "ParameterValue",
     #             use_previous_value: false,
+    #             resolved_value: "ParameterValue",
     #           },
     #         ],
     #         disable_rollback: false,
@@ -862,6 +864,14 @@ module Aws::CloudFormation
     #         stack_set_name: "StackSetName", # required
     #         accounts: ["Account"], # required
     #         regions: ["Region"], # required
+    #         parameter_overrides: [
+    #           {
+    #             parameter_key: "ParameterKey",
+    #             parameter_value: "ParameterValue",
+    #             use_previous_value: false,
+    #             resolved_value: "ParameterValue",
+    #           },
+    #         ],
     #         operation_preferences: {
     #           region_order: ["Region"],
     #           failure_tolerance_count: 1,
@@ -887,6 +897,46 @@ module Aws::CloudFormation
     #   instances using the specified AWS account(s).
     #   @return [Array<String>]
     #
+    # @!attribute [rw] parameter_overrides
+    #   A list of stack set parameters whose values you want to override in
+    #   the selected stack instances.
+    #
+    #   Any overridden parameter values will be applied to all stack
+    #   instances in the specified accounts and regions. When specifying
+    #   parameters and their values, be aware of how AWS CloudFormation sets
+    #   parameter values during stack instance operations:
+    #
+    #   * To override the current value for a parameter, include the
+    #     parameter and specify its value.
+    #
+    #   * To leave a parameter set to its present value, you can do one of
+    #     the following:
+    #
+    #     * Do not include the parameter in the list.
+    #
+    #     * Include the parameter and specify `UsePreviousValue` as `true`.
+    #       (You cannot specify both a value and set `UsePreviousValue` to
+    #       `true`.)
+    #
+    #   * To set all overridden parameter back to the values specified in
+    #     the stack set, specify a parameter list but do not include any
+    #     parameters.
+    #
+    #   * To leave all parameters set to their present values, do not
+    #     specify this property at all.
+    #
+    #   During stack set updates, any parameter values overridden for a
+    #   stack instance are not updated, but retain their overridden value.
+    #
+    #   You can only override the parameter *values* that are specified in
+    #   the stack set; to add or delete a parameter itself, use
+    #   [UpdateStackSet][1] to update the stack set template.
+    #
+    #
+    #
+    #   [1]: http://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_UpdateStackSet.html
+    #   @return [Array<Types::Parameter>]
+    #
     # @!attribute [rw] operation_preferences
     #   Preferences for how AWS CloudFormation performs this stack set
     #   operation.
@@ -917,6 +967,7 @@ module Aws::CloudFormation
       :stack_set_name,
       :accounts,
       :regions,
+      :parameter_overrides,
       :operation_preferences,
       :operation_id)
       include Aws::Structure
@@ -959,6 +1010,7 @@ module Aws::CloudFormation
     #             parameter_key: "ParameterKey",
     #             parameter_value: "ParameterValue",
     #             use_previous_value: false,
+    #             resolved_value: "ParameterValue",
     #           },
     #         ],
     #         capabilities: ["CAPABILITY_IAM"], # accepts CAPABILITY_IAM, CAPABILITY_NAMED_IAM
@@ -1869,6 +1921,7 @@ module Aws::CloudFormation
     #             parameter_key: "ParameterKey",
     #             parameter_value: "ParameterValue",
     #             use_previous_value: false,
+    #             resolved_value: "ParameterValue",
     #           },
     #         ],
     #       }
@@ -2790,6 +2843,7 @@ module Aws::CloudFormation
     #         parameter_key: "ParameterKey",
     #         parameter_value: "ParameterValue",
     #         use_previous_value: false,
+    #         resolved_value: "ParameterValue",
     #       }
     #
     # @!attribute [rw] parameter_key
@@ -2799,7 +2853,7 @@ module Aws::CloudFormation
     #   @return [String]
     #
     # @!attribute [rw] parameter_value
-    #   The value associated with the parameter.
+    #   The input value associated with the parameter.
     #   @return [String]
     #
     # @!attribute [rw] use_previous_value
@@ -2808,12 +2862,23 @@ module Aws::CloudFormation
     #   not specify a parameter value.
     #   @return [Boolean]
     #
+    # @!attribute [rw] resolved_value
+    #   Read-only. The value that corresponds to a Systems Manager parameter
+    #   key. This field is returned only for [ `SSM` parameter types][1] in
+    #   the template.
+    #
+    #
+    #
+    #   [1]: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/parameters-section-structure.html#aws-ssm-parameter-types
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/Parameter AWS API Documentation
     #
     class Parameter < Struct.new(
       :parameter_key,
       :parameter_value,
-      :use_previous_value)
+      :use_previous_value,
+      :resolved_value)
       include Aws::Structure
     end
 
@@ -3545,6 +3610,11 @@ module Aws::CloudFormation
     #   The ID of the stack instance.
     #   @return [String]
     #
+    # @!attribute [rw] parameter_overrides
+    #   A list of parameters from the stack set template whose values have
+    #   been overridden in this stack instance.
+    #   @return [Array<Types::Parameter>]
+    #
     # @!attribute [rw] status
     #   The status of the stack instance, in terms of its synchronization
     #   with its associated stack set.
@@ -3581,6 +3651,7 @@ module Aws::CloudFormation
       :region,
       :account,
       :stack_id,
+      :parameter_overrides,
       :status,
       :status_reason)
       include Aws::Structure
@@ -4401,6 +4472,7 @@ module Aws::CloudFormation
     #             parameter_key: "ParameterKey",
     #             parameter_value: "ParameterValue",
     #             use_previous_value: false,
+    #             resolved_value: "ParameterValue",
     #           },
     #         ],
     #         capabilities: ["CAPABILITY_IAM"], # accepts CAPABILITY_IAM, CAPABILITY_NAMED_IAM
@@ -4663,6 +4735,140 @@ module Aws::CloudFormation
       include Aws::Structure
     end
 
+    # @note When making an API call, you may pass UpdateStackInstancesInput
+    #   data as a hash:
+    #
+    #       {
+    #         stack_set_name: "StackSetName", # required
+    #         accounts: ["Account"], # required
+    #         regions: ["Region"], # required
+    #         parameter_overrides: [
+    #           {
+    #             parameter_key: "ParameterKey",
+    #             parameter_value: "ParameterValue",
+    #             use_previous_value: false,
+    #             resolved_value: "ParameterValue",
+    #           },
+    #         ],
+    #         operation_preferences: {
+    #           region_order: ["Region"],
+    #           failure_tolerance_count: 1,
+    #           failure_tolerance_percentage: 1,
+    #           max_concurrent_count: 1,
+    #           max_concurrent_percentage: 1,
+    #         },
+    #         operation_id: "ClientRequestToken",
+    #       }
+    #
+    # @!attribute [rw] stack_set_name
+    #   The name or unique ID of the stack set associated with the stack
+    #   instances.
+    #   @return [String]
+    #
+    # @!attribute [rw] accounts
+    #   The names of one or more AWS accounts for which you want to update
+    #   parameter values for stack instances. The overridden parameter
+    #   values will be applied to all stack instances in the specified
+    #   accounts and regions.
+    #   @return [Array<String>]
+    #
+    # @!attribute [rw] regions
+    #   The names of one or more regions in which you want to update
+    #   parameter values for stack instances. The overridden parameter
+    #   values will be applied to all stack instances in the specified
+    #   accounts and regions.
+    #   @return [Array<String>]
+    #
+    # @!attribute [rw] parameter_overrides
+    #   A list of input parameters whose values you want to update for the
+    #   specified stack instances.
+    #
+    #   Any overridden parameter values will be applied to all stack
+    #   instances in the specified accounts and regions. When specifying
+    #   parameters and their values, be aware of how AWS CloudFormation sets
+    #   parameter values during stack instance update operations:
+    #
+    #   * To override the current value for a parameter, include the
+    #     parameter and specify its value.
+    #
+    #   * To leave a parameter set to its present value, you can do one of
+    #     the following:
+    #
+    #     * Do not include the parameter in the list.
+    #
+    #     * Include the parameter and specify `UsePreviousValue` as `true`.
+    #       (You cannot specify both a value and set `UsePreviousValue` to
+    #       `true`.)
+    #
+    #   * To set all overridden parameter back to the values specified in
+    #     the stack set, specify a parameter list but do not include any
+    #     parameters.
+    #
+    #   * To leave all parameters set to their present values, do not
+    #     specify this property at all.
+    #
+    #   During stack set updates, any parameter values overridden for a
+    #   stack instance are not updated, but retain their overridden value.
+    #
+    #   You can only override the parameter *values* that are specified in
+    #   the stack set; to add or delete a parameter itself, use
+    #   `UpdateStackSet` to update the stack set template. If you add a
+    #   parameter to a template, before you can override the parameter value
+    #   specified in the stack set you must first use [UpdateStackSet][1] to
+    #   update all stack instances with the updated template and parameter
+    #   value specified in the stack set. Once a stack instance has been
+    #   updated with the new parameter, you can then override the parameter
+    #   value using `UpdateStackInstances`.
+    #
+    #
+    #
+    #   [1]: http://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_UpdateStackSet.html
+    #   @return [Array<Types::Parameter>]
+    #
+    # @!attribute [rw] operation_preferences
+    #   Preferences for how AWS CloudFormation performs this stack set
+    #   operation.
+    #   @return [Types::StackSetOperationPreferences]
+    #
+    # @!attribute [rw] operation_id
+    #   The unique identifier for this stack set operation.
+    #
+    #   The operation ID also functions as an idempotency token, to ensure
+    #   that AWS CloudFormation performs the stack set operation only once,
+    #   even if you retry the request multiple times. You might retry stack
+    #   set operation requests to ensure that AWS CloudFormation
+    #   successfully received them.
+    #
+    #   If you don't specify an operation ID, the SDK generates one
+    #   automatically.
+    #
+    #   **A suitable default value is auto-generated.** You should normally
+    #   not need to pass this option.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/UpdateStackInstancesInput AWS API Documentation
+    #
+    class UpdateStackInstancesInput < Struct.new(
+      :stack_set_name,
+      :accounts,
+      :regions,
+      :parameter_overrides,
+      :operation_preferences,
+      :operation_id)
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] operation_id
+    #   The unique identifier for this stack set operation.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/UpdateStackInstancesOutput AWS API Documentation
+    #
+    class UpdateStackInstancesOutput < Struct.new(
+      :operation_id)
+      include Aws::Structure
+    end
+
     # The output for an UpdateStack action.
     #
     # @!attribute [rw] stack_id
@@ -4690,6 +4896,7 @@ module Aws::CloudFormation
     #             parameter_key: "ParameterKey",
     #             parameter_value: "ParameterValue",
     #             use_previous_value: false,
+    #             resolved_value: "ParameterValue",
     #           },
     #         ],
     #         capabilities: ["CAPABILITY_IAM"], # accepts CAPABILITY_IAM, CAPABILITY_NAMED_IAM

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-cloudformation
 version: !ruby/object:Gem::Version
-  version: 1.2.0
+  version: 1.3.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-09-26 00:00:00.000000000 Z
+date: 2017-11-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core