aws-sdk-cloudformation 1.0.0.rc9 → 1.0.0.rc10

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA1:
3
- metadata.gz: 08ac1cb76d40c630f8b26b8a967500f74ff2f680
4
- data.tar.gz: 1458c08073b57a44d98b3646ea75644e10bf6f24
3
+ metadata.gz: 8950d5fff5307b3c36fba2256aeac6abc380fdc4
4
+ data.tar.gz: 364b6ef6665ae5ae9245572362fa4beb06caf809
5
5
  SHA512:
6
- metadata.gz: 220f0cdb71a5acdc903d5d031705ce5b0e2dd44aae01854e42972513ebdd30e238f8e178fa91295b6b86582d1eaedc8f532549e98646b477fc5c2358b9ee8d7e
7
- data.tar.gz: fa0cbe2fbd4c362fd8f627c8535a2af4ad07708057e36c5d7dff763ee9c7c479eb21b2129ca8bca561aff5db4374f038a98f75c8418a52541052b59d68e54038
6
+ metadata.gz: 777b6a719a649675fd8823e549b2ae7d3b4a243f01b5d1094240088f1305eaf908b6131e98db4956ae9d9b491f5f9b6005ffb1aa6de079ef3f885639624a81b9
7
+ data.tar.gz: 7c340d9a8e67c121c35e0687088834d2efb9ef7784066257cda7af8c096554b20cb7b27b3ff04c19f8f52f86582086ab5f8963c4ec684bee37531d4e944bd35e
@@ -47,6 +47,6 @@ require_relative 'aws-sdk-cloudformation/customizations'
47
47
  # @service
48
48
  module Aws::CloudFormation
49
49
 
50
- GEM_VERSION = '1.0.0.rc9'
50
+ GEM_VERSION = '1.0.0.rc10'
51
51
 
52
52
  end
@@ -233,7 +233,7 @@ module Aws::CloudFormation
233
233
  # only resources that are in the `UPDATE_FAILED` state because a
234
234
  # rollback failed. You can't specify resources that are in the
235
235
  # `UPDATE_FAILED` state for other reasons, for example, because an
236
- # update was canceled. To check why a resource update failed, use the
236
+ # update was cancelled. To check why a resource update failed, use the
237
237
  # DescribeStackResources action, and view the resource status reason.
238
238
  #
239
239
  # Specify this property to skip rolling back resources that AWS
@@ -252,15 +252,24 @@ module Aws::CloudFormation
252
252
  # dependent resources to fail. In this case, it might not be necessary
253
253
  # to skip the dependent resources.
254
254
  #
255
- # To specify resources in a nested stack, use the following format:
256
- # `NestedStackName.ResourceLogicalID`. If the `ResourceLogicalID` is a
257
- # stack resource (`Type: AWS::CloudFormation::Stack`), it must be in one
258
- # of the following states: `DELETE_IN_PROGRESS`, `DELETE_COMPLETE`, or
259
- # `DELETE_FAILED`.
255
+ # To skip resources that are part of nested stacks, use the following
256
+ # format: `NestedStackName.ResourceLogicalID`. If you want to specify
257
+ # the logical ID of a stack resource (`Type:
258
+ # AWS::CloudFormation::Stack`) in the `ResourcesToSkip` list, then its
259
+ # corresponding embedded stack must be in one of the following states:
260
+ # `DELETE_IN_PROGRESS`, `DELETE_COMPLETE`, or `DELETE_FAILED`.
261
+ #
262
+ # <note markdown="1"> Don't confuse a child stack's name with its corresponding logical ID
263
+ # defined in the parent stack. For an example of a continue update
264
+ # rollback operation with nested stacks, see [Using ResourcesToSkip to
265
+ # recover a nested stacks hierarchy][2].
266
+ #
267
+ # </note>
260
268
  #
261
269
  #
262
270
  #
263
271
  # [1]: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/troubleshooting.html#troubleshooting-errors-update-rollback-failed
272
+ # [2]: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-continueupdaterollback.html#nested-stacks
264
273
  #
265
274
  # @option params [String] :client_request_token
266
275
  # A unique identifier for this `ContinueUpdateRollback` request. Specify
@@ -422,7 +431,7 @@ module Aws::CloudFormation
422
431
  # @option params [Array<Types::Tag>] :tags
423
432
  # Key-value pairs to associate with this stack. AWS CloudFormation also
424
433
  # propagates these tags to resources in the stack. You can specify a
425
- # maximum of 10 tags.
434
+ # maximum of 50 tags.
426
435
  #
427
436
  # @option params [required, String] :change_set_name
428
437
  # The name of the change set. The name must be unique among all change
@@ -485,8 +494,8 @@ module Aws::CloudFormation
485
494
  # notification_arns: ["NotificationARN"],
486
495
  # tags: [
487
496
  # {
488
- # key: "TagKey",
489
- # value: "TagValue",
497
+ # key: "TagKey", # required
498
+ # value: "TagValue", # required
490
499
  # },
491
500
  # ],
492
501
  # change_set_name: "ChangeSetName", # required
@@ -671,7 +680,7 @@ module Aws::CloudFormation
671
680
  # @option params [Array<Types::Tag>] :tags
672
681
  # Key-value pairs to associate with this stack. AWS CloudFormation also
673
682
  # propagates these tags to the resources created in the stack. A maximum
674
- # number of 10 tags can be specified.
683
+ # number of 50 tags can be specified.
675
684
  #
676
685
  # @option params [String] :client_request_token
677
686
  # A unique identifier for this `CreateStack` request. Specify this token
@@ -680,6 +689,20 @@ module Aws::CloudFormation
680
689
  # retry `CreateStack` requests to ensure that AWS CloudFormation
681
690
  # successfully received them.
682
691
  #
692
+ # All events triggered by a given stack operation are assigned the same
693
+ # client request token, which you can use to track operations. For
694
+ # example, if you execute a `CreateStack` operation with the token
695
+ # `token1`, then all the `StackEvents` generated by that operation will
696
+ # have `ClientRequestToken` set as `token1`.
697
+ #
698
+ # In the console, stack operations display the client request token on
699
+ # the Events tab. Stack operations that are initiated from the console
700
+ # use the token format *Console-StackOperation-ID*, which helps you
701
+ # easily identify the stack operation . For example, if you create a
702
+ # stack using the console, each stack event would be assigned the same
703
+ # token in the following format:
704
+ # `Console-CreateStack-7f59c3cf-00d2-40c7-b2ff-e75db0987002`.
705
+ #
683
706
  # @return [Types::CreateStackOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
684
707
  #
685
708
  # * {Types::CreateStackOutput#stack_id #stack_id} => String
@@ -708,8 +731,8 @@ module Aws::CloudFormation
708
731
  # stack_policy_url: "StackPolicyURL",
709
732
  # tags: [
710
733
  # {
711
- # key: "TagKey",
712
- # value: "TagValue",
734
+ # key: "TagKey", # required
735
+ # value: "TagValue", # required
713
736
  # },
