aws-sdk-cloudformation 1.29.0 → 1.30.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA1:
3
- metadata.gz: 6b59f86483fa5b82941570227948692914749d62
4
- data.tar.gz: 7af00c5d073de106ec1529d4b33ac650e47466b3
3
+ metadata.gz: 7a6eccc3eab9bee838b271fbaec88540d54239bb
4
+ data.tar.gz: cdb86da0078ecde01493a285cd247cda15485589
5
5
  SHA512:
6
- metadata.gz: 25201c6a6f308318ac4464b02d2e5d22b02d9d8018f5d1a6c2cb29ad0ea98ff246d2f7ca4d46e16da0fc1401d4c3b54cc5e00ccf46db31ca3c04be62196f6b60
7
- data.tar.gz: d2ef3d37989076ea979899b87293ab89c6e1ee2aafdd19ed702bc9c6c831d49b996e44f323322ec943ce9596c81691e1f908ec582e526cdd1137e43c0c2f1274
6
+ metadata.gz: d1b531f4939e9cb2ba8486ec94dd7747a92f63f37f3eb3be0cbc411949f74815ac500dc9940ef157764002215578678b773be7b2707ea21d9a6382bda6570a36
7
+ data.tar.gz: 9f5e859efc6a890aff924776241ed9005631e499757cfbb3ece9bf2fc4efa293cf8a3e35feb53dd41c9d58819b837d8b9f4cb64e6518144d9e79781d1935f6a9
@@ -47,6 +47,6 @@ require_relative 'aws-sdk-cloudformation/customizations'
47
47
  # @service
48
48
  module Aws::CloudFormation
49
49
 
50
- GEM_VERSION = '1.29.0'
50
+ GEM_VERSION = '1.30.0'
51
51
 
52
52
  end
@@ -1026,16 +1026,26 @@ module Aws::CloudFormation
1026
1026
 
1027
1027
  # Creates stack instances for the specified accounts, within the
1028
1028
  # specified regions. A stack instance refers to a stack in a specific
1029
- # account and region. `Accounts` and `Regions` are required
1030
- # parameters—you must specify at least one account and one region.
1029
+ # account and region. You must specify at least one value for either
1030
+ # `Accounts` or `DeploymentTargets`, and you must specify at least one
1031
+ # value for `Regions`.
1031
1032
  #
1032
1033
  # @option params [required, String] :stack_set_name
1033
1034
  # The name or unique ID of the stack set that you want to create stack
1034
1035
  # instances from.
1035
1036
  #
1036
- # @option params [required, Array<String>] :accounts
1037
- # The names of one or more AWS accounts that you want to create stack
1038
- # instances in the specified region(s) for.
1037
+ # @option params [Array<String>] :accounts
1038
+ # \[Self-managed permissions\] The names of one or more AWS accounts
1039
+ # that you want to create stack instances in the specified region(s)
1040
+ # for.
1041
+ #
1042
+ # You can specify `Accounts` or `DeploymentTargets`, but not both.
1043
+ #
1044
+ # @option params [Types::DeploymentTargets] :deployment_targets
1045
+ # \[`Service-managed` permissions\] The AWS Organizations accounts for
1046
+ # which to create stack instances in the specified Regions.
1047
+ #
1048
+ # You can specify `Accounts` or `DeploymentTargets`, but not both.
1039
1049
  #
1040
1050
  # @option params [required, Array<String>] :regions
1041
1051
  # The names of one or more regions where you want to create stack
@@ -1110,7 +1120,11 @@ module Aws::CloudFormation
1110
1120
  #
1111
1121
  # resp = client.create_stack_instances({
1112
1122
  # stack_set_name: "StackSetName", # required
1113
- # accounts: ["Account"], # required
1123
+ # accounts: ["Account"],
1124
+ # deployment_targets: {
1125
+ # accounts: ["Account"],
1126
+ # organizational_unit_ids: ["OrganizationalUnitId"],
1127
+ # },
1114
1128
  # regions: ["Region"], # required
1115
1129
  # parameter_overrides: [
1116
1130
  # {
@@ -1298,6 +1312,32 @@ module Aws::CloudFormation
1298
1312
  # to control which stack resources users and groups can include in their
1299
1313
  # stack sets.
1300
1314
  #
