aws-sdk-cloudformation 1.173.0 → 1.174.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: a4d8076e2d5ac07f05996b7dd89b5a1d7f643c398e7543b4f35784b522027467
4
- data.tar.gz: 84cda65d3364979f6e6a013f7ac26a0b96b33a3922da6db532434b65d18a9399
3
+ metadata.gz: b6f5cabce1ae55d1b7aa40ebebfd2342a2261c564ce66bed1d304971a16c66b7
4
+ data.tar.gz: cbab3cb4208e2f9c0b059eb6b859eeb472dfe1ac30b9f8d53259ceb1eedc3b55
5
5
  SHA512:
6
- metadata.gz: 863c95fa6590b696375dd2e9851f7022ec77a885a11285d9d1f564d220f94ce19d31f18e7f4a202c19e65a8d3fd8104ed15de83d7c05919ec41b3db42868c910
7
- data.tar.gz: 2757d5e4ec33b1a70d000625c9cad99d3ea27c827086aa820ca817acae79e5df101e45d9261e82854249dad4c433a4d0500b24fa066488b57a4d0f5ed4d33404
6
+ metadata.gz: 9b3d57fc35a2df822510e6a6365fe2b815b2bb7acd3ec5ac7039b22199e57564827e9d795d6d3bb58d309b365b233a9d90044fbdf06943eb4427dbfba6d668af
7
+ data.tar.gz: 8a3dc2f3f75f1f49b6baa6119bcf3fec9e8b51bc90261c13ba35a8d5acf261119addef77ae0e584695eda9ef0a482e51aa66c0cc6497b433efeefda6df0c742a
data/CHANGELOG.md CHANGED
@@ -1,6 +1,11 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.174.0 (2026-11-19)
5
+ ------------------
6
+
7
+ * Feature - Adds parameters to support custom execution roles for service-managed stack sets to CreateStackSet, UpdateStackSet, and DescribeStackSet, enabling the use of Macros, Transforms, and Nested Stacks.
8
+
4
9
  1.173.0 (2026-11-18)
5
10
  ------------------
6
11
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.173.0
1
+ 1.174.0
@@ -2072,12 +2072,19 @@ module Aws::CloudFormation
2072
2072
  # custom processing on CloudFormation templates with template
2073
2073
  # macros][9].
2074
2074
  #
2075
- # StackSets with service-managed permissions don't currently support
2076
- # the use of macros in templates. (This includes the
2075
+ # With service-managed permissions, CloudFormation can process macros,
2076
+ # nested stacks, and transforms in your StackSet template only when
2077
+ # you provide a custom execution role template. (Macros include the
2077
2078
  # [AWS::Include][10] and [AWS::Serverless][11] transforms, which are
2078
- # macros hosted by CloudFormation.) Even if you specify this
2079
- # capability for a StackSet with service-managed permissions, if you
2080
- # reference a macro in your template the StackSet operation will fail.
2079
+ # macros hosted by CloudFormation.) The default service-managed
2080
+ # execution role can't provision them: if you reference a macro in
2081
+ # your template, the StackSet operation fails even when you specify
2082
+ # this capability.
2083
+ #
2084
+ # To use macros, nested stacks, or transforms with service-managed
2085
+ # permissions, specify a custom execution role template in
2086
+ # `ExecutionRoleTemplateBody` or `ExecutionRoleTemplateUrl`, and
2087
+ # specify both `CAPABILITY_NAMED_IAM` and `CAPABILITY_AUTO_EXPAND`.
2081
2088
  #
2082
2089
  #
2083
2090
  #
@@ -2121,16 +2128,19 @@ module Aws::CloudFormation
2121
2128
  # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-prereqs-self-managed.html
2122
2129
  #
2123
2130
  # @option params [String] :execution_role_name
2124
- # The name of the IAM execution role to use to create the StackSet. If
2125
- # you do not specify an execution role, CloudFormation uses the
2126
- # `AWSCloudFormationStackSetExecutionRole` role for the StackSet
2127
- # operation.
2131
+ # The name of the IAM execution role that CloudFormation uses for
2132
+ # StackSet operations in your target accounts.
2128
2133
  #
2129
- # Specify an IAM role only if you are using customized execution roles
2130
- # to control which stack resources users and groups can include in their
2131
- # StackSets.
2134
+ # \[Self-managed permissions\] If you do not specify an execution role,
2135
+ # CloudFormation uses the `AWSCloudFormationStackSetExecutionRole` role
2136
+ # for the StackSet operation. Specify an IAM role only if you are using
2137
+ # customized execution roles to control which stack resources users and
2138
+ # groups can include in their StackSets.
2132
2139
  #