714
737
  # ],
715
738
  # client_request_token: "ClientRequestToken",
@@ -728,6 +751,228 @@ module Aws::CloudFormation
728
751
  req.send_request(options)
729
752
  end
730
753
 
754
+ # Creates stack instances for the specified accounts, within the
755
+ # specified regions. A stack instance refers to a stack in a specific
756
+ # account and region. `Accounts` and `Regions` are required
757
+ # parameters—you must specify at least one account and one region.
758
+ #
759
+ # @option params [required, String] :stack_set_name
760
+ # The name or unique ID of the stack set that you want to create stack
761
+ # instances from.
762
+ #
763
+ # @option params [required, Array<String>] :accounts
764
+ # The names of one or more AWS accounts that you want to create stack
765
+ # instances in the specified region(s) for.
766
+ #
767
+ # @option params [required, Array<String>] :regions
768
+ # The names of one or more regions where you want to create stack
769
+ # instances using the specified AWS account(s).
770
+ #
771
+ # @option params [Types::StackSetOperationPreferences] :operation_preferences
772
+ # Preferences for how AWS CloudFormation performs this stack set
773
+ # operation.
774
+ #
775
+ # @option params [String] :operation_id
776
+ # The unique identifier for this stack set operation.
777
+ #
778
+ # The operation ID also functions as an idempotency token, to ensure
779
+ # that AWS CloudFormation performs the stack set operation only once,
780
+ # even if you retry the request multiple times. You might retry stack
781
+ # set operation requests to ensure that AWS CloudFormation successfully
782
+ # received them.
783
+ #
784
+ # If you don't specify an operation ID, the SDK generates one
785
+ # automatically.
786
+ #
787
+ # Repeating this stack set operation with a new operation ID retries all
788
+ # stack instances whose status is `OUTDATED`.
789
+ #
790
+ # **A suitable default value is auto-generated.** You should normally
791
+ # not need to pass this option.**
792
+ #
793
+ # @return [Types::CreateStackInstancesOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
794
+ #
795
+ # * {Types::CreateStackInstancesOutput#operation_id #operation_id} => String
796
+ #
797
+ # @example Request syntax with placeholder values
798
+ #
799
+ # resp = client.create_stack_instances({
800
+ # stack_set_name: "StackSetName", # required
801
+ # accounts: ["Account"], # required
802
+ # regions: ["Region"], # required
803
+ # operation_preferences: {
804
+ # region_order: ["Region"],
805
+ # failure_tolerance_count: 1,
806
+ # failure_tolerance_percentage: 1,
807
+ # max_concurrent_count: 1,
808
+ # max_concurrent_percentage: 1,
809
+ # },
810
+ # operation_id: "ClientRequestToken",
811
+ # })
812
+ #
813
+ # @example Response structure
814
+ #
815
+ # resp.operation_id #=> String
816
+ #
817
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateStackInstances AWS API Documentation
818
+ #
819
+ # @overload create_stack_instances(params = {})
820
+ # @param [Hash] params ({})
821
+ def create_stack_instances(params = {}, options = {})
822
+ req = build_request(:create_stack_instances, params)
823
+ req.send_request(options)
824
+ end
825
+
826
+ # Creates a stack set.
827
+ #
828
+ # @option params [required, String] :stack_set_name
829
+ # The name to associate with the stack set. The name must be unique in
830
+ # the region where you create your stack set.
831
+ #
832
+ # <note markdown="1"> A stack name can contain only alphanumeric characters (case-sensitive)
833
+ # and hyphens. It must start with an alphabetic character and can't be
834
+ # longer than 128 characters.
835
+ #
836
+ # </note>
837
+ #
838
+ # @option params [String] :description
839
+ # A description of the stack set. You can use the description to
840
+ # identify the stack set's purpose or other important information.
841
+ #
842
+ # @option params [String] :template_body
843
+ # The structure that contains the template body, with a minimum length
844
+ # of 1 byte and a maximum length of 51,200 bytes. For more information,
845
+ # see [Template Anatomy][1] in the AWS CloudFormation User Guide.
846
+ #
847
+ # Conditional: You must specify either the TemplateBody or the
848
+ # TemplateURL parameter, but not both.
849
+ #
850
+ #
851
+ #
852
+ # [1]: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html
853
+ #
854
+ # @option params [String] :template_url
855
+ # The location of the file that contains the template body. The URL must
856
+ # point to a template (maximum size: 460,800 bytes) that's located in
857
+ # an Amazon S3 bucket. For more information, see [Template Anatomy][1]
858
+ # in the AWS CloudFormation User Guide.
859
+ #
860
+ # Conditional: You must specify either the TemplateBody or the
861
+ # TemplateURL parameter, but not both.
862
+ #
863
+ #
864
+ #
865
+ # [1]: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html
866
+ #
867
+ # @option params [Array<Types::Parameter>] :parameters
868
+ # The input parameters for the stack set template.
869
+ #
870
+ # @option params [Array<String>] :capabilities
871
+ # A list of values that you must specify before AWS CloudFormation can
872
+ # create certain stack sets. Some stack set templates might include
873
+ # resources that can affect permissions in your AWS account—for example,
874
+ # by creating new AWS Identity and Access Management (IAM) users. For
875
+ # those stack sets, you must explicitly acknowledge their capabilities
876
+ # by specifying this parameter.
877
+ #
878
+ # The only valid values are CAPABILITY\_IAM and CAPABILITY\_NAMED\_IAM.
879
+ # The following resources require you to specify this parameter:
880
+ #
881
+ # * AWS::IAM::AccessKey
882
+ #
883
+ # * AWS::IAM::Group
884
+ #
885
+ # * AWS::IAM::InstanceProfile
886
+ #
887
+ # * AWS::IAM::Policy
888
+ #
889
+ # * AWS::IAM::Role
890
+ #
891
+ # * AWS::IAM::User
892
+ #
893
+ # * AWS::IAM::UserToGroupAddition
894
+ #
895
+ # If your stack template contains these resources, we recommend that you
896
+ # review all permissions that are associated with them and edit their
897
+ # permissions if necessary.
898
+ #
899
+ # If you have IAM resources, you can specify either capability. If you
900
+ # have IAM resources with custom names, you must specify
901
+ # CAPABILITY\_NAMED\_IAM. If you don't specify this parameter, this
902
+ # action returns an `InsufficientCapabilities` error.
903
+ #
904
+ # For more information, see [Acknowledging IAM Resources in AWS
905
+ # CloudFormation Templates.][1]
906
+ #
907
+ #
908
+ #
909
+ # [1]: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html#capabilities
910
+ #
911
+ # @option params [Array<Types::Tag>] :tags
912
+ # The key-value pairs to associate with this stack set and the stacks
913
+ # created from it. AWS CloudFormation also propagates these tags to
914
+ # supported resources that are created in the stacks. A maximum number
915
+ # of 50 tags can be specified.
916
+ #
917
+ # If you specify tags as part of a `CreateStackSet` action, AWS
918
+ # CloudFormation checks to see if you have the required IAM permission
919
+ # to tag resources. If you don't, the entire `CreateStackSet` action
920
+ # fails with an `access denied` error, and the stack set is not created.
921
+ #
922
+ # @option params [String] :client_request_token
923
+ # A unique identifier for this `CreateStackSet` request. Specify this
924
+ # token if you plan to retry requests so that AWS CloudFormation knows
925
+ # that you're not attempting to create another stack set with the same
926
+ # name. You might retry `CreateStackSet` requests to ensure that AWS
927
+ # CloudFormation successfully received them.
928
+ #
929
+ # If you don't specify an operation ID, the SDK generates one
930
+ # automatically.
931
+ #
932
+ # **A suitable default value is auto-generated.** You should normally
933
+ # not need to pass this option.**
934
+ #
935
+ # @return [Types::CreateStackSetOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
936
+ #
937
+ # * {Types::CreateStackSetOutput#stack_set_id #stack_set_id} => String
938
+ #
939
+ # @example Request syntax with placeholder values
940
+ #
941
+ # resp = client.create_stack_set({
942
+ # stack_set_name: "StackSetName", # required
943
+ # description: "Description",
944
+ # template_body: "TemplateBody",
945
+ # template_url: "TemplateURL",
946
+ # parameters: [
947
+ # {
948
+ # parameter_key: "ParameterKey",
949
+ # parameter_value: "ParameterValue",
950
+ # use_previous_value: false,
951
+ # },
952
+ # ],
953
+ # capabilities: ["CAPABILITY_IAM"], # accepts CAPABILITY_IAM, CAPABILITY_NAMED_IAM
954
+ # tags: [
955
+ # {
956
+ # key: "TagKey", # required
957
+ # value: "TagValue", # required
958
+ # },
959
+ # ],
960
+ # client_request_token: "ClientRequestToken",
961
+ # })
962
+ #
963
+ # @example Response structure
964
+ #
965
+ # resp.stack_set_id #=> String
966
+ #
967
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateStackSet AWS API Documentation
968
+ #
969
+ # @overload create_stack_set(params = {})
970
+ # @param [Hash] params ({})
971
+ def create_stack_set(params = {}, options = {})
972
+ req = build_request(:create_stack_set, params)
973
+ req.send_request(options)
974
+ end
975
+
731
976
  # Deletes the specified change set. Deleting change sets ensures that no