1315
+ # @option params [String] :permission_model
1316
+ # Describes how the IAM roles required for stack set operations are
1317
+ # created. By default, `SELF-MANAGED` is specified.
1318
+ #
1319
+ # * With `self-managed` permissions, you must create the administrator
1320
+ # and execution roles required to deploy to target accounts. For more
1321
+ # information, see [Grant Self-Managed Stack Set Permissions][1].
1322
+ #
1323
+ # * With `service-managed` permissions, StackSets automatically creates
1324
+ # the IAM roles required to deploy to accounts managed by AWS
1325
+ # Organizations. For more information, see [Grant Service-Managed
1326
+ # Stack Set Permissions][2].
1327
+ #
1328
+ #
1329
+ #
1330
+ # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-prereqs-self-managed.html
1331
+ # [2]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-prereqs-service-managed.html
1332
+ #
1333
+ # @option params [Types::AutoDeployment] :auto_deployment
1334
+ # Describes whether StackSets automatically deploys to AWS Organizations
1335
+ # accounts that are added to the target organization or organizational
1336
+ # unit (OU). Specify only if `PermissionModel` is `SERVICE_MANAGED`.
1337
+ #
1338
+ # If you specify `AutoDeployment`, do not specify `DeploymentTargets` or
1339
+ # `Regions`.
1340
+ #
1301
1341
  # @option params [String] :client_request_token
1302
1342
  # A unique identifier for this `CreateStackSet` request. Specify this
1303
1343
  # token if you plan to retry requests so that AWS CloudFormation knows
@@ -1339,6 +1379,11 @@ module Aws::CloudFormation
1339
1379
  # ],
1340
1380
  # administration_role_arn: "RoleARN",
1341
1381
  # execution_role_name: "ExecutionRoleName",
1382
+ # permission_model: "SERVICE_MANAGED", # accepts SERVICE_MANAGED, SELF_MANAGED
1383
+ # auto_deployment: {
1384
+ # enabled: false,
1385
+ # retain_stacks_on_account_removal: false,
1386
+ # },
1342
1387
  # client_request_token: "ClientRequestToken",
1343
1388
  # })
1344
1389
  #
@@ -1462,9 +1507,17 @@ module Aws::CloudFormation
1462
1507
  # The name or unique ID of the stack set that you want to delete stack
1463
1508
  # instances for.
1464
1509
  #
1465
- # @option params [required, Array<String>] :accounts
1466
- # The names of the AWS accounts that you want to delete stack instances
1467
- # for.
1510
+ # @option params [Array<String>] :accounts
1511
+ # \[Self-managed permissions\] The names of the AWS accounts that you
1512
+ # want to delete stack instances for.
1513
+ #
1514
+ # You can specify `Accounts` or `DeploymentTargets`, but not both.
1515
+ #
1516
+ # @option params [Types::DeploymentTargets] :deployment_targets
1517
+ # \[`Service-managed` permissions\] The AWS Organizations accounts from
1518
+ # which to delete stack instances.
1519
+ #
1520
+ # You can specify `Accounts` or `DeploymentTargets`, but not both.
1468
1521
  #
1469
1522
  # @option params [required, Array<String>] :regions
1470
1523
  # The regions where you want to delete stack set instances.
@@ -1510,7 +1563,11 @@ module Aws::CloudFormation
1510
1563
  #
1511
1564
  # resp = client.delete_stack_instances({
1512
1565
  # stack_set_name: "StackSetName", # required
1513
- # accounts: ["Account"], # required
1566
+ # accounts: ["Account"],
1567
+ # deployment_targets: {
1568
+ # accounts: ["Account"],
1569
+ # organizational_unit_ids: ["OrganizationalUnitId"],
1570
+ # },
1514
1571
  # regions: ["Region"], # required
1515
1572
  # operation_preferences: {
1516
1573
  # region_order: ["Region"],
@@ -1577,17 +1634,19 @@ module Aws::CloudFormation
1577
1634
  # @option params [String] :arn
1578
1635
  # The Amazon Resource Name (ARN) of the type.
1579
1636
  #
1580
- # Conditional: You must specify `TypeName` or `Arn`.
1637
+ # Conditional: You must specify either `TypeName` and `Type`, or `Arn`.
1581
1638
  #
1582
1639
  # @option params [String] :type
1583
1640
  # The kind of type.
1584
1641
  #
1585
1642
  # Currently the only valid value is `RESOURCE`.
1586
1643
  #
