aws-sdk-cloudformation 1.4.0 → 1.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 60b82b35bd370c2c60f0c4cdf18ed53912d62bf6
-  data.tar.gz: 213eafd786339f4f1d7caff2ade9a8058c93dfc6
+  metadata.gz: d61c6b15e2d8b7fbc07fea79d132a684772d8b07
+  data.tar.gz: a8dea38889fa3c74b35c0d5a1214a6add99f7b94
 SHA512:
-  metadata.gz: 9d4fa786595403b40603a7c90f41c4ef7dbd70dcf142342081adaacf8e20542b2e5f7ccf29b28acc4955ec534c47a337df8ac0c1801b92055b95554c9ba831a7
-  data.tar.gz: 99a59a6b26c5ad1d0fb8a3df871e696113cad90c57843894dd669ef0701a3203f6f049474c3acda2edc0fa72da2bc9188d37ac573aa9c3c299b6a704ffa5e432
+  metadata.gz: 4d65ac5b5b78dc357316f15665724011b37db374f36bdb6202f8a1d5b107f45a322028c37e155b66fc4dcafbbfe40a6e91ed3b42e63cb2ebfbaa5f3e57e04c9e
+  data.tar.gz: 0e4eeb802414a646cf2f1aebcb1c9baa0871a8e23a24e820f6f4d4a44240f536c934c6bfacfb2dc997c5dd3a9e0304415091fd3ecae3adf3a873989c0e79e1c7

data/lib/aws-sdk-cloudformation.rb

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

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

@@ -1020,13 +1020,23 @@ module Aws::CloudFormation
     #   Specify an IAM role only if you are using customized administrator
     #   roles to control which users or groups can manage specific stack sets
     #   within the same administrator account. For more information, see
-    #   [Define Permissions for Multiple Administrators][1] in the *AWS
-    #   CloudFormation User Guide*.
+    #   [Prerequisites: Granting Permissions for Stack Set Operations][1] in
+    #   the *AWS CloudFormation User Guide*.
     #
     #
     #
     #   [1]: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-prereqs.html
     #
+    # @option params [String] :execution_role_name
+    #   The name of the IAM execution role to use to create the stack set. If
+    #   you do not specify an execution role, AWS CloudFormation uses the
+    #   `AWSCloudFormationStackSetExecutionRole` role for the stack set
+    #   operation.
+    #
+    #   Specify an IAM role only if you are using customized execution roles
+    #   to control which stack resources users and groups can include in their
+    #   stack sets.
+    #
     # @option params [String] :client_request_token
     #   A unique identifier for this `CreateStackSet` request. Specify this
     #   token if you plan to retry requests so that AWS CloudFormation knows
@@ -1067,6 +1077,7 @@ module Aws::CloudFormation
     #       },
     #     ],
     #     administration_role_arn: "RoleARN",
+    #     execution_role_name: "ExecutionRoleName",
     #     client_request_token: "ClientRequestToken",
     #   })
     #
@@ -1726,6 +1737,7 @@ module Aws::CloudFormation
     #   resp.stack_set.tags[0].value #=> String
     #   resp.stack_set.stack_set_arn #=> String
     #   resp.stack_set.administration_role_arn #=> String
+    #   resp.stack_set.execution_role_name #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/DescribeStackSet AWS API Documentation
     #
@@ -1770,6 +1782,7 @@ module Aws::CloudFormation
     #   resp.stack_set_operation.operation_preferences.max_concurrent_percentage #=> Integer
     #   resp.stack_set_operation.retain_stacks #=> Boolean
     #   resp.stack_set_operation.administration_role_arn #=> String
+    #   resp.stack_set_operation.execution_role_name #=> String
     #   resp.stack_set_operation.creation_timestamp #=> Time
     #   resp.stack_set_operation.end_timestamp #=> Time
     #
@@ -3143,7 +3156,7 @@ module Aws::CloudFormation
     # @example Request syntax with placeholder values
     #
     #   resp = client.update_stack_instances({
-    #     stack_set_name: "StackSetName", # required
+    #     stack_set_name: "StackSetNameOrId", # required
     #     accounts: ["Account"], # required
     #     regions: ["Region"], # required
     #     parameter_overrides: [
@@ -3177,7 +3190,8 @@ module Aws::CloudFormation
       req.send_request(options)
     end
 