732
977
  # one executes the wrong change set.
733
978
  #
@@ -794,6 +1039,20 @@ module Aws::CloudFormation
794
1039
  # retry `DeleteStack` requests to ensure that AWS CloudFormation
795
1040
  # successfully received them.
796
1041
  #
1042
+ # All events triggered by a given stack operation are assigned the same
1043
+ # client request token, which you can use to track operations. For
1044
+ # example, if you execute a `CreateStack` operation with the token
1045
+ # `token1`, then all the `StackEvents` generated by that operation will
1046
+ # have `ClientRequestToken` set as `token1`.
1047
+ #
1048
+ # In the console, stack operations display the client request token on
1049
+ # the Events tab. Stack operations that are initiated from the console
1050
+ # use the token format *Console-StackOperation-ID*, which helps you
1051
+ # easily identify the stack operation . For example, if you create a
1052
+ # stack using the console, each stack event would be assigned the same
1053
+ # token in the following format:
1054
+ # `Console-CreateStack-7f59c3cf-00d2-40c7-b2ff-e75db0987002`.
1055
+ #
797
1056
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
798
1057
  #
799
1058
  # @example Request syntax with placeholder values
@@ -814,6 +1073,106 @@ module Aws::CloudFormation
814
1073
  req.send_request(options)
815
1074
  end
816
1075
 
1076
+ # Deletes stack instances for the specified accounts, in the specified
1077
+ # regions.
1078
+ #
1079
+ # @option params [required, String] :stack_set_name
1080
+ # The name or unique ID of the stack set that you want to delete stack
1081
+ # instances for.
1082
+ #
1083
+ # @option params [required, Array<String>] :accounts
1084
+ # The names of the AWS accounts that you want to delete stack instances
1085
+ # for.
1086
+ #
1087
+ # @option params [required, Array<String>] :regions
1088
+ # The regions where you want to delete stack set instances.
1089
+ #
1090
+ # @option params [Types::StackSetOperationPreferences] :operation_preferences
1091
+ # Preferences for how AWS CloudFormation performs this stack set
1092
+ # operation.
1093
+ #
1094
+ # @option params [required, Boolean] :retain_stacks
1095
+ # Removes the stack instances from the specified stack set, but doesn't
1096
+ # delete the stacks. You can't reassociate a retained stack or add an
1097
+ # existing, saved stack to a new stack set.
1098
+ #
1099
+ # @option params [String] :operation_id
1100
+ # The unique identifier for this stack set operation.
1101
+ #
1102
+ # If you don't specify an operation ID, the SDK generates one
1103
+ # automatically.
1104
+ #
1105
+ # The operation ID also functions as an idempotency token, to ensure
1106
+ # that AWS CloudFormation performs the stack set operation only once,
1107
+ # even if you retry the request multiple times. You can retry stack set
1108
+ # operation requests to ensure that AWS CloudFormation successfully
1109
+ # received them.
1110
+ #
1111
+ # Repeating this stack set operation with a new operation ID retries all
1112
+ # stack instances whose status is `OUTDATED`.
1113
+ #
1114
+ # **A suitable default value is auto-generated.** You should normally
1115
+ # not need to pass this option.**
1116
+ #
1117
+ # @return [Types::DeleteStackInstancesOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1118
+ #
1119
+ # * {Types::DeleteStackInstancesOutput#operation_id #operation_id} => String
1120
+ #
1121
+ # @example Request syntax with placeholder values
1122
+ #
1123
+ # resp = client.delete_stack_instances({
1124
+ # stack_set_name: "StackSetName", # required
1125
+ # accounts: ["Account"], # required
1126
+ # regions: ["Region"], # required
1127
+ # operation_preferences: {
1128
+ # region_order: ["Region"],
1129
+ # failure_tolerance_count: 1,
1130
+ # failure_tolerance_percentage: 1,
1131
+ # max_concurrent_count: 1,
1132
+ # max_concurrent_percentage: 1,
1133
+ # },
1134
+ # retain_stacks: false, # required
1135
+ # operation_id: "ClientRequestToken",
1136
+ # })
1137
+ #
1138
+ # @example Response structure
1139
+ #
1140
+ # resp.operation_id #=> String
1141
+ #
1142
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/DeleteStackInstances AWS API Documentation
1143
+ #
1144
+ # @overload delete_stack_instances(params = {})
1145
+ # @param [Hash] params ({})
1146
+ def delete_stack_instances(params = {}, options = {})
1147
+ req = build_request(:delete_stack_instances, params)
1148
+ req.send_request(options)
1149
+ end
1150
+
1151
+ # Deletes a stack set. Before you can delete a stack set, all of its
1152
+ # member stack instances must be deleted. For more information about how
1153
+ # to do this, see DeleteStackInstances.
1154
+ #
1155
+ # @option params [required, String] :stack_set_name
1156
+ # The name or unique ID of the stack set that you're deleting. You can
1157
+ # obtain this value by running ListStackSets.
1158
+ #
1159
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
1160
+ #
1161
+ # @example Request syntax with placeholder values
1162
+ #
1163
+ # resp = client.delete_stack_set({
1164
+ # stack_set_name: "StackSetName", # required
1165
+ # })
1166
+ #
1167
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/DeleteStackSet AWS API Documentation
1168
+ #
1169
+ # @overload delete_stack_set(params = {})
1170
+ # @param [Hash] params ({})
1171
+ def delete_stack_set(params = {}, options = {})
1172
+ req = build_request(:delete_stack_set, params)
1173
+ req.send_request(options)
1174
+ end
1175
+
817
1176
  # Retrieves your account's AWS CloudFormation limits, such as the