2133
- # Valid only if the permissions model is `SELF_MANAGED`.
2140
+ # \[Service-managed permissions\] Set this name when you use custom
2141
+ # execution roles. The role that your custom execution role template
2142
+ # provisions in your target accounts must have this same name, and the
2143
+ # name must begin with `stacksets-exec-custom-`.
2134
2144
  #
2135
2145
  # @option params [String] :permission_model
2136
2146
  # Describes how the IAM roles required for StackSet operations are
@@ -2209,6 +2219,31 @@ module Aws::CloudFormation
2209
2219
  # Describes whether CloudFormation performs non-conflicting operations
2210
2220
  # concurrently and queues conflicting operations.
2211
2221
  #
2222
+ # @option params [String] :execution_role_template_body
2223
+ # The body of the template that creates a custom execution role in
2224
+ # target accounts. This parameter applies only when the permissions
2225
+ # model is `SERVICE_MANAGED`.
2226
+ #
2227
+ # Conditional: Specify either `ExecutionRoleTemplateBody` or
2228
+ # `ExecutionRoleTemplateUrl`, but not both. If you don't specify
2229
+ # either, CloudFormation uses the default service-managed execution role
2230
+ # in target accounts.
2231
+ #
2232
+ # @option params [String] :execution_role_template_url
2233
+ # The URL of an Amazon S3 object that contains the template that creates
2234
+ # a custom execution role in target accounts. This parameter applies
2235
+ # only when the permissions model is `SERVICE_MANAGED`.
2236
+ #
2237
+ # Conditional: Specify either `ExecutionRoleTemplateBody` or
2238
+ # `ExecutionRoleTemplateUrl`, but not both. If you don't specify
2239
+ # either, CloudFormation uses the default service-managed execution role
2240
+ # in target accounts.
2241
+ #
2242
+ # @option params [String] :stack_set_output_bucket
2243
+ # The name of the Amazon S3 bucket that stores the execution role stack
2244
+ # template body. CloudFormation uses this bucket only when you specify a
2245
+ # custom execution role template.
2246
+ #
2212
2247
  # @return [Types::CreateStackSetOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2213
2248
  #
2214
2249
  # * {Types::CreateStackSetOutput#stack_set_id #stack_set_id} => String
@@ -2249,6 +2284,9 @@ module Aws::CloudFormation
2249
2284
  # managed_execution: {
2250
2285
  # active: false,
2251
2286
  # },
2287
+ # execution_role_template_body: "TemplateBody",
2288
+ # execution_role_template_url: "TemplateURL",
2289
+ # stack_set_output_bucket: "StackSetOutputBucket",
2252
2290
  # })
2253
2291
  #
2254
2292
  # @example Response structure
@@ -4053,6 +4091,7 @@ module Aws::CloudFormation
4053
4091
  # resp.stack_set.managed_execution.active #=> Boolean
4054
4092
  # resp.stack_set.regions #=> Array
4055
4093
  # resp.stack_set.regions[0] #=> String
4094
+ # resp.stack_set.stack_set_output_bucket_path #=> String
4056
4095
  #
4057
4096
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/DescribeStackSet AWS API Documentation
4058
4097
  #
@@ -8960,12 +8999,19 @@ module Aws::CloudFormation
8960
8999
  # custom processing on CloudFormation templates with template
8961
9000
  # macros][9].
8962
9001
  #
8963
- # StackSets with service-managed permissions do not currently support
8964
- # the use of macros in templates. (This includes the
9002
+ # With service-managed permissions, CloudFormation can process macros,
9003
+ # nested stacks, and transforms in your StackSet template only when
9004
+ # you provide a custom execution role template. (Macros include the
8965
9005
  # [AWS::Include][10] and [AWS::Serverless][11] transforms, which are
8966
- # macros hosted by CloudFormation.) Even if you specify this
8967
- # capability for a StackSet with service-managed permissions, if you
8968
- # reference a macro in your template the StackSet operation will fail.
9006
+ # macros hosted by CloudFormation.) The default service-managed
9007
+ # execution role can't provision them: if you reference a macro in
9008
+ # your template, the StackSet operation fails even when you specify
9009
+ # this capability.
9010
+ #
9011
+ # To use macros, nested stacks, or transforms with service-managed
9012
+ # permissions, specify a custom execution role template in
9013
+ # `ExecutionRoleTemplateBody` or `ExecutionRoleTemplateUrl`, and
9014
+ # specify both `CAPABILITY_NAMED_IAM` and `CAPABILITY_AUTO_EXPAND`.
8969
9015
  #
