aws-sdk-cloudformation 1.3.0 → 1.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 060aa2dd7926f49933ab1d888e1171a6b4c27b93
-  data.tar.gz: 8f3c02f5f639b9f34491ce7ed68bb4956f197596
+  metadata.gz: 60b82b35bd370c2c60f0c4cdf18ed53912d62bf6
+  data.tar.gz: 213eafd786339f4f1d7caff2ade9a8058c93dfc6
 SHA512:
-  metadata.gz: 63ac221fb9cdb3ea440507c574591cc257935dcf2ed012de224ca6e4c102e1d3eb1bfa5ee903b8e263460f7c11b586d3d377655e1f8061f3dbf5f23f600610ef
-  data.tar.gz: 742ca06823d948210cbe18544bfee791f88a9253536e175eb758f5b385e13f32ffa4c9d7b37a283d18c2ae696506d7277ffb4af4e394a18d17ba72ee47104276
+  metadata.gz: 9d4fa786595403b40603a7c90f41c4ef7dbd70dcf142342081adaacf8e20542b2e5f7ccf29b28acc4955ec534c47a337df8ac0c1801b92055b95554c9ba831a7
+  data.tar.gz: 99a59a6b26c5ad1d0fb8a3df871e696113cad90c57843894dd669ef0701a3203f6f049474c3acda2edc0fa72da2bc9188d37ac573aa9c3c299b6a704ffa5e432

data/lib/aws-sdk-cloudformation.rb

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

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

@@ -1013,6 +1013,20 @@ module Aws::CloudFormation
     #   to tag resources. If you don't, the entire `CreateStackSet` action
     #   fails with an `access denied` error, and the stack set is not created.
     #
+    # @option params [String] :administration_role_arn
+    #   The Amazon Resource Number (ARN) of the IAM role to use to create this
+    #   stack set.
+    #
+    #   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*.
+    #
+    #
+    #
+    #   [1]: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-prereqs.html
+    #
     # @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
@@ -1052,6 +1066,7 @@ module Aws::CloudFormation
     #         value: "TagValue", # required
     #       },
     #     ],
+    #     administration_role_arn: "RoleARN",
     #     client_request_token: "ClientRequestToken",
     #   })
     #
@@ -1709,6 +1724,8 @@ module Aws::CloudFormation
     #   resp.stack_set.tags #=> Array
     #   resp.stack_set.tags[0].key #=> String
     #   resp.stack_set.tags[0].value #=> String
+    #   resp.stack_set.stack_set_arn #=> String
+    #   resp.stack_set.administration_role_arn #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/DescribeStackSet AWS API Documentation
     #
@@ -1752,6 +1769,7 @@ module Aws::CloudFormation
     #   resp.stack_set_operation.operation_preferences.max_concurrent_count #=> Integer
     #   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.creation_timestamp #=> Time
     #   resp.stack_set_operation.end_timestamp #=> Time
     #
@@ -3284,6 +3302,26 @@ module Aws::CloudFormation
     #   Preferences for how AWS CloudFormation performs this stack set
     #   operation.
     #
+    # @option params [String] :administration_role_arn
+    #   The Amazon Resource Number (ARN) of the IAM role to use to update this
+    #   stack set.
+    #
+    #   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*.
+    #
+    #   If you specify a customized administrator role, AWS CloudFormation
+    #   uses that role to update the stack. If you do not specify a customized
+    #   administrator 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.
+    #
+    #
+    #
+    #   [1]: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-prereqs.html
+    #
     # @option params [String] :operation_id
     #   The unique ID for this stack set operation.
     #
@@ -3336,6 +3374,7 @@ module Aws::CloudFormation
     #       max_concurrent_count: 1,
     #       max_concurrent_percentage: 1,
     #     },
+    #     administration_role_arn: "RoleARN",
     #     operation_id: "ClientRequestToken",
     #   })
     #
@@ -3478,7 +3517,7 @@ module Aws::CloudFormation
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-cloudformation'
-      context[:gem_version] = '1.3.0'
+      context[:gem_version] = '1.4.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -208,6 +208,7 @@ module Aws::CloudFormation
     StackResourceSummary = Shapes::StructureShape.new(name: 'StackResourceSummary')
     StackResources = Shapes::ListShape.new(name: 'StackResources')
     StackSet = Shapes::StructureShape.new(name: 'StackSet')
+    StackSetARN = Shapes::StringShape.new(name: 'StackSetARN')
     StackSetId = Shapes::StringShape.new(name: 'StackSetId')
     StackSetName = Shapes::StringShape.new(name: 'StackSetName')
     StackSetNameOrId = Shapes::StringShape.new(name: 'StackSetNameOrId')
@@ -374,6 +375,7 @@ module Aws::CloudFormation
     CreateStackSetInput.add_member(:parameters, Shapes::ShapeRef.new(shape: Parameters, location_name: "Parameters"))
     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(:client_request_token, Shapes::ShapeRef.new(shape: ClientRequestToken, location_name: "ClientRequestToken", metadata: {"idempotencyToken"=>true}))
     CreateStackSetInput.struct_class = Types::CreateStackSetInput
 