818
1177
  # maximum number of stacks that you can create in your account.
819
1178
  #
@@ -1009,6 +1368,52 @@ module Aws::CloudFormation
1009
1368
  req.send_request(options)
1010
1369
  end
1011
1370
 
1371
+ # Returns the stack instance that's associated with the specified stack
1372
+ # set, AWS account, and region.
1373
+ #
1374
+ # For a list of stack instances that are associated with a specific
1375
+ # stack set, use ListStackInstances.
1376
+ #
1377
+ # @option params [required, String] :stack_set_name
1378
+ # The name or the unique stack ID of the stack set that you want to get
1379
+ # stack instance information for.
1380
+ #
1381
+ # @option params [required, String] :stack_instance_account
1382
+ # The ID of an AWS account that's associated with this stack instance.
1383
+ #
1384
+ # @option params [required, String] :stack_instance_region
1385
+ # The name of a region that's associated with this stack instance.
1386
+ #
1387
+ # @return [Types::DescribeStackInstanceOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1388
+ #
1389
+ # * {Types::DescribeStackInstanceOutput#stack_instance #stack_instance} => Types::StackInstance
1390
+ #
1391
+ # @example Request syntax with placeholder values
1392
+ #
1393
+ # resp = client.describe_stack_instance({
1394
+ # stack_set_name: "StackSetName", # required
1395
+ # stack_instance_account: "Account", # required
1396
+ # stack_instance_region: "Region", # required
1397
+ # })
1398
+ #
1399
+ # @example Response structure
1400
+ #
1401
+ # resp.stack_instance.stack_set_id #=> String
1402
+ # resp.stack_instance.region #=> String
1403
+ # resp.stack_instance.account #=> String
1404
+ # resp.stack_instance.stack_id #=> String
1405
+ # resp.stack_instance.status #=> String, one of "CURRENT", "OUTDATED", "INOPERABLE"
1406
+ # resp.stack_instance.status_reason #=> String
1407
+ #
1408
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/DescribeStackInstance AWS API Documentation
1409
+ #
1410
+ # @overload describe_stack_instance(params = {})
1411
+ # @param [Hash] params ({})
1412
+ def describe_stack_instance(params = {}, options = {})
1413
+ req = build_request(:describe_stack_instance, params)
1414
+ req.send_request(options)
1415
+ end
1416
+
1012
1417
  # Returns a description of the specified resource in the specified
1013
1418
  # stack.
1014
1419
  #
@@ -1160,6 +1565,92 @@ module Aws::CloudFormation
1160
1565
  req.send_request(options)
1161
1566
  end
1162
1567
 
1568
+ # Returns the description of the specified stack set.
1569
+ #
1570
+ # @option params [required, String] :stack_set_name
1571
+ # The name or unique ID of the stack set whose description you want.
1572
+ #
1573
+ # @return [Types::DescribeStackSetOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1574
+ #
1575
+ # * {Types::DescribeStackSetOutput#stack_set #stack_set} => Types::StackSet
1576
+ #
1577
+ # @example Request syntax with placeholder values
1578
+ #
1579
+ # resp = client.describe_stack_set({
1580
+ # stack_set_name: "StackSetName", # required
1581
+ # })
1582
+ #
1583
+ # @example Response structure
1584
+ #
1585
+ # resp.stack_set.stack_set_name #=> String
1586
+ # resp.stack_set.stack_set_id #=> String
1587
+ # resp.stack_set.description #=> String
1588
+ # resp.stack_set.status #=> String, one of "ACTIVE", "DELETED"
1589
+ # resp.stack_set.template_body #=> String
1590
+ # resp.stack_set.parameters #=> Array
1591
+ # resp.stack_set.parameters[0].parameter_key #=> String
1592
+ # resp.stack_set.parameters[0].parameter_value #=> String
1593
+ # resp.stack_set.parameters[0].use_previous_value #=> Boolean
1594
+ # resp.stack_set.capabilities #=> Array
1595
+ # resp.stack_set.capabilities[0] #=> String, one of "CAPABILITY_IAM", "CAPABILITY_NAMED_IAM"
1596
+ # resp.stack_set.tags #=> Array
1597
+ # resp.stack_set.tags[0].key #=> String
1598
+ # resp.stack_set.tags[0].value #=> String
1599
+ #
1600
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/DescribeStackSet AWS API Documentation
1601
+ #
1602
+ # @overload describe_stack_set(params = {})
1603
+ # @param [Hash] params ({})
1604
+ def describe_stack_set(params = {}, options = {})
1605
+ req = build_request(:describe_stack_set, params)
1606
+ req.send_request(options)
1607
+ end
1608
+
1609
+ # Returns the description of the specified stack set operation.
1610
+ #
1611
+ # @option params [required, String] :stack_set_name
1612
+ # The name or the unique stack ID of the stack set for the stack
1613
+ # operation.
1614
+ #
1615
+ # @option params [required, String] :operation_id
1616
+ # The unique ID of the stack set operation.
1617
+ #
1618
+ # @return [Types::DescribeStackSetOperationOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1619
+ #
1620
+ # * {Types::DescribeStackSetOperationOutput#stack_set_operation #stack_set_operation} => Types::StackSetOperation
1621
+ #
1622
+ # @example Request syntax with placeholder values
1623
+ #
1624
+ # resp = client.describe_stack_set_operation({
1625
+ # stack_set_name: "StackSetName", # required
1626
+ # operation_id: "ClientRequestToken", # required
1627
+ # })
1628
+ #
1629
+ # @example Response structure
1630
+ #
1631
+ # resp.stack_set_operation.operation_id #=> String
1632
+ # resp.stack_set_operation.stack_set_id #=> String
1633
+ # resp.stack_set_operation.action #=> String, one of "CREATE", "UPDATE", "DELETE"
1634
+ # resp.stack_set_operation.status #=> String, one of "RUNNING", "SUCCEEDED", "FAILED", "STOPPING", "STOPPED"
1635
+ # resp.stack_set_operation.operation_preferences.region_order #=> Array
1636
+ # resp.stack_set_operation.operation_preferences.region_order[0] #=> String
1637
+ # resp.stack_set_operation.operation_preferences.failure_tolerance_count #=> Integer
1638
+ # resp.stack_set_operation.operation_preferences.failure_tolerance_percentage #=> Integer
1639
+ # resp.stack_set_operation.operation_preferences.max_concurrent_count #=> Integer
1640
+ # resp.stack_set_operation.operation_preferences.max_concurrent_percentage #=> Integer
1641
+ # resp.stack_set_operation.retain_stacks #=> Boolean
1642
+ # resp.stack_set_operation.creation_timestamp #=> Time
1643
+ # resp.stack_set_operation.end_timestamp #=> Time
1644
+ #
1645
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/DescribeStackSetOperation AWS API Documentation
1646
+ #
1647
+ # @overload describe_stack_set_operation(params = {})
1648
+ # @param [Hash] params ({})
1649
+ def describe_stack_set_operation(params = {}, options = {})
1650
+ req = build_request(:describe_stack_set_operation, params)
1651
+ req.send_request(options)
1652
+ end
1653
+
1163
1654
  # Returns the description for the specified stack; if no stack name was