8970
9016
  #
8971
9017
  #
@@ -9035,14 +9081,15 @@ module Aws::CloudFormation
9035
9081
  # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-prereqs-self-managed.html
9036
9082
  #
9037
9083
  # @option params [String] :execution_role_name
9084
+ # The name of the IAM execution role that CloudFormation uses for
9085
+ # StackSet operations in your target accounts.
9086
+ #
9038
9087
  # \[Self-managed permissions\] The name of the IAM execution role to use
9039
9088
  # to update the stack set. If you do not specify an execution role,
9040
9089
  # CloudFormation uses the `AWSCloudFormationStackSetExecutionRole` role
9041
- # for the StackSet operation.
9042
- #
9043
- # Specify an IAM role only if you are using customized execution roles
9044
- # to control which stack resources users and groups can include in their
9045
- # StackSets.
9090
+ # for the StackSet operation. Specify an IAM role only if you are using
9091
+ # customized execution roles to control which stack resources users and
9092
+ # groups can include in their StackSets.
9046
9093
  #
9047
9094
  # If you specify a customized execution role, CloudFormation uses that
9048
9095
  # role to update the stack. If you do not specify a customized execution
@@ -9050,6 +9097,13 @@ module Aws::CloudFormation
9050
9097
  # associated with the StackSet, so long as you have permissions to
9051
9098
  # perform operations on the StackSet.
9052
9099
  #
9100
+ # \[Service-managed permissions\] Set this name when you use custom
9101
+ # execution roles. The role that your custom execution role template
9102
+ # provisions in your target accounts must have this same name, and the
9103
+ # name must begin with `stacksets-exec-custom-`. You don't need to
9104
+ # specify this parameter if an execution role name is already configured
9105
+ # for the StackSet and you aren't changing it.
9106
+ #
9053
9107
  # @option params [Types::DeploymentTargets] :deployment_targets
9054
9108
  # \[Service-managed permissions\] The Organizations accounts in which to
9055
9109
  # update associated stack instances.
@@ -9180,6 +9234,38 @@ module Aws::CloudFormation
9180
9234
  # Describes whether CloudFormation performs non-conflicting operations
9181
9235
  # concurrently and queues conflicting operations.
9182
9236
  #
9237
+ # @option params [String] :execution_role_template_body
9238
+ # The body of the template that creates or updates a custom execution
9239
+ # role in target accounts. This parameter applies only when the
9240
+ # permissions model is `SERVICE_MANAGED`.
9241
+ #
9242
+ # Conditional: Specify either `ExecutionRoleTemplateBody` or
9243
+ # `ExecutionRoleTemplateUrl`, but not both. If you don't specify
9244
+ # either, CloudFormation uses the default service-managed execution role
9245
+ # in target accounts.
9246
+ #
9247
+ # @option params [String] :execution_role_template_url
9248
+ # The URL of an Amazon S3 object that contains the template that creates
9249
+ # or updates a custom execution role in target accounts. This parameter
9250
+ # applies only when the permissions model is `SERVICE_MANAGED`.
9251
+ #
9252
+ # Conditional: Specify either `ExecutionRoleTemplateBody` or
9253
+ # `ExecutionRoleTemplateUrl`, but not both. If you don't specify
9254
+ # either, CloudFormation uses the default service-managed execution role
9255
+ # in target accounts.
9256
+ #
9257
+ # @option params [Boolean] :use_admin_execution_role
9258
+ # Specifies whether CloudFormation uses the default service-managed
9259
+ # execution role instead of a custom execution role in target accounts.
9260
+ # If you set this to `true`, CloudFormation ignores any custom execution
9261
+ # role template specified in `ExecutionRoleTemplateBody` or
9262
+ # `ExecutionRoleTemplateUrl`.
9263
+ #
9264
+ # @option params [String] :stack_set_output_bucket
9265
+ # The name of the Amazon S3 bucket that stores the execution role stack
9266
+ # template body. CloudFormation uses this bucket only when you specify a
9267
+ # custom execution role template.
9268
+ #
9183
9269
  # @return [Types::UpdateStackSetOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
9184
9270
  #
9185
9271
  # * {Types::UpdateStackSetOutput#operation_id #operation_id} => String
@@ -9237,6 +9323,10 @@ module Aws::CloudFormation
9237
9323
  # managed_execution: {
9238
9324
  # active: false,
9239
9325
  # },