-    # Updates the stack set and *all* associated stack instances.
+    # Updates the stack set, and associated stack instances in the specified
+    # accounts and regions.
     #
     # Even if the stack set operation created by updating the stack set
     # fails (completely or partially, below or above a specified failure
@@ -3322,6 +3336,22 @@ module Aws::CloudFormation
     #
     #   [1]: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-prereqs.html
     #
+    # @option params [String] :execution_role_name
+    #   The name of the IAM execution role to use to update the stack set. If
+    #   you do not specify an execution role, AWS CloudFormation uses the
+    #   `AWSCloudFormationStackSetExecutionRole` role for the stack set
+    #   operation.
+    #
+    #   Specify an IAM role only if you are using customized execution roles
+    #   to control which stack resources users and groups can include in their
+    #   stack sets.
+    #
+    #   If you specify a customized execution role, AWS CloudFormation uses
+    #   that role to update the stack. If you do not specify a customized
+    #   execution role, AWS CloudFormation performs the update using the role
+    #   previously associated with the stack set, so long as you have
+    #   permissions to perform operations on the stack set.
+    #
     # @option params [String] :operation_id
     #   The unique ID for this stack set operation.
     #
@@ -3340,6 +3370,42 @@ module Aws::CloudFormation
     #   **A suitable default value is auto-generated.** You should normally
     #   not need to pass this option.**
     #
+    # @option params [Array<String>] :accounts
+    #   The accounts in which to update associated stack instances. If you
+    #   specify accounts, you must also specify the regions in which to update
+    #   stack set instances.
+    #
+    #   To update *all* the stack instances associated with this stack set, do
+    #   not specify the `Accounts` or `Regions` properties.
+    #
+    #   If the stack set update includes changes to the template (that is, if
+    #   the `TemplateBody` or `TemplateURL` properties are specified), or the
+    #   `Parameters` property, AWS CloudFormation marks all stack instances
+    #   with a status of `OUTDATED` prior to updating the stack instances in
+    #   the specified accounts and regions. If the stack set update does not
+    #   include changes to the template or parameters, AWS CloudFormation
+    #   updates the stack instances in the specified accounts and regions,
+    #   while leaving all other stack instances with their existing stack
+    #   instance status.
+    #
+    # @option params [Array<String>] :regions
+    #   The regions in which to update associated stack instances. If you
+    #   specify regions, you must also specify accounts in which to update
+    #   stack set instances.
+    #
+    #   To update *all* the stack instances associated with this stack set, do
+    #   not specify the `Accounts` or `Regions` properties.
+    #
+    #   If the stack set update includes changes to the template (that is, if
+    #   the `TemplateBody` or `TemplateURL` properties are specified), or the
+    #   `Parameters` property, AWS CloudFormation marks all stack instances
+    #   with a status of `OUTDATED` prior to updating the stack instances in
+    #   the specified accounts and regions. If the stack set update does not
+    #   include changes to the template or parameters, AWS CloudFormation
+    #   updates the stack instances in the specified accounts and regions,
+    #   while leaving all other stack instances with their existing stack
+    #   instance status.
+    #
     # @return [Types::UpdateStackSetOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::UpdateStackSetOutput#operation_id #operation_id} => String
@@ -3375,7 +3441,10 @@ module Aws::CloudFormation
     #       max_concurrent_percentage: 1,
     #     },
     #     administration_role_arn: "RoleARN",
+    #     execution_role_name: "ExecutionRoleName",
     #     operation_id: "ClientRequestToken",
+    #     accounts: ["Account"],
+    #     regions: ["Region"],
     #   })
     #
     # @example Response structure
@@ -3517,7 +3586,7 @@ module Aws::CloudFormation
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-cloudformation'
-      context[:gem_version] = '1.4.0'
+      context[:gem_version] = '1.5.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -90,6 +90,7 @@ module Aws::CloudFormation
     EventId = Shapes::StringShape.new(name: 'EventId')
     ExecuteChangeSetInput = Shapes::StructureShape.new(name: 'ExecuteChangeSetInput')
     ExecuteChangeSetOutput = Shapes::StructureShape.new(name: 'ExecuteChangeSetOutput')
+    ExecutionRoleName = Shapes::StringShape.new(name: 'ExecutionRoleName')
     ExecutionStatus = Shapes::StringShape.new(name: 'ExecutionStatus')
     Export = Shapes::StructureShape.new(name: 'Export')
     ExportName = Shapes::StringShape.new(name: 'ExportName')
