aws-sdk-cloudformation 1.46.0 → 1.51.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 +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
|
|