9326
+ # execution_role_template_body: "TemplateBody",
9327
+ # execution_role_template_url: "TemplateURL",
9328
+ # use_admin_execution_role: false,
9329
+ # stack_set_output_bucket: "StackSetOutputBucket",
9240
9330
  # })
9241
9331
  #
9242
9332
  # @example Response structure
@@ -9374,7 +9464,7 @@ module Aws::CloudFormation
9374
9464
  tracer: tracer
9375
9465
  )
9376
9466
  context[:gem_name] = 'aws-sdk-cloudformation'
9377
- context[:gem_version] = '1.173.0'
9467
+ context[:gem_version] = '1.174.0'
9378
9468
  Seahorse::Client::Request.new(handlers, context)
9379
9469
  end
9380
9470
 
@@ -600,6 +600,8 @@ module Aws::CloudFormation
600
600
  StackSetOperationSummaries = Shapes::ListShape.new(name: 'StackSetOperationSummaries')
601
601
  StackSetOperationSummary = Shapes::StructureShape.new(name: 'StackSetOperationSummary')
602
602
  StackSetOperationTotalStackInstancesCount = Shapes::IntegerShape.new(name: 'StackSetOperationTotalStackInstancesCount')
603
+ StackSetOutputBucket = Shapes::StringShape.new(name: 'StackSetOutputBucket')
604
+ StackSetOutputBucketPath = Shapes::StringShape.new(name: 'StackSetOutputBucketPath')
603
605
  StackSetStatus = Shapes::StringShape.new(name: 'StackSetStatus')
604
606
  StackSetSummaries = Shapes::ListShape.new(name: 'StackSetSummaries')
605
607
  StackSetSummary = Shapes::StructureShape.new(name: 'StackSetSummary')
@@ -688,6 +690,7 @@ module Aws::CloudFormation
688
690
  UpdateTerminationProtectionInput = Shapes::StructureShape.new(name: 'UpdateTerminationProtectionInput')
689
691
  UpdateTerminationProtectionOutput = Shapes::StructureShape.new(name: 'UpdateTerminationProtectionOutput')
690
692
  Url = Shapes::StringShape.new(name: 'Url')
693
+ UseAdminExecutionRoleNullable = Shapes::BooleanShape.new(name: 'UseAdminExecutionRoleNullable')
691
694
  UsePreviousTemplate = Shapes::BooleanShape.new(name: 'UsePreviousTemplate')
692
695
  UsePreviousValue = Shapes::BooleanShape.new(name: 'UsePreviousValue')
693
696
  ValidateTemplateInput = Shapes::StructureShape.new(name: 'ValidateTemplateInput')
@@ -937,6 +940,9 @@ module Aws::CloudFormation
937
940
  CreateStackSetInput.add_member(:call_as, Shapes::ShapeRef.new(shape: CallAs, location_name: "CallAs"))
938
941
  CreateStackSetInput.add_member(:client_request_token, Shapes::ShapeRef.new(shape: ClientRequestToken, location_name: "ClientRequestToken", metadata: {"idempotencyToken" => true}))
939
942
  CreateStackSetInput.add_member(:managed_execution, Shapes::ShapeRef.new(shape: ManagedExecution, location_name: "ManagedExecution"))
943
+ CreateStackSetInput.add_member(:execution_role_template_body, Shapes::ShapeRef.new(shape: TemplateBody, location_name: "ExecutionRoleTemplateBody"))
944
+ CreateStackSetInput.add_member(:execution_role_template_url, Shapes::ShapeRef.new(shape: TemplateURL, location_name: "ExecutionRoleTemplateUrl"))
945
+ CreateStackSetInput.add_member(:stack_set_output_bucket, Shapes::ShapeRef.new(shape: StackSetOutputBucket, location_name: "StackSetOutputBucket"))
940
946
  CreateStackSetInput.struct_class = Types::CreateStackSetInput
941
947
 
942
948
  CreateStackSetOutput.add_member(:stack_set_id, Shapes::ShapeRef.new(shape: StackSetId, location_name: "StackSetId"))
@@ -2283,6 +2289,7 @@ module Aws::CloudFormation
2283
2289
  StackSet.add_member(:organizational_unit_ids, Shapes::ShapeRef.new(shape: OrganizationalUnitIdList, location_name: "OrganizationalUnitIds"))
2284
2290
  StackSet.add_member(:managed_execution, Shapes::ShapeRef.new(shape: ManagedExecution, location_name: "ManagedExecution"))