@@ -376,6 +377,7 @@ module Aws::CloudFormation
     CreateStackSetInput.add_member(:capabilities, Shapes::ShapeRef.new(shape: Capabilities, location_name: "Capabilities"))
     CreateStackSetInput.add_member(:tags, Shapes::ShapeRef.new(shape: Tags, location_name: "Tags"))
     CreateStackSetInput.add_member(:administration_role_arn, Shapes::ShapeRef.new(shape: RoleARN, location_name: "AdministrationRoleARN"))
+    CreateStackSetInput.add_member(:execution_role_name, Shapes::ShapeRef.new(shape: ExecutionRoleName, location_name: "ExecutionRoleName"))
     CreateStackSetInput.add_member(:client_request_token, Shapes::ShapeRef.new(shape: ClientRequestToken, location_name: "ClientRequestToken", metadata: {"idempotencyToken"=>true}))
     CreateStackSetInput.struct_class = Types::CreateStackSetInput
 
@@ -811,6 +813,7 @@ module Aws::CloudFormation
     StackSet.add_member(:tags, Shapes::ShapeRef.new(shape: Tags, location_name: "Tags"))
     StackSet.add_member(:stack_set_arn, Shapes::ShapeRef.new(shape: StackSetARN, location_name: "StackSetARN"))
     StackSet.add_member(:administration_role_arn, Shapes::ShapeRef.new(shape: RoleARN, location_name: "AdministrationRoleARN"))
+    StackSet.add_member(:execution_role_name, Shapes::ShapeRef.new(shape: ExecutionRoleName, location_name: "ExecutionRoleName"))
     StackSet.struct_class = Types::StackSet
 
     StackSetOperation.add_member(:operation_id, Shapes::ShapeRef.new(shape: ClientRequestToken, location_name: "OperationId"))
@@ -820,6 +823,7 @@ module Aws::CloudFormation
     StackSetOperation.add_member(:operation_preferences, Shapes::ShapeRef.new(shape: StackSetOperationPreferences, location_name: "OperationPreferences"))
     StackSetOperation.add_member(:retain_stacks, Shapes::ShapeRef.new(shape: RetainStacksNullable, location_name: "RetainStacks"))
     StackSetOperation.add_member(:administration_role_arn, Shapes::ShapeRef.new(shape: RoleARN, location_name: "AdministrationRoleARN"))
+    StackSetOperation.add_member(:execution_role_name, Shapes::ShapeRef.new(shape: ExecutionRoleName, location_name: "ExecutionRoleName"))
     StackSetOperation.add_member(:creation_timestamp, Shapes::ShapeRef.new(shape: Timestamp, location_name: "CreationTimestamp"))
     StackSetOperation.add_member(:end_timestamp, Shapes::ShapeRef.new(shape: Timestamp, location_name: "EndTimestamp"))
     StackSetOperation.struct_class = Types::StackSetOperation