1644
+ # Conditional: You must specify either `TypeName` and `Type`, or `Arn`.
1645
+ #
1587
1646
  # @option params [String] :type_name
1588
1647
  # The name of the type.
1589
1648
  #
1590
- # Conditional: You must specify `TypeName` or `Arn`.
1649
+ # Conditional: You must specify either `TypeName` and `Type`, or `Arn`.
1591
1650
  #
1592
1651
  # @option params [String] :version_id
1593
1652
  # The ID of a specific version of the type. The version ID is the value
@@ -1925,6 +1984,7 @@ module Aws::CloudFormation
1925
1984
  # resp.stack_instance.parameter_overrides[0].resolved_value #=> String
1926
1985
  # resp.stack_instance.status #=> String, one of "CURRENT", "OUTDATED", "INOPERABLE"
1927
1986
  # resp.stack_instance.status_reason #=> String
1987
+ # resp.stack_instance.organizational_unit_id #=> String
1928
1988
  # resp.stack_instance.drift_status #=> String, one of "DRIFTED", "IN_SYNC", "UNKNOWN", "NOT_CHECKED"
1929
1989
  # resp.stack_instance.last_drift_check_timestamp #=> Time
1930
1990
  #
@@ -2228,6 +2288,11 @@ module Aws::CloudFormation
2228
2288
  # resp.stack_set.stack_set_drift_detection_details.in_sync_stack_instances_count #=> Integer
2229
2289
  # resp.stack_set.stack_set_drift_detection_details.in_progress_stack_instances_count #=> Integer
2230
2290
  # resp.stack_set.stack_set_drift_detection_details.failed_stack_instances_count #=> Integer
2291
+ # resp.stack_set.auto_deployment.enabled #=> Boolean
2292
+ # resp.stack_set.auto_deployment.retain_stacks_on_account_removal #=> Boolean
2293
+ # resp.stack_set.permission_model #=> String, one of "SERVICE_MANAGED", "SELF_MANAGED"
2294
+ # resp.stack_set.organizational_unit_ids #=> Array
2295
+ # resp.stack_set.organizational_unit_ids[0] #=> String
2231
2296
  #
2232
2297
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/DescribeStackSet AWS API Documentation
2233
2298
  #
@@ -2263,7 +2328,7 @@ module Aws::CloudFormation
2263
2328
  # resp.stack_set_operation.operation_id #=> String
2264
2329
  # resp.stack_set_operation.stack_set_id #=> String
2265
2330
  # resp.stack_set_operation.action #=> String, one of "CREATE", "UPDATE", "DELETE", "DETECT_DRIFT"
2266
- # resp.stack_set_operation.status #=> String, one of "RUNNING", "SUCCEEDED", "FAILED", "STOPPING", "STOPPED"
2331
+ # resp.stack_set_operation.status #=> String, one of "RUNNING", "SUCCEEDED", "FAILED", "STOPPING", "STOPPED", "QUEUED"
2267
2332
  # resp.stack_set_operation.operation_preferences.region_order #=> Array
2268
2333
  # resp.stack_set_operation.operation_preferences.region_order[0] #=> String
2269
2334
  # resp.stack_set_operation.operation_preferences.failure_tolerance_count #=> Integer
@@ -2275,6 +2340,10 @@ module Aws::CloudFormation
2275
2340
  # resp.stack_set_operation.execution_role_name #=> String
2276
2341
  # resp.stack_set_operation.creation_timestamp #=> Time
2277
2342
  # resp.stack_set_operation.end_timestamp #=> Time
2343
+ # resp.stack_set_operation.deployment_targets.accounts #=> Array
2344
+ # resp.stack_set_operation.deployment_targets.accounts[0] #=> String
2345
+ # resp.stack_set_operation.deployment_targets.organizational_unit_ids #=> Array
2346
+ # resp.stack_set_operation.deployment_targets.organizational_unit_ids[0] #=> String
2278
2347
  # resp.stack_set_operation.stack_set_drift_detection_details.drift_status #=> String, one of "DRIFTED", "IN_SYNC", "NOT_CHECKED"
2279
2348
  # resp.stack_set_operation.stack_set_drift_detection_details.drift_detection_status #=> String, one of "COMPLETED", "FAILED", "PARTIAL_SUCCESS", "IN_PROGRESS", "STOPPED"
2280
2349
  # resp.stack_set_operation.stack_set_drift_detection_details.last_drift_check_timestamp #=> Time
