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.
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/master/CONTRIBUTING.md
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.46.0'
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/master/CONTRIBUTING.md
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. AWS CloudFormation generates the change set by comparing
529
- # this template with the stack that you specified.
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 [Template Anatomy][1] in 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
- # \[`Self-managed` permissions\] The names of one or more AWS accounts
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
- # \[`Service-managed` permissions\] The AWS Organizations accounts for
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. For more information, see [Template Anatomy][1]
1272
- # in the AWS CloudFormation User Guide.
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 contain macros. If your stack template contains one
1332
- # or more macros, and you choose to create a stack directly from the
1333
- # processed template, without first reviewing the resulting changes in
1334
- # a change set, you must acknowledge this capability. For more
1335
- # information, see [Using AWS CloudFormation Macros to Perform Custom
1336
- # Processing on Templates][9].
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
- # </note>
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
- # \[`Self-managed` permissions\] The names of the AWS accounts that you
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
- # \[`Service-managed` permissions\] The AWS Organizations accounts from
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
- # Removes a type or type version from active use in the CloudFormation
1704
- # registry. If a type or type version is deregistered, it cannot be used
1705
- # in CloudFormation operations.
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
- # You cannot deregister the default version of a type, unless it is the
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 type.
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 type.
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 type.
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 type. The version ID is the value
1735
- # at the end of the Amazon Resource Name (ARN) assigned to the type
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 a type that has been registered.
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 type version. Otherwise, it returns information about
2577
- # the default type version.
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 type.
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 type.
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 type.
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 type. The version ID is the value
2598
- # at the end of the Amazon Resource Name (ARN) assigned to the type
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 type version. Otherwise, it returns information about
2603
- # the default type version.
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 a type's registration, including its
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 informaiton about a type.
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 informaiton about the
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. For more information,
2961
- # go to [Template Anatomy][1] in the AWS CloudFormation User Guide.
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 templates, see [Template
3179
- # Anatomy][1] in the AWS CloudFormation User Guide.
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&lt;Types::StackInstanceSummary&gt;
@@ -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&lt;Types::StackSetOperationResultSummary&gt;
@@ -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&lt;Types::StackSetOperationSummary&gt;
@@ -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&lt;Types::StackSetSummary&gt;
@@ -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 type(s).
4081
+ # Returns a list of registration tokens for the specified extension(s).
3781
4082
  #
3782
4083
  # @option params [String] :type
3783
- # The kind of type.
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 type.
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 type.
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 type registration request.
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 a type.
4150
+ # Returns summary information about the versions of an extension.
3852
4151
  #
3853
4152
  # @option params [String] :type
3854
- # The kind of the type.
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 type for which you want version summary information.
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 type for which you want version
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 type versions that you want to get
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 type version is registered and can be used in
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 type version has been deregistered and can no
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 types that have been registered with
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 type is visible and usable in CloudFormation
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 type is only visible and usable within the account
3949
- # in which it is registered. Currently, AWS CloudFormation marks any
3950
- # types you create as `PRIVATE`.
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 type is publically visible and usable within any
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 type includes an update handler to process
3965
- # updates to the type during stack update operations.
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 type does not include an update handler, so the
3968
- # type cannot be updated and must instead be replaced during stack
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 type does not include create, read, and
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 types that you want to get summary
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 type is registered for use in CloudFormation
4278
+ # * `LIVE`\: The extension is registered for use in CloudFormation
3981
4279
  # operations.
3982
4280
  #
3983
- # * `DEPRECATED`\: The type has been deregistered and can no longer be
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 a type with the CloudFormation service. Registering a type
4123
- # makes it available for use in CloudFormation templates in your AWS
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 resource schema
4424
+ # * Validating the extension schema
4127
4425
  #
4128
- # * Determining which handlers have been specified for the resource
4426
+ # * Determining which handlers, if any, have been specified for the
4427
+ # extension
4129
4428
  #
4130
- # * Making the resource type available for use in your account
4429
+ # * Making the extension available for use in your account
4131
4430
  #
4132
- # For more information on how to develop types and ready them for
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 type versions registered at a
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 resource type versions if necessary.
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 type.
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 type being registered.
4452
+ # The name of the extension being registered.
4156
4453
  #
4157
- # We recommend that type names adhere to the following pattern:
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 resource type names:
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 schema handler package that
4179
- # contains the schema, event handlers, and associated files for the type
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 type
4183
- # you want to register, see [submit][1] in the *CloudFormation CLI User
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 resource provider type must be able to access
4187
- # the the schema handler package in the S3 bucket. That is, the user
4188
- # needs to have [GetObject][2] permissions for the schema handler
4189
- # package. For more information, see [Actions, Resources, and Condition
4190
- # Keys for Amazon S3][3] in the *AWS Identity and Access Management User
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 a type.
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 resource provider. If your resource type
4207
- # calls AWS APIs in any of its handlers, you must create an <i> <a
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 resource provider
4212
- # handler, CloudFormation assumes this execution role to create a
4213
- # temporary session token, which it then passes to the resource provider
4214
- # handler, thereby supplying your resource provider with the appropriate
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 a type from
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 a type. The default version of a type
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 type for which you want version
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 type.
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 type.
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 type. The version ID is the value
4316
- # at the end of the Amazon Resource Name (ARN) assigned to the type
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. For more information,
4449
- # go to [Template Anatomy][1] in the AWS CloudFormation User Guide.
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
- # \[`Self-managed` permissions\] The names of one or more AWS accounts
4767
- # for which you want to update parameter values for stack instances. The
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
- # \[`Service-managed` permissions\] The AWS Organizations accounts for
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. For more information, see [Template Anatomy][1]
4928
- # in the AWS CloudFormation User Guide.
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 contain macros. If your stack template contains one
4995
- # or more macros, and you choose to update a stack directly from the
4996
- # processed template, without first reviewing the resulting changes in
4997
- # a change set, you must acknowledge this capability. For more
4998
- # information, see [Using AWS CloudFormation Macros to Perform Custom
4999
- # Processing on Templates][9].
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 macros in stack templates. (This
5002
- # includes the [AWS::Include][10] and [AWS::Serverless][11]
5003
- # transforms, which are macros hosted by AWS CloudFormation.) Even if
5004
- # you specify this capability, if you include a macro in your template
5005
- # the stack set operation will fail.
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
- # \[`Service-managed` permissions\] The AWS Organizations accounts in
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
- # \[`Service-managed` permissions\] Describes whether StackSets
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
- # \[`Self-managed` permissions\] The accounts in which to update
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 [Template Anatomy][1] in the AWS
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.46.0'
5746
+ context[:gem_version] = '1.51.0'
5378
5747
  Seahorse::Client::Request.new(handlers, context)
5379
5748
  end
5380
5749