@@ -807,6 +809,8 @@ module Aws::CloudFormation
     StackSet.add_member(:parameters, Shapes::ShapeRef.new(shape: Parameters, location_name: "Parameters"))
     StackSet.add_member(:capabilities, Shapes::ShapeRef.new(shape: Capabilities, location_name: "Capabilities"))
     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.struct_class = Types::StackSet
 
     StackSetOperation.add_member(:operation_id, Shapes::ShapeRef.new(shape: ClientRequestToken, location_name: "OperationId"))
@@ -815,6 +819,7 @@ module Aws::CloudFormation
     StackSetOperation.add_member(:status, Shapes::ShapeRef.new(shape: StackSetOperationStatus, location_name: "Status"))
     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(: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
@@ -935,6 +940,7 @@ module Aws::CloudFormation
     UpdateStackSetInput.add_member(:capabilities, Shapes::ShapeRef.new(shape: Capabilities, location_name: "Capabilities"))
     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(:operation_id, Shapes::ShapeRef.new(shape: ClientRequestToken, location_name: "OperationId", metadata: {"idempotencyToken"=>true}))
     UpdateStackSetInput.struct_class = Types::UpdateStackSetInput
 

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

@@ -1020,6 +1020,7 @@ module Aws::CloudFormation
     #             value: "TagValue", # required
     #           },
     #         ],
+    #         administration_role_arn: "RoleARN",
     #         client_request_token: "ClientRequestToken",
     #       }
     #
@@ -1127,6 +1128,21 @@ module Aws::CloudFormation
     #   created.
     #   @return [Array<Types::Tag>]
     #
+    # @!attribute [rw] administration_role_arn
+    #   The Amazon Resource Number (ARN) of the IAM role to use to create
+    #   this stack set.
+    #
+    #   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*.
+    #
+    #
+    #
+    #   [1]: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-prereqs.html
+    #   @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
@@ -1151,6 +1167,7 @@ module Aws::CloudFormation
       :parameters,
       :capabilities,
       :tags,
+      :administration_role_arn,
       :client_request_token)
       include Aws::Structure
     end
@@ -3125,29 +3142,12 @@ module Aws::CloudFormation
     # Rollback triggers enable you to have AWS CloudFormation monitor the
     # state of your application during stack creation and updating, and to
     # roll back that operation if the application breaches the threshold of
-    # any of the alarms you've specified. For each rollback trigger you
-    # create, you specify the Cloudwatch alarm that CloudFormation should
-    # monitor. CloudFormation monitors the specified alarms during the stack
-    # create or update operation, and for the specified amount of time after
-    # all resources have been deployed. If any of the alarms goes to ALERT
-    # state during the stack operation or the monitoring period,
-    # CloudFormation rolls back the entire stack operation. If the
-    # monitoring period expires without any alarms going to ALERT state,
-    # CloudFormation proceeds to dispose of old resources as usual.
-    #
-    # By default, CloudFormation only rolls back stack operations if an
-    # alarm goes to ALERT state, not INSUFFICIENT\_DATA state. To have
-    # CloudFormation roll back the stack operation if an alarm goes to
-    # INSUFFICIENT\_DATA state as well, edit the CloudWatch alarm to treat
-    # missing data as `breaching`. For more information, see [Configuring
-    # How CloudWatch Alarms Treats Missing Data][1].
-    #
-    # AWS CloudFormation does not monitor rollback triggers when it rolls
-    # back a stack during an update operation.
+    # any of the alarms you've specified. For more information, see
+    # [Monitor and Roll Back Stack Operations][1].
     #
     #
     #
-    # [1]: http://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html
+    # [1]: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-rollback-triggers.html
     #
     # @note When making an API call, you may pass RollbackConfiguration
     #   data as a hash:
@@ -3171,37 +3171,34 @@ module Aws::CloudFormation
     #   triggers for this parameter, those triggers replace any list of
     #   triggers previously specified for the stack. This means:
     #
-    #   * If you don't specify this parameter, AWS CloudFormation uses the
-    #     rollback triggers previously specified for this stack, if any.
+    #   * To use the rollback triggers previously specified for this stack,
+    #     if any, don't specify this parameter.
     #
-    #   * If you specify any rollback triggers using this parameter, you
-    #     must specify all the triggers that you want used for this stack,
-    #     even triggers you've specifed before (for example, when creating
-    #     the stack or during a previous stack update). Any triggers that
-    #     you don't include in the updated list of triggers are no longer
+    #   * To specify new or updated rollback triggers, you must specify
+    #     *all* the triggers that you want used for this stack, even
+    #     triggers you've specifed before (for example, when creating the
+    #     stack or during a previous stack update). Any triggers that you
+    #     don't include in the updated list of triggers are no longer
     #     applied to the stack.
     #
-    #   * If you specify an empty list, AWS CloudFormation removes all
-    #     currently specified triggers.
+    #   * To remove all currently specified triggers, specify an empty list
+    #     for this parameter.
     #
