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 +4 -4
- data/CHANGELOG.md +5 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-cloudformation/client.rb +114 -24
- data/lib/aws-sdk-cloudformation/client_api.rb +11 -0
- data/lib/aws-sdk-cloudformation/types.rb +133 -30
- data/lib/aws-sdk-cloudformation.rb +1 -1
- data/sig/client.rbs +9 -2
- data/sig/types.rbs +8 -0
- metadata +1 -1
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA256:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: b6f5cabce1ae55d1b7aa40ebebfd2342a2261c564ce66bed1d304971a16c66b7
|
|
4
|
+
data.tar.gz: cbab3cb4208e2f9c0b059eb6b859eeb472dfe1ac30b9f8d53259ceb1eedc3b55
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
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.
|
|
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
|
-
#
|
|
2076
|
-
#
|
|
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.)
|
|
2079
|
-
#
|
|
2080
|
-
#
|
|
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
|
|
2125
|
-
#
|
|
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
|
-
#
|
|
2130
|
-
#
|
|
2131
|
-
#
|
|
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
|
-
#
|
|
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
|
-
#
|
|
8964
|
-
#
|
|
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.)
|
|
8967
|
-
#
|
|
8968
|
-
#
|
|
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
|
-
#
|
|
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.
|
|
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
|
-
#
|
|
1861
|
-
#
|
|
1862
|
-
#
|
|
1863
|
-
#
|
|
1864
|
-
#
|
|
1865
|
-
#
|
|
1866
|
-
#
|
|
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
|
|
1915
|
-
#
|
|
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
|
-
#
|
|
1920
|
-
#
|
|
1921
|
-
#
|
|
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
|
-
#
|
|
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
|
-
#
|
|
12925
|
-
#
|
|
12926
|
-
#
|
|
12927
|
-
#
|
|
12928
|
-
#
|
|
12929
|
-
#
|
|
12930
|
-
#
|
|
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
|
-
#
|
|
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
|
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
|
|