2285
2291
  StackSet.add_member(:regions, Shapes::ShapeRef.new(shape: RegionList, location_name: "Regions"))
2292
+ StackSet.add_member(:stack_set_output_bucket_path, Shapes::ShapeRef.new(shape: StackSetOutputBucketPath, location_name: "StackSetOutputBucketPath"))
2286
2293
  StackSet.struct_class = Types::StackSet
2287
2294
 
2288
2295
  StackSetARNList.member = Shapes::ShapeRef.new(shape: StackSetARN)
@@ -2599,6 +2606,10 @@ module Aws::CloudFormation
2599
2606
  UpdateStackSetInput.add_member(:regions, Shapes::ShapeRef.new(shape: RegionList, location_name: "Regions"))
2600
2607
  UpdateStackSetInput.add_member(:call_as, Shapes::ShapeRef.new(shape: CallAs, location_name: "CallAs"))
2601
2608
  UpdateStackSetInput.add_member(:managed_execution, Shapes::ShapeRef.new(shape: ManagedExecution, location_name: "ManagedExecution"))
2609
+ UpdateStackSetInput.add_member(:execution_role_template_body, Shapes::ShapeRef.new(shape: TemplateBody, location_name: "ExecutionRoleTemplateBody"))
2610
+ UpdateStackSetInput.add_member(:execution_role_template_url, Shapes::ShapeRef.new(shape: TemplateURL, location_name: "ExecutionRoleTemplateUrl"))
2611
+ UpdateStackSetInput.add_member(:use_admin_execution_role, Shapes::ShapeRef.new(shape: UseAdminExecutionRoleNullable, location_name: "UseAdminExecutionRole"))
2612
+ UpdateStackSetInput.add_member(:stack_set_output_bucket, Shapes::ShapeRef.new(shape: StackSetOutputBucket, location_name: "StackSetOutputBucket"))
2602
2613
  UpdateStackSetInput.struct_class = Types::UpdateStackSetInput
2603
2614
 
2604
2615
  UpdateStackSetOutput.add_member(:operation_id, Shapes::ShapeRef.new(shape: ClientRequestToken, location_name: "OperationId"))
@@ -1857,13 +1857,19 @@ module Aws::CloudFormation
1857
1857
  # information, see [Perform custom processing on CloudFormation
1858
1858
  # templates with template macros][9].
1859
1859
  #
1860
- # StackSets with service-managed permissions don't currently
1861
- # support the use of macros in templates. (This includes the
1862
- # [AWS::Include][10] and [AWS::Serverless][11] transforms, which are
1863
- # macros hosted by CloudFormation.) Even if you specify this
1864
- # capability for a StackSet with service-managed permissions, if you
1865
- # reference a macro in your template the StackSet operation will
1866
- # fail.
1860
+ # With service-managed permissions, CloudFormation can process
1861
+ # macros, nested stacks, and transforms in your StackSet template
1862
+ # only when you provide a custom execution role template. (Macros
1863
+ # include the [AWS::Include][10] and [AWS::Serverless][11]
1864
+ # transforms, which are macros hosted by CloudFormation.) The
1865
+ # default service-managed execution role can't provision them: if
1866
+ # you reference a macro in your template, the StackSet operation
1867
+ # fails even when you specify this capability.
1868
+ #
1869
+ # To use macros, nested stacks, or transforms with service-managed
1870
+ # permissions, specify a custom execution role template in
1871
+ # `ExecutionRoleTemplateBody` or `ExecutionRoleTemplateUrl`, and
1872
+ # specify both `CAPABILITY_NAMED_IAM` and `CAPABILITY_AUTO_EXPAND`.
1867
1873
  #
1868
1874
  #
1869
1875
  #
@@ -1911,16 +1917,20 @@ module Aws::CloudFormation
1911
1917
  # @return [String]
1912
1918
  #
1913
1919
  # @!attribute [rw] execution_role_name
1914
- # The name of the IAM execution role to use to create the StackSet. If
1915
- # you do not specify an execution role, CloudFormation uses the
1916
- # `AWSCloudFormationStackSetExecutionRole` role for the StackSet
1917
- # operation.
1920
+ # The name of the IAM execution role that CloudFormation uses for
1921
+ # StackSet operations in your target accounts.
1918
1922
  #
1919
- # Specify an IAM role only if you are using customized execution roles
1920
- # to control which stack resources users and groups can include in
1921
- # their StackSets.
1923
+ # \[Self-managed permissions\] If you do not specify an execution
1924
+ # role, CloudFormation uses the
1925
+ # `AWSCloudFormationStackSetExecutionRole` role for the StackSet
1926
+ # operation. Specify an IAM role only if you are using customized
1927
+ # execution roles to control which stack resources users and groups
1928
+ # can include in their StackSets.
1922
1929
  #