@@ -2391,15 +2460,17 @@ module Aws::CloudFormation
2391
2460
  #
2392
2461
  # Currently the only valid value is `RESOURCE`.
2393
2462
  #
2463
+ # Conditional: You must specify either `TypeName` and `Type`, or `Arn`.
2464
+ #
2394
2465
  # @option params [String] :type_name
2395
2466
  # The name of the type.
2396
2467
  #
2397
- # Conditional: You must specify `TypeName` or `Arn`.
2468
+ # Conditional: You must specify either `TypeName` and `Type`, or `Arn`.
2398
2469
  #
2399
2470
  # @option params [String] :arn
2400
2471
  # The Amazon Resource Name (ARN) of the type.
2401
2472
  #
2402
- # Conditional: You must specify `TypeName` or `Arn`.
2473
+ # Conditional: You must specify either `TypeName` and `Type`, or `Arn`.
2403
2474
  #
2404
2475
  # @option params [String] :version_id
2405
2476
  # The ID of a specific version of the type. The version ID is the value
@@ -3246,6 +3317,7 @@ module Aws::CloudFormation
3246
3317
  # resp.summaries[0].stack_id #=> String
3247
3318
  # resp.summaries[0].status #=> String, one of "CURRENT", "OUTDATED", "INOPERABLE"
3248
3319
  # resp.summaries[0].status_reason #=> String
3320
+ # resp.summaries[0].organizational_unit_id #=> String
3249
3321
  # resp.summaries[0].drift_status #=> String, one of "DRIFTED", "IN_SYNC", "UNKNOWN", "NOT_CHECKED"
3250
3322
  # resp.summaries[0].last_drift_check_timestamp #=> Time
3251
3323
  # resp.next_token #=> String
@@ -3361,6 +3433,7 @@ module Aws::CloudFormation
3361
3433
  # resp.summaries[0].status_reason #=> String
3362
3434
  # resp.summaries[0].account_gate_result.status #=> String, one of "SUCCEEDED", "FAILED", "SKIPPED"
3363
3435
  # resp.summaries[0].account_gate_result.status_reason #=> String
3436
+ # resp.summaries[0].organizational_unit_id #=> String
3364
3437
  # resp.next_token #=> String
3365
3438
  #
3366
3439
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/ListStackSetOperationResults AWS API Documentation
@@ -3411,7 +3484,7 @@ module Aws::CloudFormation
3411
3484
  # resp.summaries #=> Array
3412
3485
  # resp.summaries[0].operation_id #=> String
3413
3486
  # resp.summaries[0].action #=> String, one of "CREATE", "UPDATE", "DELETE", "DETECT_DRIFT"
3414
- # resp.summaries[0].status #=> String, one of "RUNNING", "SUCCEEDED", "FAILED", "STOPPING", "STOPPED"
3487
+ # resp.summaries[0].status #=> String, one of "RUNNING", "SUCCEEDED", "FAILED", "STOPPING", "STOPPED", "QUEUED"
3415
3488
  # resp.summaries[0].creation_timestamp #=> Time
3416
3489
  # resp.summaries[0].end_timestamp #=> Time
3417
3490
  # resp.next_token #=> String
@@ -3466,6 +3539,9 @@ module Aws::CloudFormation
3466
3539
  # resp.summaries[0].stack_set_id #=> String
3467
3540
  # resp.summaries[0].description #=> String
3468
3541
  # resp.summaries[0].status #=> String, one of "ACTIVE", "DELETED"
3542
+ # resp.summaries[0].auto_deployment.enabled #=> Boolean
3543
+ # resp.summaries[0].auto_deployment.retain_stacks_on_account_removal #=> Boolean
3544
+ # resp.summaries[0].permission_model #=> String, one of "SERVICE_MANAGED", "SELF_MANAGED"
3469
3545
  # resp.summaries[0].drift_status #=> String, one of "DRIFTED", "IN_SYNC", "UNKNOWN", "NOT_CHECKED"
3470
3546
  # resp.summaries[0].last_drift_check_timestamp #=> Time
3471
3547
  # resp.next_token #=> String
@@ -3534,26 +3610,30 @@ module Aws::CloudFormation
3534
3610
  req.send_request(options)
3535
3611
  end
3536
3612
 
3537
- # Returns a list of registration tokens for the specified type.
3613
+ # Returns a list of registration tokens for the specified type(s).
3538
3614
  #
