aws-sdk-cloudformation 1.46.0 → 1.51.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/CHANGELOG.md +340 -0
- data/LICENSE.txt +202 -0
- data/VERSION +1 -0
- data/lib/aws-sdk-cloudformation.rb +2 -2
- data/lib/aws-sdk-cloudformation/client.rb +539 -170
- data/lib/aws-sdk-cloudformation/client_api.rb +21 -1
- data/lib/aws-sdk-cloudformation/customizations.rb +1 -1
- data/lib/aws-sdk-cloudformation/errors.rb +1 -1
- data/lib/aws-sdk-cloudformation/event.rb +1 -1
- data/lib/aws-sdk-cloudformation/resource.rb +3 -3
- data/lib/aws-sdk-cloudformation/stack.rb +6 -5
- data/lib/aws-sdk-cloudformation/stack_resource.rb +1 -1
- data/lib/aws-sdk-cloudformation/stack_resource_summary.rb +1 -1
- data/lib/aws-sdk-cloudformation/types.rb +612 -214
- data/lib/aws-sdk-cloudformation/waiters.rb +1 -1
- metadata +11 -8
data/VERSION
ADDED
@@ -0,0 +1 @@
|
|
1
|
+
1.51.0
|
@@ -3,7 +3,7 @@
|
|
3
3
|
# WARNING ABOUT GENERATED CODE
|
4
4
|
#
|
5
5
|
# This file is generated. See the contributing guide for more information:
|
6
|
-
# https://github.com/aws/aws-sdk-ruby/blob/
|
6
|
+
# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
|
7
7
|
#
|
8
8
|
# WARNING ABOUT GENERATED CODE
|
9
9
|
|
@@ -53,6 +53,6 @@ require_relative 'aws-sdk-cloudformation/customizations'
|
|
53
53
|
# @!group service
|
54
54
|
module Aws::CloudFormation
|
55
55
|
|
56
|
-
GEM_VERSION = '1.
|
56
|
+
GEM_VERSION = '1.51.0'
|
57
57
|
|
58
58
|
end
|
@@ -3,7 +3,7 @@
|
|
3
3
|
# WARNING ABOUT GENERATED CODE
|
4
4
|
#
|
5
5
|
# This file is generated. See the contributing guide for more information:
|
6
|
-
# https://github.com/aws/aws-sdk-ruby/blob/
|
6
|
+
# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
|
7
7
|
#
|
8
8
|
# WARNING ABOUT GENERATED CODE
|
9
9
|
|
@@ -525,8 +525,9 @@ module Aws::CloudFormation
|
|
525
525
|
# @option params [String] :template_url
|
526
526
|
# The location of the file that contains the revised template. The URL
|
527
527
|
# must point to a template (max size: 460,800 bytes) that is located in
|
528
|
-
# an S3 bucket
|
529
|
-
# this template with the stack
|
528
|
+
# an S3 bucket or a Systems Manager document. AWS CloudFormation
|
529
|
+
# generates the change set by comparing this template with the stack
|
530
|
+
# that you specified.
|
530
531
|
#
|
531
532
|
# Conditional: You must specify only `TemplateBody` or `TemplateURL`.
|
532
533
|
#
|
@@ -815,8 +816,8 @@ module Aws::CloudFormation
|
|
815
816
|
# @option params [String] :template_url
|
816
817
|
# Location of file containing the template body. The URL must point to a
|
817
818
|
# template (max size: 460,800 bytes) that is located in an Amazon S3
|
818
|
-
# bucket. For more information, go to the
|
819
|
-
# AWS CloudFormation User Guide.
|
819
|
+
# bucket or a Systems Manager document. For more information, go to the
|
820
|
+
# [Template Anatomy][1] in the AWS CloudFormation User Guide.
|
820
821
|
#
|
821
822
|
# Conditional: You must specify either the `TemplateBody` or the
|
822
823
|
# `TemplateURL` parameter, but not both.
|
@@ -1115,14 +1116,14 @@ module Aws::CloudFormation
|
|
1115
1116
|
# instances from.
|
1116
1117
|
#
|
1117
1118
|
# @option params [Array<String>] :accounts
|
1118
|
-
# \[
|
1119
|
+
# \[Self-managed permissions\] The names of one or more AWS accounts
|
1119
1120
|
# that you want to create stack instances in the specified Region(s)
|
1120
1121
|
# for.
|
1121
1122
|
#
|
1122
1123
|
# You can specify `Accounts` or `DeploymentTargets`, but not both.
|
1123
1124
|
#
|
1124
1125
|
# @option params [Types::DeploymentTargets] :deployment_targets
|
1125
|
-
# \[
|
1126
|
+
# \[Service-managed permissions\] The AWS Organizations accounts for
|
1126
1127
|
# which to create stack instances in the specified Regions.
|
1127
1128
|
#
|
1128
1129
|
# You can specify `Accounts` or `DeploymentTargets`, but not both.
|
@@ -1192,6 +1193,27 @@ module Aws::CloudFormation
|
|
1192
1193
|
# **A suitable default value is auto-generated.** You should normally
|
1193
1194
|
# not need to pass this option.**
|
1194
1195
|
#
|
1196
|
+
# @option params [String] :call_as
|
1197
|
+
# \[Service-managed permissions\] Specifies whether you are acting as an
|
1198
|
+
# account administrator in the organization's management account or as
|
1199
|
+
# a delegated administrator in a member account.
|
1200
|
+
#
|
1201
|
+
# By default, `SELF` is specified. Use `SELF` for stack sets with
|
1202
|
+
# self-managed permissions.
|
1203
|
+
#
|
1204
|
+
# * If you are signed in to the management account, specify `SELF`.
|
1205
|
+
#
|
1206
|
+
# * If you are signed in to a delegated administrator account, specify
|
1207
|
+
# `DELEGATED_ADMIN`.
|
1208
|
+
#
|
1209
|
+
# Your AWS account must be registered as a delegated administrator in
|
1210
|
+
# the management account. For more information, see [Register a
|
1211
|
+
# delegated administrator][1] in the *AWS CloudFormation User Guide*.
|
1212
|
+
#
|
1213
|
+
#
|
1214
|
+
#
|
1215
|
+
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-orgs-delegated-admin.html
|
1216
|
+
#
|
1195
1217
|
# @return [Types::CreateStackInstancesOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
1196
1218
|
#
|
1197
1219
|
# * {Types::CreateStackInstancesOutput#operation_id #operation_id} => String
|
@@ -1203,6 +1225,7 @@ module Aws::CloudFormation
|
|
1203
1225
|
# accounts: ["Account"],
|
1204
1226
|
# deployment_targets: {
|
1205
1227
|
# accounts: ["Account"],
|
1228
|
+
# accounts_url: "AccountsUrl",
|
1206
1229
|
# organizational_unit_ids: ["OrganizationalUnitId"],
|
1207
1230
|
# },
|
1208
1231
|
# regions: ["Region"], # required
|
@@ -1215,6 +1238,7 @@ module Aws::CloudFormation
|
|
1215
1238
|
# },
|
1216
1239
|
# ],
|
1217
1240
|
# operation_preferences: {
|
1241
|
+
# region_concurrency_type: "SEQUENTIAL", # accepts SEQUENTIAL, PARALLEL
|
1218
1242
|
# region_order: ["Region"],
|
1219
1243
|
# failure_tolerance_count: 1,
|
1220
1244
|
# failure_tolerance_percentage: 1,
|
@@ -1222,6 +1246,7 @@ module Aws::CloudFormation
|
|
1222
1246
|
# max_concurrent_percentage: 1,
|
1223
1247
|
# },
|
1224
1248
|
# operation_id: "ClientRequestToken",
|
1249
|
+
# call_as: "SELF", # accepts SELF, DELEGATED_ADMIN
|
1225
1250
|
# })
|
1226
1251
|
#
|
1227
1252
|
# @example Response structure
|
@@ -1268,8 +1293,9 @@ module Aws::CloudFormation
|
|
1268
1293
|
# @option params [String] :template_url
|
1269
1294
|
# The location of the file that contains the template body. The URL must
|
1270
1295
|
# point to a template (maximum size: 460,800 bytes) that's located in
|
1271
|
-
# an Amazon S3 bucket
|
1272
|
-
# in the AWS CloudFormation User
|
1296
|
+
# an Amazon S3 bucket or a Systems Manager document. For more
|
1297
|
+
# information, see [Template Anatomy][1] in the AWS CloudFormation User
|
1298
|
+
# Guide.
|
1273
1299
|
#
|
1274
1300
|
# Conditional: You must specify either the TemplateBody or the
|
1275
1301
|
# TemplateURL parameter, but not both.
|
@@ -1328,20 +1354,21 @@ module Aws::CloudFormation
|
|
1328
1354
|
#
|
1329
1355
|
# * `CAPABILITY_AUTO_EXPAND`
|
1330
1356
|
#
|
1331
|
-
# Some templates
|
1332
|
-
# or more macros,
|
1333
|
-
# processed template, without first reviewing the
|
1334
|
-
# a change set
|
1335
|
-
#
|
1336
|
-
# Processing on
|
1337
|
-
#
|
1338
|
-
# <note markdown="1"> Stack sets do not currently support macros in stack templates. (This
|
1339
|
-
# includes the [AWS::Include][10] and [AWS::Serverless][11]
|
1340
|
-
# transforms, which are macros hosted by AWS CloudFormation.) Even if
|
1341
|
-
# you specify this capability, if you include a macro in your template
|
1342
|
-
# the stack set operation will fail.
|
1357
|
+
# Some templates reference macros. If your stack set template
|
1358
|
+
# references one or more macros, you must create the stack set
|
1359
|
+
# directly from the processed template, without first reviewing the
|
1360
|
+
# resulting changes in a change set. To create the stack set directly,
|
1361
|
+
# you must acknowledge this capability. For more information, see
|
1362
|
+
# [Using AWS CloudFormation Macros to Perform Custom Processing on
|
1363
|
+
# Templates][9].
|
1343
1364
|
#
|
1344
|
-
#
|
1365
|
+
# Stack sets with service-managed permissions do not currently support
|
1366
|
+
# the use of macros in templates. (This includes the
|
1367
|
+
# [AWS::Include][10] and [AWS::Serverless][11] transforms, which are
|
1368
|
+
# macros hosted by AWS CloudFormation.) Even if you specify this
|
1369
|
+
# capability for a stack set with service-managed permissions, if you
|
1370
|
+
# reference a macro in your template the stack set operation will
|
1371
|
+
# fail.
|
1345
1372
|
#
|
1346
1373
|
#
|
1347
1374
|
#
|
@@ -1415,6 +1442,32 @@ module Aws::CloudFormation
|
|
1415
1442
|
# accounts that are added to the target organization or organizational
|
1416
1443
|
# unit (OU). Specify only if `PermissionModel` is `SERVICE_MANAGED`.
|
1417
1444
|
#
|
1445
|
+
# @option params [String] :call_as
|
1446
|
+
# \[Service-managed permissions\] Specifies whether you are acting as an
|
1447
|
+
# account administrator in the organization's management account or as
|
1448
|
+
# a delegated administrator in a member account.
|
1449
|
+
#
|
1450
|
+
# By default, `SELF` is specified. Use `SELF` for stack sets with
|
1451
|
+
# self-managed permissions.
|
1452
|
+
#
|
1453
|
+
# * To create a stack set with service-managed permissions while signed
|
1454
|
+
# in to the management account, specify `SELF`.
|
1455
|
+
#
|
1456
|
+
# * To create a stack set with service-managed permissions while signed
|
1457
|
+
# in to a delegated administrator account, specify `DELEGATED_ADMIN`.
|
1458
|
+
#
|
1459
|
+
# Your AWS account must be registered as a delegated admin in the
|
1460
|
+
# management account. For more information, see [Register a delegated
|
1461
|
+
# administrator][1] in the *AWS CloudFormation User Guide*.
|
1462
|
+
#
|
1463
|
+
# Stack sets with service-managed permissions are created in the
|
1464
|
+
# management account, including stack sets that are created by delegated
|
1465
|
+
# administrators.
|
1466
|
+
#
|
1467
|
+
#
|
1468
|
+
#
|
1469
|
+
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-orgs-delegated-admin.html
|
1470
|
+
#
|
1418
1471
|
# @option params [String] :client_request_token
|
1419
1472
|
# A unique identifier for this `CreateStackSet` request. Specify this
|
1420
1473
|
# token if you plan to retry requests so that AWS CloudFormation knows
|
@@ -1461,6 +1514,7 @@ module Aws::CloudFormation
|
|
1461
1514
|
# enabled: false,
|
1462
1515
|
# retain_stacks_on_account_removal: false,
|
1463
1516
|
# },
|
1517
|
+
# call_as: "SELF", # accepts SELF, DELEGATED_ADMIN
|
1464
1518
|
# client_request_token: "ClientRequestToken",
|
1465
1519
|
# })
|
1466
1520
|
#
|
@@ -1590,13 +1644,13 @@ module Aws::CloudFormation
|
|
1590
1644
|
# instances for.
|
1591
1645
|
#
|
1592
1646
|
# @option params [Array<String>] :accounts
|
1593
|
-
# \[
|
1647
|
+
# \[Self-managed permissions\] The names of the AWS accounts that you
|
1594
1648
|
# want to delete stack instances for.
|
1595
1649
|
#
|
1596
1650
|
# You can specify `Accounts` or `DeploymentTargets`, but not both.
|
1597
1651
|
#
|
1598
1652
|
# @option params [Types::DeploymentTargets] :deployment_targets
|
1599
|
-
# \[
|
1653
|
+
# \[Service-managed permissions\] The AWS Organizations accounts from
|
1600
1654
|
# which to delete stack instances.
|
1601
1655
|
#
|
1602
1656
|
# You can specify `Accounts` or `DeploymentTargets`, but not both.
|
@@ -1637,6 +1691,27 @@ module Aws::CloudFormation
|
|
1637
1691
|
# **A suitable default value is auto-generated.** You should normally
|
1638
1692
|
# not need to pass this option.**
|
1639
1693
|
#
|
1694
|
+
# @option params [String] :call_as
|
1695
|
+
# \[Service-managed permissions\] Specifies whether you are acting as an
|
1696
|
+
# account administrator in the organization's management account or as
|
1697
|
+
# a delegated administrator in a member account.
|
1698
|
+
#
|
1699
|
+
# By default, `SELF` is specified. Use `SELF` for stack sets with
|
1700
|
+
# self-managed permissions.
|
1701
|
+
#
|
1702
|
+
# * If you are signed in to the management account, specify `SELF`.
|
1703
|
+
#
|
1704
|
+
# * If you are signed in to a delegated administrator account, specify
|
1705
|
+
# `DELEGATED_ADMIN`.
|
1706
|
+
#
|
1707
|
+
# Your AWS account must be registered as a delegated administrator in
|
1708
|
+
# the management account. For more information, see [Register a
|
1709
|
+
# delegated administrator][1] in the *AWS CloudFormation User Guide*.
|
1710
|
+
#
|
1711
|
+
#
|
1712
|
+
#
|
1713
|
+
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-orgs-delegated-admin.html
|
1714
|
+
#
|
1640
1715
|
# @return [Types::DeleteStackInstancesOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
1641
1716
|
#
|
1642
1717
|
# * {Types::DeleteStackInstancesOutput#operation_id #operation_id} => String
|
@@ -1648,10 +1723,12 @@ module Aws::CloudFormation
|
|
1648
1723
|
# accounts: ["Account"],
|
1649
1724
|
# deployment_targets: {
|
1650
1725
|
# accounts: ["Account"],
|
1726
|
+
# accounts_url: "AccountsUrl",
|
1651
1727
|
# organizational_unit_ids: ["OrganizationalUnitId"],
|
1652
1728
|
# },
|
1653
1729
|
# regions: ["Region"], # required
|
1654
1730
|
# operation_preferences: {
|
1731
|
+
# region_concurrency_type: "SEQUENTIAL", # accepts SEQUENTIAL, PARALLEL
|
1655
1732
|
# region_order: ["Region"],
|
1656
1733
|
# failure_tolerance_count: 1,
|
1657
1734
|
# failure_tolerance_percentage: 1,
|
@@ -1660,6 +1737,7 @@ module Aws::CloudFormation
|
|
1660
1737
|
# },
|
1661
1738
|
# retain_stacks: false, # required
|
1662
1739
|
# operation_id: "ClientRequestToken",
|
1740
|
+
# call_as: "SELF", # accepts SELF, DELEGATED_ADMIN
|
1663
1741
|
# })
|
1664
1742
|
#
|
1665
1743
|
# @example Response structure
|
@@ -1683,12 +1761,34 @@ module Aws::CloudFormation
|
|
1683
1761
|
# The name or unique ID of the stack set that you're deleting. You can
|
1684
1762
|
# obtain this value by running ListStackSets.
|
1685
1763
|
#
|
1764
|
+
# @option params [String] :call_as
|
1765
|
+
# \[Service-managed permissions\] Specifies whether you are acting as an
|
1766
|
+
# account administrator in the organization's management account or as
|
1767
|
+
# a delegated administrator in a member account.
|
1768
|
+
#
|
1769
|
+
# By default, `SELF` is specified. Use `SELF` for stack sets with
|
1770
|
+
# self-managed permissions.
|
1771
|
+
#
|
1772
|
+
# * If you are signed in to the management account, specify `SELF`.
|
1773
|
+
#
|
1774
|
+
# * If you are signed in to a delegated administrator account, specify
|
1775
|
+
# `DELEGATED_ADMIN`.
|
1776
|
+
#
|
1777
|
+
# Your AWS account must be registered as a delegated administrator in
|
1778
|
+
# the management account. For more information, see [Register a
|
1779
|
+
# delegated administrator][1] in the *AWS CloudFormation User Guide*.
|
1780
|
+
#
|
1781
|
+
#
|
1782
|
+
#
|
1783
|
+
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-orgs-delegated-admin.html
|
1784
|
+
#
|
1686
1785
|
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
1687
1786
|
#
|
1688
1787
|
# @example Request syntax with placeholder values
|
1689
1788
|
#
|
1690
1789
|
# resp = client.delete_stack_set({
|
1691
1790
|
# stack_set_name: "StackSetName", # required
|
1791
|
+
# call_as: "SELF", # accepts SELF, DELEGATED_ADMIN
|
1692
1792
|
# })
|
1693
1793
|
#
|
1694
1794
|
# @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/DeleteStackSet AWS API Documentation
|
@@ -1700,40 +1800,48 @@ module Aws::CloudFormation
|
|
1700
1800
|
req.send_request(options)
|
1701
1801
|
end
|
1702
1802
|
|
1703
|
-
#
|
1704
|
-
# registry
|
1705
|
-
# in CloudFormation
|
1803
|
+
# Marks an extension or extension version as `DEPRECATED` in the
|
1804
|
+
# CloudFormation registry, removing it from active use. Deprecated
|
1805
|
+
# extensions or extension versions cannot be used in CloudFormation
|
1806
|
+
# operations.
|
1807
|
+
#
|
1808
|
+
# To deregister an entire extension, you must individually deregister
|
1809
|
+
# all active versions of that extension. If an extension has only a
|
1810
|
+
# single active version, deregistering that version results in the
|
1811
|
+
# extension itself being deregistered and marked as deprecated in the
|
1812
|
+
# registry.
|
1813
|
+
#
|
1814
|
+
# You cannot deregister the default version of an extension if there are
|
1815
|
+
# other active version of that extension. If you do deregister the
|
1816
|
+
# default version of an extension, the textensionype itself is
|
1817
|
+
# deregistered as well and marked as deprecated.
|
1818
|
+
#
|
1819
|
+
# To view the deprecation status of an extension or extension version,
|
1820
|
+
# use [DescribeType][1].
|
1821
|
+
#
|
1706
1822
|
#
|
1707
|
-
# To deregister a type, you must individually deregister all registered
|
1708
|
-
# versions of that type. If a type has only a single registered version,
|
1709
|
-
# deregistering that version results in the type itself being
|
1710
|
-
# deregistered.
|
1711
1823
|
#
|
1712
|
-
#
|
1713
|
-
# only registered version of that type, in which case the type itself is
|
1714
|
-
# deregistered as well.
|
1824
|
+
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_DescribeType.html
|
1715
1825
|
#
|
1716
1826
|
# @option params [String] :arn
|
1717
|
-
# The Amazon Resource Name (ARN) of the
|
1827
|
+
# The Amazon Resource Name (ARN) of the extension.
|
1718
1828
|
#
|
1719
1829
|
# Conditional: You must specify either `TypeName` and `Type`, or `Arn`.
|
1720
1830
|
#
|
1721
1831
|
# @option params [String] :type
|
1722
|
-
# The kind of
|
1723
|
-
#
|
1724
|
-
# Currently the only valid value is `RESOURCE`.
|
1832
|
+
# The kind of extension.
|
1725
1833
|
#
|
1726
1834
|
# Conditional: You must specify either `TypeName` and `Type`, or `Arn`.
|
1727
1835
|
#
|
1728
1836
|
# @option params [String] :type_name
|
1729
|
-
# The name of the
|
1837
|
+
# The name of the extension.
|
1730
1838
|
#
|
1731
1839
|
# Conditional: You must specify either `TypeName` and `Type`, or `Arn`.
|
1732
1840
|
#
|
1733
1841
|
# @option params [String] :version_id
|
1734
|
-
# The ID of a specific version of the
|
1735
|
-
# at the end of the Amazon Resource Name (ARN) assigned to the
|
1736
|
-
# version when it is registered.
|
1842
|
+
# The ID of a specific version of the extension. The version ID is the
|
1843
|
+
# value at the end of the Amazon Resource Name (ARN) assigned to the
|
1844
|
+
# extension version when it is registered.
|
1737
1845
|
#
|
1738
1846
|
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
1739
1847
|
#
|
@@ -2059,6 +2167,27 @@ module Aws::CloudFormation
|
|
2059
2167
|
# @option params [required, String] :stack_instance_region
|
2060
2168
|
# The name of a Region that's associated with this stack instance.
|
2061
2169
|
#
|
2170
|
+
# @option params [String] :call_as
|
2171
|
+
# \[Service-managed permissions\] Specifies whether you are acting as an
|
2172
|
+
# account administrator in the organization's management account or as
|
2173
|
+
# a delegated administrator in a member account.
|
2174
|
+
#
|
2175
|
+
# By default, `SELF` is specified. Use `SELF` for stack sets with
|
2176
|
+
# self-managed permissions.
|
2177
|
+
#
|
2178
|
+
# * If you are signed in to the management account, specify `SELF`.
|
2179
|
+
#
|
2180
|
+
# * If you are signed in to a delegated administrator account, specify
|
2181
|
+
# `DELEGATED_ADMIN`.
|
2182
|
+
#
|
2183
|
+
# Your AWS account must be registered as a delegated administrator in
|
2184
|
+
# the management account. For more information, see [Register a
|
2185
|
+
# delegated administrator][1] in the *AWS CloudFormation User Guide*.
|
2186
|
+
#
|
2187
|
+
#
|
2188
|
+
#
|
2189
|
+
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-orgs-delegated-admin.html
|
2190
|
+
#
|
2062
2191
|
# @return [Types::DescribeStackInstanceOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
2063
2192
|
#
|
2064
2193
|
# * {Types::DescribeStackInstanceOutput#stack_instance #stack_instance} => Types::StackInstance
|
@@ -2069,6 +2198,7 @@ module Aws::CloudFormation
|
|
2069
2198
|
# stack_set_name: "StackSetName", # required
|
2070
2199
|
# stack_instance_account: "Account", # required
|
2071
2200
|
# stack_instance_region: "Region", # required
|
2201
|
+
# call_as: "SELF", # accepts SELF, DELEGATED_ADMIN
|
2072
2202
|
# })
|
2073
2203
|
#
|
2074
2204
|
# @example Response structure
|
@@ -2359,6 +2489,27 @@ module Aws::CloudFormation
|
|
2359
2489
|
# @option params [required, String] :stack_set_name
|
2360
2490
|
# The name or unique ID of the stack set whose description you want.
|
2361
2491
|
#
|
2492
|
+
# @option params [String] :call_as
|
2493
|
+
# \[Service-managed permissions\] Specifies whether you are acting as an
|
2494
|
+
# account administrator in the organization's management account or as
|
2495
|
+
# a delegated administrator in a member account.
|
2496
|
+
#
|
2497
|
+
# By default, `SELF` is specified. Use `SELF` for stack sets with
|
2498
|
+
# self-managed permissions.
|
2499
|
+
#
|
2500
|
+
# * If you are signed in to the management account, specify `SELF`.
|
2501
|
+
#
|
2502
|
+
# * If you are signed in to a delegated administrator account, specify
|
2503
|
+
# `DELEGATED_ADMIN`.
|
2504
|
+
#
|
2505
|
+
# Your AWS account must be registered as a delegated administrator in
|
2506
|
+
# the management account. For more information, see [Register a
|
2507
|
+
# delegated administrator][1] in the *AWS CloudFormation User Guide*.
|
2508
|
+
#
|
2509
|
+
#
|
2510
|
+
#
|
2511
|
+
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-orgs-delegated-admin.html
|
2512
|
+
#
|
2362
2513
|
# @return [Types::DescribeStackSetOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
2363
2514
|
#
|
2364
2515
|
# * {Types::DescribeStackSetOutput#stack_set #stack_set} => Types::StackSet
|
@@ -2367,6 +2518,7 @@ module Aws::CloudFormation
|
|
2367
2518
|
#
|
2368
2519
|
# resp = client.describe_stack_set({
|
2369
2520
|
# stack_set_name: "StackSetName", # required
|
2521
|
+
# call_as: "SELF", # accepts SELF, DELEGATED_ADMIN
|
2370
2522
|
# })
|
2371
2523
|
#
|
2372
2524
|
# @example Response structure
|
@@ -2421,6 +2573,27 @@ module Aws::CloudFormation
|
|
2421
2573
|
# @option params [required, String] :operation_id
|
2422
2574
|
# The unique ID of the stack set operation.
|
2423
2575
|
#
|
2576
|
+
# @option params [String] :call_as
|
2577
|
+
# \[Service-managed permissions\] Specifies whether you are acting as an
|
2578
|
+
# account administrator in the organization's management account or as
|
2579
|
+
# a delegated administrator in a member account.
|
2580
|
+
#
|
2581
|
+
# By default, `SELF` is specified. Use `SELF` for stack sets with
|
2582
|
+
# self-managed permissions.
|
2583
|
+
#
|
2584
|
+
# * If you are signed in to the management account, specify `SELF`.
|
2585
|
+
#
|
2586
|
+
# * If you are signed in to a delegated administrator account, specify
|
2587
|
+
# `DELEGATED_ADMIN`.
|
2588
|
+
#
|
2589
|
+
# Your AWS account must be registered as a delegated administrator in
|
2590
|
+
# the management account. For more information, see [Register a
|
2591
|
+
# delegated administrator][1] in the *AWS CloudFormation User Guide*.
|
2592
|
+
#
|
2593
|
+
#
|
2594
|
+
#
|
2595
|
+
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-orgs-delegated-admin.html
|
2596
|
+
#
|
2424
2597
|
# @return [Types::DescribeStackSetOperationOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
2425
2598
|
#
|
2426
2599
|
# * {Types::DescribeStackSetOperationOutput#stack_set_operation #stack_set_operation} => Types::StackSetOperation
|
@@ -2430,6 +2603,7 @@ module Aws::CloudFormation
|
|
2430
2603
|
# resp = client.describe_stack_set_operation({
|
2431
2604
|
# stack_set_name: "StackSetName", # required
|
2432
2605
|
# operation_id: "ClientRequestToken", # required
|
2606
|
+
# call_as: "SELF", # accepts SELF, DELEGATED_ADMIN
|
2433
2607
|
# })
|
2434
2608
|
#
|
2435
2609
|
# @example Response structure
|
@@ -2438,6 +2612,7 @@ module Aws::CloudFormation
|
|
2438
2612
|
# resp.stack_set_operation.stack_set_id #=> String
|
2439
2613
|
# resp.stack_set_operation.action #=> String, one of "CREATE", "UPDATE", "DELETE", "DETECT_DRIFT"
|
2440
2614
|
# resp.stack_set_operation.status #=> String, one of "RUNNING", "SUCCEEDED", "FAILED", "STOPPING", "STOPPED", "QUEUED"
|
2615
|
+
# resp.stack_set_operation.operation_preferences.region_concurrency_type #=> String, one of "SEQUENTIAL", "PARALLEL"
|
2441
2616
|
# resp.stack_set_operation.operation_preferences.region_order #=> Array
|
2442
2617
|
# resp.stack_set_operation.operation_preferences.region_order[0] #=> String
|
2443
2618
|
# resp.stack_set_operation.operation_preferences.failure_tolerance_count #=> Integer
|
@@ -2451,6 +2626,7 @@ module Aws::CloudFormation
|
|
2451
2626
|
# resp.stack_set_operation.end_timestamp #=> Time
|
2452
2627
|
# resp.stack_set_operation.deployment_targets.accounts #=> Array
|
2453
2628
|
# resp.stack_set_operation.deployment_targets.accounts[0] #=> String
|
2629
|
+
# resp.stack_set_operation.deployment_targets.accounts_url #=> String
|
2454
2630
|
# resp.stack_set_operation.deployment_targets.organizational_unit_ids #=> Array
|
2455
2631
|
# resp.stack_set_operation.deployment_targets.organizational_unit_ids[0] #=> String
|
2456
2632
|
# resp.stack_set_operation.stack_set_drift_detection_details.drift_status #=> String, one of "DRIFTED", "IN_SYNC", "NOT_CHECKED"
|
@@ -2570,37 +2746,36 @@ module Aws::CloudFormation
|
|
2570
2746
|
req.send_request(options)
|
2571
2747
|
end
|
2572
2748
|
|
2573
|
-
# Returns detailed information about
|
2749
|
+
# Returns detailed information about an extension that has been
|
2750
|
+
# registered.
|
2574
2751
|
#
|
2575
2752
|
# If you specify a `VersionId`, `DescribeType` returns information about
|
2576
|
-
# that specific
|
2577
|
-
# the default
|
2753
|
+
# that specific extension version. Otherwise, it returns information
|
2754
|
+
# about the default extension version.
|
2578
2755
|
#
|
2579
2756
|
# @option params [String] :type
|
2580
|
-
# The kind of
|
2581
|
-
#
|
2582
|
-
# Currently the only valid value is `RESOURCE`.
|
2757
|
+
# The kind of extension.
|
2583
2758
|
#
|
2584
2759
|
# Conditional: You must specify either `TypeName` and `Type`, or `Arn`.
|
2585
2760
|
#
|
2586
2761
|
# @option params [String] :type_name
|
2587
|
-
# The name of the
|
2762
|
+
# The name of the extension.
|
2588
2763
|
#
|
2589
2764
|
# Conditional: You must specify either `TypeName` and `Type`, or `Arn`.
|
2590
2765
|
#
|
2591
2766
|
# @option params [String] :arn
|
2592
|
-
# The Amazon Resource Name (ARN) of the
|
2767
|
+
# The Amazon Resource Name (ARN) of the extension.
|
2593
2768
|
#
|
2594
2769
|
# Conditional: You must specify either `TypeName` and `Type`, or `Arn`.
|
2595
2770
|
#
|
2596
2771
|
# @option params [String] :version_id
|
2597
|
-
# The ID of a specific version of the
|
2598
|
-
# at the end of the Amazon Resource Name (ARN) assigned to the
|
2599
|
-
# version when it is registered.
|
2772
|
+
# The ID of a specific version of the extension. The version ID is the
|
2773
|
+
# value at the end of the Amazon Resource Name (ARN) assigned to the
|
2774
|
+
# extension version when it is registered.
|
2600
2775
|
#
|
2601
2776
|
# If you specify a `VersionId`, `DescribeType` returns information about
|
2602
|
-
# that specific
|
2603
|
-
# the default
|
2777
|
+
# that specific extension version. Otherwise, it returns information
|
2778
|
+
# about the default extension version.
|
2604
2779
|
#
|
2605
2780
|
# @return [Types::DescribeTypeOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
2606
2781
|
#
|
@@ -2659,7 +2834,7 @@ module Aws::CloudFormation
|
|
2659
2834
|
req.send_request(options)
|
2660
2835
|
end
|
2661
2836
|
|
2662
|
-
# Returns information about
|
2837
|
+
# Returns information about an extension's registration, including its
|
2663
2838
|
# current status and type and version identifiers.
|
2664
2839
|
#
|
2665
2840
|
# When you initiate a registration request using ` RegisterType `, you
|
@@ -2667,7 +2842,7 @@ module Aws::CloudFormation
|
|
2667
2842
|
# that registration request.
|
2668
2843
|
#
|
2669
2844
|
# Once the registration request has completed, use ` DescribeType ` to
|
2670
|
-
# return detailed
|
2845
|
+
# return detailed information about an extension.
|
2671
2846
|
#
|
2672
2847
|
# @option params [required, String] :registration_token
|
2673
2848
|
# The identifier for this registration request.
|
@@ -2861,7 +3036,7 @@ module Aws::CloudFormation
|
|
2861
3036
|
# Once the operation has completed, use the following actions to return
|
2862
3037
|
# drift information:
|
2863
3038
|
#
|
2864
|
-
# * Use ` DescribeStackSet ` to return detailed
|
3039
|
+
# * Use ` DescribeStackSet ` to return detailed information about the
|
2865
3040
|
# stack set, including detailed information about the last *completed*
|
2866
3041
|
# drift operation performed on the stack set. (Information about drift
|
2867
3042
|
# operations that are in progress is not included.)
|
@@ -2908,6 +3083,27 @@ module Aws::CloudFormation
|
|
2908
3083
|
# **A suitable default value is auto-generated.** You should normally
|
2909
3084
|
# not need to pass this option.**
|
2910
3085
|
#
|
3086
|
+
# @option params [String] :call_as
|
3087
|
+
# \[Service-managed permissions\] Specifies whether you are acting as an
|
3088
|
+
# account administrator in the organization's management account or as
|
3089
|
+
# a delegated administrator in a member account.
|
3090
|
+
#
|
3091
|
+
# By default, `SELF` is specified. Use `SELF` for stack sets with
|
3092
|
+
# self-managed permissions.
|
3093
|
+
#
|
3094
|
+
# * If you are signed in to the management account, specify `SELF`.
|
3095
|
+
#
|
3096
|
+
# * If you are signed in to a delegated administrator account, specify
|
3097
|
+
# `DELEGATED_ADMIN`.
|
3098
|
+
#
|
3099
|
+
# Your AWS account must be registered as a delegated administrator in
|
3100
|
+
# the management account. For more information, see [Register a
|
3101
|
+
# delegated administrator][1] in the *AWS CloudFormation User Guide*.
|
3102
|
+
#
|
3103
|
+
#
|
3104
|
+
#
|
3105
|
+
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-orgs-delegated-admin.html
|
3106
|
+
#
|
2911
3107
|
# @return [Types::DetectStackSetDriftOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
2912
3108
|
#
|
2913
3109
|
# * {Types::DetectStackSetDriftOutput#operation_id #operation_id} => String
|
@@ -2917,6 +3113,7 @@ module Aws::CloudFormation
|
|
2917
3113
|
# resp = client.detect_stack_set_drift({
|
2918
3114
|
# stack_set_name: "StackSetNameOrId", # required
|
2919
3115
|
# operation_preferences: {
|
3116
|
+
# region_concurrency_type: "SEQUENTIAL", # accepts SEQUENTIAL, PARALLEL
|
2920
3117
|
# region_order: ["Region"],
|
2921
3118
|
# failure_tolerance_count: 1,
|
2922
3119
|
# failure_tolerance_percentage: 1,
|
@@ -2924,6 +3121,7 @@ module Aws::CloudFormation
|
|
2924
3121
|
# max_concurrent_percentage: 1,
|
2925
3122
|
# },
|
2926
3123
|
# operation_id: "ClientRequestToken",
|
3124
|
+
# call_as: "SELF", # accepts SELF, DELEGATED_ADMIN
|
2927
3125
|
# })
|
2928
3126
|
#
|
2929
3127
|
# @example Response structure
|
@@ -2957,8 +3155,9 @@ module Aws::CloudFormation
|
|
2957
3155
|
#
|
2958
3156
|
# @option params [String] :template_url
|
2959
3157
|
# Location of file containing the template body. The URL must point to a
|
2960
|
-
# template that is located in an Amazon S3 bucket
|
2961
|
-
# go to [Template Anatomy][1] in the AWS
|
3158
|
+
# template that is located in an Amazon S3 bucket or a Systems Manager
|
3159
|
+
# document. For more information, go to [Template Anatomy][1] in the AWS
|
3160
|
+
# CloudFormation User Guide.
|
2962
3161
|
#
|
2963
3162
|
# Conditional: You must pass `TemplateURL` or `TemplateBody`. If both
|
2964
3163
|
# are passed, only `TemplateBody` is used.
|
@@ -3175,8 +3374,9 @@ module Aws::CloudFormation
|
|
3175
3374
|
# @option params [String] :template_url
|
3176
3375
|
# Location of file containing the template body. The URL must point to a
|
3177
3376
|
# template (max size: 460,800 bytes) that is located in an Amazon S3
|
3178
|
-
# bucket. For more information about
|
3179
|
-
# Anatomy][1] in the AWS CloudFormation User
|
3377
|
+
# bucket or a Systems Manager document. For more information about
|
3378
|
+
# templates, see [Template Anatomy][1] in the AWS CloudFormation User
|
3379
|
+
# Guide.
|
3180
3380
|
#
|
3181
3381
|
# Conditional: You must specify only one of the following parameters:
|
3182
3382
|
# `StackName`, `StackSetName`, `TemplateBody`, or `TemplateURL`.
|
@@ -3439,6 +3639,27 @@ module Aws::CloudFormation
|
|
3439
3639
|
# @option params [String] :stack_instance_region
|
3440
3640
|
# The name of the Region where you want to list stack instances.
|
3441
3641
|
#
|
3642
|
+
# @option params [String] :call_as
|
3643
|
+
# \[Service-managed permissions\] Specifies whether you are acting as an
|
3644
|
+
# account administrator in the organization's management account or as
|
3645
|
+
# a delegated administrator in a member account.
|
3646
|
+
#
|
3647
|
+
# By default, `SELF` is specified. Use `SELF` for stack sets with
|
3648
|
+
# self-managed permissions.
|
3649
|
+
#
|
3650
|
+
# * If you are signed in to the management account, specify `SELF`.
|
3651
|
+
#
|
3652
|
+
# * If you are signed in to a delegated administrator account, specify
|
3653
|
+
# `DELEGATED_ADMIN`.
|
3654
|
+
#
|
3655
|
+
# Your AWS account must be registered as a delegated administrator in
|
3656
|
+
# the management account. For more information, see [Register a
|
3657
|
+
# delegated administrator][1] in the *AWS CloudFormation User Guide*.
|
3658
|
+
#
|
3659
|
+
#
|
3660
|
+
#
|
3661
|
+
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-orgs-delegated-admin.html
|
3662
|
+
#
|
3442
3663
|
# @return [Types::ListStackInstancesOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
3443
3664
|
#
|
3444
3665
|
# * {Types::ListStackInstancesOutput#summaries #summaries} => Array<Types::StackInstanceSummary>
|
@@ -3460,6 +3681,7 @@ module Aws::CloudFormation
|
|
3460
3681
|
# ],
|
3461
3682
|
# stack_instance_account: "Account",
|
3462
3683
|
# stack_instance_region: "Region",
|
3684
|
+
# call_as: "SELF", # accepts SELF, DELEGATED_ADMIN
|
3463
3685
|
# })
|
3464
3686
|
#
|
3465
3687
|
# @example Response structure
|
@@ -3569,6 +3791,27 @@ module Aws::CloudFormation
|
|
3569
3791
|
# includes a `NextToken` value that you can assign to the `NextToken`
|
3570
3792
|
# request parameter to get the next set of results.
|
3571
3793
|
#
|
3794
|
+
# @option params [String] :call_as
|
3795
|
+
# \[Service-managed permissions\] Specifies whether you are acting as an
|
3796
|
+
# account administrator in the organization's management account or as
|
3797
|
+
# a delegated administrator in a member account.
|
3798
|
+
#
|
3799
|
+
# By default, `SELF` is specified. Use `SELF` for stack sets with
|
3800
|
+
# self-managed permissions.
|
3801
|
+
#
|
3802
|
+
# * If you are signed in to the management account, specify `SELF`.
|
3803
|
+
#
|
3804
|
+
# * If you are signed in to a delegated administrator account, specify
|
3805
|
+
# `DELEGATED_ADMIN`.
|
3806
|
+
#
|
3807
|
+
# Your AWS account must be registered as a delegated administrator in
|
3808
|
+
# the management account. For more information, see [Register a
|
3809
|
+
# delegated administrator][1] in the *AWS CloudFormation User Guide*.
|
3810
|
+
#
|
3811
|
+
#
|
3812
|
+
#
|
3813
|
+
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-orgs-delegated-admin.html
|
3814
|
+
#
|
3572
3815
|
# @return [Types::ListStackSetOperationResultsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
3573
3816
|
#
|
3574
3817
|
# * {Types::ListStackSetOperationResultsOutput#summaries #summaries} => Array<Types::StackSetOperationResultSummary>
|
@@ -3583,6 +3826,7 @@ module Aws::CloudFormation
|
|
3583
3826
|
# operation_id: "ClientRequestToken", # required
|
3584
3827
|
# next_token: "NextToken",
|
3585
3828
|
# max_results: 1,
|
3829
|
+
# call_as: "SELF", # accepts SELF, DELEGATED_ADMIN
|
3586
3830
|
# })
|
3587
3831
|
#
|
3588
3832
|
# @example Response structure
|
@@ -3627,6 +3871,27 @@ module Aws::CloudFormation
|
|
3627
3871
|
# includes a `NextToken` value that you can assign to the `NextToken`
|
3628
3872
|
# request parameter to get the next set of results.
|
3629
3873
|
#
|
3874
|
+
# @option params [String] :call_as
|
3875
|
+
# \[Service-managed permissions\] Specifies whether you are acting as an
|
3876
|
+
# account administrator in the organization's management account or as
|
3877
|
+
# a delegated administrator in a member account.
|
3878
|
+
#
|
3879
|
+
# By default, `SELF` is specified. Use `SELF` for stack sets with
|
3880
|
+
# self-managed permissions.
|
3881
|
+
#
|
3882
|
+
# * If you are signed in to the management account, specify `SELF`.
|
3883
|
+
#
|
3884
|
+
# * If you are signed in to a delegated administrator account, specify
|
3885
|
+
# `DELEGATED_ADMIN`.
|
3886
|
+
#
|
3887
|
+
# Your AWS account must be registered as a delegated administrator in
|
3888
|
+
# the management account. For more information, see [Register a
|
3889
|
+
# delegated administrator][1] in the *AWS CloudFormation User Guide*.
|
3890
|
+
#
|
3891
|
+
#
|
3892
|
+
#
|
3893
|
+
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-orgs-delegated-admin.html
|
3894
|
+
#
|
3630
3895
|
# @return [Types::ListStackSetOperationsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
3631
3896
|
#
|
3632
3897
|
# * {Types::ListStackSetOperationsOutput#summaries #summaries} => Array<Types::StackSetOperationSummary>
|
@@ -3640,6 +3905,7 @@ module Aws::CloudFormation
|
|
3640
3905
|
# stack_set_name: "StackSetName", # required
|
3641
3906
|
# next_token: "NextToken",
|
3642
3907
|
# max_results: 1,
|
3908
|
+
# call_as: "SELF", # accepts SELF, DELEGATED_ADMIN
|
3643
3909
|
# })
|
3644
3910
|
#
|
3645
3911
|
# @example Response structure
|
@@ -3664,6 +3930,19 @@ module Aws::CloudFormation
|
|
3664
3930
|
# Returns summary information about stack sets that are associated with
|
3665
3931
|
# the user.
|
3666
3932
|
#
|
3933
|
+
# * \[Self-managed permissions\] If you set the `CallAs` parameter to
|
3934
|
+
# `SELF` while signed in to your AWS account, `ListStackSets` returns
|
3935
|
+
# all self-managed stack sets in your AWS account.
|
3936
|
+
#
|
3937
|
+
# * \[Service-managed permissions\] If you set the `CallAs` parameter to
|
3938
|
+
# `SELF` while signed in to the organization's management account,
|
3939
|
+
# `ListStackSets` returns all stack sets in the management account.
|
3940
|
+
#
|
3941
|
+
# * \[Service-managed permissions\] If you set the `CallAs` parameter to
|
3942
|
+
# `DELEGATED_ADMIN` while signed in to your member account,
|
3943
|
+
# `ListStackSets` returns all stack sets with service-managed
|
3944
|
+
# permissions in the management account.
|
3945
|
+
#
|
3667
3946
|
# @option params [String] :next_token
|
3668
3947
|
# If the previous paginated request didn't return all of the remaining
|
3669
3948
|
# results, the response object's `NextToken` parameter value is set to
|
@@ -3682,6 +3961,27 @@ module Aws::CloudFormation
|
|
3682
3961
|
# The status of the stack sets that you want to get summary information
|
3683
3962
|
# about.
|
3684
3963
|
#
|
3964
|
+
# @option params [String] :call_as
|
3965
|
+
# \[Service-managed permissions\] Specifies whether you are acting as an
|
3966
|
+
# account administrator in the management account or as a delegated
|
3967
|
+
# administrator in a member account.
|
3968
|
+
#
|
3969
|
+
# By default, `SELF` is specified. Use `SELF` for stack sets with
|
3970
|
+
# self-managed permissions.
|
3971
|
+
#
|
3972
|
+
# * If you are signed in to the management account, specify `SELF`.
|
3973
|
+
#
|
3974
|
+
# * If you are signed in to a delegated administrator account, specify
|
3975
|
+
# `DELEGATED_ADMIN`.
|
3976
|
+
#
|
3977
|
+
# Your AWS account must be registered as a delegated administrator in
|
3978
|
+
# the management account. For more information, see [Register a
|
3979
|
+
# delegated administrator][1] in the *AWS CloudFormation User Guide*.
|
3980
|
+
#
|
3981
|
+
#
|
3982
|
+
#
|
3983
|
+
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-orgs-delegated-admin.html
|
3984
|
+
#
|
3685
3985
|
# @return [Types::ListStackSetsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
3686
3986
|
#
|
3687
3987
|
# * {Types::ListStackSetsOutput#summaries #summaries} => Array<Types::StackSetSummary>
|
@@ -3695,6 +3995,7 @@ module Aws::CloudFormation
|
|
3695
3995
|
# next_token: "NextToken",
|
3696
3996
|
# max_results: 1,
|
3697
3997
|
# status: "ACTIVE", # accepts ACTIVE, DELETED
|
3998
|
+
# call_as: "SELF", # accepts SELF, DELEGATED_ADMIN
|
3698
3999
|
# })
|
3699
4000
|
#
|
3700
4001
|
# @example Response structure
|
@@ -3777,27 +4078,25 @@ module Aws::CloudFormation
|
|
3777
4078
|
req.send_request(options)
|
3778
4079
|
end
|
3779
4080
|
|
3780
|
-
# Returns a list of registration tokens for the specified
|
4081
|
+
# Returns a list of registration tokens for the specified extension(s).
|
3781
4082
|
#
|
3782
4083
|
# @option params [String] :type
|
3783
|
-
# The kind of
|
3784
|
-
#
|
3785
|
-
# Currently the only valid value is `RESOURCE`.
|
4084
|
+
# The kind of extension.
|
3786
4085
|
#
|
3787
4086
|
# Conditional: You must specify either `TypeName` and `Type`, or `Arn`.
|
3788
4087
|
#
|
3789
4088
|
# @option params [String] :type_name
|
3790
|
-
# The name of the
|
4089
|
+
# The name of the extension.
|
3791
4090
|
#
|
3792
4091
|
# Conditional: You must specify either `TypeName` and `Type`, or `Arn`.
|
3793
4092
|
#
|
3794
4093
|
# @option params [String] :type_arn
|
3795
|
-
# The Amazon Resource Name (ARN) of the
|
4094
|
+
# The Amazon Resource Name (ARN) of the extension.
|
3796
4095
|
#
|
3797
4096
|
# Conditional: You must specify either `TypeName` and `Type`, or `Arn`.
|
3798
4097
|
#
|
3799
4098
|
# @option params [String] :registration_status_filter
|
3800
|
-
# The current status of the
|
4099
|
+
# The current status of the extension registration request.
|
3801
4100
|
#
|
3802
4101
|
# The default is `IN_PROGRESS`.
|
3803
4102
|
#
|
@@ -3848,23 +4147,22 @@ module Aws::CloudFormation
|
|
3848
4147
|
req.send_request(options)
|
3849
4148
|
end
|
3850
4149
|
|
3851
|
-
# Returns summary information about the versions of
|
4150
|
+
# Returns summary information about the versions of an extension.
|
3852
4151
|
#
|
3853
4152
|
# @option params [String] :type
|
3854
|
-
# The kind of the
|
3855
|
-
#
|
3856
|
-
# Currently the only valid value is `RESOURCE`.
|
4153
|
+
# The kind of the extension.
|
3857
4154
|
#
|
3858
4155
|
# Conditional: You must specify either `TypeName` and `Type`, or `Arn`.
|
3859
4156
|
#
|
3860
4157
|
# @option params [String] :type_name
|
3861
|
-
# The name of the
|
4158
|
+
# The name of the extension for which you want version summary
|
4159
|
+
# information.
|
3862
4160
|
#
|
3863
4161
|
# Conditional: You must specify either `TypeName` and `Type`, or `Arn`.
|
3864
4162
|
#
|
3865
4163
|
# @option params [String] :arn
|
3866
|
-
# The Amazon Resource Name (ARN) of the
|
3867
|
-
# summary information.
|
4164
|
+
# The Amazon Resource Name (ARN) of the extension for which you want
|
4165
|
+
# version summary information.
|
3868
4166
|
#
|
3869
4167
|
# Conditional: You must specify either `TypeName` and `Type`, or `Arn`.
|
3870
4168
|
#
|
@@ -3883,17 +4181,17 @@ module Aws::CloudFormation
|
|
3883
4181
|
# `NextToken` parameter is set to `null`.
|
3884
4182
|
#
|
3885
4183
|
# @option params [String] :deprecated_status
|
3886
|
-
# The deprecation status of the
|
4184
|
+
# The deprecation status of the extension versions that you want to get
|
3887
4185
|
# summary information about.
|
3888
4186
|
#
|
3889
4187
|
# Valid values include:
|
3890
4188
|
#
|
3891
|
-
# * `LIVE`\: The
|
4189
|
+
# * `LIVE`\: The extension version is registered and can be used in
|
3892
4190
|
# CloudFormation operations, dependent on its provisioning behavior
|
3893
4191
|
# and visibility scope.
|
3894
4192
|
#
|
3895
|
-
# * `DEPRECATED`\: The
|
3896
|
-
# longer be used in CloudFormation operations.
|
4193
|
+
# * `DEPRECATED`\: The extension version has been deregistered and can
|
4194
|
+
# no longer be used in CloudFormation operations.
|
3897
4195
|
#
|
3898
4196
|
# The default is `LIVE`.
|
3899
4197
|
#
|
@@ -3936,20 +4234,20 @@ module Aws::CloudFormation
|
|
3936
4234
|
req.send_request(options)
|
3937
4235
|
end
|
3938
4236
|
|
3939
|
-
# Returns summary information about
|
3940
|
-
# CloudFormation.
|
4237
|
+
# Returns summary information about extension that have been registered
|
4238
|
+
# with CloudFormation.
|
3941
4239
|
#
|
3942
4240
|
# @option params [String] :visibility
|
3943
|
-
# The scope at which the
|
3944
|
-
# operations.
|
4241
|
+
# The scope at which the extension is visible and usable in
|
4242
|
+
# CloudFormation operations.
|
3945
4243
|
#
|
3946
4244
|
# Valid values include:
|
3947
4245
|
#
|
3948
|
-
# * `PRIVATE`\: The
|
3949
|
-
# in which it is registered. Currently, AWS CloudFormation
|
3950
|
-
#
|
4246
|
+
# * `PRIVATE`\: The extension is only visible and usable within the
|
4247
|
+
# account in which it is registered. Currently, AWS CloudFormation
|
4248
|
+
# marks any extension you create as `PRIVATE`.
|
3951
4249
|
#
|
3952
|
-
# * `PUBLIC`\: The
|
4250
|
+
# * `PUBLIC`\: The extension is publically visible and usable within any
|
3953
4251
|
# Amazon account.
|
3954
4252
|
#
|
3955
4253
|
# The default is `PRIVATE`.
|
@@ -3961,27 +4259,27 @@ module Aws::CloudFormation
|
|
3961
4259
|
#
|
3962
4260
|
# Valid values include:
|
3963
4261
|
#
|
3964
|
-
# * `FULLY_MUTABLE`\: The
|
3965
|
-
# updates to the
|
4262
|
+
# * `FULLY_MUTABLE`\: The extension includes an update handler to
|
4263
|
+
# process updates to the extension during stack update operations.
|
3966
4264
|
#
|
3967
|
-
# * `IMMUTABLE`\: The
|
3968
|
-
#
|
3969
|
-
# update operations.
|
4265
|
+
# * `IMMUTABLE`\: The extension does not include an update handler, so
|
4266
|
+
# the extension cannot be updated and must instead be replaced during
|
4267
|
+
# stack update operations.
|
3970
4268
|
#
|
3971
|
-
# * `NON_PROVISIONABLE`\: The
|
3972
|
-
# delete handlers, and therefore cannot actually be provisioned.
|
4269
|
+
# * `NON_PROVISIONABLE`\: The extension does not include create, read,
|
4270
|
+
# and delete handlers, and therefore cannot actually be provisioned.
|
3973
4271
|
#
|
3974
4272
|
# @option params [String] :deprecated_status
|
3975
|
-
# The deprecation status of the
|
4273
|
+
# The deprecation status of the extension that you want to get summary
|
3976
4274
|
# information about.
|
3977
4275
|
#
|
3978
4276
|
# Valid values include:
|
3979
4277
|
#
|
3980
|
-
# * `LIVE`\: The
|
4278
|
+
# * `LIVE`\: The extension is registered for use in CloudFormation
|
3981
4279
|
# operations.
|
3982
4280
|
#
|
3983
|
-
# * `DEPRECATED`\: The
|
3984
|
-
# used in CloudFormation operations.
|
4281
|
+
# * `DEPRECATED`\: The extension has been deregistered and can no longer
|
4282
|
+
# be used in CloudFormation operations.
|
3985
4283
|
#
|
3986
4284
|
# @option params [String] :type
|
3987
4285
|
# The type of extension.
|
@@ -4119,24 +4417,25 @@ module Aws::CloudFormation
|
|
4119
4417
|
req.send_request(options)
|
4120
4418
|
end
|
4121
4419
|
|
4122
|
-
# Registers
|
4123
|
-
# makes it available for use in CloudFormation templates in
|
4124
|
-
# account, and includes:
|
4420
|
+
# Registers an extension with the CloudFormation service. Registering an
|
4421
|
+
# extension makes it available for use in CloudFormation templates in
|
4422
|
+
# your AWS account, and includes:
|
4125
4423
|
#
|
4126
|
-
# * Validating the
|
4424
|
+
# * Validating the extension schema
|
4127
4425
|
#
|
4128
|
-
# * Determining which handlers have been specified for the
|
4426
|
+
# * Determining which handlers, if any, have been specified for the
|
4427
|
+
# extension
|
4129
4428
|
#
|
4130
|
-
# * Making the
|
4429
|
+
# * Making the extension available for use in your account
|
4131
4430
|
#
|
4132
|
-
# For more information on how to develop
|
4431
|
+
# For more information on how to develop extensions and ready them for
|
4133
4432
|
# registeration, see [Creating Resource Providers][1] in the
|
4134
4433
|
# *CloudFormation CLI User Guide*.
|
4135
4434
|
#
|
4136
|
-
# You can have a maximum of 50 resource
|
4137
|
-
# time. This maximum is per account and per region. Use
|
4435
|
+
# You can have a maximum of 50 resource extension versions registered at
|
4436
|
+
# a time. This maximum is per account and per region. Use
|
4138
4437
|
# [DeregisterType](AWSCloudFormation/latest/APIReference/API_DeregisterType.html)
|
4139
|
-
# to deregister specific
|
4438
|
+
# to deregister specific extension versions if necessary.
|
4140
4439
|
#
|
4141
4440
|
# Once you have initiated a registration request using ` RegisterType `,
|
4142
4441
|
# you can use ` DescribeTypeRegistration ` to monitor the progress of
|
@@ -4147,18 +4446,16 @@ module Aws::CloudFormation
|
|
4147
4446
|
# [1]: https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/resource-types.html
|
4148
4447
|
#
|
4149
4448
|
# @option params [String] :type
|
4150
|
-
# The kind of
|
4151
|
-
#
|
4152
|
-
# Currently, the only valid value is `RESOURCE`.
|
4449
|
+
# The kind of extension.
|
4153
4450
|
#
|
4154
4451
|
# @option params [required, String] :type_name
|
4155
|
-
# The name of the
|
4452
|
+
# The name of the extension being registered.
|
4156
4453
|
#
|
4157
|
-
# We recommend that
|
4454
|
+
# We recommend that extension names adhere to the following pattern:
|
4158
4455
|
# *company\_or\_organization*\::*service*\::*type*.
|
4159
4456
|
#
|
4160
4457
|
# <note markdown="1"> The following organization namespaces are reserved and cannot be used
|
4161
|
-
# in your
|
4458
|
+
# in your extension names:
|
4162
4459
|
#
|
4163
4460
|
# * `Alexa`
|
4164
4461
|
#
|
@@ -4175,20 +4472,18 @@ module Aws::CloudFormation
|
|
4175
4472
|
# </note>
|
4176
4473
|
#
|
4177
4474
|
# @option params [required, String] :schema_handler_package
|
4178
|
-
# A url to the S3 bucket containing the
|
4179
|
-
# contains the
|
4180
|
-
# you want to register.
|
4475
|
+
# A url to the S3 bucket containing the extension project package that
|
4476
|
+
# contains the neccessary files for the extension you want to register.
|
4181
4477
|
#
|
4182
|
-
# For information on generating a schema handler package for the
|
4183
|
-
# you want to register, see [submit][1] in the *CloudFormation
|
4184
|
-
# Guide*.
|
4478
|
+
# For information on generating a schema handler package for the
|
4479
|
+
# extension you want to register, see [submit][1] in the *CloudFormation
|
4480
|
+
# CLI User Guide*.
|
4185
4481
|
#
|
4186
|
-
# <note markdown="1"> The user registering the
|
4187
|
-
#
|
4188
|
-
#
|
4189
|
-
#
|
4190
|
-
#
|
4191
|
-
# Guide*.
|
4482
|
+
# <note markdown="1"> The user registering the extension must be able to access the package
|
4483
|
+
# in the S3 bucket. That is, the user needs to have [GetObject][2]
|
4484
|
+
# permissions for the schema handler package. For more information, see
|
4485
|
+
# [Actions, Resources, and Condition Keys for Amazon S3][3] in the *AWS
|
4486
|
+
# Identity and Access Management User Guide*.
|
4192
4487
|
#
|
4193
4488
|
# </note>
|
4194
4489
|
#
|
@@ -4199,26 +4494,25 @@ module Aws::CloudFormation
|
|
4199
4494
|
# [3]: https://docs.aws.amazon.com/IAM/latest/UserGuide/list_amazons3.html
|
4200
4495
|
#
|
4201
4496
|
# @option params [Types::LoggingConfig] :logging_config
|
4202
|
-
# Specifies logging configuration information for
|
4497
|
+
# Specifies logging configuration information for an extension.
|
4203
4498
|
#
|
4204
4499
|
# @option params [String] :execution_role_arn
|
4205
4500
|
# The Amazon Resource Name (ARN) of the IAM role for CloudFormation to
|
4206
|
-
# assume when invoking the
|
4207
|
-
#
|
4501
|
+
# assume when invoking the extension. If your extension calls AWS APIs
|
4502
|
+
# in any of its handlers, you must create an <i> <a
|
4208
4503
|
# href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html">IAM
|
4209
4504
|
# execution role</a> </i> that includes the necessary permissions to
|
4210
4505
|
# call those AWS APIs, and provision that execution role in your
|
4211
|
-
# account. When CloudFormation needs to invoke the
|
4212
|
-
#
|
4213
|
-
#
|
4214
|
-
#
|
4215
|
-
# credentials.
|
4506
|
+
# account. When CloudFormation needs to invoke the extension handler,
|
4507
|
+
# CloudFormation assumes this execution role to create a temporary
|
4508
|
+
# session token, which it then passes to the extension handler, thereby
|
4509
|
+
# supplying your extension with the appropriate credentials.
|
4216
4510
|
#
|
4217
4511
|
# @option params [String] :client_request_token
|
4218
4512
|
# A unique identifier that acts as an idempotency key for this
|
4219
4513
|
# registration request. Specifying a client request token prevents
|
4220
|
-
# CloudFormation from generating more than one version of
|
4221
|
-
# the same registeration request, even if the request is submitted
|
4514
|
+
# CloudFormation from generating more than one version of an extension
|
4515
|
+
# from the same registeration request, even if the request is submitted
|
4222
4516
|
# multiple times.
|
4223
4517
|
#
|
4224
4518
|
# @return [Types::RegisterTypeOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
@@ -4292,29 +4586,29 @@ module Aws::CloudFormation
|
|
4292
4586
|
req.send_request(options)
|
4293
4587
|
end
|
4294
4588
|
|
4295
|
-
# Specify the default version of
|
4296
|
-
# will be used in CloudFormation operations.
|
4589
|
+
# Specify the default version of an extension. The default version of an
|
4590
|
+
# extension will be used in CloudFormation operations.
|
4297
4591
|
#
|
4298
4592
|
# @option params [String] :arn
|
4299
|
-
# The Amazon Resource Name (ARN) of the
|
4300
|
-
# summary information.
|
4593
|
+
# The Amazon Resource Name (ARN) of the extension for which you want
|
4594
|
+
# version summary information.
|
4301
4595
|
#
|
4302
4596
|
# Conditional: You must specify either `TypeName` and `Type`, or `Arn`.
|
4303
4597
|
#
|
4304
4598
|
# @option params [String] :type
|
4305
|
-
# The kind of
|
4599
|
+
# The kind of extension.
|
4306
4600
|
#
|
4307
4601
|
# Conditional: You must specify either `TypeName` and `Type`, or `Arn`.
|
4308
4602
|
#
|
4309
4603
|
# @option params [String] :type_name
|
4310
|
-
# The name of the
|
4604
|
+
# The name of the extension.
|
4311
4605
|
#
|
4312
4606
|
# Conditional: You must specify either `TypeName` and `Type`, or `Arn`.
|
4313
4607
|
#
|
4314
4608
|
# @option params [String] :version_id
|
4315
|
-
# The ID of a specific version of the
|
4316
|
-
# at the end of the Amazon Resource Name (ARN) assigned to the
|
4317
|
-
# version when it is registered.
|
4609
|
+
# The ID of a specific version of the extension. The version ID is the
|
4610
|
+
# value at the end of the Amazon Resource Name (ARN) assigned to the
|
4611
|
+
# extension version when it is registered.
|
4318
4612
|
#
|
4319
4613
|
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
4320
4614
|
#
|
@@ -4394,6 +4688,27 @@ module Aws::CloudFormation
|
|
4394
4688
|
# @option params [required, String] :operation_id
|
4395
4689
|
# The ID of the stack operation.
|
4396
4690
|
#
|
4691
|
+
# @option params [String] :call_as
|
4692
|
+
# \[Service-managed permissions\] Specifies whether you are acting as an
|
4693
|
+
# account administrator in the organization's management account or as
|
4694
|
+
# a delegated administrator in a member account.
|
4695
|
+
#
|
4696
|
+
# By default, `SELF` is specified. Use `SELF` for stack sets with
|
4697
|
+
# self-managed permissions.
|
4698
|
+
#
|
4699
|
+
# * If you are signed in to the management account, specify `SELF`.
|
4700
|
+
#
|
4701
|
+
# * If you are signed in to a delegated administrator account, specify
|
4702
|
+
# `DELEGATED_ADMIN`.
|
4703
|
+
#
|
4704
|
+
# Your AWS account must be registered as a delegated administrator in
|
4705
|
+
# the management account. For more information, see [Register a
|
4706
|
+
# delegated administrator][1] in the *AWS CloudFormation User Guide*.
|
4707
|
+
#
|
4708
|
+
#
|
4709
|
+
#
|
4710
|
+
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-orgs-delegated-admin.html
|
4711
|
+
#
|
4397
4712
|
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
4398
4713
|
#
|
4399
4714
|
# @example Request syntax with placeholder values
|
@@ -4401,6 +4716,7 @@ module Aws::CloudFormation
|
|
4401
4716
|
# resp = client.stop_stack_set_operation({
|
4402
4717
|
# stack_set_name: "StackSetName", # required
|
4403
4718
|
# operation_id: "ClientRequestToken", # required
|
4719
|
+
# call_as: "SELF", # accepts SELF, DELEGATED_ADMIN
|
4404
4720
|
# })
|
4405
4721
|
#
|
4406
4722
|
# @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/StopStackSetOperation AWS API Documentation
|
@@ -4445,8 +4761,9 @@ module Aws::CloudFormation
|
|
4445
4761
|
#
|
4446
4762
|
# @option params [String] :template_url
|
4447
4763
|
# Location of file containing the template body. The URL must point to a
|
4448
|
-
# template that is located in an Amazon S3 bucket
|
4449
|
-
# go to [Template Anatomy][1] in the AWS
|
4764
|
+
# template that is located in an Amazon S3 bucket or a Systems Manager
|
4765
|
+
# document. For more information, go to [Template Anatomy][1] in the AWS
|
4766
|
+
# CloudFormation User Guide.
|
4450
4767
|
#
|
4451
4768
|
# Conditional: You must specify only one of the following parameters:
|
4452
4769
|
# `TemplateBody`, `TemplateURL`, or set the `UsePreviousTemplate` to
|
@@ -4763,15 +5080,15 @@ module Aws::CloudFormation
|
|
4763
5080
|
# instances.
|
4764
5081
|
#
|
4765
5082
|
# @option params [Array<String>] :accounts
|
4766
|
-
# \[
|
4767
|
-
#
|
5083
|
+
# \[Self-managed permissions\] The names of one or more AWS accounts for
|
5084
|
+
# which you want to update parameter values for stack instances. The
|
4768
5085
|
# overridden parameter values will be applied to all stack instances in
|
4769
5086
|
# the specified accounts and Regions.
|
4770
5087
|
#
|
4771
5088
|
# You can specify `Accounts` or `DeploymentTargets`, but not both.
|
4772
5089
|
#
|
4773
5090
|
# @option params [Types::DeploymentTargets] :deployment_targets
|
4774
|
-
# \[
|
5091
|
+
# \[Service-managed permissions\] The AWS Organizations accounts for
|
4775
5092
|
# which you want to update parameter values for stack instances. If your
|
4776
5093
|
# update targets OUs, the overridden parameter values only apply to the
|
4777
5094
|
# accounts that are currently in the target OUs and their child OUs.
|
@@ -4849,6 +5166,27 @@ module Aws::CloudFormation
|
|
4849
5166
|
# **A suitable default value is auto-generated.** You should normally
|
4850
5167
|
# not need to pass this option.**
|
4851
5168
|
#
|
5169
|
+
# @option params [String] :call_as
|
5170
|
+
# \[Service-managed permissions\] Specifies whether you are acting as an
|
5171
|
+
# account administrator in the organization's management account or as
|
5172
|
+
# a delegated administrator in a member account.
|
5173
|
+
#
|
5174
|
+
# By default, `SELF` is specified. Use `SELF` for stack sets with
|
5175
|
+
# self-managed permissions.
|
5176
|
+
#
|
5177
|
+
# * If you are signed in to the management account, specify `SELF`.
|
5178
|
+
#
|
5179
|
+
# * If you are signed in to a delegated administrator account, specify
|
5180
|
+
# `DELEGATED_ADMIN`.
|
5181
|
+
#
|
5182
|
+
# Your AWS account must be registered as a delegated administrator in
|
5183
|
+
# the management account. For more information, see [Register a
|
5184
|
+
# delegated administrator][1] in the *AWS CloudFormation User Guide*.
|
5185
|
+
#
|
5186
|
+
#
|
5187
|
+
#
|
5188
|
+
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-orgs-delegated-admin.html
|
5189
|
+
#
|
4852
5190
|
# @return [Types::UpdateStackInstancesOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
4853
5191
|
#
|
4854
5192
|
# * {Types::UpdateStackInstancesOutput#operation_id #operation_id} => String
|
@@ -4860,6 +5198,7 @@ module Aws::CloudFormation
|
|
4860
5198
|
# accounts: ["Account"],
|
4861
5199
|
# deployment_targets: {
|
4862
5200
|
# accounts: ["Account"],
|
5201
|
+
# accounts_url: "AccountsUrl",
|
4863
5202
|
# organizational_unit_ids: ["OrganizationalUnitId"],
|
4864
5203
|
# },
|
4865
5204
|
# regions: ["Region"], # required
|
@@ -4872,6 +5211,7 @@ module Aws::CloudFormation
|
|
4872
5211
|
# },
|
4873
5212
|
# ],
|
4874
5213
|
# operation_preferences: {
|
5214
|
+
# region_concurrency_type: "SEQUENTIAL", # accepts SEQUENTIAL, PARALLEL
|
4875
5215
|
# region_order: ["Region"],
|
4876
5216
|
# failure_tolerance_count: 1,
|
4877
5217
|
# failure_tolerance_percentage: 1,
|
@@ -4879,6 +5219,7 @@ module Aws::CloudFormation
|
|
4879
5219
|
# max_concurrent_percentage: 1,
|
4880
5220
|
# },
|
4881
5221
|
# operation_id: "ClientRequestToken",
|
5222
|
+
# call_as: "SELF", # accepts SELF, DELEGATED_ADMIN
|
4882
5223
|
# })
|
4883
5224
|
#
|
4884
5225
|
# @example Response structure
|
@@ -4924,8 +5265,9 @@ module Aws::CloudFormation
|
|
4924
5265
|
# @option params [String] :template_url
|
4925
5266
|
# The location of the file that contains the template body. The URL must
|
4926
5267
|
# point to a template (maximum size: 460,800 bytes) that is located in
|
4927
|
-
# an Amazon S3 bucket
|
4928
|
-
# in the AWS CloudFormation User
|
5268
|
+
# an Amazon S3 bucket or a Systems Manager document. For more
|
5269
|
+
# information, see [Template Anatomy][1] in the AWS CloudFormation User
|
5270
|
+
# Guide.
|
4929
5271
|
#
|
4930
5272
|
# Conditional: You must specify only one of the following parameters:
|
4931
5273
|
# `TemplateBody` or `TemplateURL`—or set `UsePreviousTemplate` to true.
|
@@ -4991,18 +5333,21 @@ module Aws::CloudFormation
|
|
4991
5333
|
#
|
4992
5334
|
# * `CAPABILITY_AUTO_EXPAND`
|
4993
5335
|
#
|
4994
|
-
# Some templates
|
4995
|
-
# or more macros,
|
4996
|
-
# processed template, without first reviewing the
|
4997
|
-
# a change set
|
4998
|
-
#
|
4999
|
-
# Processing on
|
5336
|
+
# Some templates reference macros. If your stack set template
|
5337
|
+
# references one or more macros, you must update the stack set
|
5338
|
+
# directly from the processed template, without first reviewing the
|
5339
|
+
# resulting changes in a change set. To update the stack set directly,
|
5340
|
+
# you must acknowledge this capability. For more information, see
|
5341
|
+
# [Using AWS CloudFormation Macros to Perform Custom Processing on
|
5342
|
+
# Templates][9].
|
5000
5343
|
#
|
5001
|
-
# Stack sets do not currently support
|
5002
|
-
#
|
5003
|
-
# transforms, which are
|
5004
|
-
#
|
5005
|
-
#
|
5344
|
+
# Stack sets with service-managed permissions do not currently support
|
5345
|
+
# the use of macros in templates. (This includes the
|
5346
|
+
# [AWS::Include][10] and [AWS::Serverless][11] transforms, which are
|
5347
|
+
# macros hosted by AWS CloudFormation.) Even if you specify this
|
5348
|
+
# capability for a stack set with service-managed permissions, if you
|
5349
|
+
# reference a macro in your template the stack set operation will
|
5350
|
+
# fail.
|
5006
5351
|
#
|
5007
5352
|
#
|
5008
5353
|
#
|
@@ -5089,7 +5434,7 @@ module Aws::CloudFormation
|
|
5089
5434
|
# permissions to perform operations on the stack set.
|
5090
5435
|
#
|
5091
5436
|
# @option params [Types::DeploymentTargets] :deployment_targets
|
5092
|
-
# \[
|
5437
|
+
# \[Service-managed permissions\] The AWS Organizations accounts in
|
5093
5438
|
# which to update associated stack instances.
|
5094
5439
|
#
|
5095
5440
|
# To update all the stack instances associated with this stack set, do
|
@@ -5124,7 +5469,7 @@ module Aws::CloudFormation
|
|
5124
5469
|
# [2]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-prereqs-service-managed.html
|
5125
5470
|
#
|
5126
5471
|
# @option params [Types::AutoDeployment] :auto_deployment
|
5127
|
-
# \[
|
5472
|
+
# \[Service-managed permissions\] Describes whether StackSets
|
5128
5473
|
# automatically deploys to AWS Organizations accounts that are added to
|
5129
5474
|
# a target organization or organizational unit (OU).
|
5130
5475
|
#
|
@@ -5150,7 +5495,7 @@ module Aws::CloudFormation
|
|
5150
5495
|
# not need to pass this option.**
|
5151
5496
|
#
|
5152
5497
|
# @option params [Array<String>] :accounts
|
5153
|
-
# \[
|
5498
|
+
# \[Self-managed permissions\] The accounts in which to update
|
5154
5499
|
# associated stack instances. If you specify accounts, you must also
|
5155
5500
|
# specify the Regions in which to update stack set instances.
|
5156
5501
|
#
|
@@ -5185,6 +5530,27 @@ module Aws::CloudFormation
|
|
5185
5530
|
# while leaving all other stack instances with their existing stack
|
5186
5531
|
# instance status.
|
5187
5532
|
#
|
5533
|
+
# @option params [String] :call_as
|
5534
|
+
# \[Service-managed permissions\] Specifies whether you are acting as an
|
5535
|
+
# account administrator in the organization's management account or as
|
5536
|
+
# a delegated administrator in a member account.
|
5537
|
+
#
|
5538
|
+
# By default, `SELF` is specified. Use `SELF` for stack sets with
|
5539
|
+
# self-managed permissions.
|
5540
|
+
#
|
5541
|
+
# * If you are signed in to the management account, specify `SELF`.
|
5542
|
+
#
|
5543
|
+
# * If you are signed in to a delegated administrator account, specify
|
5544
|
+
# `DELEGATED_ADMIN`.
|
5545
|
+
#
|
5546
|
+
# Your AWS account must be registered as a delegated administrator in
|
5547
|
+
# the management account. For more information, see [Register a
|
5548
|
+
# delegated administrator][1] in the *AWS CloudFormation User Guide*.
|
5549
|
+
#
|
5550
|
+
#
|
5551
|
+
#
|
5552
|
+
# [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-orgs-delegated-admin.html
|
5553
|
+
#
|
5188
5554
|
# @return [Types::UpdateStackSetOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
5189
5555
|
#
|
5190
5556
|
# * {Types::UpdateStackSetOutput#operation_id #operation_id} => String
|
@@ -5213,6 +5579,7 @@ module Aws::CloudFormation
|
|
5213
5579
|
# },
|
5214
5580
|
# ],
|
5215
5581
|
# operation_preferences: {
|
5582
|
+
# region_concurrency_type: "SEQUENTIAL", # accepts SEQUENTIAL, PARALLEL
|
5216
5583
|
# region_order: ["Region"],
|
5217
5584
|
# failure_tolerance_count: 1,
|
5218
5585
|
# failure_tolerance_percentage: 1,
|
@@ -5223,6 +5590,7 @@ module Aws::CloudFormation
|
|
5223
5590
|
# execution_role_name: "ExecutionRoleName",
|
5224
5591
|
# deployment_targets: {
|
5225
5592
|
# accounts: ["Account"],
|
5593
|
+
# accounts_url: "AccountsUrl",
|
5226
5594
|
# organizational_unit_ids: ["OrganizationalUnitId"],
|
5227
5595
|
# },
|
5228
5596
|
# permission_model: "SERVICE_MANAGED", # accepts SERVICE_MANAGED, SELF_MANAGED
|
@@ -5233,6 +5601,7 @@ module Aws::CloudFormation
|
|
5233
5601
|
# operation_id: "ClientRequestToken",
|
5234
5602
|
# accounts: ["Account"],
|
5235
5603
|
# regions: ["Region"],
|
5604
|
+
# call_as: "SELF", # accepts SELF, DELEGATED_ADMIN
|
5236
5605
|
# })
|
5237
5606
|
#
|
5238
5607
|
# @example Response structure
|
@@ -5313,8 +5682,8 @@ module Aws::CloudFormation
|
|
5313
5682
|
# @option params [String] :template_url
|
5314
5683
|
# Location of file containing the template body. The URL must point to a
|
5315
5684
|
# template (max size: 460,800 bytes) that is located in an Amazon S3
|
5316
|
-
# bucket. For more information, go to
|
5317
|
-
# CloudFormation User Guide.
|
5685
|
+
# bucket or a Systems Manager document. For more information, go to
|
5686
|
+
# [Template Anatomy][1] in the AWS CloudFormation User Guide.
|
5318
5687
|
#
|
5319
5688
|
# Conditional: You must pass `TemplateURL` or `TemplateBody`. If both
|
5320
5689
|
# are passed, only `TemplateBody` is used.
|
@@ -5374,7 +5743,7 @@ module Aws::CloudFormation
|
|
5374
5743
|
params: params,
|
5375
5744
|
config: config)
|
5376
5745
|
context[:gem_name] = 'aws-sdk-cloudformation'
|
5377
|
-
context[:gem_version] = '1.
|
5746
|
+
context[:gem_version] = '1.51.0'
|
5378
5747
|
Seahorse::Client::Request.new(handlers, context)
|
5379
5748
|
end
|
5380
5749
|
|