1923
- # Valid only if the permissions model is `SELF_MANAGED`.
1930
+ # \[Service-managed permissions\] Set this name when you use custom
1931
+ # execution roles. The role that your custom execution role template
1932
+ # provisions in your target accounts must have this same name, and the
1933
+ # name must begin with `stacksets-exec-custom-`.
1924
1934
  # @return [String]
1925
1935
  #
1926
1936
  # @!attribute [rw] permission_model
@@ -2007,6 +2017,34 @@ module Aws::CloudFormation
2007
2017
  # concurrently and queues conflicting operations.
2008
2018
  # @return [Types::ManagedExecution]
2009
2019
  #
2020
+ # @!attribute [rw] execution_role_template_body
2021
+ # The body of the template that creates a custom execution role in
2022
+ # target accounts. This parameter applies only when the permissions
2023
+ # model is `SERVICE_MANAGED`.
2024
+ #
2025
+ # Conditional: Specify either `ExecutionRoleTemplateBody` or
2026
+ # `ExecutionRoleTemplateUrl`, but not both. If you don't specify
2027
+ # either, CloudFormation uses the default service-managed execution
2028
+ # role in target accounts.
2029
+ # @return [String]
2030
+ #
2031
+ # @!attribute [rw] execution_role_template_url
2032
+ # The URL of an Amazon S3 object that contains the template that
2033
+ # creates a custom execution role in target accounts. This parameter
2034
+ # applies only when the permissions model is `SERVICE_MANAGED`.
2035
+ #
2036
+ # Conditional: Specify either `ExecutionRoleTemplateBody` or
2037
+ # `ExecutionRoleTemplateUrl`, but not both. If you don't specify
2038
+ # either, CloudFormation uses the default service-managed execution
2039
+ # role in target accounts.
2040
+ # @return [String]
2041
+ #
2042
+ # @!attribute [rw] stack_set_output_bucket
2043
+ # The name of the Amazon S3 bucket that stores the execution role
2044
+ # stack template body. CloudFormation uses this bucket only when you
2045
+ # specify a custom execution role template.
2046
+ # @return [String]
2047
+ #
2010
2048
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateStackSetInput AWS API Documentation
2011
2049
  #
2012
2050
  class CreateStackSetInput < Struct.new(
@@ -2024,7 +2062,10 @@ module Aws::CloudFormation
2024
2062
  :auto_deployment,
2025
2063
  :call_as,
2026
2064
  :client_request_token,
2027
- :managed_execution)
2065
+ :managed_execution,
2066
+ :execution_role_template_body,
2067
+ :execution_role_template_url,
2068
+ :stack_set_output_bucket)
2028
2069
  SENSITIVE = []
2029
2070
  include Aws::Structure
2030
2071
  end
@@ -10600,6 +10641,12 @@ module Aws::CloudFormation
10600
10641
  # list output is in no particular order.
10601
10642
  # @return [Array<String>]
10602
10643
  #
10644
+ # @!attribute [rw] stack_set_output_bucket_path
10645
+ # The Amazon S3 bucket path where CloudFormation stores the execution
10646
+ # role stack template body. CloudFormation uses this bucket only when
10647
+ # you specify a custom execution role template.
10648
+ # @return [String]
10649
+ #
10603
10650
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/StackSet AWS API Documentation
10604
10651
  #
10605
10652
  class StackSet < Struct.new(
@@ -10619,7 +10666,8 @@ module Aws::CloudFormation
10619
10666
  :permission_model,
10620
10667
  :organizational_unit_ids,
10621
10668
  :managed_execution,
10622
- :regions)
10669
+ :regions,
10670
+ :stack_set_output_bucket_path)
10623
10671
  SENSITIVE = []
10624
10672
  include Aws::Structure
10625
10673
  end
@@ -12921,13 +12969,19 @@ module Aws::CloudFormation
12921
12969
  # information, see [Perform custom processing on CloudFormation
12922
12970
  # templates with template macros][9].
12923
12971
  #