3539
3615
  # @option params [String] :type
3540
3616
  # The kind of type.
3541
3617
  #
3542
3618
  # Currently the only valid value is `RESOURCE`.
3543
3619
  #
3620
+ # Conditional: You must specify either `TypeName` and `Type`, or `Arn`.
3621
+ #
3544
3622
  # @option params [String] :type_name
3545
3623
  # The name of the type.
3546
3624
  #
3547
- # Conditional: You must specify `TypeName` or `Arn`.
3625
+ # Conditional: You must specify either `TypeName` and `Type`, or `Arn`.
3548
3626
  #
3549
3627
  # @option params [String] :type_arn
3550
3628
  # The Amazon Resource Name (ARN) of the type.
3551
3629
  #
3552
- # Conditional: You must specify `TypeName` or `Arn`.
3630
+ # Conditional: You must specify either `TypeName` and `Type`, or `Arn`.
3553
3631
  #
3554
3632
  # @option params [String] :registration_status_filter
3555
3633
  # The current status of the type registration request.
3556
3634
  #
3635
+ # The default is `IN_PROGRESS`.
3636
+ #
3557
3637
  # @option params [Integer] :max_results
3558
3638
  # The maximum number of results to be returned with a single call. If
3559
3639
  # the number of available results exceeds this maximum, the response
@@ -3606,16 +3686,18 @@ module Aws::CloudFormation
3606
3686
  #
3607
3687
  # Currently the only valid value is `RESOURCE`.
3608
3688
  #
3689
+ # Conditional: You must specify either `TypeName` and `Type`, or `Arn`.
3690
+ #
3609
3691
  # @option params [String] :type_name
3610
3692
  # The name of the type for which you want version summary information.
3611
3693
  #
3612
- # Conditional: You must specify `TypeName` or `Arn`.
3694
+ # Conditional: You must specify either `TypeName` and `Type`, or `Arn`.
3613
3695
  #
3614
3696
  # @option params [String] :arn
3615
3697
  # The Amazon Resource Name (ARN) of the type for which you want version
3616
3698
  # summary information.
3617
3699
  #
3618
- # Conditional: You must specify `TypeName` or `Arn`.
3700
+ # Conditional: You must specify either `TypeName` and `Type`, or `Arn`.
3619
3701
  #
3620
3702
  # @option params [Integer] :max_results
3621
3703
  # The maximum number of results to be returned with a single call. If
@@ -3644,6 +3726,8 @@ module Aws::CloudFormation
3644
3726
  # * `DEPRECATED`\: The type version has been deregistered and can no
3645
3727
  # longer be used in CloudFormation operations.
3646
3728
  #
3729
+ # The default is `LIVE`.
3730
+ #
3647
3731
  # @return [Types::ListTypeVersionsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
3648
3732
  #
3649
3733
  # * {Types::ListTypeVersionsOutput#type_version_summaries #type_version_summaries} => Array&lt;Types::TypeVersionSummary&gt;
@@ -3696,6 +3780,8 @@ module Aws::CloudFormation
3696
3780
  # * `PUBLIC`\: The type is publically visible and usable within any
3697
3781
  # Amazon account.
3698
3782
  #
3783
+ # The default is `PRIVATE`.
3784
+ #
3699
3785
  # @option params [String] :provisioning_type
3700
3786
  # The provisioning behavior of the type. AWS CloudFormation determines
3701
3787
  # the provisioning type during registration, based on the types of
@@ -3866,14 +3952,17 @@ module Aws::CloudFormation
3866
3952
  # * Making the resource type available for use in your account
3867
3953
  #
3868
3954
  # For more information on how to develop types and ready them for
3869
- # registeration, see [Creating Resource
3870
- # Providers](cloudformation-cli/latest/userguide/resource-types.html) in
3871
- # the *CloudFormation CLI User Guide*.
3955
+ # registeration, see [Creating Resource Providers][1] in the
3956
+ # *CloudFormation CLI User Guide*.
3872
3957
  #
3873
3958
  # Once you have initiated a registration request using ` RegisterType `,
3874
3959
  # you can use ` DescribeTypeRegistration ` to monitor the progress of
3875
3960
  # the registration request.
3876
3961
  #
3962
+ #
3963
+ #
3964
+ # [1]: https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/resource-types.html
3965
+ #
3877
3966
  # @option params [String] :type
3878
3967
  # The kind of type.