@@ -917,7 +921,7 @@ 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(:stack_set_name, Shapes::ShapeRef.new(shape: StackSetNameOrId, 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"))
@@ -941,7 +945,10 @@ module Aws::CloudFormation
     UpdateStackSetInput.add_member(:tags, Shapes::ShapeRef.new(shape: Tags, location_name: "Tags"))
     UpdateStackSetInput.add_member(:operation_preferences, Shapes::ShapeRef.new(shape: StackSetOperationPreferences, location_name: "OperationPreferences"))
     UpdateStackSetInput.add_member(:administration_role_arn, Shapes::ShapeRef.new(shape: RoleARN, location_name: "AdministrationRoleARN"))
+    UpdateStackSetInput.add_member(:execution_role_name, Shapes::ShapeRef.new(shape: ExecutionRoleName, location_name: "ExecutionRoleName"))
     UpdateStackSetInput.add_member(:operation_id, Shapes::ShapeRef.new(shape: ClientRequestToken, location_name: "OperationId", metadata: {"idempotencyToken"=>true}))
+    UpdateStackSetInput.add_member(:accounts, Shapes::ShapeRef.new(shape: AccountList, location_name: "Accounts"))
+    UpdateStackSetInput.add_member(:regions, Shapes::ShapeRef.new(shape: RegionList, location_name: "Regions"))
     UpdateStackSetInput.struct_class = Types::UpdateStackSetInput
 
     UpdateStackSetOutput.add_member(:operation_id, Shapes::ShapeRef.new(shape: ClientRequestToken, location_name: "OperationId"))
@@ -1378,6 +1385,7 @@ module Aws::CloudFormation
         o.errors << Shapes::ShapeRef.new(shape: OperationIdAlreadyExistsException)
         o.errors << Shapes::ShapeRef.new(shape: StaleRequestException)
         o.errors << Shapes::ShapeRef.new(shape: InvalidOperationException)
+        o.errors << Shapes::ShapeRef.new(shape: StackInstanceNotFoundException)
       end)
 
       api.add_operation(:update_termination_protection, Seahorse::Model::Operation.new.tap do |o|

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

@@ -1021,6 +1021,7 @@ module Aws::CloudFormation
     #           },
     #         ],
     #         administration_role_arn: "RoleARN",
+    #         execution_role_name: "ExecutionRoleName",
     #         client_request_token: "ClientRequestToken",
     #       }
     #
@@ -1135,14 +1136,25 @@ module Aws::CloudFormation
     #   Specify an IAM role only if you are using customized administrator
     #   roles to control which users or groups can manage specific stack
     #   sets within the same administrator account. For more information,
-    #   see [Define Permissions for Multiple Administrators][1] in the *AWS
-    #   CloudFormation User Guide*.
+    #   see [Prerequisites: Granting Permissions for Stack Set
+    #   Operations][1] in the *AWS CloudFormation User Guide*.
     #
     #
     #
     #   [1]: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-prereqs.html
     #   @return [String]
     #
+    # @!attribute [rw] execution_role_name
+    #   The name of the IAM execution role to use to create the stack set.
+    #   If you do not specify an execution role, AWS CloudFormation uses the
+    #   `AWSCloudFormationStackSetExecutionRole` role for the stack set
+    #   operation.
+    #
+    #   Specify an IAM role only if you are using customized execution roles
+    #   to control which stack resources users and groups can include in
+    #   their stack sets.
+    #   @return [String]
+    #
     # @!attribute [rw] client_request_token
     #   A unique identifier for this `CreateStackSet` request. Specify this
     #   token if you plan to retry requests so that AWS CloudFormation knows
@@ -1168,6 +1180,7 @@ module Aws::CloudFormation
       :capabilities,
       :tags,
       :administration_role_arn,
+      :execution_role_name,
       :client_request_token)
       include Aws::Structure
     end
@@ -3952,14 +3965,23 @@ module Aws::CloudFormation
     #
     #   Use customized administrator roles to control which users or groups
     #   can manage specific stack sets within the same administrator
-    #   account. For more information, see [Define Permissions for Multiple
-    #   Administrators][1] in the *AWS CloudFormation User Guide*.
+    #   account. For more information, see [Prerequisites: Granting
+    #   Permissions for Stack Set Operations][1] in the *AWS CloudFormation
+    #   User Guide*.
     #
     #
     #
     #   [1]: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-prereqs.html
     #   @return [String]
     #
+    # @!attribute [rw] execution_role_name
+    #   The name of the IAM execution role used to create or update the
+    #   stack set.
+    #
+    #   Use customized execution roles to control which stack resources
+    #   users and groups can include in their stack sets.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/StackSet AWS API Documentation
     #
     class StackSet < Struct.new(
@@ -3972,7 +3994,8 @@ module Aws::CloudFormation
       :capabilities,
       :tags,
       :stack_set_arn,
-      :administration_role_arn)
+      :administration_role_arn,
+      :execution_role_name)
       include Aws::Structure
     end
 
@@ -4044,6 +4067,14 @@ module Aws::CloudFormation
     #   [1]: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-prereqs.html
     #   @return [String]
     #
+    # @!attribute [rw] execution_role_name
+    #   The name of the IAM execution role used to create or update the
+    #   stack set.
+    #
+    #   Use customized execution roles to control which stack resources
+    #   users and groups can include in their stack sets.
+    #   @return [String]
+    #
     # @!attribute [rw] creation_timestamp
     #   The time at which the operation was initiated. Note that the
     #   creation times for the stack set operation might differ from the
@@ -4070,6 +4101,7 @@ module Aws::CloudFormation
       :operation_preferences,
       :retain_stacks,
       :administration_role_arn,
+      :execution_role_name,
       :creation_timestamp,
       :end_timestamp)
       include Aws::Structure
@@ -4774,7 +4806,7 @@ module Aws::CloudFormation
     #   data as a hash:
     #
     #       {