12924
- # StackSets with service-managed permissions do not currently
12925
- # support the use of macros in templates. (This includes the
12926
- # [AWS::Include][10] and [AWS::Serverless][11] transforms, which are
12927
- # macros hosted by CloudFormation.) Even if you specify this
12928
- # capability for a StackSet with service-managed permissions, if you
12929
- # reference a macro in your template the StackSet operation will
12930
- # fail.
12972
+ # With service-managed permissions, CloudFormation can process
12973
+ # macros, nested stacks, and transforms in your StackSet template
12974
+ # only when you provide a custom execution role template. (Macros
12975
+ # include the [AWS::Include][10] and [AWS::Serverless][11]
12976
+ # transforms, which are macros hosted by CloudFormation.) The
12977
+ # default service-managed execution role can't provision them: if
12978
+ # you reference a macro in your template, the StackSet operation
12979
+ # fails even when you specify this capability.
12980
+ #
12981
+ # To use macros, nested stacks, or transforms with service-managed
12982
+ # permissions, specify a custom execution role template in
12983
+ # `ExecutionRoleTemplateBody` or `ExecutionRoleTemplateUrl`, and
12984
+ # specify both `CAPABILITY_NAMED_IAM` and `CAPABILITY_AUTO_EXPAND`.
12931
12985
  #
12932
12986
  #
12933
12987
  #
@@ -13004,21 +13058,29 @@ module Aws::CloudFormation
13004
13058
  # @return [String]
13005
13059
  #
13006
13060
  # @!attribute [rw] execution_role_name
13061
+ # The name of the IAM execution role that CloudFormation uses for
13062
+ # StackSet operations in your target accounts.
13063
+ #
13007
13064
  # \[Self-managed permissions\] The name of the IAM execution role to
13008
13065
  # use to update the stack set. If you do not specify an execution
13009
13066
  # role, CloudFormation uses the
13010
13067
  # `AWSCloudFormationStackSetExecutionRole` role for the StackSet
13011
- # operation.
13012
- #
13013
- # Specify an IAM role only if you are using customized execution roles
13014
- # to control which stack resources users and groups can include in
13015
- # their StackSets.
13068
+ # operation. Specify an IAM role only if you are using customized
13069
+ # execution roles to control which stack resources users and groups
13070
+ # can include in their StackSets.
13016
13071
  #
13017
13072
  # If you specify a customized execution role, CloudFormation uses that
13018
13073
  # role to update the stack. If you do not specify a customized
13019
13074
  # execution role, CloudFormation performs the update using the role
13020
13075
  # previously associated with the StackSet, so long as you have
13021
13076
  # permissions to perform operations on the StackSet.
13077
+ #
13078
+ # \[Service-managed permissions\] Set this name when you use custom
13079
+ # execution roles. The role that your custom execution role template
13080
+ # provisions in your target accounts must have this same name, and the
13081
+ # name must begin with `stacksets-exec-custom-`. You don't need to
13082
+ # specify this parameter if an execution role name is already
13083
+ # configured for the StackSet and you aren't changing it.
13022
13084
  # @return [String]
13023
13085
  #
13024
13086
  # @!attribute [rw] deployment_targets
@@ -13159,6 +13221,43 @@ module Aws::CloudFormation
13159
13221
  # concurrently and queues conflicting operations.
13160
13222
  # @return [Types::ManagedExecution]
13161
13223
  #
13224
+ # @!attribute [rw] execution_role_template_body
13225
+ # The body of the template that creates or updates a custom execution
13226
+ # role in target accounts. This parameter applies only when the
13227
+ # permissions model is `SERVICE_MANAGED`.
13228
+ #
13229
+ # Conditional: Specify either `ExecutionRoleTemplateBody` or
13230
+ # `ExecutionRoleTemplateUrl`, but not both. If you don't specify
13231
+ # either, CloudFormation uses the default service-managed execution
13232
+ # role in target accounts.
13233
+ # @return [String]
13234
+ #
13235
+ # @!attribute [rw] execution_role_template_url
13236
+ # The URL of an Amazon S3 object that contains the template that
13237
+ # creates or updates a custom execution role in target accounts. This
13238
+ # parameter applies only when the permissions model is
13239
+ # `SERVICE_MANAGED`.
13240
+ #
13241
+ # Conditional: Specify either `ExecutionRoleTemplateBody` or
13242
+ # `ExecutionRoleTemplateUrl`, but not both. If you don't specify
13243
+ # either, CloudFormation uses the default service-managed execution
13244
+ # role in target accounts.
13245
+ # @return [String]
13246
+ #
13247
+ # @!attribute [rw] use_admin_execution_role
13248
+ # Specifies whether CloudFormation uses the default service-managed
13249
+ # execution role instead of a custom execution role in target
13250
+ # accounts. If you set this to `true`, CloudFormation ignores any
13251
+ # custom execution role template specified in
13252
+ # `ExecutionRoleTemplateBody` or `ExecutionRoleTemplateUrl`.
13253
+ # @return [Boolean]
13254
+ #
13255
+ # @!attribute [rw] stack_set_output_bucket
13256
+ # The name of the Amazon S3 bucket that stores the execution role
13257
+ # stack template body. CloudFormation uses this bucket only when you
13258
+ # specify a custom execution role template.
13259
+ # @return [String]
13260
+ #
13162
13261
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/UpdateStackSetInput AWS API Documentation
13163
13262
  #