3879
3968
  #
@@ -3911,9 +4000,18 @@ module Aws::CloudFormation
3911
4000
  # you want to register, see [submit][1] in the *CloudFormation CLI User
3912
4001
  # Guide*.
3913
4002
  #
4003
+ # <note markdown="1"> As part of registering a resource provider type, CloudFormation must
4004
+ # be able to access the S3 bucket which contains the schema handler
4005
+ # package for that resource provider. For more information, see [IAM
4006
+ # Permissions for Registering a Resource Provider][2] in the *AWS
4007
+ # CloudFormation User Guide*.
4008
+ #
4009
+ # </note>
4010
+ #
3914
4011
  #
3915
4012
  #
3916
4013
  # [1]: https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/resource-type-cli-submit.html
4014
+ # [2]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/registry.html#registry-register-permissions
3917
4015
  #
3918
4016
  # @option params [Types::LoggingConfig] :logging_config
3919
4017
  # Specifies logging configuration information for a type.
@@ -4013,15 +4111,17 @@ module Aws::CloudFormation
4013
4111
  # The Amazon Resource Name (ARN) of the type for which you want version
4014
4112
  # summary information.
4015
4113
  #
4016
- # Conditional: You must specify `TypeName` or `Arn`.
4114
+ # Conditional: You must specify either `TypeName` and `Type`, or `Arn`.
4017
4115
  #
4018
4116
  # @option params [String] :type
4019
4117
  # The kind of type.
4020
4118
  #
4119
+ # Conditional: You must specify either `TypeName` and `Type`, or `Arn`.
4120
+ #
4021
4121
  # @option params [String] :type_name
4022
4122
  # The name of the type.
4023
4123
  #
4024
- # Conditional: You must specify `TypeName` or `Arn`.
4124
+ # Conditional: You must specify either `TypeName` and `Type`, or `Arn`.
4025
4125
  #
4026
4126
  # @option params [String] :version_id
4027
4127
  # The ID of a specific version of the type. The version ID is the value
@@ -4475,11 +4575,23 @@ module Aws::CloudFormation
4475
4575
  # The name or unique ID of the stack set associated with the stack
4476
4576
  # instances.
4477
4577
  #
4478
- # @option params [required, Array<String>] :accounts
4479
- # The names of one or more AWS accounts for which you want to update
4480
- # parameter values for stack instances. The overridden parameter values
4481
- # will be applied to all stack instances in the specified accounts and
4482
- # regions.
4578
+ # @option params [Array<String>] :accounts
4579
+ # \[Self-managed permissions\] The names of one or more AWS accounts for
4580
+ # which you want to update parameter values for stack instances. The
4581
+ # overridden parameter values will be applied to all stack instances in
4582
+ # the specified accounts and regions.
4583
+ #
4584
+ # You can specify `Accounts` or `DeploymentTargets`, but not both.
4585
+ #
4586
+ # @option params [Types::DeploymentTargets] :deployment_targets
4587
+ # \[`Service-managed` permissions\] The AWS Organizations accounts for
4588
+ # which you want to update parameter values for stack instances. If your
4589
+ # update targets OUs, the overridden parameter values only apply to the
4590
+ # accounts that are currently in the target OUs and their child OUs.
4591
+ # Accounts added to the target OUs and their child OUs in the future
4592
+ # won't use the overridden values.
4593
+ #
4594
+ # You can specify `Accounts` or `DeploymentTargets`, but not both.
4483
4595
  #
4484
4596
  # @option params [required, Array<String>] :regions
4485
4597
  # The names of one or more regions in which you want to update parameter
@@ -4558,7 +4670,11 @@ module Aws::CloudFormation
4558
4670
  #
4559
4671
  # resp = client.update_stack_instances({
4560
4672
  # stack_set_name: "StackSetNameOrId", # required
4561
- # accounts: ["Account"], # required
4673
+ # accounts: ["Account"],
4674
+ # deployment_targets: {
4675
+ # accounts: ["Account"],
4676
+ # organizational_unit_ids: ["OrganizationalUnitId"],
4677
+ # },
4562
4678
  # regions: ["Region"], # required
4563
4679
  # parameter_overrides: [
4564
4680
  # {
@@ -4785,6 +4901,49 @@ module Aws::CloudFormation
4785
4901
  # previously associated with the stack set, so long as you have
4786
4902
  # permissions to perform operations on the stack set.
