aws-sdk-cloudformation 1.29.0 → 1.30.0

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