1164
1655
  # specified, then it returns the description for all the stacks created.
1165
1656
  #
@@ -1220,6 +1711,7 @@ module Aws::CloudFormation
1220
1711
  # resp.stacks[0].outputs[0].output_key #=> String
1221
1712
  # resp.stacks[0].outputs[0].output_value #=> String
1222
1713
  # resp.stacks[0].outputs[0].description #=> String
1714
+ # resp.stacks[0].outputs[0].export_name #=> String
1223
1715
  # resp.stacks[0].role_arn #=> String
1224
1716
  # resp.stacks[0].tags #=> Array
1225
1717
  # resp.stacks[0].tags[0].key #=> String
@@ -1486,6 +1978,10 @@ module Aws::CloudFormation
1486
1978
  # Conditional: You must specify only one of the following parameters:
1487
1979
  # `StackName`, `TemplateBody`, or `TemplateURL`.
1488
1980
  #
1981
+ # @option params [String] :stack_set_name
1982
+ # The name or unique ID of the stack set from which the stack was
1983
+ # created.
1984
+ #
1489
1985
  # @return [Types::GetTemplateSummaryOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1490
1986
  #
1491
1987
  # * {Types::GetTemplateSummaryOutput#parameters #parameters} => Array&lt;Types::ParameterDeclaration&gt;
@@ -1503,6 +1999,7 @@ module Aws::CloudFormation
1503
1999
  # template_body: "TemplateBody",
1504
2000
  # template_url: "TemplateURL",
1505
2001
  # stack_name: "StackNameOrId",
2002
+ # stack_set_name: "StackSetNameOrId",
1506
2003
  # })
1507
2004
  #
1508
2005
  # @example Response structure
@@ -1675,6 +2172,69 @@ module Aws::CloudFormation
1675
2172
  req.send_request(options)
1676
2173
  end
1677
2174
 
2175
+ # Returns summary information about stack instances that are associated
2176
+ # with the specified stack set. You can filter for stack instances that
2177
+ # are associated with a specific AWS account name or region.
2178
+ #
2179
+ # @option params [required, String] :stack_set_name
2180
+ # The name or unique ID of the stack set that you want to list stack
2181
+ # instances for.
2182
+ #
2183
+ # @option params [String] :next_token
2184
+ # If the previous request didn't return all of the remaining results,
2185
+ # the response's `NextToken` parameter value is set to a token. To
2186
+ # retrieve the next set of results, call `ListStackInstances` again and
2187
+ # assign that token to the request object's `NextToken` parameter. If
2188
+ # there are no remaining results, the previous response object's
2189
+ # `NextToken` parameter is set to `null`.
2190
+ #
2191
+ # @option params [Integer] :max_results
2192
+ # The maximum number of results to be returned with a single call. If
2193
+ # the number of available results exceeds this maximum, the response
2194
+ # includes a `NextToken` value that you can assign to the `NextToken`
2195
+ # request parameter to get the next set of results.
2196
+ #
2197
+ # @option params [String] :stack_instance_account
2198
+ # The name of the AWS account that you want to list stack instances for.
2199
+ #
2200
+ # @option params [String] :stack_instance_region
2201
+ # The name of the region where you want to list stack instances.
2202
+ #
2203
+ # @return [Types::ListStackInstancesOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2204
+ #
2205
+ # * {Types::ListStackInstancesOutput#summaries #summaries} => Array&lt;Types::StackInstanceSummary&gt;
2206
+ # * {Types::ListStackInstancesOutput#next_token #next_token} => String
2207
+ #
2208
+ # @example Request syntax with placeholder values
2209
+ #
2210
+ # resp = client.list_stack_instances({
2211
+ # stack_set_name: "StackSetName", # required
2212
+ # next_token: "NextToken",
2213
+ # max_results: 1,
2214
+ # stack_instance_account: "Account",
2215
+ # stack_instance_region: "Region",
2216
+ # })
2217
+ #
2218
+ # @example Response structure
2219
+ #
2220
+ # resp.summaries #=> Array
2221
+ # resp.summaries[0].stack_set_id #=> String
2222
+ # resp.summaries[0].region #=> String
2223
+ # resp.summaries[0].account #=> String
2224
+ # resp.summaries[0].stack_id #=> String
2225
+ # resp.summaries[0].status #=> String, one of "CURRENT", "OUTDATED", "INOPERABLE"
2226
+ # resp.summaries[0].status_reason #=> String
2227
+ # resp.next_token #=> String
2228
+ #
2229
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/ListStackInstances AWS API Documentation
2230
+ #
2231
+ # @overload list_stack_instances(params = {})
2232
+ # @param [Hash] params ({})
2233
+ def list_stack_instances(params = {}, options = {})
2234
+ req = build_request(:list_stack_instances, params)
2235
+ req.send_request(options)
2236
+ end
2237
+
1678
2238
  # Returns descriptions of all resources of the specified stack.
1679
2239
  #
1680
2240
  # For deleted stacks, ListStackResources returns resource information
@@ -1727,6 +2287,170 @@ module Aws::CloudFormation
1727
2287
  req.send_request(options)
1728
2288
  end
1729
2289
 