13164
13263
  class UpdateStackSetInput < Struct.new(
@@ -13180,7 +13279,11 @@ module Aws::CloudFormation
13180
13279
  :accounts,
13181
13280
  :regions,
13182
13281
  :call_as,
13183
- :managed_execution)
13282
+ :managed_execution,
13283
+ :execution_role_template_body,
13284
+ :execution_role_template_url,
13285
+ :use_admin_execution_role,
13286
+ :stack_set_output_bucket)
13184
13287
  SENSITIVE = []
13185
13288
  include Aws::Structure
13186
13289
  end
@@ -59,7 +59,7 @@ module Aws::CloudFormation
59
59
  autoload :StackResource, 'aws-sdk-cloudformation/stack_resource'
60
60
  autoload :StackResourceSummary, 'aws-sdk-cloudformation/stack_resource_summary'
61
61
 
62
- GEM_VERSION = '1.173.0'
62
+ GEM_VERSION = '1.174.0'
63
63
 
64
64
  end
65
65
 
data/sig/client.rbs CHANGED
@@ -382,7 +382,10 @@ module Aws
382
382
  ?client_request_token: ::String,
383
383
  ?managed_execution: {
384
384
  active: bool?
385
- }
385
+ },
386
+ ?execution_role_template_body: ::String,
387
+ ?execution_role_template_url: ::String,
388
+ ?stack_set_output_bucket: ::String
386
389
  ) -> _CreateStackSetResponseSuccess
387
390
  | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _CreateStackSetResponseSuccess
388
391
 
@@ -1623,7 +1626,11 @@ module Aws
1623
1626
  ?call_as: ("SELF" | "DELEGATED_ADMIN"),
1624
1627
  ?managed_execution: {
1625
1628
  active: bool?
1626
- }
1629
+ },
1630
+ ?execution_role_template_body: ::String,
1631
+ ?execution_role_template_url: ::String,
1632
+ ?use_admin_execution_role: bool,
1633
+ ?stack_set_output_bucket: ::String
1627
1634
  ) -> _UpdateStackSetResponseSuccess
1628
1635
  | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _UpdateStackSetResponseSuccess
1629
1636
 
data/sig/types.rbs CHANGED
@@ -281,6 +281,9 @@ module Aws::CloudFormation
281
281
  attr_accessor call_as: ("SELF" | "DELEGATED_ADMIN")
282
282
  attr_accessor client_request_token: ::String
283
283
  attr_accessor managed_execution: Types::ManagedExecution
284
+ attr_accessor execution_role_template_body: ::String
285
+ attr_accessor execution_role_template_url: ::String
286
+ attr_accessor stack_set_output_bucket: ::String
284
287
  SENSITIVE: []
285
288
  end
286
289
 
@@ -1918,6 +1921,7 @@ module Aws::CloudFormation
1918
1921
  attr_accessor organizational_unit_ids: ::Array[::String]
1919
1922
  attr_accessor managed_execution: Types::ManagedExecution
1920
1923
  attr_accessor regions: ::Array[::String]
1924
+ attr_accessor stack_set_output_bucket_path: ::String
1921
1925
  SENSITIVE: []
1922
1926
  end
1923
1927
 
@@ -2269,6 +2273,10 @@ module Aws::CloudFormation
2269
2273
  attr_accessor regions: ::Array[::String]
2270
2274
  attr_accessor call_as: ("SELF" | "DELEGATED_ADMIN")
2271
2275
  attr_accessor managed_execution: Types::ManagedExecution
2276
+ attr_accessor execution_role_template_body: ::String
2277
+ attr_accessor execution_role_template_url: ::String
2278
+ attr_accessor use_admin_execution_role: bool
2279
+ attr_accessor stack_set_output_bucket: ::String
2272
2280
  SENSITIVE: []
2273
2281
  end
2274
2282
 
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: aws-sdk-cloudformation
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.173.0
4
+ version: 1.174.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Amazon Web Services