-    #         stack_set_name: "StackSetName", # required
+    #         stack_set_name: "StackSetNameOrId", # required
     #         accounts: ["Account"], # required
     #         regions: ["Region"], # required
     #         parameter_overrides: [
@@ -4949,7 +4981,10 @@ module Aws::CloudFormation
     #           max_concurrent_percentage: 1,
     #         },
     #         administration_role_arn: "RoleARN",
+    #         execution_role_name: "ExecutionRoleName",
     #         operation_id: "ClientRequestToken",
+    #         accounts: ["Account"],
+    #         regions: ["Region"],
     #       }
     #
     # @!attribute [rw] stack_set_name
@@ -5107,6 +5142,23 @@ module Aws::CloudFormation
     #   [1]: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-prereqs.html
     #   @return [String]
     #
+    # @!attribute [rw] execution_role_name
+    #   The name of the IAM execution role to use to update the stack set.
+    #   If you do not specify an execution role, AWS CloudFormation uses the
+    #   `AWSCloudFormationStackSetExecutionRole` role for the stack set
+    #   operation.
+    #
+    #   Specify an IAM role only if you are using customized execution roles
+    #   to control which stack resources users and groups can include in
+    #   their stack sets.
+    #
+    #   If you specify a customized execution role, AWS CloudFormation uses
+    #   that role to update the stack. If you do not specify a customized
+    #   execution role, AWS CloudFormation performs the update using the
+    #   role previously associated with the stack set, so long as you have
+    #   permissions to perform operations on the stack set.
+    #   @return [String]
+    #
     # @!attribute [rw] operation_id
     #   The unique ID for this stack set operation.
     #
@@ -5126,6 +5178,44 @@ module Aws::CloudFormation
     #   not need to pass this option.
     #   @return [String]
     #
+    # @!attribute [rw] accounts
+    #   The accounts in which to update associated stack instances. If you
+    #   specify accounts, you must also specify the regions in which to
+    #   update stack set instances.
+    #
+    #   To update *all* the stack instances associated with this stack set,
+    #   do not specify the `Accounts` or `Regions` properties.
+    #
+    #   If the stack set update includes changes to the template (that is,
+    #   if the `TemplateBody` or `TemplateURL` properties are specified), or
+    #   the `Parameters` property, AWS CloudFormation marks all stack
+    #   instances with a status of `OUTDATED` prior to updating the stack
+    #   instances in the specified accounts and regions. If the stack set
+    #   update does not include changes to the template or parameters, AWS
+    #   CloudFormation updates the stack instances in the specified accounts
+    #   and regions, while leaving all other stack instances with their
+    #   existing stack instance status.
+    #   @return [Array<String>]
+    #
+    # @!attribute [rw] regions
+    #   The regions in which to update associated stack instances. If you
+    #   specify regions, you must also specify accounts in which to update
+    #   stack set instances.
+    #
+    #   To update *all* the stack instances associated with this stack set,
+    #   do not specify the `Accounts` or `Regions` properties.
+    #
+    #   If the stack set update includes changes to the template (that is,
+    #   if the `TemplateBody` or `TemplateURL` properties are specified), or
+    #   the `Parameters` property, AWS CloudFormation marks all stack
+    #   instances with a status of `OUTDATED` prior to updating the stack
+    #   instances in the specified accounts and regions. If the stack set
+    #   update does not include changes to the template or parameters, AWS
+    #   CloudFormation updates the stack instances in the specified accounts
+    #   and regions, while leaving all other stack instances with their
+    #   existing stack instance status.
+    #   @return [Array<String>]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/UpdateStackSetInput AWS API Documentation
     #
     class UpdateStackSetInput < Struct.new(
@@ -5139,7 +5229,10 @@ module Aws::CloudFormation
       :tags,
       :operation_preferences,
       :administration_role_arn,
-      :operation_id)
+      :execution_role_name,
+      :operation_id,
+      :accounts,
+      :regions)
       include Aws::Structure
     end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-cloudformation
 version: !ruby/object:Gem::Version
-  version: 1.4.0
+  version: 1.5.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-03-29 00:00:00.000000000 Z
+date: 2018-05-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core
@@ -80,7 +80,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.5.2.2
+rubygems_version: 2.5.2.3
 signing_key: 
 specification_version: 4
 summary: AWS SDK for Ruby - AWS CloudFormation