2290
+ # Returns summary information about the results of a stack set
2291
+ # operation.
2292
+ #
2293
+ # @option params [required, String] :stack_set_name
2294
+ # The name or unique ID of the stack set that you want to get operation
2295
+ # results for.
2296
+ #
2297
+ # @option params [required, String] :operation_id
2298
+ # The ID of the stack set operation.
2299
+ #
2300
+ # @option params [String] :next_token
2301
+ # If the previous request didn't return all of the remaining results,
2302
+ # the response object's `NextToken` parameter value is set to a token.
2303
+ # To retrieve the next set of results, call
2304
+ # `ListStackSetOperationResults` again and assign that token to the
2305
+ # request object's `NextToken` parameter. If there are no remaining
2306
+ # results, the previous response object's `NextToken` parameter is set
2307
+ # to `null`.
2308
+ #
2309
+ # @option params [Integer] :max_results
2310
+ # The maximum number of results to be returned with a single call. If
2311
+ # the number of available results exceeds this maximum, the response
2312
+ # includes a `NextToken` value that you can assign to the `NextToken`
2313
+ # request parameter to get the next set of results.
2314
+ #
2315
+ # @return [Types::ListStackSetOperationResultsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2316
+ #
2317
+ # * {Types::ListStackSetOperationResultsOutput#summaries #summaries} => Array&lt;Types::StackSetOperationResultSummary&gt;
2318
+ # * {Types::ListStackSetOperationResultsOutput#next_token #next_token} => String
2319
+ #
2320
+ # @example Request syntax with placeholder values
2321
+ #
2322
+ # resp = client.list_stack_set_operation_results({
2323
+ # stack_set_name: "StackSetName", # required
2324
+ # operation_id: "ClientRequestToken", # required
2325
+ # next_token: "NextToken",
2326
+ # max_results: 1,
2327
+ # })
2328
+ #
2329
+ # @example Response structure
2330
+ #
2331
+ # resp.summaries #=> Array
2332
+ # resp.summaries[0].account #=> String
2333
+ # resp.summaries[0].region #=> String
2334
+ # resp.summaries[0].status #=> String, one of "PENDING", "RUNNING", "SUCCEEDED", "FAILED", "CANCELLED"
2335
+ # resp.summaries[0].status_reason #=> String
2336
+ # resp.summaries[0].account_gate_result.status #=> String, one of "SUCCEEDED", "FAILED", "SKIPPED"
2337
+ # resp.summaries[0].account_gate_result.status_reason #=> String
2338
+ # resp.next_token #=> String
2339
+ #
2340
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/ListStackSetOperationResults AWS API Documentation
2341
+ #
2342
+ # @overload list_stack_set_operation_results(params = {})
2343
+ # @param [Hash] params ({})
2344
+ def list_stack_set_operation_results(params = {}, options = {})
2345
+ req = build_request(:list_stack_set_operation_results, params)
2346
+ req.send_request(options)
2347
+ end
2348
+
2349
+ # Returns summary information about operations performed on a stack set.
2350
+ #
2351
+ # @option params [required, String] :stack_set_name
2352
+ # The name or unique ID of the stack set that you want to get operation
2353
+ # summaries for.
2354
+ #
2355
+ # @option params [String] :next_token
2356
+ # If the previous paginated request didn't return all of the remaining
2357
+ # results, the response object's `NextToken` parameter value is set to
2358
+ # a token. To retrieve the next set of results, call
2359
+ # `ListStackSetOperations` again and assign that token to the request
2360
+ # object's `NextToken` parameter. If there are no remaining results,
2361
+ # the previous response object's `NextToken` parameter is set to
2362
+ # `null`.
2363
+ #
2364
+ # @option params [Integer] :max_results
2365
+ # The maximum number of results to be returned with a single call. If
2366
+ # the number of available results exceeds this maximum, the response
2367
+ # includes a `NextToken` value that you can assign to the `NextToken`
2368
+ # request parameter to get the next set of results.
2369
+ #
2370
+ # @return [Types::ListStackSetOperationsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2371
+ #
2372
+ # * {Types::ListStackSetOperationsOutput#summaries #summaries} => Array&lt;Types::StackSetOperationSummary&gt;
2373
+ # * {Types::ListStackSetOperationsOutput#next_token #next_token} => String
2374
+ #
2375
+ # @example Request syntax with placeholder values
2376
+ #
2377
+ # resp = client.list_stack_set_operations({
2378
+ # stack_set_name: "StackSetName", # required
2379
+ # next_token: "NextToken",
2380
+ # max_results: 1,
2381
+ # })
2382
+ #
2383
+ # @example Response structure
2384
+ #
2385
+ # resp.summaries #=> Array
2386
+ # resp.summaries[0].operation_id #=> String
2387
+ # resp.summaries[0].action #=> String, one of "CREATE", "UPDATE", "DELETE"
2388
+ # resp.summaries[0].status #=> String, one of "RUNNING", "SUCCEEDED", "FAILED", "STOPPING", "STOPPED"
2389
+ # resp.summaries[0].creation_timestamp #=> Time
2390
+ # resp.summaries[0].end_timestamp #=> Time
2391
+ # resp.next_token #=> String
2392
+ #
2393
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/ListStackSetOperations AWS API Documentation
2394
+ #
2395
+ # @overload list_stack_set_operations(params = {})
2396
+ # @param [Hash] params ({})
2397
+ def list_stack_set_operations(params = {}, options = {})
2398
+ req = build_request(:list_stack_set_operations, params)
2399
+ req.send_request(options)
2400
+ end
2401
+
2402
+ # Returns summary information about stack sets that are associated with
2403
+ # the user.
2404
+ #
2405
+ # @option params [String] :next_token
2406
+ # If the previous paginated request didn't return all of the remaining
2407
+ # results, the response object's `NextToken` parameter value is set to
2408
+ # a token. To retrieve the next set of results, call `ListStackSets`
2409
+ # again and assign that token to the request object's `NextToken`
2410
+ # parameter. If there are no remaining results, the previous response
2411
+ # object's `NextToken` parameter is set to `null`.
2412
+ #
2413
+ # @option params [Integer] :max_results
2414
+ # The maximum number of results to be returned with a single call. If
2415
+ # the number of available results exceeds this maximum, the response
2416
+ # includes a `NextToken` value that you can assign to the `NextToken`
2417
+ # request parameter to get the next set of results.
2418
+ #
2419
+ # @option params [String] :status
2420
+ # The status of the stack sets that you want to get summary information
2421
+ # about.
2422
+ #
2423
+ # @return [Types::ListStackSetsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2424
+ #
2425
+ # * {Types::ListStackSetsOutput#summaries #summaries} => Array&lt;Types::StackSetSummary&gt;
2426
+ # * {Types::ListStackSetsOutput#next_token #next_token} => String
2427
+ #
2428
+ # @example Request syntax with placeholder values
2429
+ #
2430
+ # resp = client.list_stack_sets({
2431
+ # next_token: "NextToken",
2432
+ # max_results: 1,
2433
+ # status: "ACTIVE", # accepts ACTIVE, DELETED
2434
+ # })
2435
+ #
2436
+ # @example Response structure
2437
+ #
2438
+ # resp.summaries #=> Array
2439
+ # resp.summaries[0].stack_set_name #=> String
2440
+ # resp.summaries[0].stack_set_id #=> String
2441
+ # resp.summaries[0].description #=> String
2442
+ # resp.summaries[0].status #=> String, one of "ACTIVE", "DELETED"
2443
+ # resp.next_token #=> String
2444
+ #
2445
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/ListStackSets AWS API Documentation
2446
+ #
2447
+ # @overload list_stack_sets(params = {})
2448
+ # @param [Hash] params ({})
2449
+ def list_stack_sets(params = {}, options = {})
2450
+ req = build_request(:list_stack_sets, params)
2451
+ req.send_request(options)
2452
+ end
2453
+
1730
2454
  # Returns the summary information for stacks whose status matches the