4787
4903
  #
4904
+ # @option params [Types::DeploymentTargets] :deployment_targets
4905
+ # \[`Service-managed` permissions\] The AWS Organizations accounts in
4906
+ # which to update associated stack instances.
4907
+ #
4908
+ # To update all the stack instances associated with this stack set, do
4909
+ # not specify `DeploymentTargets` or `Regions`.
4910
+ #
4911
+ # If the stack set update includes changes to the template (that is, if
4912
+ # `TemplateBody` or `TemplateURL` is specified), or the `Parameters`,
4913
+ # AWS CloudFormation marks all stack instances with a status of
4914
+ # `OUTDATED` prior to updating the stack instances in the specified
4915
+ # accounts and Regions. If the stack set update does not include changes
4916
+ # to the template or parameters, AWS CloudFormation updates the stack
4917
+ # instances in the specified accounts and Regions, while leaving all
4918
+ # other stack instances with their existing stack instance status.
4919
+ #
4920
+ # @option params [String] :permission_model
4921
+ # Describes how the IAM roles required for stack set operations are
4922
+ # created. You cannot modify `PermissionModel` if there are stack
4923
+ # instances associated with your stack set.
4924
+ #
4925
+ # * With `self-managed` permissions, you must create the administrator
4926
+ # and execution roles required to deploy to target accounts. For more
4927
+ # information, see [Grant Self-Managed Stack Set Permissions][1].
4928
+ #
4929
+ # * With `service-managed` permissions, StackSets automatically creates
4930
+ # the IAM roles required to deploy to accounts managed by AWS
4931
+ # Organizations. For more information, see [Grant Service-Managed
4932
+ # Stack Set Permissions][2].
4933
+ #
4934
+ #
4935
+ #
4936
+ # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-prereqs-self-managed.html
4937
+ # [2]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-prereqs-service-managed.html
4938
+ #
4939
+ # @option params [Types::AutoDeployment] :auto_deployment
4940
+ # \[`Service-managed` permissions\] Describes whether StackSets
4941
+ # automatically deploys to AWS Organizations accounts that are added to
4942
+ # a target organization or organizational unit (OU).
4943
+ #
4944
+ # If you specify `AutoDeployment`, do not specify `DeploymentTargets` or
4945
+ # `Regions`.
4946
+ #
4788
4947
  # @option params [String] :operation_id
4789
4948
  # The unique ID for this stack set operation.
4790
4949
  #
@@ -4804,9 +4963,9 @@ module Aws::CloudFormation
4804
4963
  # not need to pass this option.**
4805
4964
  #
4806
4965
  # @option params [Array<String>] :accounts
4807
- # The accounts in which to update associated stack instances. If you
4808
- # specify accounts, you must also specify the regions in which to update
4809
- # stack set instances.
4966
+ # \[Self-managed permissions\] The accounts in which to update
4967
+ # associated stack instances. If you specify accounts, you must also
4968
+ # specify the regions in which to update stack set instances.
4810
4969
  #
4811
4970
  # To update *all* the stack instances associated with this stack set, do
4812
4971
  # not specify the `Accounts` or `Regions` properties.
@@ -4875,6 +5034,15 @@ module Aws::CloudFormation
4875
5034
  # },
4876
5035
  # administration_role_arn: "RoleARN",
4877
5036
  # execution_role_name: "ExecutionRoleName",
5037
+ # deployment_targets: {
5038
+ # accounts: ["Account"],
5039
+ # organizational_unit_ids: ["OrganizationalUnitId"],
5040
+ # },
5041
+ # permission_model: "SERVICE_MANAGED", # accepts SERVICE_MANAGED, SELF_MANAGED
5042
+ # auto_deployment: {
5043
+ # enabled: false,
5044
+ # retain_stacks_on_account_removal: false,
5045
+ # },
4878
5046
  # operation_id: "ClientRequestToken",
4879
5047
  # accounts: ["Account"],
4880
5048
  # regions: ["Region"],
@@ -5019,7 +5187,7 @@ module Aws::CloudFormation
5019
5187
  params: params,
5020
5188
  config: config)
5021
5189
  context[:gem_name] = 'aws-sdk-cloudformation'
5022
- context[:gem_version] = '1.29.0'
5190
+ context[:gem_version] = '1.30.0'
5023
5191
  Seahorse::Client::Request.new(handlers, context)
5024
5192
  end
5025
5193