-    #   If a specified Cloudwatch alarm is missing, the entire stack
-    #   operation fails and is rolled back.
+    #   If a specified trigger is missing, the entire stack operation fails
+    #   and is rolled back.
     #   @return [Array<Types::RollbackTrigger>]
     #
     # @!attribute [rw] monitoring_time_in_minutes
     #   The amount of time, in minutes, during which CloudFormation should
     #   monitor all the rollback triggers after the stack creation or update
-    #   operation deploys all necessary resources. If any of the alarms goes
-    #   to ALERT state during the stack operation or this monitoring period,
-    #   CloudFormation rolls back the entire stack operation. Then, for
-    #   update operations, if the monitoring period expires without any
-    #   alarms going to ALERT state CloudFormation proceeds to dispose of
-    #   old resources as usual.
+    #   operation deploys all necessary resources.
+    #
+    #   The default is 0 minutes.
     #
     #   If you specify a monitoring period but do not specify any rollback
     #   triggers, CloudFormation still waits the specified period of time
-    #   before cleaning up old resources for update operations. You can use
-    #   this monitoring period to perform any manual stack validation
+    #   before cleaning up old resources after update operations. You can
+    #   use this monitoring period to perform any manual stack validation
     #   desired, and manually cancel the stack creation or update (using
     #   [CancelUpdateStack][1], for example) as necessary.
     #
@@ -3224,7 +3221,7 @@ module Aws::CloudFormation
     end
 
     # A rollback trigger AWS CloudFormation monitors during creation and
-    # updating of stacks. If any of the alarms you specify goes to ALERT
+    # updating of stacks. If any of the alarms you specify goes to ALARM
     # state during the stack operation or within the specified monitoring
     # period afterwards, CloudFormation rolls back the entire stack
     # operation.
@@ -3239,6 +3236,9 @@ module Aws::CloudFormation
     #
     # @!attribute [rw] arn
     #   The Amazon Resource Name (ARN) of the rollback trigger.
+    #
+    #   If a specified trigger is missing, the entire stack operation fails
+    #   and is rolled back.
     #   @return [String]
     #
     # @!attribute [rw] type
@@ -3942,6 +3942,24 @@ module Aws::CloudFormation
     #   maximum number of 50 tags can be specified.
     #   @return [Array<Types::Tag>]
     #
+    # @!attribute [rw] stack_set_arn
+    #   The Amazon Resource Number (ARN) of the stack set.
+    #   @return [String]
+    #
+    # @!attribute [rw] administration_role_arn
+    #   The Amazon Resource Number (ARN) of the IAM role used to create or
+    #   update the stack set.
+    #
+    #   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*.
+    #
+    #
+    #
+    #   [1]: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-prereqs.html
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/StackSet AWS API Documentation
     #
     class StackSet < Struct.new(
@@ -3952,7 +3970,9 @@ module Aws::CloudFormation
       :template_body,
       :parameters,
       :capabilities,
-      :tags)
+      :tags,
+      :stack_set_arn,
+      :administration_role_arn)
       include Aws::Structure
     end
 
@@ -4010,6 +4030,20 @@ module Aws::CloudFormation
     #   or add an existing, saved stack to a new stack set.
     #   @return [Boolean]
     #
+    # @!attribute [rw] administration_role_arn
+    #   The Amazon Resource Number (ARN) of the IAM role used to perform
+    #   this stack set operation.
+    #
+    #   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*.
+    #
+    #
+    #
+    #   [1]: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-prereqs.html
+    #   @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
@@ -4035,6 +4069,7 @@ module Aws::CloudFormation
       :status,
       :operation_preferences,
       :retain_stacks,
+      :administration_role_arn,
       :creation_timestamp,
       :end_timestamp)
       include Aws::Structure
@@ -4913,6 +4948,7 @@ module Aws::CloudFormation
     #           max_concurrent_count: 1,
     #           max_concurrent_percentage: 1,
     #         },
+    #         administration_role_arn: "RoleARN",
     #         operation_id: "ClientRequestToken",
     #       }
     #
@@ -5050,6 +5086,27 @@ module Aws::CloudFormation
     #   operation.
     #   @return [Types::StackSetOperationPreferences]
     #
+    # @!attribute [rw] administration_role_arn
+    #   The Amazon Resource Number (ARN) of the IAM role to use to update
+    #   this stack set.
+    #
+    #   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*.
+    #
+    #   If you specify a customized administrator role, AWS CloudFormation
+    #   uses that role to update the stack. If you do not specify a
+    #   customized administrator 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.
+    #
+    #
+    #
+    #   [1]: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-prereqs.html
+    #   @return [String]
+    #
     # @!attribute [rw] operation_id
     #   The unique ID for this stack set operation.
     #
@@ -5081,6 +5138,7 @@ module Aws::CloudFormation
       :capabilities,
       :tags,
       :operation_preferences,
+      :administration_role_arn,
       :operation_id)
       include Aws::Structure
     end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-cloudformation
 version: !ruby/object:Gem::Version
-  version: 1.3.0
+  version: 1.4.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-11-22 00:00:00.000000000 Z
+date: 2018-03-29 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.1
+rubygems_version: 2.5.2.2
 signing_key: 
 specification_version: 4
 summary: AWS SDK for Ruby - AWS CloudFormation