1731
2455
  # specified StackStatusFilter. Summary information for stacks that have
1732
2456
  # been deleted is kept for 90 days after the stack is deleted. If no
@@ -1866,6 +2590,34 @@ module Aws::CloudFormation
1866
2590
  req.send_request(options)
1867
2591
  end
1868
2592
 
2593
+ # Stops an in-progress operation on a stack set and its associated stack
2594
+ # instances.
2595
+ #
2596
+ # @option params [required, String] :stack_set_name
2597
+ # The name or unique ID of the stack set that you want to stop the
2598
+ # operation for.
2599
+ #
2600
+ # @option params [required, String] :operation_id
2601
+ # The ID of the stack operation.
2602
+ #
2603
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
2604
+ #
2605
+ # @example Request syntax with placeholder values
2606
+ #
2607
+ # resp = client.stop_stack_set_operation({
2608
+ # stack_set_name: "StackSetName", # required
2609
+ # operation_id: "ClientRequestToken", # required
2610
+ # })
2611
+ #
2612
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/StopStackSetOperation AWS API Documentation
2613
+ #
2614
+ # @overload stop_stack_set_operation(params = {})
2615
+ # @param [Hash] params ({})
2616
+ def stop_stack_set_operation(params = {}, options = {})
2617
+ req = build_request(:stop_stack_set_operation, params)
2618
+ req.send_request(options)
2619
+ end
2620
+
1869
2621
  # Updates a stack as specified in the template. After the call completes
1870
2622
  # successfully, the stack update starts. You can check the status of the
1871
2623
  # stack via the DescribeStacks action.
@@ -2043,7 +2795,7 @@ module Aws::CloudFormation
2043
2795
  # @option params [Array<Types::Tag>] :tags
2044
2796
  # Key-value pairs to associate with this stack. AWS CloudFormation also
2045
2797
  # propagates these tags to supported resources in the stack. You can
2046
- # specify a maximum number of 10 tags.
2798
+ # specify a maximum number of 50 tags.
2047
2799
  #
2048
2800
  # If you don't specify this parameter, AWS CloudFormation doesn't
2049
2801
  # modify the stack's tags. If you specify an empty value, AWS
@@ -2056,6 +2808,20 @@ module Aws::CloudFormation
2056
2808
  # retry `UpdateStack` requests to ensure that AWS CloudFormation
2057
2809
  # successfully received them.
2058
2810
  #
2811
+ # All events triggered by a given stack operation are assigned the same
2812
+ # client request token, which you can use to track operations. For
2813
+ # example, if you execute a `CreateStack` operation with the token
2814
+ # `token1`, then all the `StackEvents` generated by that operation will
2815
+ # have `ClientRequestToken` set as `token1`.
2816
+ #
2817
+ # In the console, stack operations display the client request token on
2818
+ # the Events tab. Stack operations that are initiated from the console
2819
+ # use the token format *Console-StackOperation-ID*, which helps you
2820
+ # easily identify the stack operation . For example, if you create a
2821
+ # stack using the console, each stack event would be assigned the same
2822
+ # token in the following format:
2823
+ # `Console-CreateStack-7f59c3cf-00d2-40c7-b2ff-e75db0987002`.
2824
+ #
2059
2825
  # @return [Types::UpdateStackOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2060
2826
  #
2061
2827
  # * {Types::UpdateStackOutput#stack_id #stack_id} => String
@@ -2084,8 +2850,8 @@ module Aws::CloudFormation
2084
2850
  # notification_arns: ["NotificationARN"],
2085
2851
  # tags: [
2086
2852
  # {
2087
- # key: "TagKey",
2088
- # value: "TagValue",
2853
+ # key: "TagKey", # required
2854
+ # value: "TagValue", # required
2089
2855
  # },
2090
2856
  # ],
2091
2857
  # client_request_token: "ClientRequestToken",
@@ -2104,6 +2870,198 @@ module Aws::CloudFormation
2104
2870
  req.send_request(options)
2105
2871
  end
2106
2872
 
