aws-sdk-cloudformation 1.46.0 → 1.51.0

Sign up to get free protection for your applications and to get access to all the features.
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