2873
+ # Updates the stack set and *all* associated stack instances.
2874
+ #
2875
+ # Even if the stack set operation created by updating the stack set
2876
+ # fails (completely or partially, below or above a specified failure
2877
+ # tolerance), the stack set is updated with your changes. Subsequent
2878
+ # CreateStackInstances calls on the specified stack set use the updated
2879
+ # stack set.
2880
+ #
2881
+ # @option params [required, String] :stack_set_name
2882
+ # The name or unique ID of the stack set that you want to update.
2883
+ #
2884
+ # @option params [String] :description
2885
+ # A brief description of updates that you are making.
2886
+ #
2887
+ # @option params [String] :template_body
2888
+ # The structure that contains the template body, with a minimum length
2889
+ # of 1 byte and a maximum length of 51,200 bytes. For more information,
2890
+ # see [Template Anatomy][1] in the AWS CloudFormation User Guide.
2891
+ #
2892
+ # Conditional: You must specify only one of the following parameters:
2893
+ # `TemplateBody` or `TemplateURL`—or set `UsePreviousTemplate` to true.
2894
+ #
2895
+ #
2896
+ #
2897
+ # [1]: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html
2898
+ #
2899
+ # @option params [String] :template_url
2900
+ # The location of the file that contains the template body. The URL must
2901
+ # point to a template (maximum size: 460,800 bytes) that is located in
2902
+ # an Amazon S3 bucket. For more information, see [Template Anatomy][1]
2903
+ # in the AWS CloudFormation User Guide.
2904
+ #
2905
+ # Conditional: You must specify only one of the following parameters:
2906
+ # `TemplateBody` or `TemplateURL`—or set `UsePreviousTemplate` to true.
2907
+ #
2908
+ #
2909
+ #
2910
+ # [1]: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html
2911
+ #
2912
+ # @option params [Boolean] :use_previous_template
2913
+ # Use the existing template that's associated with the stack set that
2914
+ # you're updating.
2915
+ #
2916
+ # Conditional: You must specify only one of the following parameters:
2917
+ # `TemplateBody` or `TemplateURL`—or set `UsePreviousTemplate` to true.
2918
+ #
2919
+ # @option params [Array<Types::Parameter>] :parameters
2920
+ # A list of input parameters for the stack set template.
2921
+ #
2922
+ # @option params [Array<String>] :capabilities
2923
+ # A list of values that you must specify before AWS CloudFormation can
2924
+ # create certain stack sets. Some stack set templates might include
2925
+ # resources that can affect permissions in your AWS account—for example,
2926
+ # by creating new AWS Identity and Access Management (IAM) users. For
2927
+ # those stack sets, you must explicitly acknowledge their capabilities
2928
+ # by specifying this parameter.
2929
+ #
2930
+ # The only valid values are CAPABILITY\_IAM and CAPABILITY\_NAMED\_IAM.
2931
+ # The following resources require you to specify this parameter:
2932
+ #
2933
+ # * AWS::IAM::AccessKey
2934
+ #
2935
+ # * AWS::IAM::Group
2936
+ #
2937
+ # * AWS::IAM::InstanceProfile
2938
+ #
2939
+ # * AWS::IAM::Policy
2940
+ #
2941
+ # * AWS::IAM::Role
2942
+ #
2943
+ # * AWS::IAM::User
2944
+ #
2945
+ # * AWS::IAM::UserToGroupAddition
2946
+ #
2947
+ # If your stack template contains these resources, we recommend that you
2948
+ # review all permissions that are associated with them and edit their
2949
+ # permissions if necessary.
2950
+ #
2951
+ # If you have IAM resources, you can specify either capability. If you
2952
+ # have IAM resources with custom names, you must specify
2953
+ # CAPABILITY\_NAMED\_IAM. If you don't specify this parameter, this
2954
+ # action returns an `InsufficientCapabilities` error.
2955
+ #
2956
+ # For more information, see [Acknowledging IAM Resources in AWS
2957
+ # CloudFormation Templates.][1]
2958
+ #
2959
+ #
2960
+ #
2961
+ # [1]: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html#capabilities
2962
+ #
2963
+ # @option params [Array<Types::Tag>] :tags
2964
+ # The key-value pairs to associate with this stack set and the stacks
2965
+ # created from it. AWS CloudFormation also propagates these tags to
2966
+ # supported resources that are created in the stacks. You can specify a
2967
+ # maximum number of 50 tags.
2968
+ #
2969
+ # If you specify tags for this parameter, those tags replace any list of
2970
+ # tags that are currently associated with this stack set. This means:
2971
+ #
2972
+ # * If you don't specify this parameter, AWS CloudFormation doesn't
2973
+ # modify the stack's tags.
2974
+ #
2975
+ # * If you specify *any* tags using this parameter, you must specify
2976
+ # *all* the tags that you want associated with this stack set, even
2977
+ # tags you've specifed before (for example, when creating the stack
2978
+ # set or during a previous update of the stack set.). Any tags that
2979
+ # you don't include in the updated list of tags are removed from the
2980
+ # stack set, and therefore from the stacks and resources as well.
2981
+ #
2982
+ # * If you specify an empty value, AWS CloudFormation removes all
2983
+ # currently associated tags.
2984
+ #
2985
+ # If you specify new tags as part of an `UpdateStackSet` action, AWS
2986
+ # CloudFormation checks to see if you have the required IAM permission
2987
+ # to tag resources. If you omit tags that are currently associated with
2988
+ # the stack set from the list of tags you specify, AWS CloudFormation
2989
+ # assumes that you want to remove those tags from the stack set, and
2990
+ # checks to see if you have permission to untag resources. If you don't
2991
+ # have the necessary permission(s), the entire `UpdateStackSet` action
2992
+ # fails with an `access denied` error, and the stack set is not updated.
2993
+ #
2994
+ # @option params [Types::StackSetOperationPreferences] :operation_preferences
2995
+ # Preferences for how AWS CloudFormation performs this stack set
2996
+ # operation.
2997
+ #
2998
+ # @option params [String] :operation_id
2999
+ # The unique ID for this stack set operation.
3000
+ #
3001
+ # The operation ID also functions as an idempotency token, to ensure
3002
+ # that AWS CloudFormation performs the stack set operation only once,
3003
+ # even if you retry the request multiple times. You might retry stack
3004
+ # set operation requests to ensure that AWS CloudFormation successfully
3005
+ # received them.
3006
+ #
3007
+ # If you don't specify an operation ID, AWS CloudFormation generates
3008
+ # one automatically.
3009
+ #
3010
+ # Repeating this stack set operation with a new operation ID retries all
3011
+ # stack instances whose status is `OUTDATED`.
3012
+ #
3013
+ # **A suitable default value is auto-generated.** You should normally
3014
+ # not need to pass this option.**
3015
+ #
3016
+ # @return [Types::UpdateStackSetOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
3017
+ #
3018
+ # * {Types::UpdateStackSetOutput#operation_id #operation_id} => String
3019
+ #
3020
+ # @example Request syntax with placeholder values
3021
+ #
3022
+ # resp = client.update_stack_set({
3023
+ # stack_set_name: "StackSetName", # required
3024
+ # description: "Description",
3025
+ # template_body: "TemplateBody",
3026
+ # template_url: "TemplateURL",
3027
+ # use_previous_template: false,
3028
+ # parameters: [
3029
+ # {
3030
+ # parameter_key: "ParameterKey",
3031
+ # parameter_value: "ParameterValue",
3032
+ # use_previous_value: false,
3033
+ # },
3034
+ # ],
3035
+ # capabilities: ["CAPABILITY_IAM"], # accepts CAPABILITY_IAM, CAPABILITY_NAMED_IAM
3036
+ # tags: [
3037
+ # {
3038
+ # key: "TagKey", # required
3039
+ # value: "TagValue", # required
3040
+ # },
3041
+ # ],
3042
+ # operation_preferences: {
3043
+ # region_order: ["Region"],
3044
+ # failure_tolerance_count: 1,
3045
+ # failure_tolerance_percentage: 1,
3046
+ # max_concurrent_count: 1,
3047
+ # max_concurrent_percentage: 1,
3048
+ # },
3049
+ # operation_id: "ClientRequestToken",
3050
+ # })
3051
+ #
3052
+ # @example Response structure
3053
+ #
3054
+ # resp.operation_id #=> String
3055
+ #
3056
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/UpdateStackSet AWS API Documentation
3057
+ #
3058
+ # @overload update_stack_set(params = {})
3059
+ # @param [Hash] params ({})
3060
+ def update_stack_set(params = {}, options = {})
3061
+ req = build_request(:update_stack_set, params)
3062
+ req.send_request(options)
3063
+ end
3064
+
2107
3065
  # Validates a specified template. AWS CloudFormation first checks if the
2108
3066
  # template is valid JSON. If it isn't, AWS CloudFormation checks if the
2109
3067
  # template is valid YAML. If both these checks fail, AWS CloudFormation
@@ -2185,7 +3143,7 @@ module Aws::CloudFormation
2185
3143
  params: params,
2186
3144
  config: config)
2187
3145
  context[:gem_name] = 'aws-sdk-cloudformation'
2188
- context[:gem_version] = '1.0.0.rc9'
3146
+ context[:gem_version] = '1.0.0.rc10'
2189
3147
  Seahorse::Client::Request.new(handlers, context)
2190
3148
  end
2191
3149