aws-sdk-cloudformation 1.134.0 → 1.150.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.
@@ -11,20 +11,20 @@ module Aws::CloudFormation
11
11
  module Types
12
12
 
13
13
  # Structure that contains the results of the account gate function which
14
- # CloudFormation invokes, if present, before proceeding with a stack set
14
+ # CloudFormation invokes, if present, before proceeding with a StackSet
15
15
  # operation in an account and Region.
16
16
  #
17
17
  # For each account and Region, CloudFormation lets you specify a Lambda
18
18
  # function that encapsulates any requirements that must be met before
19
- # CloudFormation can proceed with a stack set operation in that account
20
- # and Region. CloudFormation invokes the function each time a stack set
19
+ # CloudFormation can proceed with a StackSet operation in that account
20
+ # and Region. CloudFormation invokes the function each time a StackSet
21
21
  # operation is requested for that account and Region; if the function
22
22
  # returns `FAILED`, CloudFormation cancels the operation in that account
23
- # and Region, and sets the stack set operation result status for that
23
+ # and Region, and sets the StackSet operation result status for that
24
24
  # account and Region to `FAILED`.
25
25
  #
26
- # For more information, see [Configuring a target account gate in
27
- # StackSets][1] in the *CloudFormation User Guide*.
26
+ # For more information, see [Prevent failed StackSets deployments using
27
+ # target account gates][1] in the *CloudFormation User Guide*.
28
28
  #
29
29
  #
30
30
  #
@@ -34,37 +34,37 @@ module Aws::CloudFormation
34
34
  # The status of the account gate function.
35
35
  #
36
36
  # * `SUCCEEDED`: The account gate function has determined that the
37
- # account and Region passes any requirements for a stack set
37
+ # account and Region passes any requirements for a StackSet
38
38
  # operation to occur. CloudFormation proceeds with the stack
39
39
  # operation in that account and Region.
40
40
  #
41
41
  # * `FAILED`: The account gate function has determined that the
42
- # account and Region doesn't meet the requirements for a stack set
43
- # operation to occur. CloudFormation cancels the stack set operation
44
- # in that account and Region, and sets the stack set operation
45
- # result status for that account and Region to `FAILED`.
42
+ # account and Region doesn't meet the requirements for a StackSet
43
+ # operation to occur. CloudFormation cancels the StackSet operation
44
+ # in that account and Region, and sets the StackSet operation result
45
+ # status for that account and Region to `FAILED`.
46
46
  #
47
47
  # * `SKIPPED`: CloudFormation has skipped calling the account gate
48
48
  # function for this account and Region, for one of the following
49
49
  # reasons:
50
50
  #
51
51
  # * An account gate function hasn't been specified for the account
52
- # and Region. CloudFormation proceeds with the stack set operation
52
+ # and Region. CloudFormation proceeds with the StackSet operation
53
53
  # in this account and Region.
54
54
  #
55
- # * The `AWSCloudFormationStackSetExecutionRole` of the stack set
55
+ # * The `AWSCloudFormationStackSetExecutionRole` of the
56
56
  # administration account lacks permissions to invoke the function.
57
- # CloudFormation proceeds with the stack set operation in this
57
+ # CloudFormation proceeds with the StackSet operation in this
58
58
  # account and Region.
59
59
  #
60
60
  # * Either no action is necessary, or no action is possible, on the
61
- # stack. CloudFormation skips the stack set operation in this
61
+ # stack. CloudFormation skips the StackSet operation in this
62
62
  # account and Region.
63
63
  # @return [String]
64
64
  #
65
65
  # @!attribute [rw] status_reason
66
66
  # The reason for the account gate status assigned to this account and
67
- # Region for the stack set operation.
67
+ # Region for the StackSet operation.
68
68
  # @return [String]
69
69
  #
70
70
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/AccountGateResult AWS API Documentation
@@ -76,7 +76,7 @@ module Aws::CloudFormation
76
76
  include Aws::Structure
77
77
  end
78
78
 
79
- # The AccountLimit data type.
79
+ # Describes the current CloudFormation limits for your account.
80
80
  #
81
81
  # CloudFormation has the following limits per account:
82
82
  #
@@ -86,9 +86,8 @@ module Aws::CloudFormation
86
86
  #
87
87
  # * Number of stack outputs
88
88
  #
89
- # For more information about these account limits, and other
90
- # CloudFormation limits, see [Understand CloudFormation quotas][1] in
91
- # the *CloudFormation User Guide*.
89
+ # For more information, see [Understand CloudFormation quotas][1] in the
90
+ # *CloudFormation User Guide*.
92
91
  #
93
92
  #
94
93
  #
@@ -153,7 +152,7 @@ module Aws::CloudFormation
153
152
  # @return [String]
154
153
  #
155
154
  # @!attribute [rw] type_name_alias
156
- # An alias to assign to the public extension, in this account and
155
+ # An alias to assign to the public extension in this account and
157
156
  # Region. If you specify an alias for the extension, CloudFormation
158
157
  # treats the alias as the extension type name within this account and
159
158
  # Region. You must use the alias to refer to the extension in your
@@ -220,7 +219,7 @@ module Aws::CloudFormation
220
219
  end
221
220
 
222
221
  # @!attribute [rw] arn
223
- # The Amazon Resource Name (ARN) of the activated extension, in this
222
+ # The Amazon Resource Name (ARN) of the activated extension in this
224
223
  # account and Region.
225
224
  # @return [String]
226
225
  #
@@ -238,9 +237,63 @@ module Aws::CloudFormation
238
237
  #
239
238
  class AlreadyExistsException < Aws::EmptyStructure; end
240
239
 
241
- # \[Service-managed permissions\] Describes whether StackSets
242
- # automatically deploys to Organizations accounts that are added to a
243
- # target organization or organizational unit (OU).
240
+ # The `Annotation` data type.
241
+ #
242
+ # A `GetHookResult` call returns detailed information and remediation
243
+ # guidance from Control Tower, Guard, Lambda, or custom Hooks for a Hook
244
+ # invocation result.
245
+ #
246
+ # @!attribute [rw] annotation_name
247
+ # An identifier for the evaluation logic that was used when invoking
248
+ # the Hook. For Control Tower, this is the control ID. For Guard, this
249
+ # is the rule ID. For Lambda and custom Hooks, this is a user-defined
250
+ # identifier.
251
+ # @return [String]
252
+ #
253
+ # @!attribute [rw] status
254
+ # The status of the Hook invocation from the downstream service.
255
+ # @return [String]
256
+ #
257
+ # @!attribute [rw] status_message
258
+ # The explanation for the specific status assigned to this Hook
259
+ # invocation. For example, "Bucket does not block public access".
260
+ # @return [String]
261
+ #
262
+ # @!attribute [rw] remediation_message
263
+ # Suggests what to change if your Hook returns a `FAILED` status. For
264
+ # example, "Block public access to the bucket".
265
+ # @return [String]
266
+ #
267
+ # @!attribute [rw] remediation_link
268
+ # A URL that you can access for additional remediation guidance.
269
+ # @return [String]
270
+ #
271
+ # @!attribute [rw] severity_level
272
+ # The relative risk associated with any violations of this type.
273
+ # @return [String]
274
+ #
275
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/Annotation AWS API Documentation
276
+ #
277
+ class Annotation < Struct.new(
278
+ :annotation_name,
279
+ :status,
280
+ :status_message,
281
+ :remediation_message,
282
+ :remediation_link,
283
+ :severity_level)
284
+ SENSITIVE = []
285
+ include Aws::Structure
286
+ end
287
+
288
+ # Describes whether StackSets automatically deploys to Organizations
289
+ # accounts that are added to a target organization or organizational
290
+ # unit (OU). For more information, see [Enable or disable automatic
291
+ # deployments for StackSets in Organizations][1] in the *CloudFormation
292
+ # User Guide*.
293
+ #
294
+ #
295
+ #
296
+ # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-orgs-manage-auto-deployment.html
244
297
  #
245
298
  # @!attribute [rw] enabled
246
299
  # If set to `true`, StackSets automatically deploys additional stack
@@ -256,11 +309,19 @@ module Aws::CloudFormation
256
309
  # resources are deleted. Specify only if `Enabled` is set to `True`.
257
310
  # @return [Boolean]
258
311
  #
312
+ # @!attribute [rw] depends_on
313
+ # A list of StackSet ARNs that this StackSet depends on for
314
+ # auto-deployment operations. When auto-deployment is triggered,
315
+ # operations will be sequenced to ensure all dependencies complete
316
+ # successfully before this StackSet's operation begins.
317
+ # @return [Array<String>]
318
+ #
259
319
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/AutoDeployment AWS API Documentation
260
320
  #
261
321
  class AutoDeployment < Struct.new(
262
322
  :enabled,
263
- :retain_stacks_on_account_removal)
323
+ :retain_stacks_on_account_removal,
324
+ :depends_on)
264
325
  SENSITIVE = []
265
326
  include Aws::Structure
266
327
  end
@@ -409,14 +470,15 @@ module Aws::CloudFormation
409
470
  include Aws::Structure
410
471
  end
411
472
 
412
- # Specifies the resource, the hook, and the hook version to be invoked.
473
+ # Specifies the resource, the Hook, and the Hook version to be invoked.
413
474
  #
414
475
  # @!attribute [rw] invocation_point
415
- # Specifies the points in provisioning logic where a hook is invoked.
476
+ # The specific point in the provisioning process where the Hook is
477
+ # invoked.
416
478
  # @return [String]
417
479
  #
418
480
  # @!attribute [rw] failure_mode
419
- # Specify the hook failure mode for non-compliant resources in the
481
+ # Specify the Hook failure mode for non-compliant resources in the
420
482
  # followings ways.
421
483
  #
422
484
  # * `FAIL` Stops provisioning resources.
@@ -425,12 +487,12 @@ module Aws::CloudFormation
425
487
  # @return [String]
426
488
  #
427
489
  # @!attribute [rw] type_name
428
- # The unique name for your hook. Specifies a three-part namespace for
429
- # your hook, with a recommended pattern of
490
+ # The unique name for your Hook. Specifies a three-part namespace for
491
+ # your Hook, with a recommended pattern of
430
492
  # `Organization::Service::Hook`.
431
493
  #
432
494
  # <note markdown="1"> The following organization namespaces are reserved and can't be
433
- # used in your hook type names:
495
+ # used in your Hook type names:
434
496
  #
435
497
  # * `Alexa`
436
498
  #
@@ -458,7 +520,7 @@ module Aws::CloudFormation
458
520
  # @return [String]
459
521
  #
460
522
  # @!attribute [rw] target_details
461
- # Specifies details about the target that the hook will run against.
523
+ # Specifies details about the target that the Hook will run against.
462
524
  # @return [Types::ChangeSetHookTargetDetails]
463
525
  #
464
526
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/ChangeSetHook AWS API Documentation
@@ -499,10 +561,10 @@ module Aws::CloudFormation
499
561
  include Aws::Structure
500
562
  end
501
563
 
502
- # Specifies target details for an activated hook.
564
+ # Specifies target details for an activated Hook.
503
565
  #
504
566
  # @!attribute [rw] target_type
505
- # The name of the type.
567
+ # The Hook target type.
506
568
  # @return [String]
507
569
  #
508
570
  # @!attribute [rw] resource_target_details
@@ -732,7 +794,9 @@ module Aws::CloudFormation
732
794
  # CloudFormation generates the change set by comparing this template
733
795
  # with the template of the stack that you specified.
734
796
  #
735
- # Conditional: You must specify only `TemplateBody` or `TemplateURL`.
797
+ # Conditional: You must specify only one of the following parameters:
798
+ # `TemplateBody`, `TemplateURL`, or set the `UsePreviousTemplate` to
799
+ # `true`.
736
800
  # @return [String]
737
801
  #
738
802
  # @!attribute [rw] template_url
@@ -743,12 +807,28 @@ module Aws::CloudFormation
743
807
  # specified. The location for an Amazon S3 bucket must start with
744
808
  # `https://`. URLs from S3 static websites are not supported.
745
809
  #
746
- # Conditional: You must specify only `TemplateBody` or `TemplateURL`.
810
+ # Conditional: You must specify only one of the following parameters:
811
+ # `TemplateBody`, `TemplateURL`, or set the `UsePreviousTemplate` to
812
+ # `true`.
747
813
  # @return [String]
748
814
  #
749
815
  # @!attribute [rw] use_previous_template
750
816
  # Whether to reuse the template that's associated with the stack to
751
817
  # create the change set.
818
+ #
819
+ # When using templates with the `AWS::LanguageExtensions` transform,
820
+ # provide the template instead of using `UsePreviousTemplate` to
821
+ # ensure new parameter values and Systems Manager parameter updates
822
+ # are applied correctly. For more information, see
823
+ # [AWS::LanguageExtensions transform][1].
824
+ #
825
+ # Conditional: You must specify only one of the following parameters:
826
+ # `TemplateBody`, `TemplateURL`, or set the `UsePreviousTemplate` to
827
+ # `true`.
828
+ #
829
+ #
830
+ #
831
+ # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/transform-aws-languageextensions.html
752
832
  # @return [Boolean]
753
833
  #
754
834
  # @!attribute [rw] parameters
@@ -764,7 +844,7 @@ module Aws::CloudFormation
764
844
  # * `CAPABILITY_IAM` and `CAPABILITY_NAMED_IAM`
765
845
  #
766
846
  # Some stack templates might include resources that can affect
767
- # permissions in your Amazon Web Services account; for example, by
847
+ # permissions in your Amazon Web Services account, for example, by
768
848
  # creating new IAM users. For those stacks, you must explicitly
769
849
  # acknowledge this by specifying one of these capabilities.
770
850
  #
@@ -850,16 +930,15 @@ module Aws::CloudFormation
850
930
  # @return [Array<String>]
851
931
  #
852
932
  # @!attribute [rw] resource_types
853
- # The template resource types that you have permissions to work with
854
- # if you execute this change set, such as `AWS::EC2::Instance`,
855
- # `AWS::EC2::*`, or `Custom::MyCustomInstance`.
933
+ # Specifies which resource types you can work with, such as
934
+ # `AWS::EC2::Instance` or `Custom::MyCustomInstance`.
856
935
  #
857
936
  # If the list of resource types doesn't include a resource type that
858
937
  # you're updating, the stack update fails. By default, CloudFormation
859
938
  # grants permissions to all resource types. IAM uses this parameter
860
939
  # for condition keys in IAM policies for CloudFormation. For more
861
- # information, see [Control access with Identity and Access
862
- # Management][1] in the *CloudFormation User Guide*.
940
+ # information, see [Control CloudFormation access with Identity and
941
+ # Access Management][1] in the *CloudFormation User Guide*.
863
942
  #
864
943
  # <note markdown="1"> Only one of the `Capabilities` and `ResourceType` parameters can be
865
944
  # specified.
@@ -1000,6 +1079,25 @@ module Aws::CloudFormation
1000
1079
  # [2]: https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-properties-name.html
1001
1080
  # @return [Boolean]
1002
1081
  #
1082
+ # @!attribute [rw] deployment_mode
1083
+ # Determines how CloudFormation handles configuration drift during
1084
+ # deployment.
1085
+ #
1086
+ # * `REVERT_DRIFT` – Creates a drift-aware change set that brings
1087
+ # actual resource states in line with template definitions. Provides
1088
+ # a three-way comparison between actual state, previous deployment
1089
+ # state, and desired state.
1090
+ #
1091
+ # ^
1092
+ #
1093
+ # For more information, see [Using drift-aware change sets][1] in the
1094
+ # *CloudFormation User Guide*.
1095
+ #
1096
+ #
1097
+ #
1098
+ # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/drift-aware-change-sets.html
1099
+ # @return [String]
1100
+ #
1003
1101
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateChangeSetInput AWS API Documentation
1004
1102
  #
1005
1103
  class CreateChangeSetInput < Struct.new(
@@ -1021,7 +1119,8 @@ module Aws::CloudFormation
1021
1119
  :resources_to_import,
1022
1120
  :include_nested_stacks,
1023
1121
  :on_stack_failure,
1024
- :import_existing_resources)
1122
+ :import_existing_resources,
1123
+ :deployment_mode)
1025
1124
  SENSITIVE = []
1026
1125
  include Aws::Structure
1027
1126
  end
@@ -1254,22 +1353,15 @@ module Aws::CloudFormation
1254
1353
  # @return [Array<String>]
1255
1354
  #
1256
1355
  # @!attribute [rw] resource_types
1257
- # The template resource types that you have permissions to work with
1258
- # for this create stack action, such as `AWS::EC2::Instance`,
1259
- # `AWS::EC2::*`, or `Custom::MyCustomInstance`. Use the following
1260
- # syntax to describe template resource types: `AWS::*` (for all Amazon
1261
- # Web Services resources), `Custom::*` (for all custom resources),
1262
- # `Custom::logical_ID ` (for a specific custom resource),
1263
- # `AWS::service_name::*` (for all resources of a particular Amazon Web
1264
- # Services service), and `AWS::service_name::resource_logical_ID `
1265
- # (for a specific Amazon Web Services resource).
1356
+ # Specifies which resource types you can work with, such as
1357
+ # `AWS::EC2::Instance` or `Custom::MyCustomInstance`.
1266
1358
  #
1267
1359
  # If the list of resource types doesn't include a resource that
1268
1360
  # you're creating, the stack creation fails. By default,
1269
1361
  # CloudFormation grants permissions to all resource types. IAM uses
1270
1362
  # this parameter for CloudFormation-specific condition keys in IAM
1271
- # policies. For more information, see [Control access with Identity
1272
- # and Access Management][1].
1363
+ # policies. For more information, see [Control CloudFormation access
1364
+ # with Identity and Access Management][1].
1273
1365
  #
1274
1366
  # <note markdown="1"> Only one of the `Capabilities` and `ResourceType` parameters can be
1275
1367
  # specified.
@@ -1301,6 +1393,14 @@ module Aws::CloudFormation
1301
1393
  # must be one of: `DO_NOTHING`, `ROLLBACK`, or `DELETE`. You can
1302
1394
  # specify either `OnFailure` or `DisableRollback`, but not both.
1303
1395
  #
1396
+ # <note markdown="1"> Although the default setting is `ROLLBACK`, there is one exception.
1397
+ # This exception occurs when a StackSet attempts to deploy a stack
1398
+ # instance and the stack instance fails to create successfully. In
1399
+ # this case, the `CreateStack` call overrides the default setting and
1400
+ # sets the value of `OnFailure` to `DELETE`.
1401
+ #
1402
+ # </note>
1403
+ #
1304
1404
  # Default: `ROLLBACK`
1305
1405
  # @return [String]
1306
1406
  #
@@ -1405,7 +1505,7 @@ module Aws::CloudFormation
1405
1505
  end
1406
1506
 
1407
1507
  # @!attribute [rw] stack_set_name
1408
- # The name or unique ID of the stack set that you want to create stack
1508
+ # The name or unique ID of the StackSet that you want to create stack
1409
1509
  # instances from.
1410
1510
  # @return [String]
1411
1511
  #
@@ -1418,7 +1518,7 @@ module Aws::CloudFormation
1418
1518
  # @return [Array<String>]
1419
1519
  #
1420
1520
  # @!attribute [rw] deployment_targets
1421
- # \[Service-managed permissions\] The Organizations accounts for which
1521
+ # \[Service-managed permissions\] The Organizations accounts in which
1422
1522
  # to create stack instances in the specified Amazon Web Services
1423
1523
  # Regions.
1424
1524
  #
@@ -1432,7 +1532,7 @@ module Aws::CloudFormation
1432
1532
  # @return [Array<String>]
1433
1533
  #
1434
1534
  # @!attribute [rw] parameter_overrides
1435
- # A list of stack set parameters whose values you want to override in
1535
+ # A list of StackSet parameters whose values you want to override in
1436
1536
  # the selected stack instances.
1437
1537
  #
1438
1538
  # Any overridden parameter values will be applied to all stack
@@ -1449,18 +1549,18 @@ module Aws::CloudFormation
1449
1549
  # can't specify both a value and set `UsePreviousValue` to `true`.)
1450
1550
  #
1451
1551
  # * To set an overridden parameter back to the value specified in the
1452
- # stack set, specify a parameter list but don't include the
1552
+ # StackSet, specify a parameter list but don't include the
1453
1553
  # parameter in the list.
1454
1554
  #
1455
1555
  # * To leave all parameters set to their present values, don't
1456
1556
  # specify this property at all.
1457
1557
  #
1458
- # During stack set updates, any parameter values overridden for a
1459
- # stack instance aren't updated, but retain their overridden value.
1558
+ # During StackSet updates, any parameter values overridden for a stack
1559
+ # instance aren't updated, but retain their overridden value.
1460
1560
  #
1461
1561
  # You can only override the parameter *values* that are specified in
1462
- # the stack set; to add or delete a parameter itself, use
1463
- # [UpdateStackSet][1] to update the stack set template.
1562
+ # the StackSet; to add or delete a parameter itself, use
1563
+ # [UpdateStackSet][1] to update the StackSet template.
1464
1564
  #
1465
1565
  #
1466
1566
  #
@@ -1468,23 +1568,22 @@ module Aws::CloudFormation
1468
1568
  # @return [Array<Types::Parameter>]
1469
1569
  #
1470
1570
  # @!attribute [rw] operation_preferences
1471
- # Preferences for how CloudFormation performs this stack set
1472
- # operation.
1571
+ # Preferences for how CloudFormation performs this StackSet operation.
1473
1572
  # @return [Types::StackSetOperationPreferences]
1474
1573
  #
1475
1574
  # @!attribute [rw] operation_id
1476
- # The unique identifier for this stack set operation.
1575
+ # The unique identifier for this StackSet operation.
1477
1576
  #
1478
1577
  # The operation ID also functions as an idempotency token, to ensure
1479
- # that CloudFormation performs the stack set operation only once, even
1480
- # if you retry the request multiple times. You might retry stack set
1578
+ # that CloudFormation performs the StackSet operation only once, even
1579
+ # if you retry the request multiple times. You might retry StackSet
1481
1580
  # operation requests to ensure that CloudFormation successfully
1482
1581
  # received them.
1483
1582
  #
1484
1583
  # If you don't specify an operation ID, the SDK generates one
1485
1584
  # automatically.
1486
1585
  #
1487
- # Repeating this stack set operation with a new operation ID retries
1586
+ # Repeating this StackSet operation with a new operation ID retries
1488
1587
  # all stack instances whose status is `OUTDATED`.
1489
1588
  #
1490
1589
  # **A suitable default value is auto-generated.** You should normally
@@ -1496,7 +1595,7 @@ module Aws::CloudFormation
1496
1595
  # an account administrator in the organization's management account
1497
1596
  # or as a delegated administrator in a member account.
1498
1597
  #
1499
- # By default, `SELF` is specified. Use `SELF` for stack sets with
1598
+ # By default, `SELF` is specified. Use `SELF` for StackSets with
1500
1599
  # self-managed permissions.
1501
1600
  #
1502
1601
  # * If you are signed in to the management account, specify `SELF`.
@@ -1530,7 +1629,7 @@ module Aws::CloudFormation
1530
1629
  end
1531
1630
 
1532
1631
  # @!attribute [rw] operation_id
1533
- # The unique identifier for this stack set operation.
1632
+ # The unique identifier for this StackSet operation.
1534
1633
  # @return [String]
1535
1634
  #
1536
1635
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateStackInstancesOutput AWS API Documentation
@@ -1547,10 +1646,16 @@ module Aws::CloudFormation
1547
1646
  # Unique identifier of the stack.
1548
1647
  # @return [String]
1549
1648
  #
1649
+ # @!attribute [rw] operation_id
1650
+ # A unique identifier for this stack operation that can be used to
1651
+ # track the operation's progress and events.
1652
+ # @return [String]
1653
+ #
1550
1654
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateStackOutput AWS API Documentation
1551
1655
  #
1552
1656
  class CreateStackOutput < Struct.new(
1553
- :stack_id)
1657
+ :stack_id,
1658
+ :operation_id)
1554
1659
  SENSITIVE = []
1555
1660
  include Aws::Structure
1556
1661
  end
@@ -1597,8 +1702,8 @@ module Aws::CloudFormation
1597
1702
  end
1598
1703
 
1599
1704
  # @!attribute [rw] stack_set_name
1600
- # The name to associate with the stack set. The name must be unique in
1601
- # the Region where you create your stack set.
1705
+ # The name to associate with the StackSet. The name must be unique in
1706
+ # the Region where you create your StackSet.
1602
1707
  #
1603
1708
  # <note markdown="1"> A stack name can contain only alphanumeric characters
1604
1709
  # (case-sensitive) and hyphens. It must start with an alphabetic
@@ -1608,8 +1713,8 @@ module Aws::CloudFormation
1608
1713
  # @return [String]
1609
1714
  #
1610
1715
  # @!attribute [rw] description
1611
- # A description of the stack set. You can use the description to
1612
- # identify the stack set's purpose or other important information.
1716
+ # A description of the StackSet. You can use the description to
1717
+ # identify the StackSet's purpose or other important information.
1613
1718
  # @return [String]
1614
1719
  #
1615
1720
  # @!attribute [rw] template_body
@@ -1632,24 +1737,24 @@ module Aws::CloudFormation
1632
1737
  # @return [String]
1633
1738
  #
1634
1739
  # @!attribute [rw] stack_id
1635
- # The stack ID you are importing into a new stack set. Specify the
1740
+ # The stack ID you are importing into a new StackSet. Specify the
1636
1741
  # Amazon Resource Name (ARN) of the stack.
1637
1742
  # @return [String]
1638
1743
  #
1639
1744
  # @!attribute [rw] parameters
1640
- # The input parameters for the stack set template.
1745
+ # The input parameters for the StackSet template.
1641
1746
  # @return [Array<Types::Parameter>]
1642
1747
  #
1643
1748
  # @!attribute [rw] capabilities
1644
- # In some cases, you must explicitly acknowledge that your stack set
1749
+ # In some cases, you must explicitly acknowledge that your StackSet
1645
1750
  # template contains certain capabilities in order for CloudFormation
1646
- # to create the stack set and related stack instances.
1751
+ # to create the StackSet and related stack instances.
1647
1752
  #
1648
1753
  # * `CAPABILITY_IAM` and `CAPABILITY_NAMED_IAM`
1649
1754
  #
1650
1755
  # Some stack templates might include resources that can affect
1651
1756
  # permissions in your Amazon Web Services account; for example, by
1652
- # creating new IAM users. For those stack sets, you must explicitly
1757
+ # creating new IAM users. For those StackSets, you must explicitly
1653
1758
  # acknowledge this by specifying one of these capabilities.
1654
1759
  #
1655
1760
  # The following IAM resources require you to specify either the
@@ -1684,21 +1789,21 @@ module Aws::CloudFormation
1684
1789
  #
1685
1790
  # * `CAPABILITY_AUTO_EXPAND`
1686
1791
  #
1687
- # Some templates reference macros. If your stack set template
1688
- # references one or more macros, you must create the stack set
1792
+ # Some templates reference macros. If your StackSet template
1793
+ # references one or more macros, you must create the StackSet
1689
1794
  # directly from the processed template, without first reviewing the
1690
- # resulting changes in a change set. To create the stack set
1795
+ # resulting changes in a change set. To create the StackSet
1691
1796
  # directly, you must acknowledge this capability. For more
1692
1797
  # information, see [Perform custom processing on CloudFormation
1693
1798
  # templates with template macros][9].
1694
1799
  #
1695
- # Stack sets with service-managed permissions don't currently
1800
+ # StackSets with service-managed permissions don't currently
1696
1801
  # support the use of macros in templates. (This includes the
1697
1802
  # [AWS::Include][10] and [AWS::Serverless][11] transforms, which are
1698
1803
  # macros hosted by CloudFormation.) Even if you specify this
1699
- # capability for a stack set with service-managed permissions, if
1700
- # you reference a macro in your template the stack set operation
1701
- # will fail.
1804
+ # capability for a StackSet with service-managed permissions, if you
1805
+ # reference a macro in your template the StackSet operation will
1806
+ # fail.
1702
1807
  #
1703
1808
  #
1704
1809
  #
@@ -1716,7 +1821,7 @@ module Aws::CloudFormation
1716
1821
  # @return [Array<String>]
1717
1822
  #
1718
1823
  # @!attribute [rw] tags
1719
- # The key-value pairs to associate with this stack set and the stacks
1824
+ # The key-value pairs to associate with this StackSet and the stacks
1720
1825
  # created from it. CloudFormation also propagates these tags to
1721
1826
  # supported resources that are created in the stacks. A maximum number
1722
1827
  # of 50 tags can be specified.
@@ -1724,18 +1829,18 @@ module Aws::CloudFormation
1724
1829
  # If you specify tags as part of a `CreateStackSet` action,
1725
1830
  # CloudFormation checks to see if you have the required IAM permission
1726
1831
  # to tag resources. If you don't, the entire `CreateStackSet` action
1727
- # fails with an `access denied` error, and the stack set is not
1832
+ # fails with an `access denied` error, and the StackSet is not
1728
1833
  # created.
1729
1834
  # @return [Array<Types::Tag>]
1730
1835
  #
1731
1836
  # @!attribute [rw] administration_role_arn
1732
1837
  # The Amazon Resource Name (ARN) of the IAM role to use to create this
1733
- # stack set.
1838
+ # StackSet.
1734
1839
  #
1735
1840
  # Specify an IAM role only if you are using customized administrator
1736
- # roles to control which users or groups can manage specific stack
1737
- # sets within the same administrator account. For more information,
1738
- # see [Grant self-managed permissions][1] in the *CloudFormation User
1841
+ # roles to control which users or groups can manage specific StackSets
1842
+ # within the same administrator account. For more information, see
1843
+ # [Grant self-managed permissions][1] in the *CloudFormation User
1739
1844
  # Guide*.
1740
1845
  #
1741
1846
  # Valid only if the permissions model is `SELF_MANAGED`.
@@ -1746,20 +1851,20 @@ module Aws::CloudFormation
1746
1851
  # @return [String]
1747
1852
  #
1748
1853
  # @!attribute [rw] execution_role_name
1749
- # The name of the IAM execution role to use to create the stack set.
1750
- # If you do not specify an execution role, CloudFormation uses the
1751
- # `AWSCloudFormationStackSetExecutionRole` role for the stack set
1854
+ # The name of the IAM execution role to use to create the StackSet. If
1855
+ # you do not specify an execution role, CloudFormation uses the
1856
+ # `AWSCloudFormationStackSetExecutionRole` role for the StackSet
1752
1857
  # operation.
1753
1858
  #
1754
1859
  # Specify an IAM role only if you are using customized execution roles
1755
1860
  # to control which stack resources users and groups can include in
1756
- # their stack sets.
1861
+ # their StackSets.
1757
1862
  #
1758
1863
  # Valid only if the permissions model is `SELF_MANAGED`.
1759
1864
  # @return [String]
1760
1865
  #
1761
1866
  # @!attribute [rw] permission_model
1762
- # Describes how the IAM roles required for stack set operations are
1867
+ # Describes how the IAM roles required for StackSet operations are
1763
1868
  # created. By default, `SELF-MANAGED` is specified.
1764
1869
  #
1765
1870
  # * With `self-managed` permissions, you must create the administrator
@@ -1769,7 +1874,7 @@ module Aws::CloudFormation
1769
1874
  # * With `service-managed` permissions, StackSets automatically
1770
1875
  # creates the IAM roles required to deploy to accounts managed by
1771
1876
  # Organizations. For more information, see [Activate trusted access
1772
- # for stack sets with Organizations][2].
1877
+ # for StackSets with Organizations][2].
1773
1878
  #
1774
1879
  #
1775
1880
  #
@@ -1780,9 +1885,9 @@ module Aws::CloudFormation
1780
1885
  # @!attribute [rw] auto_deployment
1781
1886
  # Describes whether StackSets automatically deploys to Organizations
1782
1887
  # accounts that are added to the target organization or organizational
1783
- # unit (OU). For more information, see [Manage automatic deployments
1784
- # for CloudFormation StackSets that use service-managed
1785
- # permissions][1] in the *CloudFormation User Guide*.
1888
+ # unit (OU). For more information, see [Enable or disable automatic
1889
+ # deployments for StackSets in Organizations][1] in the
1890
+ # *CloudFormation User Guide*.
1786
1891
  #
1787
1892
  # Required if the permissions model is `SERVICE_MANAGED`. (Not used
1788
1893
  # with self-managed permissions.)
@@ -1797,14 +1902,14 @@ module Aws::CloudFormation
1797
1902
  # organization's management account or as a delegated administrator
1798
1903
  # in a member account.
1799
1904
  #
1800
- # By default, `SELF` is specified. Use `SELF` for stack sets with
1905
+ # By default, `SELF` is specified. Use `SELF` for StackSets with
1801
1906
  # self-managed permissions.
1802
1907
  #
1803
- # * To create a stack set with service-managed permissions while
1804
- # signed in to the management account, specify `SELF`.
1908
+ # * To create a StackSet with service-managed permissions while signed
1909
+ # in to the management account, specify `SELF`.
1805
1910
  #
1806
- # * To create a stack set with service-managed permissions while
1807
- # signed in to a delegated administrator account, specify
1911
+ # * To create a StackSet with service-managed permissions while signed
1912
+ # in to a delegated administrator account, specify
1808
1913
  # `DELEGATED_ADMIN`.
1809
1914
  #
1810
1915
  # Your Amazon Web Services account must be registered as a delegated
@@ -1812,8 +1917,8 @@ module Aws::CloudFormation
1812
1917
  # [Register a delegated administrator][1] in the *CloudFormation
1813
1918
  # User Guide*.
1814
1919
  #
1815
- # Stack sets with service-managed permissions are created in the
1816
- # management account, including stack sets that are created by
1920
+ # StackSets with service-managed permissions are created in the
1921
+ # management account, including StackSets that are created by
1817
1922
  # delegated administrators.
1818
1923
  #
1819
1924
  # Valid only if the permissions model is `SERVICE_MANAGED`.
@@ -1826,8 +1931,8 @@ module Aws::CloudFormation
1826
1931
  # @!attribute [rw] client_request_token
1827
1932
  # A unique identifier for this `CreateStackSet` request. Specify this
1828
1933
  # token if you plan to retry requests so that CloudFormation knows
1829
- # that you're not attempting to create another stack set with the
1830
- # same name. You might retry `CreateStackSet` requests to ensure that
1934
+ # that you're not attempting to create another StackSet with the same
1935
+ # name. You might retry `CreateStackSet` requests to ensure that
1831
1936
  # CloudFormation successfully received them.
1832
1937
  #
1833
1938
  # If you don't specify an operation ID, the SDK generates one
@@ -1838,7 +1943,7 @@ module Aws::CloudFormation
1838
1943
  # @return [String]
1839
1944
  #
1840
1945
  # @!attribute [rw] managed_execution
1841
- # Describes whether StackSets performs non-conflicting operations
1946
+ # Describes whether CloudFormation performs non-conflicting operations
1842
1947
  # concurrently and queues conflicting operations.
1843
1948
  # @return [Types::ManagedExecution]
1844
1949
  #
@@ -1865,7 +1970,7 @@ module Aws::CloudFormation
1865
1970
  end
1866
1971
 
1867
1972
  # @!attribute [rw] stack_set_id
1868
- # The ID of the stack set that you're creating.
1973
+ # The ID of the StackSet that you're creating.
1869
1974
  # @return [String]
1870
1975
  #
1871
1976
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateStackSetOutput AWS API Documentation
@@ -1893,7 +1998,7 @@ module Aws::CloudFormation
1893
1998
  class DeactivateOrganizationsAccessOutput < Aws::EmptyStructure; end
1894
1999
 
1895
2000
  # @!attribute [rw] type_name
1896
- # The type name of the extension, in this account and Region. If you
2001
+ # The type name of the extension in this account and Region. If you
1897
2002
  # specified a type name alias when enabling the extension, use the
1898
2003
  # type name alias.
1899
2004
  #
@@ -1909,8 +2014,8 @@ module Aws::CloudFormation
1909
2014
  # @return [String]
1910
2015
  #
1911
2016
  # @!attribute [rw] arn
1912
- # The Amazon Resource Name (ARN) for the extension, in this account
1913
- # and Region.
2017
+ # The Amazon Resource Name (ARN) for the extension in this account and
2018
+ # Region.
1914
2019
  #
1915
2020
  # Conditional: You must specify either `Arn`, or `TypeName` and
1916
2021
  # `Type`.
@@ -2041,7 +2146,7 @@ module Aws::CloudFormation
2041
2146
  end
2042
2147
 
2043
2148
  # @!attribute [rw] stack_set_name
2044
- # The name or unique ID of the stack set that you want to delete stack
2149
+ # The name or unique ID of the StackSet that you want to delete stack
2045
2150
  # instances for.
2046
2151
  # @return [String]
2047
2152
  #
@@ -2060,40 +2165,39 @@ module Aws::CloudFormation
2060
2165
  # @return [Types::DeploymentTargets]
2061
2166
  #
2062
2167
  # @!attribute [rw] regions
2063
- # The Amazon Web Services Regions where you want to delete stack set
2168
+ # The Amazon Web Services Regions where you want to delete StackSet
2064
2169
  # instances.
2065
2170
  # @return [Array<String>]
2066
2171
  #
2067
2172
  # @!attribute [rw] operation_preferences
2068
- # Preferences for how CloudFormation performs this stack set
2069
- # operation.
2173
+ # Preferences for how CloudFormation performs this StackSet operation.
2070
2174
  # @return [Types::StackSetOperationPreferences]
2071
2175
  #
2072
2176
  # @!attribute [rw] retain_stacks
2073
- # Removes the stack instances from the specified stack set, but
2177
+ # Removes the stack instances from the specified StackSet, but
2074
2178
  # doesn't delete the stacks. You can't reassociate a retained stack
2075
2179
  # or add an existing, saved stack to a new stack set.
2076
2180
  #
2077
- # For more information, see [Stack set operation options][1].
2181
+ # For more information, see [StackSet operation options][1].
2078
2182
  #
2079
2183
  #
2080
2184
  #
2081
- # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/what-is-cfnstacksets.html#stackset-ops-options
2185
+ # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-concepts.html#stackset-ops-options
2082
2186
  # @return [Boolean]
2083
2187
  #
2084
2188
  # @!attribute [rw] operation_id
2085
- # The unique identifier for this stack set operation.
2189
+ # The unique identifier for this StackSet operation.
2086
2190
  #
2087
2191
  # If you don't specify an operation ID, the SDK generates one
2088
2192
  # automatically.
2089
2193
  #
2090
2194
  # The operation ID also functions as an idempotency token, to ensure
2091
- # that CloudFormation performs the stack set operation only once, even
2092
- # if you retry the request multiple times. You can retry stack set
2195
+ # that CloudFormation performs the StackSet operation only once, even
2196
+ # if you retry the request multiple times. You can retry StackSet
2093
2197
  # operation requests to ensure that CloudFormation successfully
2094
2198
  # received them.
2095
2199
  #
2096
- # Repeating this stack set operation with a new operation ID retries
2200
+ # Repeating this StackSet operation with a new operation ID retries
2097
2201
  # all stack instances whose status is `OUTDATED`.
2098
2202
  #
2099
2203
  # **A suitable default value is auto-generated.** You should normally
@@ -2105,7 +2209,7 @@ module Aws::CloudFormation
2105
2209
  # an account administrator in the organization's management account
2106
2210
  # or as a delegated administrator in a member account.
2107
2211
  #
2108
- # By default, `SELF` is specified. Use `SELF` for stack sets with
2212
+ # By default, `SELF` is specified. Use `SELF` for StackSets with
2109
2213
  # self-managed permissions.
2110
2214
  #
2111
2215
  # * If you are signed in to the management account, specify `SELF`.
@@ -2139,7 +2243,7 @@ module Aws::CloudFormation
2139
2243
  end
2140
2244
 
2141
2245
  # @!attribute [rw] operation_id
2142
- # The unique identifier for this stack set operation.
2246
+ # The unique identifier for this StackSet operation.
2143
2247
  # @return [String]
2144
2248
  #
2145
2249
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/DeleteStackInstancesOutput AWS API Documentation
@@ -2151,8 +2255,8 @@ module Aws::CloudFormation
2151
2255
  end
2152
2256
 
2153
2257
  # @!attribute [rw] stack_set_name
2154
- # The name or unique ID of the stack set that you're deleting. You
2155
- # can obtain this value by running ListStackSets.
2258
+ # The name or unique ID of the StackSet that you're deleting. You can
2259
+ # obtain this value by running ListStackSets.
2156
2260
  # @return [String]
2157
2261
  #
2158
2262
  # @!attribute [rw] call_as
@@ -2160,7 +2264,7 @@ module Aws::CloudFormation
2160
2264
  # an account administrator in the organization's management account
2161
2265
  # or as a delegated administrator in a member account.
2162
2266
  #
2163
- # By default, `SELF` is specified. Use `SELF` for stack sets with
2267
+ # By default, `SELF` is specified. Use `SELF` for StackSets with
2164
2268
  # self-managed permissions.
2165
2269
  #
2166
2270
  # * If you are signed in to the management account, specify `SELF`.
@@ -2191,19 +2295,26 @@ module Aws::CloudFormation
2191
2295
  #
2192
2296
  class DeleteStackSetOutput < Aws::EmptyStructure; end
2193
2297
 
2194
- # \[Service-managed permissions\] The Organizations accounts to which
2195
- # StackSets deploys. StackSets doesn't deploy stack instances to the
2196
- # organization management account, even if the organization management
2197
- # account is in your organization or in an OU in your organization.
2298
+ # Specifies the Organizations accounts where you want to create, update,
2299
+ # or delete stack instances. You can target either your entire
2300
+ # organization or specific accounts using organizational units (OUs) and
2301
+ # account filter options.
2198
2302
  #
2199
- # For update operations, you can specify either `Accounts` or
2200
- # `OrganizationalUnitIds`. For create and delete operations, specify
2201
- # `OrganizationalUnitIds`.
2303
+ # CloudFormation doesn't deploy stack instances to the organization
2304
+ # management account, even if the organization management account is in
2305
+ # your organization or in an OU in your organization.
2306
+ #
2307
+ # When performing create operations, if you specify both
2308
+ # `OrganizationalUnitIds` and `Accounts`, you must also specify the
2309
+ # `AccountFilterType` property.
2202
2310
  #
2203
2311
  # @!attribute [rw] accounts
2204
- # The account IDs of the Amazon Web Services accounts. If you have
2205
- # many account numbers, you can provide those accounts using the
2206
- # `AccountsUrl` property instead.
2312
+ # The Amazon Web Services account IDs where you want to perform stack
2313
+ # operations. How these accounts are used depends on the
2314
+ # `AccountFilterType` property.
2315
+ #
2316
+ # If you have many account numbers, you can provide those accounts
2317
+ # using the `AccountsUrl` property instead.
2207
2318
  # @return [Array<String>]
2208
2319
  #
2209
2320
  # @!attribute [rw] accounts_url
@@ -2212,36 +2323,44 @@ module Aws::CloudFormation
2212
2323
  # `.txt`, and the data can be comma-separated or new-line-separated.
2213
2324
  # There is currently a 10MB limit for the data (approximately 800,000
2214
2325
  # accounts).
2326
+ #
2327
+ # This property serves the same purpose as `Accounts` but allows you
2328
+ # to specify a large number of accounts.
2215
2329
  # @return [String]
2216
2330
  #
2217
2331
  # @!attribute [rw] organizational_unit_ids
2218
- # The organization root ID or organizational unit (OU) IDs.
2332
+ # The organization root ID or organizational unit (OU) IDs where you
2333
+ # want to perform stack operations. CloudFormation will perform
2334
+ # operations on accounts within these OUs and their child OUs.
2219
2335
  # @return [Array<String>]
2220
2336
  #
2221
2337
  # @!attribute [rw] account_filter_type
2222
- # Limit deployment targets to individual accounts or include
2223
- # additional accounts with provided OUs.
2224
- #
2225
- # The following is a list of possible values for the
2226
- # `AccountFilterType` operation.
2338
+ # Refines which accounts will have stack operations performed on them
2339
+ # by specifying how to use the `Accounts` and `OrganizationalUnitIds`
2340
+ # properties together.
2227
2341
  #
2228
- # * `INTERSECTION`: StackSets deploys to the accounts specified in
2229
- # `Accounts` parameter.
2342
+ # The following values determine how CloudFormation selects target
2343
+ # accounts:
2230
2344
  #
2231
- # * `DIFFERENCE`: StackSets excludes the accounts specified in
2232
- # `Accounts` parameter. This enables user to avoid certain accounts
2233
- # within an OU such as suspended accounts.
2345
+ # * `INTERSECTION`: Performs stack operations only on specific
2346
+ # individual accounts within the selected OUs. Only accounts that
2347
+ # are both specified in the `Accounts` property and belong to the
2348
+ # specified OUs will be targeted.
2234
2349
  #
2235
- # * `UNION`: StackSets includes additional accounts deployment
2236
- # targets.
2350
+ # * `DIFFERENCE`: Performs stack operations on all accounts in the
2351
+ # selected OUs except for specific accounts listed in the `Accounts`
2352
+ # property. This enables you to exclude certain accounts within an
2353
+ # OU, such as suspended accounts.
2237
2354
  #
2355
+ # * `UNION`: Performs stack operations on the specified OUs plus
2356
+ # additional individual accounts listed in the `Accounts` property.
2238
2357
  # This is the default value if `AccountFilterType` is not provided.
2239
- # This enables user to update an entire OU and individual accounts
2240
- # from a different OU in one request, which used to be two separate
2241
- # requests.
2358
+ # This lets you target an entire OU and individual accounts from a
2359
+ # different OU in one request. Note that `UNION` is not supported
2360
+ # for `CreateStackInstances` operations.
2242
2361
  #
2243
- # * `NONE`: Deploys to all the accounts in specified organizational
2244
- # units (OU).
2362
+ # * `NONE`: Performs stack operations on all accounts in the specified
2363
+ # organizational units (OUs).
2245
2364
  # @return [String]
2246
2365
  #
2247
2366
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/DeploymentTargets AWS API Documentation
@@ -2300,8 +2419,8 @@ module Aws::CloudFormation
2300
2419
  # The input for the DescribeAccountLimits action.
2301
2420
  #
2302
2421
  # @!attribute [rw] next_token
2303
- # A string that identifies the next page of limits that you want to
2304
- # retrieve.
2422
+ # The token for the next set of items to return. (You received this
2423
+ # token from a previous call.)
2305
2424
  # @return [String]
2306
2425
  #
2307
2426
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/DescribeAccountLimitsInput AWS API Documentation
@@ -2345,9 +2464,8 @@ module Aws::CloudFormation
2345
2464
  # @return [String]
2346
2465
  #
2347
2466
  # @!attribute [rw] next_token
2348
- # A string, provided by the `DescribeChangeSetHooks` response output,
2349
- # that identifies the next page of information that you want to
2350
- # retrieve.
2467
+ # The token for the next set of items to return. (You received this
2468
+ # token from a previous call.)
2351
2469
  # @return [String]
2352
2470
  #
2353
2471
  # @!attribute [rw] logical_resource_id
@@ -2375,11 +2493,11 @@ module Aws::CloudFormation
2375
2493
  # @return [String]
2376
2494
  #
2377
2495
  # @!attribute [rw] hooks
2378
- # List of hook objects.
2496
+ # List of Hook objects.
2379
2497
  # @return [Array<Types::ChangeSetHook>]
2380
2498
  #
2381
2499
  # @!attribute [rw] status
2382
- # Provides the status of the change set hook.
2500
+ # Provides the status of the change set Hook.
2383
2501
  # @return [String]
2384
2502
  #
2385
2503
  # @!attribute [rw] next_token
@@ -2421,8 +2539,8 @@ module Aws::CloudFormation
2421
2539
  # @return [String]
2422
2540
  #
2423
2541
  # @!attribute [rw] next_token
2424
- # A string (provided by the DescribeChangeSet response output) that
2425
- # identifies the next page of information that you want to retrieve.
2542
+ # The token for the next set of items to return. (You received this
2543
+ # token from a previous call.)
2426
2544
  # @return [String]
2427
2545
  #
2428
2546
  # @!attribute [rw] include_property_values
@@ -2497,6 +2615,22 @@ module Aws::CloudFormation
2497
2615
  # error message.
2498
2616
  # @return [String]
2499
2617
  #
2618
+ # @!attribute [rw] stack_drift_status
2619
+ # The drift status of the stack when the change set was created. Valid
2620
+ # values:
2621
+ #
2622
+ # * `DRIFTED` – The stack has drifted from its last deployment.
2623
+ #
2624
+ # * `IN_SYNC` – The stack is in sync with its last deployment.
2625
+ #
2626
+ # * `NOT_CHECKED` – CloudFormation doesn’t currently return this
2627
+ # value.
2628
+ #
2629
+ # * `UNKNOWN` – The drift status could not be determined.
2630
+ #
2631
+ # Only present for drift-aware change sets.
2632
+ # @return [String]
2633
+ #
2500
2634
  # @!attribute [rw] notification_arns
2501
2635
  # The ARNs of the Amazon SNS topics that will be associated with the
2502
2636
  # stack if you execute the change set.
@@ -2581,6 +2715,11 @@ module Aws::CloudFormation
2581
2715
  # [2]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/resource-import.html
2582
2716
  # @return [Boolean]
2583
2717
  #
2718
+ # @!attribute [rw] deployment_mode
2719
+ # The deployment mode specified when the change set was created. Valid
2720
+ # value is `REVERT_DRIFT`. Only present for drift-aware change sets.
2721
+ # @return [String]
2722
+ #
2584
2723
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/DescribeChangeSetOutput AWS API Documentation
2585
2724
  #
2586
2725
  class DescribeChangeSetOutput < Struct.new(
@@ -2594,6 +2733,7 @@ module Aws::CloudFormation
2594
2733
  :execution_status,
2595
2734
  :status,
2596
2735
  :status_reason,
2736
+ :stack_drift_status,
2597
2737
  :notification_arns,
2598
2738
  :rollback_configuration,
2599
2739
  :capabilities,
@@ -2604,7 +2744,64 @@ module Aws::CloudFormation
2604
2744
  :parent_change_set_id,
2605
2745
  :root_change_set_id,
2606
2746
  :on_stack_failure,
2607
- :import_existing_resources)
2747
+ :import_existing_resources,
2748
+ :deployment_mode)
2749
+ SENSITIVE = []
2750
+ include Aws::Structure
2751
+ end
2752
+
2753
+ # @!attribute [rw] stack_name
2754
+ # The name or unique stack ID for which you want to retrieve events.
2755
+ # @return [String]
2756
+ #
2757
+ # @!attribute [rw] change_set_name
2758
+ # The name or Amazon Resource Name (ARN) of the change set for which
2759
+ # you want to retrieve events.
2760
+ # @return [String]
2761
+ #
2762
+ # @!attribute [rw] operation_id
2763
+ # The unique identifier of the operation for which you want to
2764
+ # retrieve events.
2765
+ # @return [String]
2766
+ #
2767
+ # @!attribute [rw] filters
2768
+ # Filters to apply when retrieving events.
2769
+ # @return [Types::EventFilter]
2770
+ #
2771
+ # @!attribute [rw] next_token
2772
+ # The token for the next set of items to return. (You received this
2773
+ # token from a previous call.)
2774
+ # @return [String]
2775
+ #
2776
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/DescribeEventsInput AWS API Documentation
2777
+ #
2778
+ class DescribeEventsInput < Struct.new(
2779
+ :stack_name,
2780
+ :change_set_name,
2781
+ :operation_id,
2782
+ :filters,
2783
+ :next_token)
2784
+ SENSITIVE = []
2785
+ include Aws::Structure
2786
+ end
2787
+
2788
+ # @!attribute [rw] operation_events
2789
+ # A list of operation events that match the specified criteria.
2790
+ # @return [Array<Types::OperationEvent>]
2791
+ #
2792
+ # @!attribute [rw] next_token
2793
+ # If the request doesn't return all the remaining results,
2794
+ # `NextToken` is set to a token. To retrieve the next set of results,
2795
+ # call `DescribeEvents` again and assign that token to the request
2796
+ # object's `NextToken` parameter. If the request returns all results,
2797
+ # `NextToken` is set to `null`.
2798
+ # @return [String]
2799
+ #
2800
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/DescribeEventsOutput AWS API Documentation
2801
+ #
2802
+ class DescribeEventsOutput < Struct.new(
2803
+ :operation_events,
2804
+ :next_token)
2608
2805
  SENSITIVE = []
2609
2806
  include Aws::Structure
2610
2807
  end
@@ -3008,8 +3205,8 @@ module Aws::CloudFormation
3008
3205
  # @return [String]
3009
3206
  #
3010
3207
  # @!attribute [rw] next_token
3011
- # A string that identifies the next page of events that you want to
3012
- # retrieve.
3208
+ # The token for the next set of items to return. (You received this
3209
+ # token from a previous call.)
3013
3210
  # @return [String]
3014
3211
  #
3015
3212
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/DescribeStackEventsInput AWS API Documentation
@@ -3043,8 +3240,8 @@ module Aws::CloudFormation
3043
3240
  end
3044
3241
 
3045
3242
  # @!attribute [rw] stack_set_name
3046
- # The name or the unique stack ID of the stack set that you want to
3047
- # get stack instance information for.
3243
+ # The name or the unique stack ID of the StackSet that you want to get
3244
+ # stack instance information for.
3048
3245
  # @return [String]
3049
3246
  #
3050
3247
  # @!attribute [rw] stack_instance_account
@@ -3061,7 +3258,7 @@ module Aws::CloudFormation
3061
3258
  # an account administrator in the organization's management account
3062
3259
  # or as a delegated administrator in a member account.
3063
3260
  #
3064
- # By default, `SELF` is specified. Use `SELF` for stack sets with
3261
+ # By default, `SELF` is specified. Use `SELF` for StackSets with
3065
3262
  # self-managed permissions.
3066
3263
  #
3067
3264
  # * If you are signed in to the management account, specify `SELF`.
@@ -3185,8 +3382,8 @@ module Aws::CloudFormation
3185
3382
  # @return [Array<String>]
3186
3383
  #
3187
3384
  # @!attribute [rw] next_token
3188
- # A string that identifies the next page of stack resource drift
3189
- # results.
3385
+ # The token for the next set of items to return. (You received this
3386
+ # token from a previous call.)
3190
3387
  # @return [String]
3191
3388
  #
3192
3389
  # @!attribute [rw] max_results
@@ -3340,7 +3537,7 @@ module Aws::CloudFormation
3340
3537
  end
3341
3538
 
3342
3539
  # @!attribute [rw] stack_set_name
3343
- # The name or unique ID of the stack set whose description you want.
3540
+ # The name or unique ID of the StackSet whose description you want.
3344
3541
  # @return [String]
3345
3542
  #
3346
3543
  # @!attribute [rw] call_as
@@ -3348,7 +3545,7 @@ module Aws::CloudFormation
3348
3545
  # an account administrator in the organization's management account
3349
3546
  # or as a delegated administrator in a member account.
3350
3547
  #
3351
- # By default, `SELF` is specified. Use `SELF` for stack sets with
3548
+ # By default, `SELF` is specified. Use `SELF` for StackSets with
3352
3549
  # self-managed permissions.
3353
3550
  #
3354
3551
  # * If you are signed in to the management account, specify `SELF`.
@@ -3376,12 +3573,12 @@ module Aws::CloudFormation
3376
3573
  end
3377
3574
 
3378
3575
  # @!attribute [rw] stack_set_name
3379
- # The name or the unique stack ID of the stack set for the stack
3576
+ # The name or the unique stack ID of the StackSet for the stack
3380
3577
  # operation.
3381
3578
  # @return [String]
3382
3579
  #
3383
3580
  # @!attribute [rw] operation_id
3384
- # The unique ID of the stack set operation.
3581
+ # The unique ID of the StackSet operation.
3385
3582
  # @return [String]
3386
3583
  #
3387
3584
  # @!attribute [rw] call_as
@@ -3389,7 +3586,7 @@ module Aws::CloudFormation
3389
3586
  # an account administrator in the organization's management account
3390
3587
  # or as a delegated administrator in a member account.
3391
3588
  #
3392
- # By default, `SELF` is specified. Use `SELF` for stack sets with
3589
+ # By default, `SELF` is specified. Use `SELF` for StackSets with
3393
3590
  # self-managed permissions.
3394
3591
  #
3395
3592
  # * If you are signed in to the management account, specify `SELF`.
@@ -3418,7 +3615,7 @@ module Aws::CloudFormation
3418
3615
  end
3419
3616
 
3420
3617
  # @!attribute [rw] stack_set_operation
3421
- # The specified stack set operation.
3618
+ # The specified StackSet operation.
3422
3619
  # @return [Types::StackSetOperation]
3423
3620
  #
3424
3621
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/DescribeStackSetOperationOutput AWS API Documentation
@@ -3430,7 +3627,7 @@ module Aws::CloudFormation
3430
3627
  end
3431
3628
 
3432
3629
  # @!attribute [rw] stack_set
3433
- # The specified stack set.
3630
+ # The specified StackSet.
3434
3631
  # @return [Types::StackSet]
3435
3632
  #
3436
3633
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/DescribeStackSetOutput AWS API Documentation
@@ -3472,8 +3669,8 @@ module Aws::CloudFormation
3472
3669
  # @return [String]
3473
3670
  #
3474
3671
  # @!attribute [rw] next_token
3475
- # A string that identifies the next page of stacks that you want to
3476
- # retrieve.
3672
+ # The token for the next set of items to return. (You received this
3673
+ # token from a previous call.)
3477
3674
  # @return [String]
3478
3675
  #
3479
3676
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/DescribeStacksInput AWS API Documentation
@@ -3654,13 +3851,14 @@ module Aws::CloudFormation
3654
3851
  # @!attribute [rw] schema
3655
3852
  # The schema that defines the extension.
3656
3853
  #
3657
- # For more information about extension schemas, see [Resource type
3658
- # schema][1] in the *CloudFormation Command Line Interface (CLI) User
3659
- # Guide*.
3854
+ # For more information, see [Resource type schema][1] in the
3855
+ # *CloudFormation Command Line Interface (CLI) User Guide* and the
3856
+ # [CloudFormation Hooks User Guide][2].
3660
3857
  #
3661
3858
  #
3662
3859
  #
3663
3860
  # [1]: https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/resource-type-schema.html
3861
+ # [2]: https://docs.aws.amazon.com/cloudformation-cli/latest/hooks-userguide/what-is-cloudformation-hooks.html
3664
3862
  # @return [String]
3665
3863
  #
3666
3864
  # @!attribute [rw] provisioning_type
@@ -3790,14 +3988,11 @@ module Aws::CloudFormation
3790
3988
  # extension in this account and Region.
3791
3989
  #
3792
3990
  # To set the configuration data for an extension, use
3793
- # [SetTypeConfiguration][1]. For more information, see [Edit
3794
- # configuration data for extensions in your account][2] in the
3795
- # *CloudFormation User Guide*.
3991
+ # [SetTypeConfiguration][1].
3796
3992
  #
3797
3993
  #
3798
3994
  #
3799
3995
  # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_SetTypeConfiguration.html
3800
- # [2]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/registry-set-configuration.html
3801
3996
  # @return [String]
3802
3997
  #
3803
3998
  # @!attribute [rw] publisher_id
@@ -4015,24 +4210,24 @@ module Aws::CloudFormation
4015
4210
  end
4016
4211
 
4017
4212
  # @!attribute [rw] stack_set_name
4018
- # The name of the stack set on which to perform the drift detection
4213
+ # The name of the StackSet on which to perform the drift detection
4019
4214
  # operation.
4020
4215
  # @return [String]
4021
4216
  #
4022
4217
  # @!attribute [rw] operation_preferences
4023
4218
  # The user-specified preferences for how CloudFormation performs a
4024
- # stack set operation.
4219
+ # StackSet operation.
4025
4220
  #
4026
4221
  # For more information about maximum concurrent accounts and failure
4027
- # tolerance, see [Stack set operation options][1].
4222
+ # tolerance, see [StackSet operation options][1].
4028
4223
  #
4029
4224
  #
4030
4225
  #
4031
- # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/what-is-cfnstacksets.html#stackset-ops-options
4226
+ # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-concepts.html#stackset-ops-options
4032
4227
  # @return [Types::StackSetOperationPreferences]
4033
4228
  #
4034
4229
  # @!attribute [rw] operation_id
4035
- # *The ID of the stack set operation.*
4230
+ # *The ID of the StackSet operation.*
4036
4231
  #
4037
4232
  # **A suitable default value is auto-generated.** You should normally
4038
4233
  # not need to pass this option.
@@ -4043,7 +4238,7 @@ module Aws::CloudFormation
4043
4238
  # an account administrator in the organization's management account
4044
4239
  # or as a delegated administrator in a member account.
4045
4240
  #
4046
- # By default, `SELF` is specified. Use `SELF` for stack sets with
4241
+ # By default, `SELF` is specified. Use `SELF` for StackSets with
4047
4242
  # self-managed permissions.
4048
4243
  #
4049
4244
  # * If you are signed in to the management account, specify `SELF`.
@@ -4073,7 +4268,7 @@ module Aws::CloudFormation
4073
4268
  end
4074
4269
 
4075
4270
  # @!attribute [rw] operation_id
4076
- # The ID of the drift detection stack set operation.
4271
+ # The ID of the drift detection StackSet operation.
4077
4272
  #
4078
4273
  # You can use this operation ID with DescribeStackSetOperation to
4079
4274
  # monitor the progress of the drift detection operation.
@@ -4137,6 +4332,21 @@ module Aws::CloudFormation
4137
4332
  include Aws::Structure
4138
4333
  end
4139
4334
 
4335
+ # Event filter allows you to focus on specific events in an operation.
4336
+ #
4337
+ # @!attribute [rw] failed_events
4338
+ # When set to true, only returns failed events within the operation.
4339
+ # This helps quickly identify root causes for a failed operation.
4340
+ # @return [Boolean]
4341
+ #
4342
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/EventFilter AWS API Documentation
4343
+ #
4344
+ class EventFilter < Struct.new(
4345
+ :failed_events)
4346
+ SENSITIVE = []
4347
+ include Aws::Structure
4348
+ end
4349
+
4140
4350
  # The input for the ExecuteChangeSet action.
4141
4351
  #
4142
4352
  # @!attribute [rw] change_set_name
@@ -4221,6 +4431,13 @@ module Aws::CloudFormation
4221
4431
  # The `Export` structure describes the exported output values for a
4222
4432
  # stack.
4223
4433
  #
4434
+ # For more information, see [Get exported outputs from a deployed
4435
+ # CloudFormation stack][1].
4436
+ #
4437
+ #
4438
+ #
4439
+ # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-stack-exports.html
4440
+ #
4224
4441
  # @!attribute [rw] exporting_stack_id
4225
4442
  # The stack that contains the exported output name and value.
4226
4443
  # @return [String]
@@ -4315,6 +4532,114 @@ module Aws::CloudFormation
4315
4532
  include Aws::Structure
4316
4533
  end
4317
4534
 
4535
+ # @!attribute [rw] hook_result_id
4536
+ # The unique identifier (ID) of the Hook invocation result that you
4537
+ # want details about. You can get the ID from the [ListHookResults][1]
4538
+ # operation.
4539
+ #
4540
+ #
4541
+ #
4542
+ # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_ListHookResults.html
4543
+ # @return [String]
4544
+ #
4545
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/GetHookResultInput AWS API Documentation
4546
+ #
4547
+ class GetHookResultInput < Struct.new(
4548
+ :hook_result_id)
4549
+ SENSITIVE = []
4550
+ include Aws::Structure
4551
+ end
4552
+
4553
+ # @!attribute [rw] hook_result_id
4554
+ # The unique identifier of the Hook result.
4555
+ # @return [String]
4556
+ #
4557
+ # @!attribute [rw] invocation_point
4558
+ # The specific point in the provisioning process where the Hook is
4559
+ # invoked.
4560
+ # @return [String]
4561
+ #
4562
+ # @!attribute [rw] failure_mode
4563
+ # The failure mode of the invocation.
4564
+ # @return [String]
4565
+ #
4566
+ # @!attribute [rw] type_name
4567
+ # The name of the Hook that was invoked.
4568
+ # @return [String]
4569
+ #
4570
+ # @!attribute [rw] original_type_name
4571
+ # The original public type name of the Hook when an alias is used.
4572
+ #
4573
+ # For example, if you activate `AWS::Hooks::GuardHook` with alias
4574
+ # `MyCompany::Custom::GuardHook`, then `TypeName` will be
4575
+ # `MyCompany::Custom::GuardHook` and `OriginalTypeName` will be
4576
+ # `AWS::Hooks::GuardHook`.
4577
+ # @return [String]
4578
+ #
4579
+ # @!attribute [rw] type_version_id
4580
+ # The version identifier of the Hook that was invoked.
4581
+ # @return [String]
4582
+ #
4583
+ # @!attribute [rw] type_configuration_version_id
4584
+ # The version identifier of the Hook configuration data that was used
4585
+ # during invocation.
4586
+ # @return [String]
4587
+ #
4588
+ # @!attribute [rw] type_arn
4589
+ # The Amazon Resource Name (ARN) of the Hook.
4590
+ # @return [String]
4591
+ #
4592
+ # @!attribute [rw] status
4593
+ # The status of the Hook invocation. The following statuses are
4594
+ # possible:
4595
+ #
4596
+ # * `HOOK_IN_PROGRESS`: The Hook is currently running.
4597
+ #
4598
+ # * `HOOK_COMPLETE_SUCCEEDED`: The Hook completed successfully.
4599
+ #
4600
+ # * `HOOK_COMPLETE_FAILED`: The Hook completed but failed validation.
4601
+ #
4602
+ # * `HOOK_FAILED`: The Hook encountered an error during execution.
4603
+ # @return [String]
4604
+ #
4605
+ # @!attribute [rw] hook_status_reason
4606
+ # A message that provides additional details about the Hook invocation
4607
+ # status.
4608
+ # @return [String]
4609
+ #
4610
+ # @!attribute [rw] invoked_at
4611
+ # The timestamp when the Hook was invoked.
4612
+ # @return [Time]
4613
+ #
4614
+ # @!attribute [rw] target
4615
+ # Information about the target of the Hook invocation.
4616
+ # @return [Types::HookTarget]
4617
+ #
4618
+ # @!attribute [rw] annotations
4619
+ # A list of objects with additional information and guidance that can
4620
+ # help you resolve a failed Hook invocation.
4621
+ # @return [Array<Types::Annotation>]
4622
+ #
4623
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/GetHookResultOutput AWS API Documentation
4624
+ #
4625
+ class GetHookResultOutput < Struct.new(
4626
+ :hook_result_id,
4627
+ :invocation_point,
4628
+ :failure_mode,
4629
+ :type_name,
4630
+ :original_type_name,
4631
+ :type_version_id,
4632
+ :type_configuration_version_id,
4633
+ :type_arn,
4634
+ :status,
4635
+ :hook_status_reason,
4636
+ :invoked_at,
4637
+ :target,
4638
+ :annotations)
4639
+ SENSITIVE = []
4640
+ include Aws::Structure
4641
+ end
4642
+
4318
4643
  # The input for the GetStackPolicy action.
4319
4644
  #
4320
4645
  # @!attribute [rw] stack_name
@@ -4333,9 +4658,9 @@ module Aws::CloudFormation
4333
4658
  # The output for the GetStackPolicy action.
4334
4659
  #
4335
4660
  # @!attribute [rw] stack_policy_body
4336
- # Structure that contains the stack policy body. (For more
4337
- # information, see [Prevent updates to stack resources][1] in the
4338
- # *CloudFormation User Guide*.)
4661
+ # Structure that contains the stack policy body. For more information,
4662
+ # see [Prevent updates to stack resources][1] in the *CloudFormation
4663
+ # User Guide*.
4339
4664
  #
4340
4665
  #
4341
4666
  #
@@ -4446,7 +4771,7 @@ module Aws::CloudFormation
4446
4771
  # @return [String]
4447
4772
  #
4448
4773
  # @!attribute [rw] stack_set_name
4449
- # The name or unique ID of the stack set from which the stack was
4774
+ # The name or unique ID of the StackSet from which the stack was
4450
4775
  # created.
4451
4776
  #
4452
4777
  # Conditional: You must specify only one of the following parameters:
@@ -4458,7 +4783,7 @@ module Aws::CloudFormation
4458
4783
  # an account administrator in the organization's management account
4459
4784
  # or as a delegated administrator in a member account.
4460
4785
  #
4461
- # By default, `SELF` is specified. Use `SELF` for stack sets with
4786
+ # By default, `SELF` is specified. Use `SELF` for StackSets with
4462
4787
  # self-managed permissions.
4463
4788
  #
4464
4789
  # * If you are signed in to the management account, specify `SELF`.
@@ -4580,68 +4905,136 @@ module Aws::CloudFormation
4580
4905
  #
4581
4906
  class HookResultNotFoundException < Aws::EmptyStructure; end
4582
4907
 
4583
- # Describes a Hook invocation, its status, and the reason for its
4584
- # status.
4908
+ # A `ListHookResults` call returns a summary of a Hook invocation.
4909
+ #
4910
+ # @!attribute [rw] hook_result_id
4911
+ # The unique identifier for this Hook invocation result.
4912
+ # @return [String]
4585
4913
  #
4586
4914
  # @!attribute [rw] invocation_point
4587
- # The exact point in the provisioning logic where the Hook runs.
4915
+ # The specific point in the provisioning process where the Hook is
4916
+ # invoked.
4588
4917
  # @return [String]
4589
4918
  #
4590
4919
  # @!attribute [rw] failure_mode
4591
- # The failure mode of the invocation. The following are potential
4592
- # modes:
4593
- #
4594
- # * `FAIL`: If the hook invocation returns a failure, then the
4595
- # requested target operation should fail.
4596
- #
4597
- # * `WARN`: If the hook invocation returns a failure, then the
4598
- # requested target operation should warn.
4920
+ # The failure mode of the invocation.
4599
4921
  # @return [String]
4600
4922
  #
4601
4923
  # @!attribute [rw] type_name
4602
- # The type name of the Hook being invoked.
4924
+ # The name of the Hook that was invoked.
4603
4925
  # @return [String]
4604
4926
  #
4605
4927
  # @!attribute [rw] type_version_id
4606
- # The version of the Hook being invoked.
4928
+ # The version of the Hook that was invoked.
4607
4929
  # @return [String]
4608
4930
  #
4609
4931
  # @!attribute [rw] type_configuration_version_id
4610
- # The version of the Hook type configuration.
4932
+ # The version of the Hook configuration.
4611
4933
  # @return [String]
4612
4934
  #
4613
4935
  # @!attribute [rw] status
4614
- # The state of the Hook invocation.
4936
+ # The status of the Hook invocation. The following statuses are
4937
+ # possible:
4938
+ #
4939
+ # * `HOOK_IN_PROGRESS`: The Hook is currently running.
4940
+ #
4941
+ # * `HOOK_COMPLETE_SUCCEEDED`: The Hook completed successfully.
4942
+ #
4943
+ # * `HOOK_COMPLETE_FAILED`: The Hook completed but failed validation.
4944
+ #
4945
+ # * `HOOK_FAILED`: The Hook encountered an error during execution.
4615
4946
  # @return [String]
4616
4947
  #
4617
4948
  # @!attribute [rw] hook_status_reason
4618
4949
  # A description of the Hook results status. For example, if the Hook
4619
- # result is in a `FAILED` state, this may contain additional
4620
- # information for the `FAILED` state.
4950
+ # result is in a failed state, this may contain additional information
4951
+ # for the failed state.
4952
+ # @return [String]
4953
+ #
4954
+ # @!attribute [rw] invoked_at
4955
+ # The timestamp when the Hook was invoked.
4956
+ #
4957
+ # Only shown in responses when the request does not specify
4958
+ # `TargetType` and `TargetId` filters.
4959
+ # @return [Time]
4960
+ #
4961
+ # @!attribute [rw] target_type
4962
+ # The target type that the Hook was invoked against.
4963
+ # @return [String]
4964
+ #
4965
+ # @!attribute [rw] target_id
4966
+ # The unique identifier of the Hook invocation target.
4967
+ # @return [String]
4968
+ #
4969
+ # @!attribute [rw] type_arn
4970
+ # The ARN of the Hook that was invoked.
4971
+ # @return [String]
4972
+ #
4973
+ # @!attribute [rw] hook_execution_target
4974
+ # The Amazon Resource Name (ARN) of the target stack or request token
4975
+ # of the Cloud Control API operation.
4976
+ #
4977
+ # Only shown in responses when the request does not specify
4978
+ # `TargetType` and `TargetId` filters.
4621
4979
  # @return [String]
4622
4980
  #
4623
4981
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/HookResultSummary AWS API Documentation
4624
4982
  #
4625
4983
  class HookResultSummary < Struct.new(
4984
+ :hook_result_id,
4626
4985
  :invocation_point,
4627
4986
  :failure_mode,
4628
4987
  :type_name,
4629
4988
  :type_version_id,
4630
4989
  :type_configuration_version_id,
4631
4990
  :status,
4632
- :hook_status_reason)
4991
+ :hook_status_reason,
4992
+ :invoked_at,
4993
+ :target_type,
4994
+ :target_id,
4995
+ :type_arn,
4996
+ :hook_execution_target)
4997
+ SENSITIVE = []
4998
+ include Aws::Structure
4999
+ end
5000
+
5001
+ # The `HookTarget` data type.
5002
+ #
5003
+ # @!attribute [rw] target_type
5004
+ # The target type.
5005
+ # @return [String]
5006
+ #
5007
+ # @!attribute [rw] target_type_name
5008
+ # The target name, for example, `AWS::S3::Bucket`.
5009
+ # @return [String]
5010
+ #
5011
+ # @!attribute [rw] target_id
5012
+ # The unique identifier of the Hook invocation target.
5013
+ # @return [String]
5014
+ #
5015
+ # @!attribute [rw] action
5016
+ # The action that invoked the Hook.
5017
+ # @return [String]
5018
+ #
5019
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/HookTarget AWS API Documentation
5020
+ #
5021
+ class HookTarget < Struct.new(
5022
+ :target_type,
5023
+ :target_type_name,
5024
+ :target_id,
5025
+ :action)
4633
5026
  SENSITIVE = []
4634
5027
  include Aws::Structure
4635
5028
  end
4636
5029
 
4637
5030
  # @!attribute [rw] stack_set_name
4638
- # The name of the stack set. The name must be unique in the Region
4639
- # where you create your stack set.
5031
+ # The name of the StackSet. The name must be unique in the Region
5032
+ # where you create your StackSet.
4640
5033
  # @return [String]
4641
5034
  #
4642
5035
  # @!attribute [rw] stack_ids
4643
- # The IDs of the stacks you are importing into a stack set. You import
4644
- # up to 10 stacks per stack set at a time.
5036
+ # The IDs of the stacks you are importing into a StackSet. You import
5037
+ # up to 10 stacks per StackSet at a time.
4645
5038
  #
4646
5039
  # Specify either `StackIds` or `StackIdsUrl`.
4647
5040
  # @return [Array<String>]
@@ -4653,36 +5046,36 @@ module Aws::CloudFormation
4653
5046
  # @return [String]
4654
5047
  #
4655
5048
  # @!attribute [rw] organizational_unit_ids
4656
- # The list of OU ID's to which the stacks being imported has to be
4657
- # mapped as deployment target.
5049
+ # The list of OU ID's to which the imported stacks must be mapped as
5050
+ # deployment targets.
4658
5051
  # @return [Array<String>]
4659
5052
  #
4660
5053
  # @!attribute [rw] operation_preferences
4661
5054
  # The user-specified preferences for how CloudFormation performs a
4662
- # stack set operation.
5055
+ # StackSet operation.
4663
5056
  #
4664
5057
  # For more information about maximum concurrent accounts and failure
4665
- # tolerance, see [Stack set operation options][1].
5058
+ # tolerance, see [StackSet operation options][1].
4666
5059
  #
4667
5060
  #
4668
5061
  #
4669
- # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/what-is-cfnstacksets.html#stackset-ops-options
5062
+ # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-concepts.html#stackset-ops-options
4670
5063
  # @return [Types::StackSetOperationPreferences]
4671
5064
  #
4672
5065
  # @!attribute [rw] operation_id
4673
- # A unique, user defined, identifier for the stack set operation.
5066
+ # A unique, user defined, identifier for the StackSet operation.
4674
5067
  #
4675
5068
  # **A suitable default value is auto-generated.** You should normally
4676
5069
  # not need to pass this option.
4677
5070
  # @return [String]
4678
5071
  #
4679
5072
  # @!attribute [rw] call_as
4680
- # By default, `SELF` is specified. Use `SELF` for stack sets with
5073
+ # By default, `SELF` is specified. Use `SELF` for StackSets with
4681
5074
  # self-managed permissions.
4682
5075
  #
4683
5076
  # * If you are signed in to the management account, specify `SELF`.
4684
5077
  #
4685
- # * For service managed stack sets, specify `DELEGATED_ADMIN`.
5078
+ # * For service managed StackSets, specify `DELEGATED_ADMIN`.
4686
5079
  # @return [String]
4687
5080
  #
4688
5081
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/ImportStacksToStackSetInput AWS API Documentation
@@ -4700,7 +5093,7 @@ module Aws::CloudFormation
4700
5093
  end
4701
5094
 
4702
5095
  # @!attribute [rw] operation_id
4703
- # The unique identifier for the stack set operation.
5096
+ # The unique identifier for the StackSet operation.
4704
5097
  # @return [String]
4705
5098
  #
4706
5099
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/ImportStacksToStackSetOutput AWS API Documentation
@@ -4764,8 +5157,8 @@ module Aws::CloudFormation
4764
5157
  # @return [String]
4765
5158
  #
4766
5159
  # @!attribute [rw] next_token
4767
- # A string (provided by the ListChangeSets response output) that
4768
- # identifies the next page of change sets that you want to retrieve.
5160
+ # The token for the next set of items to return. (You received this
5161
+ # token from a previous call.)
4769
5162
  # @return [String]
4770
5163
  #
4771
5164
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/ListChangeSetsInput AWS API Documentation
@@ -4800,9 +5193,8 @@ module Aws::CloudFormation
4800
5193
  end
4801
5194
 
4802
5195
  # @!attribute [rw] next_token
4803
- # A string (provided by the ListExports response output) that
4804
- # identifies the next page of exported output values that you asked to
4805
- # retrieve.
5196
+ # The token for the next set of items to return. (You received this
5197
+ # token from a previous call.)
4806
5198
  # @return [String]
4807
5199
  #
4808
5200
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/ListExportsInput AWS API Documentation
@@ -4833,7 +5225,8 @@ module Aws::CloudFormation
4833
5225
  end
4834
5226
 
4835
5227
  # @!attribute [rw] next_token
4836
- # A string that identifies the next page of resource scan results.
5228
+ # The token for the next set of items to return. (You received this
5229
+ # token from a previous call.)
4837
5230
  # @return [String]
4838
5231
  #
4839
5232
  # @!attribute [rw] max_results
@@ -4875,26 +5268,50 @@ module Aws::CloudFormation
4875
5268
  end
4876
5269
 
4877
5270
  # @!attribute [rw] target_type
4878
- # The type of operation being targeted by the Hook.
5271
+ # Filters results by target type. Currently, only `CHANGE_SET` and
5272
+ # `CLOUD_CONTROL` are supported filter options.
5273
+ #
5274
+ # Required when `TargetId` is specified and cannot be used otherwise.
4879
5275
  # @return [String]
4880
5276
  #
4881
5277
  # @!attribute [rw] target_id
4882
- # The logical ID of the target the operation is acting on by the Hook.
4883
- # If the target is a change set, it's the ARN of the change set.
5278
+ # Filters results by the unique identifier of the target the Hook was
5279
+ # invoked against.
5280
+ #
5281
+ # For change sets, this is the change set ARN. When the target is a
5282
+ # Cloud Control API operation, this value must be the
5283
+ # `HookRequestToken` returned by the Cloud Control API request. For
5284
+ # more information on the `HookRequestToken`, see [ProgressEvent][1].
4884
5285
  #
4885
- # If the target is a Cloud Control API operation, this will be the
4886
- # `HookRequestToken` returned by the Cloud Control API operation
4887
- # request. For more information on the `HookRequestToken`, see
4888
- # [ProgressEvent][1].
5286
+ # Required when `TargetType` is specified and cannot be used
5287
+ # otherwise.
4889
5288
  #
4890
5289
  #
4891
5290
  #
4892
5291
  # [1]: https://docs.aws.amazon.com/cloudcontrolapi/latest/APIReference/API_ProgressEvent.html
4893
5292
  # @return [String]
4894
5293
  #
5294
+ # @!attribute [rw] type_arn
5295
+ # Filters results by the ARN of the Hook. Can be used alone or in
5296
+ # combination with `Status`.
5297
+ # @return [String]
5298
+ #
5299
+ # @!attribute [rw] status
5300
+ # Filters results by the status of Hook invocations. Can only be used
5301
+ # in combination with `TypeArn`. Valid values are:
5302
+ #
5303
+ # * `HOOK_IN_PROGRESS`: The Hook is currently running.
5304
+ #
5305
+ # * `HOOK_COMPLETE_SUCCEEDED`: The Hook completed successfully.
5306
+ #
5307
+ # * `HOOK_COMPLETE_FAILED`: The Hook completed but failed validation.
5308
+ #
5309
+ # * `HOOK_FAILED`: The Hook encountered an error during execution.
5310
+ # @return [String]
5311
+ #
4895
5312
  # @!attribute [rw] next_token
4896
- # A string that identifies the next page of events that you want to
4897
- # retrieve.
5313
+ # The token for the next set of items to return. (You received this
5314
+ # token from a previous call.)
4898
5315
  # @return [String]
4899
5316
  #
4900
5317
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/ListHookResultsInput AWS API Documentation
@@ -4902,27 +5319,19 @@ module Aws::CloudFormation
4902
5319
  class ListHookResultsInput < Struct.new(
4903
5320
  :target_type,
4904
5321
  :target_id,
5322
+ :type_arn,
5323
+ :status,
4905
5324
  :next_token)
4906
5325
  SENSITIVE = []
4907
5326
  include Aws::Structure
4908
5327
  end
4909
5328
 
4910
5329
  # @!attribute [rw] target_type
4911
- # The type of operation being targeted by the Hook.
5330
+ # The target type.
4912
5331
  # @return [String]
4913
5332
  #
4914
5333
  # @!attribute [rw] target_id
4915
- # The logical ID of the target the operation is acting on by the Hook.
4916
- # If the target is a change set, it's the ARN of the change set.
4917
- #
4918
- # If the target is a Cloud Control API operation, this will be the
4919
- # `HooksRequestToken` returned by the Cloud Control API operation
4920
- # request. For more information on the `HooksRequestToken`, see
4921
- # [ProgressEvent][1].
4922
- #
4923
- #
4924
- #
4925
- # [1]: https://docs.aws.amazon.com/cloudcontrolapi/latest/APIReference/API_ProgressEvent.html
5334
+ # The unique identifier of the Hook invocation target.
4926
5335
  # @return [String]
4927
5336
  #
4928
5337
  # @!attribute [rw] hook_results
@@ -4952,9 +5361,8 @@ module Aws::CloudFormation
4952
5361
  # @return [String]
4953
5362
  #
4954
5363
  # @!attribute [rw] next_token
4955
- # A string (provided by the ListImports response output) that
4956
- # identifies the next page of stacks that are importing the specified
4957
- # exported output value.
5364
+ # The token for the next set of items to return. (You received this
5365
+ # token from a previous call.)
4958
5366
  # @return [String]
4959
5367
  #
4960
5368
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/ListImportsInput AWS API Documentation
@@ -4995,7 +5403,8 @@ module Aws::CloudFormation
4995
5403
  # @return [Array<Types::ScannedResourceIdentifier>]
4996
5404
  #
4997
5405
  # @!attribute [rw] next_token
4998
- # A string that identifies the next page of resource scan results.
5406
+ # The token for the next set of items to return. (You received this
5407
+ # token from a previous call.)
4999
5408
  # @return [String]
5000
5409
  #
5001
5410
  # @!attribute [rw] max_results
@@ -5063,7 +5472,8 @@ module Aws::CloudFormation
5063
5472
  # @return [String]
5064
5473
  #
5065
5474
  # @!attribute [rw] next_token
5066
- # A string that identifies the next page of resource scan results.
5475
+ # The token for the next set of items to return. (You received this
5476
+ # token from a previous call.)
5067
5477
  # @return [String]
5068
5478
  #
5069
5479
  # @!attribute [rw] max_results
@@ -5111,7 +5521,8 @@ module Aws::CloudFormation
5111
5521
  end
5112
5522
 
5113
5523
  # @!attribute [rw] next_token
5114
- # A string that identifies the next page of resource scan results.
5524
+ # The token for the next set of items to return. (You received this
5525
+ # token from a previous call.)
5115
5526
  # @return [String]
5116
5527
  #
5117
5528
  # @!attribute [rw] max_results
@@ -5158,17 +5569,13 @@ module Aws::CloudFormation
5158
5569
  end
5159
5570
 
5160
5571
  # @!attribute [rw] stack_set_name
5161
- # The name or unique ID of the stack set that you want to list drifted
5572
+ # The name or unique ID of the StackSet that you want to list drifted
5162
5573
  # resources for.
5163
5574
  # @return [String]
5164
5575
  #
5165
5576
  # @!attribute [rw] next_token
5166
- # If the previous paginated request didn't return all of the
5167
- # remaining results, the response object's `NextToken` parameter
5168
- # value is set to a token. To retrieve the next set of results, call
5169
- # this action again and assign that token to the request object's
5170
- # `NextToken` parameter. If there are no remaining results, the
5171
- # previous response object's `NextToken` parameter is set to `null`.
5577
+ # The token for the next set of items to return. (You received this
5578
+ # token from a previous call.)
5172
5579
  # @return [String]
5173
5580
  #
5174
5581
  # @!attribute [rw] max_results
@@ -5212,7 +5619,7 @@ module Aws::CloudFormation
5212
5619
  # an account administrator in the organization's management account
5213
5620
  # or as a delegated administrator in a member account.
5214
5621
  #
5215
- # By default, `SELF` is specified. Use `SELF` for stack sets with
5622
+ # By default, `SELF` is specified. Use `SELF` for StackSets with
5216
5623
  # self-managed permissions.
5217
5624
  #
5218
5625
  # * If you are signed in to the management account, specify `SELF`.
@@ -5269,17 +5676,13 @@ module Aws::CloudFormation
5269
5676
  end
5270
5677
 
5271
5678
  # @!attribute [rw] stack_set_name
5272
- # The name or unique ID of the stack set that you want to list stack
5679
+ # The name or unique ID of the StackSet that you want to list stack
5273
5680
  # instances for.
5274
5681
  # @return [String]
5275
5682
  #
5276
5683
  # @!attribute [rw] next_token
5277
- # If the previous request didn't return all the remaining results,
5278
- # the response's `NextToken` parameter value is set to a token. To
5279
- # retrieve the next set of results, call `ListStackInstances` again
5280
- # and assign that token to the request object's `NextToken`
5281
- # parameter. If there are no remaining results, the previous response
5282
- # object's `NextToken` parameter is set to `null`.
5684
+ # The token for the next set of items to return. (You received this
5685
+ # token from a previous call.)
5283
5686
  # @return [String]
5284
5687
  #
5285
5688
  # @!attribute [rw] max_results
@@ -5307,7 +5710,7 @@ module Aws::CloudFormation
5307
5710
  # an account administrator in the organization's management account
5308
5711
  # or as a delegated administrator in a member account.
5309
5712
  #
5310
- # By default, `SELF` is specified. Use `SELF` for stack sets with
5713
+ # By default, `SELF` is specified. Use `SELF` for StackSets with
5311
5714
  # self-managed permissions.
5312
5715
  #
5313
5716
  # * If you are signed in to the management account, specify `SELF`.
@@ -5367,11 +5770,8 @@ module Aws::CloudFormation
5367
5770
  # @return [String]
5368
5771
  #
5369
5772
  # @!attribute [rw] next_token
5370
- # If the request doesn't return all the remaining results,
5371
- # `NextToken` is set to a token. To retrieve the next set of results,
5372
- # call this action again and assign that token to the request
5373
- # object's `NextToken` parameter. If the request returns all results,
5374
- # `NextToken` is set to `null`.
5773
+ # The token for the next set of items to return. (You received this
5774
+ # token from a previous call.)
5375
5775
  # @return [String]
5376
5776
  #
5377
5777
  # @!attribute [rw] max_results
@@ -5416,14 +5816,11 @@ module Aws::CloudFormation
5416
5816
  # Execution status to use as a filter. Specify one or more execution
5417
5817
  # status codes to list only stack refactors with the specified
5418
5818
  # execution status codes.
5419
- # @return [Array<String>]
5420
- #
5421
- # @!attribute [rw] next_token
5422
- # If the request doesn't return all the remaining results,
5423
- # `NextToken` is set to a token. To retrieve the next set of results,
5424
- # call this action again and assign that token to the request
5425
- # object's `NextToken` parameter. If the request returns all results,
5426
- # `NextToken` is set to `null`.
5819
+ # @return [Array<String>]
5820
+ #
5821
+ # @!attribute [rw] next_token
5822
+ # The token for the next set of items to return. (You received this
5823
+ # token from a previous call.)
5427
5824
  # @return [String]
5428
5825
  #
5429
5826
  # @!attribute [rw] max_results
@@ -5489,8 +5886,8 @@ module Aws::CloudFormation
5489
5886
  # @return [String]
5490
5887
  #
5491
5888
  # @!attribute [rw] next_token
5492
- # A string that identifies the next page of stack resources that you
5493
- # want to retrieve.
5889
+ # The token for the next set of items to return. (You received this
5890
+ # token from a previous call.)
5494
5891
  # @return [String]
5495
5892
  #
5496
5893
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/ListStackResourcesInput AWS API Documentation
@@ -5524,13 +5921,13 @@ module Aws::CloudFormation
5524
5921
  end
5525
5922
 
5526
5923
  # @!attribute [rw] stack_set_name
5527
- # The name or unique ID of the stack set that you want to get
5528
- # automatic deployment targets for.
5924
+ # The name or unique ID of the StackSet that you want to get automatic
5925
+ # deployment targets for.
5529
5926
  # @return [String]
5530
5927
  #
5531
5928
  # @!attribute [rw] next_token
5532
- # A string that identifies the next page of stack set deployment
5533
- # targets that you want to retrieve.
5929
+ # The token for the next set of items to return. (You received this
5930
+ # token from a previous call.)
5534
5931
  # @return [String]
5535
5932
  #
5536
5933
  # @!attribute [rw] max_results
@@ -5575,7 +5972,7 @@ module Aws::CloudFormation
5575
5972
  end
5576
5973
 
5577
5974
  # @!attribute [rw] summaries
5578
- # An array of summaries of the deployment targets for the stack set.
5975
+ # An array of summaries of the deployment targets for the StackSet.
5579
5976
  # @return [Array<Types::StackSetAutoDeploymentTargetSummary>]
5580
5977
  #
5581
5978
  # @!attribute [rw] next_token
@@ -5600,22 +5997,17 @@ module Aws::CloudFormation
5600
5997
  end
5601
5998
 
5602
5999
  # @!attribute [rw] stack_set_name
5603
- # The name or unique ID of the stack set that you want to get
5604
- # operation results for.
6000
+ # The name or unique ID of the StackSet that you want to get operation
6001
+ # results for.
5605
6002
  # @return [String]
5606
6003
  #
5607
6004
  # @!attribute [rw] operation_id
5608
- # The ID of the stack set operation.
6005
+ # The ID of the StackSet operation.
5609
6006
  # @return [String]
5610
6007
  #
5611
6008
  # @!attribute [rw] next_token
5612
- # If the previous request didn't return all the remaining results,
5613
- # the response object's `NextToken` parameter value is set to a
5614
- # token. To retrieve the next set of results, call
5615
- # `ListStackSetOperationResults` again and assign that token to the
5616
- # request object's `NextToken` parameter. If there are no remaining
5617
- # results, the previous response object's `NextToken` parameter is
5618
- # set to `null`.
6009
+ # The token for the next set of items to return. (You received this
6010
+ # token from a previous call.)
5619
6011
  # @return [String]
5620
6012
  #
5621
6013
  # @!attribute [rw] max_results
@@ -5630,7 +6022,7 @@ module Aws::CloudFormation
5630
6022
  # an account administrator in the organization's management account
5631
6023
  # or as a delegated administrator in a member account.
5632
6024
  #
5633
- # By default, `SELF` is specified. Use `SELF` for stack sets with
6025
+ # By default, `SELF` is specified. Use `SELF` for StackSets with
5634
6026
  # self-managed permissions.
5635
6027
  #
5636
6028
  # * If you are signed in to the management account, specify `SELF`.
@@ -5689,18 +6081,13 @@ module Aws::CloudFormation
5689
6081
  end
5690
6082
 
5691
6083
  # @!attribute [rw] stack_set_name
5692
- # The name or unique ID of the stack set that you want to get
5693
- # operation summaries for.
6084
+ # The name or unique ID of the StackSet that you want to get operation
6085
+ # summaries for.
5694
6086
  # @return [String]
5695
6087
  #
5696
6088
  # @!attribute [rw] next_token
5697
- # If the previous paginated request didn't return all of the
5698
- # remaining results, the response object's `NextToken` parameter
5699
- # value is set to a token. To retrieve the next set of results, call
5700
- # `ListStackSetOperations` again and assign that token to the request
5701
- # object's `NextToken` parameter. If there are no remaining results,
5702
- # the previous response object's `NextToken` parameter is set to
5703
- # `null`.
6089
+ # The token for the next set of items to return. (You received this
6090
+ # token from a previous call.)
5704
6091
  # @return [String]
5705
6092
  #
5706
6093
  # @!attribute [rw] max_results
@@ -5715,7 +6102,7 @@ module Aws::CloudFormation
5715
6102
  # an account administrator in the organization's management account
5716
6103
  # or as a delegated administrator in a member account.
5717
6104
  #
5718
- # By default, `SELF` is specified. Use `SELF` for stack sets with
6105
+ # By default, `SELF` is specified. Use `SELF` for StackSets with
5719
6106
  # self-managed permissions.
5720
6107
  #
5721
6108
  # * If you are signed in to the management account, specify `SELF`.
@@ -5746,7 +6133,7 @@ module Aws::CloudFormation
5746
6133
 
5747
6134
  # @!attribute [rw] summaries
5748
6135
  # A list of `StackSetOperationSummary` structures that contain summary
5749
- # information about operations for the specified stack set.
6136
+ # information about operations for the specified StackSet.
5750
6137
  # @return [Array<Types::StackSetOperationSummary>]
5751
6138
  #
5752
6139
  # @!attribute [rw] next_token
@@ -5767,12 +6154,8 @@ module Aws::CloudFormation
5767
6154
  end
5768
6155
 
5769
6156
  # @!attribute [rw] next_token
5770
- # If the previous paginated request didn't return all the remaining
5771
- # results, the response object's `NextToken` parameter value is set
5772
- # to a token. To retrieve the next set of results, call
5773
- # `ListStackSets` again and assign that token to the request object's
5774
- # `NextToken` parameter. If there are no remaining results, the
5775
- # previous response object's `NextToken` parameter is set to `null`.
6157
+ # The token for the next set of items to return. (You received this
6158
+ # token from a previous call.)
5776
6159
  # @return [String]
5777
6160
  #
5778
6161
  # @!attribute [rw] max_results
@@ -5783,8 +6166,8 @@ module Aws::CloudFormation
5783
6166
  # @return [Integer]
5784
6167
  #
5785
6168
  # @!attribute [rw] status
5786
- # The status of the stack sets that you want to get summary
5787
- # information about.
6169
+ # The status of the StackSets that you want to get summary information
6170
+ # about.
5788
6171
  # @return [String]
5789
6172
  #
5790
6173
  # @!attribute [rw] call_as
@@ -5792,7 +6175,7 @@ module Aws::CloudFormation
5792
6175
  # an account administrator in the management account or as a delegated
5793
6176
  # administrator in a member account.
5794
6177
  #
5795
- # By default, `SELF` is specified. Use `SELF` for stack sets with
6178
+ # By default, `SELF` is specified. Use `SELF` for StackSets with
5796
6179
  # self-managed permissions.
5797
6180
  #
5798
6181
  # * If you are signed in to the management account, specify `SELF`.
@@ -5823,7 +6206,7 @@ module Aws::CloudFormation
5823
6206
 
5824
6207
  # @!attribute [rw] summaries
5825
6208
  # A list of `StackSetSummary` structures that contain information
5826
- # about the user's stack sets.
6209
+ # about the user's StackSets.
5827
6210
  # @return [Array<Types::StackSetSummary>]
5828
6211
  #
5829
6212
  # @!attribute [rw] next_token
@@ -5846,8 +6229,8 @@ module Aws::CloudFormation
5846
6229
  # The input for ListStacks action.
5847
6230
  #
5848
6231
  # @!attribute [rw] next_token
5849
- # A string that identifies the next page of stacks that you want to
5850
- # retrieve.
6232
+ # The token for the next set of items to return. (You received this
6233
+ # token from a previous call.)
5851
6234
  # @return [String]
5852
6235
  #
5853
6236
  # @!attribute [rw] stack_status_filter
@@ -5923,12 +6306,8 @@ module Aws::CloudFormation
5923
6306
  # @return [Integer]
5924
6307
  #
5925
6308
  # @!attribute [rw] next_token
5926
- # If the previous paginated request didn't return all the remaining
5927
- # results, the response object's `NextToken` parameter value is set
5928
- # to a token. To retrieve the next set of results, call this action
5929
- # again and assign that token to the request object's `NextToken`
5930
- # parameter. If there are no remaining results, the previous response
5931
- # object's `NextToken` parameter is set to `null`.
6309
+ # The token for the next set of items to return. (You received this
6310
+ # token from a previous call.)
5932
6311
  # @return [String]
5933
6312
  #
5934
6313
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/ListTypeRegistrationsInput AWS API Documentation
@@ -5999,12 +6378,8 @@ module Aws::CloudFormation
5999
6378
  # @return [Integer]
6000
6379
  #
6001
6380
  # @!attribute [rw] next_token
6002
- # If the previous paginated request didn't return all of the
6003
- # remaining results, the response object's `NextToken` parameter
6004
- # value is set to a token. To retrieve the next set of results, call
6005
- # this action again and assign that token to the request object's
6006
- # `NextToken` parameter. If there are no remaining results, the
6007
- # previous response object's `NextToken` parameter is set to `null`.
6381
+ # The token for the next set of items to return. (You received this
6382
+ # token from a previous call.)
6008
6383
  # @return [String]
6009
6384
  #
6010
6385
  # @!attribute [rw] deprecated_status
@@ -6081,8 +6456,7 @@ module Aws::CloudFormation
6081
6456
  # Region.
6082
6457
  # * `PUBLIC`: Extensions that are publicly visible and available to be
6083
6458
  # activated within any Amazon Web Services account. This includes
6084
- # extensions from Amazon Web Services, in addition to third-party
6085
- # publishers.
6459
+ # extensions from Amazon Web Services and third-party publishers.
6086
6460
  #
6087
6461
  # The default is `PRIVATE`.
6088
6462
  # @return [String]
@@ -6143,12 +6517,8 @@ module Aws::CloudFormation
6143
6517
  # @return [Integer]
6144
6518
  #
6145
6519
  # @!attribute [rw] next_token
6146
- # If the previous paginated request didn't return all the remaining
6147
- # results, the response object's `NextToken` parameter value is set
6148
- # to a token. To retrieve the next set of results, call this action
6149
- # again and assign that token to the request object's `NextToken`
6150
- # parameter. If there are no remaining results, the previous response
6151
- # object's `NextToken` parameter is set to `null`.
6520
+ # The token for the next set of items to return. (You received this
6521
+ # token from a previous call.)
6152
6522
  # @return [String]
6153
6523
  #
6154
6524
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/ListTypesInput AWS API Documentation
@@ -6187,6 +6557,31 @@ module Aws::CloudFormation
6187
6557
  include Aws::Structure
6188
6558
  end
6189
6559
 
6560
+ # Contains drift information for a resource property, including actual
6561
+ # value, previous deployment value, and drift detection timestamp.
6562
+ #
6563
+ # @!attribute [rw] previous_value
6564
+ # The configuration value from the previous CloudFormation deployment.
6565
+ # @return [String]
6566
+ #
6567
+ # @!attribute [rw] actual_value
6568
+ # The current live configuration value of the resource property.
6569
+ # @return [String]
6570
+ #
6571
+ # @!attribute [rw] drift_detection_timestamp
6572
+ # The timestamp when drift was detected for this resource property.
6573
+ # @return [Time]
6574
+ #
6575
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/LiveResourceDrift AWS API Documentation
6576
+ #
6577
+ class LiveResourceDrift < Struct.new(
6578
+ :previous_value,
6579
+ :actual_value,
6580
+ :drift_detection_timestamp)
6581
+ SENSITIVE = []
6582
+ include Aws::Structure
6583
+ end
6584
+
6190
6585
  # Contains logging configuration information for an extension.
6191
6586
  #
6192
6587
  # @!attribute [rw] log_role_arn
@@ -6212,16 +6607,16 @@ module Aws::CloudFormation
6212
6607
  # concurrently and queues conflicting operations.
6213
6608
  #
6214
6609
  # @!attribute [rw] active
6215
- # When `true`, StackSets performs non-conflicting operations
6610
+ # When `true`, CloudFormation performs non-conflicting operations
6216
6611
  # concurrently and queues conflicting operations. After conflicting
6217
- # operations finish, StackSets starts queued operations in request
6218
- # order.
6612
+ # operations finish, CloudFormation starts queued operations in
6613
+ # request order.
6219
6614
  #
6220
- # <note markdown="1"> If there are already running or queued operations, StackSets queues
6221
- # all incoming operations even if they are non-conflicting.
6615
+ # <note markdown="1"> If there are already running or queued operations, CloudFormation
6616
+ # queues all incoming operations even if they are non-conflicting.
6222
6617
  #
6223
- # You can't modify your stack set's execution configuration while
6224
- # there are running or queued operations for that stack set.
6618
+ # You can't modify your StackSet's execution configuration while
6619
+ # there are running or queued operations for that StackSet.
6225
6620
  #
6226
6621
  # </note>
6227
6622
  #
@@ -6294,14 +6689,179 @@ module Aws::CloudFormation
6294
6689
  #
6295
6690
  class NameAlreadyExistsException < Aws::EmptyStructure; end
6296
6691
 
6692
+ # Contains information about a CloudFormation operation.
6693
+ #
6694
+ # @!attribute [rw] operation_type
6695
+ # The type of operation.
6696
+ # @return [String]
6697
+ #
6698
+ # @!attribute [rw] operation_id
6699
+ # The unique identifier for the operation.
6700
+ # @return [String]
6701
+ #
6702
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/OperationEntry AWS API Documentation
6703
+ #
6704
+ class OperationEntry < Struct.new(
6705
+ :operation_type,
6706
+ :operation_id)
6707
+ SENSITIVE = []
6708
+ include Aws::Structure
6709
+ end
6710
+
6711
+ # Contains detailed information about an event that occurred during a
6712
+ # CloudFormation operation.
6713
+ #
6714
+ # @!attribute [rw] event_id
6715
+ # A unique identifier for this event.
6716
+ # @return [String]
6717
+ #
6718
+ # @!attribute [rw] stack_id
6719
+ # The unique ID name of the instance of the stack.
6720
+ # @return [String]
6721
+ #
6722
+ # @!attribute [rw] operation_id
6723
+ # The unique identifier of the operation this event belongs to.
6724
+ # @return [String]
6725
+ #
6726
+ # @!attribute [rw] operation_type
6727
+ # The type of operation.
6728
+ # @return [String]
6729
+ #
6730
+ # @!attribute [rw] operation_status
6731
+ # The current status of the operation.
6732
+ # @return [String]
6733
+ #
6734
+ # @!attribute [rw] event_type
6735
+ # The type of event.
6736
+ # @return [String]
6737
+ #
6738
+ # @!attribute [rw] logical_resource_id
6739
+ # The logical name of the resource as specified in the template.
6740
+ # @return [String]
6741
+ #
6742
+ # @!attribute [rw] physical_resource_id
6743
+ # The name or unique identifier that corresponds to a physical
6744
+ # instance ID of a resource.
6745
+ # @return [String]
6746
+ #
6747
+ # @!attribute [rw] resource_type
6748
+ # Type of resource.
6749
+ # @return [String]
6750
+ #
6751
+ # @!attribute [rw] timestamp
6752
+ # Time the status was updated.
6753
+ # @return [Time]
6754
+ #
6755
+ # @!attribute [rw] start_time
6756
+ # The time when the event started.
6757
+ # @return [Time]
6758
+ #
6759
+ # @!attribute [rw] end_time
6760
+ # The time when the event ended.
6761
+ # @return [Time]
6762
+ #
6763
+ # @!attribute [rw] resource_status
6764
+ # Current status of the resource.
6765
+ # @return [String]
6766
+ #
6767
+ # @!attribute [rw] resource_status_reason
6768
+ # Success or failure message associated with the resource.
6769
+ # @return [String]
6770
+ #
6771
+ # @!attribute [rw] resource_properties
6772
+ # The properties used to create the resource.
6773
+ # @return [String]
6774
+ #
6775
+ # @!attribute [rw] client_request_token
6776
+ # A unique identifier for the request that initiated this operation.
6777
+ # @return [String]
6778
+ #
6779
+ # @!attribute [rw] hook_type
6780
+ # The type name of the Hook that was invoked.
6781
+ # @return [String]
6782
+ #
6783
+ # @!attribute [rw] hook_status
6784
+ # The status of the Hook invocation.
6785
+ # @return [String]
6786
+ #
6787
+ # @!attribute [rw] hook_status_reason
6788
+ # Additional information about the Hook status.
6789
+ # @return [String]
6790
+ #
6791
+ # @!attribute [rw] hook_invocation_point
6792
+ # The point in the operation lifecycle when the Hook was invoked.
6793
+ # @return [String]
6794
+ #
6795
+ # @!attribute [rw] hook_failure_mode
6796
+ # Specifies how Hook failures are handled.
6797
+ # @return [String]
6798
+ #
6799
+ # @!attribute [rw] detailed_status
6800
+ # Additional status information about the operation.
6801
+ # @return [String]
6802
+ #
6803
+ # @!attribute [rw] validation_failure_mode
6804
+ # Specifies how validation failures are handled.
6805
+ # @return [String]
6806
+ #
6807
+ # @!attribute [rw] validation_name
6808
+ # The name of the validation that was performed.
6809
+ # @return [String]
6810
+ #
6811
+ # @!attribute [rw] validation_status
6812
+ # The status of the validation.
6813
+ # @return [String]
6814
+ #
6815
+ # @!attribute [rw] validation_status_reason
6816
+ # Additional information about the validation status.
6817
+ # @return [String]
6818
+ #
6819
+ # @!attribute [rw] validation_path
6820
+ # The path within the resource where the validation was applied.
6821
+ # @return [String]
6822
+ #
6823
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/OperationEvent AWS API Documentation
6824
+ #
6825
+ class OperationEvent < Struct.new(
6826
+ :event_id,
6827
+ :stack_id,
6828
+ :operation_id,
6829
+ :operation_type,
6830
+ :operation_status,
6831
+ :event_type,
6832
+ :logical_resource_id,
6833
+ :physical_resource_id,
6834
+ :resource_type,
6835
+ :timestamp,
6836
+ :start_time,
6837
+ :end_time,
6838
+ :resource_status,
6839
+ :resource_status_reason,
6840
+ :resource_properties,
6841
+ :client_request_token,
6842
+ :hook_type,
6843
+ :hook_status,
6844
+ :hook_status_reason,
6845
+ :hook_invocation_point,
6846
+ :hook_failure_mode,
6847
+ :detailed_status,
6848
+ :validation_failure_mode,
6849
+ :validation_name,
6850
+ :validation_status,
6851
+ :validation_status_reason,
6852
+ :validation_path)
6853
+ SENSITIVE = []
6854
+ include Aws::Structure
6855
+ end
6856
+
6297
6857
  # The specified operation ID already exists.
6298
6858
  #
6299
6859
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/OperationIdAlreadyExistsException AWS API Documentation
6300
6860
  #
6301
6861
  class OperationIdAlreadyExistsException < Aws::EmptyStructure; end
6302
6862
 
6303
- # Another operation is currently in progress for this stack set. Only
6304
- # one operation can be performed for a stack set at a given time.
6863
+ # Another operation is currently in progress for this StackSet. Only one
6864
+ # operation can be performed for a stack set at a given time.
6305
6865
  #
6306
6866
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/OperationInProgressException AWS API Documentation
6307
6867
  #
@@ -6343,7 +6903,7 @@ module Aws::CloudFormation
6343
6903
  #
6344
6904
  class OperationStatusCheckFailedException < Aws::EmptyStructure; end
6345
6905
 
6346
- # The Output data type.
6906
+ # The `Output` data type.
6347
6907
  #
6348
6908
  # @!attribute [rw] output_key
6349
6909
  # The key associated with the output.
@@ -6372,7 +6932,7 @@ module Aws::CloudFormation
6372
6932
  include Aws::Structure
6373
6933
  end
6374
6934
 
6375
- # The Parameter data type.
6935
+ # The `Parameter` data type.
6376
6936
  #
6377
6937
  # @!attribute [rw] parameter_key
6378
6938
  # The key associated with the parameter. If you don't specify a key
@@ -6429,7 +6989,7 @@ module Aws::CloudFormation
6429
6989
  include Aws::Structure
6430
6990
  end
6431
6991
 
6432
- # The ParameterDeclaration data type.
6992
+ # The `ParameterDeclaration` data type.
6433
6993
  #
6434
6994
  # @!attribute [rw] parameter_key
6435
6995
  # The name that's associated with the parameter.
@@ -6930,8 +7490,10 @@ module Aws::CloudFormation
6930
7490
  # @!attribute [rw] action
6931
7491
  # The action that CloudFormation takes on the resource, such as `Add`
6932
7492
  # (adds a new resource), `Modify` (changes a resource), `Remove`
6933
- # (deletes a resource), `Import` (imports a resource), or `Dynamic`
6934
- # (exact action for the resource can't be determined).
7493
+ # (deletes a resource), `Import` (imports a resource), `Dynamic`
7494
+ # (exact action for the resource can't be determined), or
7495
+ # `SyncWithActual` (resource will not be changed, only CloudFormation
7496
+ # metadata will change).
6935
7497
  # @return [String]
6936
7498
  #
6937
7499
  # @!attribute [rw] logical_resource_id
@@ -6970,6 +7532,31 @@ module Aws::CloudFormation
6970
7532
  # attribute's `Metadata`, `Properties`, or `Tags`.
6971
7533
  # @return [Array<String>]
6972
7534
  #
7535
+ # @!attribute [rw] resource_drift_status
7536
+ # The drift status of the resource. Valid values:
7537
+ #
7538
+ # * `IN_SYNC` – The resource matches its template definition.
7539
+ #
7540
+ # * `MODIFIED` – Resource properties were modified outside
7541
+ # CloudFormation.
7542
+ #
7543
+ # * `DELETED` – The resource was deleted outside CloudFormation.
7544
+ #
7545
+ # * `NOT_CHECKED` – CloudFormation doesn’t currently return this
7546
+ # value.
7547
+ #
7548
+ # * `UNKNOWN` – Drift status could not be determined.
7549
+ #
7550
+ # * `UNSUPPORTED` – Resource type does not support actual state
7551
+ # comparison.
7552
+ #
7553
+ # Only present for drift-aware change sets.
7554
+ # @return [String]
7555
+ #
7556
+ # @!attribute [rw] resource_drift_ignored_attributes
7557
+ # List of resource attributes for which drift was ignored.
7558
+ # @return [Array<Types::ResourceDriftIgnoredAttribute>]
7559
+ #
6973
7560
  # @!attribute [rw] details
6974
7561
  # For the `Modify` action, a list of `ResourceChangeDetail` structures
6975
7562
  # that describes the changes that CloudFormation will make to the
@@ -6996,6 +7583,11 @@ module Aws::CloudFormation
6996
7583
  # after the change is executed.
6997
7584
  # @return [String]
6998
7585
  #
7586
+ # @!attribute [rw] previous_deployment_context
7587
+ # Information about the resource's state from the previous
7588
+ # CloudFormation deployment.
7589
+ # @return [String]
7590
+ #
6999
7591
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/ResourceChange AWS API Documentation
7000
7592
  #
7001
7593
  class ResourceChange < Struct.new(
@@ -7006,11 +7598,14 @@ module Aws::CloudFormation
7006
7598
  :resource_type,
7007
7599
  :replacement,
7008
7600
  :scope,
7601
+ :resource_drift_status,
7602
+ :resource_drift_ignored_attributes,
7009
7603
  :details,
7010
7604
  :change_set_id,
7011
7605
  :module_info,
7012
7606
  :before_context,
7013
- :after_context)
7607
+ :after_context,
7608
+ :previous_deployment_context)
7014
7609
  SENSITIVE = []
7015
7610
  include Aws::Structure
7016
7611
  end
@@ -7072,6 +7667,9 @@ module Aws::CloudFormation
7072
7667
  # nested stack's template might have changed. Changes to a nested
7073
7668
  # stack's template aren't visible to CloudFormation until you run
7074
7669
  # an update on the parent stack.
7670
+ #
7671
+ # * `NoModification` entities are changes made to the template that
7672
+ # matches the actual state of the resource.
7075
7673
  # @return [String]
7076
7674
  #
7077
7675
  # @!attribute [rw] causing_entity
@@ -7214,6 +7812,32 @@ module Aws::CloudFormation
7214
7812
  include Aws::Structure
7215
7813
  end
7216
7814
 
7815
+ # The `ResourceDriftIgnoredAttribute` data type.
7816
+ #
7817
+ # @!attribute [rw] path
7818
+ # Path of the resource attribute for which drift was ignored.
7819
+ # @return [String]
7820
+ #
7821
+ # @!attribute [rw] reason
7822
+ # Reason why drift was ignored for the attribute, can have 2 possible
7823
+ # values:
7824
+ #
7825
+ # * `WRITE_ONLY_PROPERTY` - Property is not included in read response
7826
+ # for the resource’s live state.
7827
+ #
7828
+ # * `MANAGED_BY_AWS` - Property is managed by an Amazon Web Services
7829
+ # service and is expected to be dynamically modified.
7830
+ # @return [String]
7831
+ #
7832
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/ResourceDriftIgnoredAttribute AWS API Documentation
7833
+ #
7834
+ class ResourceDriftIgnoredAttribute < Struct.new(
7835
+ :path,
7836
+ :reason)
7837
+ SENSITIVE = []
7838
+ include Aws::Structure
7839
+ end
7840
+
7217
7841
  # Describes the target resources of a specific type in your import
7218
7842
  # template (for example, all `AWS::S3::Bucket` resources) and the
7219
7843
  # properties you can provide during the import to identify resources of
@@ -7417,6 +8041,33 @@ module Aws::CloudFormation
7417
8041
  # can be truncated.
7418
8042
  # @return [String]
7419
8043
  #
8044
+ # @!attribute [rw] before_value_from
8045
+ # Indicates the source of the before value. Valid values:
8046
+ #
8047
+ # * `ACTUAL_STATE` – The before value represents current actual state.
8048
+ #
8049
+ # * `PREVIOUS_DEPLOYMENT_STATE` – The before value represents the
8050
+ # previous CloudFormation deployment state.
8051
+ #
8052
+ # Only present for drift-aware change sets.
8053
+ # @return [String]
8054
+ #
8055
+ # @!attribute [rw] after_value_from
8056
+ # Indicates the source of the after value. Valid value:
8057
+ #
8058
+ # * `TEMPLATE` – The after value comes from the new template.
8059
+ #
8060
+ # ^
8061
+ #
8062
+ # Only present for drift-aware change sets.
8063
+ # @return [String]
8064
+ #
8065
+ # @!attribute [rw] drift
8066
+ # Detailed drift information for the resource property, including
8067
+ # actual values, previous deployment values, and drift detection
8068
+ # timestamps.
8069
+ # @return [Types::LiveResourceDrift]
8070
+ #
7420
8071
  # @!attribute [rw] attribute_change_type
7421
8072
  # The type of change to be made to the property if the change is
7422
8073
  # executed.
@@ -7426,6 +8077,9 @@ module Aws::CloudFormation
7426
8077
  # * `Remove` The item will be removed.
7427
8078
  #
7428
8079
  # * `Modify` The item will be modified.
8080
+ #
8081
+ # * `SyncWithActual` The drift status of this item will be reset but
8082
+ # the item will not be modified.
7429
8083
  # @return [String]
7430
8084
  #
7431
8085
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/ResourceTargetDefinition AWS API Documentation
@@ -7437,6 +8091,9 @@ module Aws::CloudFormation
7437
8091
  :path,
7438
8092
  :before_value,
7439
8093
  :after_value,
8094
+ :before_value_from,
8095
+ :after_value_from,
8096
+ :drift,
7440
8097
  :attribute_change_type)
7441
8098
  SENSITIVE = []
7442
8099
  include Aws::Structure
@@ -7585,10 +8242,16 @@ module Aws::CloudFormation
7585
8242
  # Unique identifier of the stack.
7586
8243
  # @return [String]
7587
8244
  #
8245
+ # @!attribute [rw] operation_id
8246
+ # A unique identifier for this rollback operation that can be used to
8247
+ # track the operation's progress and events.
8248
+ # @return [String]
8249
+ #
7588
8250
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/RollbackStackOutput AWS API Documentation
7589
8251
  #
7590
8252
  class RollbackStackOutput < Struct.new(
7591
- :stack_id)
8253
+ :stack_id,
8254
+ :operation_id)
7592
8255
  SENSITIVE = []
7593
8256
  include Aws::Structure
7594
8257
  end
@@ -7774,8 +8437,8 @@ module Aws::CloudFormation
7774
8437
  end
7775
8438
 
7776
8439
  # @!attribute [rw] type_arn
7777
- # The Amazon Resource Name (ARN) for the extension, in this account
7778
- # and Region.
8440
+ # The Amazon Resource Name (ARN) for the extension in this account and
8441
+ # Region.
7779
8442
  #
7780
8443
  # For public extensions, this will be the ARN assigned when you call
7781
8444
  # the [ActivateType][1] API operation in this account and Region. For
@@ -7793,19 +8456,15 @@ module Aws::CloudFormation
7793
8456
  # @return [String]
7794
8457
  #
7795
8458
  # @!attribute [rw] configuration
7796
- # The configuration data for the extension, in this account and
7797
- # Region.
8459
+ # The configuration data for the extension in this account and Region.
7798
8460
  #
7799
- # The configuration data must be formatted as JSON, and validate
7800
- # against the schema returned in the `ConfigurationSchema` response
7801
- # element of [DescribeType][1]. For more information, see [Defining
7802
- # the account-level configuration of an extension][2] in the
7803
- # *CloudFormation Command Line Interface (CLI) User Guide*.
8461
+ # The configuration data must be formatted as JSON and validate
8462
+ # against the extension's schema returned in the `Schema` response
8463
+ # element of [DescribeType][1].
7804
8464
  #
7805
8465
  #
7806
8466
  #
7807
8467
  # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_DescribeType.html
7808
- # [2]: https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/resource-type-model.html#resource-type-howto-configuration
7809
8468
  # @return [String]
7810
8469
  #
7811
8470
  # @!attribute [rw] configuration_alias
@@ -7842,7 +8501,7 @@ module Aws::CloudFormation
7842
8501
  end
7843
8502
 
7844
8503
  # @!attribute [rw] configuration_arn
7845
- # The Amazon Resource Name (ARN) for the configuration data, in this
8504
+ # The Amazon Resource Name (ARN) for the configuration data in this
7846
8505
  # account and Region.
7847
8506
  #
7848
8507
  # Conditional: You must specify `ConfigurationArn`, or `Type` and
@@ -7914,10 +8573,10 @@ module Aws::CloudFormation
7914
8573
  #
7915
8574
  # @!attribute [rw] unique_id
7916
8575
  # A unique ID of the signal. When you signal Amazon EC2 instances or
7917
- # Auto Scaling groups, specify the instance ID that you are signaling
7918
- # as the unique ID. If you send multiple signals to a single resource
7919
- # (such as signaling a wait condition), each signal requires a
7920
- # different unique ID.
8576
+ # Amazon EC2 Auto Scaling groups, specify the instance ID that you are
8577
+ # signaling as the unique ID. If you send multiple signals to a single
8578
+ # resource (such as signaling a wait condition), each signal requires
8579
+ # a different unique ID.
7921
8580
  # @return [String]
7922
8581
  #
7923
8582
  # @!attribute [rw] status
@@ -7937,7 +8596,7 @@ module Aws::CloudFormation
7937
8596
  include Aws::Structure
7938
8597
  end
7939
8598
 
7940
- # The Stack data type.
8599
+ # The `Stack` data type.
7941
8600
  #
7942
8601
  # @!attribute [rw] stack_id
7943
8602
  # Unique identifier of the stack.
@@ -8094,7 +8753,7 @@ module Aws::CloudFormation
8094
8753
  # The detailed status of the resource or stack. If
8095
8754
  # `CONFIGURATION_COMPLETE` is present, the resource or resource
8096
8755
  # configuration phase has completed and the stabilization of the
8097
- # resources is in progress. The stack sets `CONFIGURATION_COMPLETE`
8756
+ # resources is in progress. The StackSets `CONFIGURATION_COMPLETE`
8098
8757
  # when all of the resources in the stack have reached that event. For
8099
8758
  # more information, see [Understand CloudFormation stack creation
8100
8759
  # events][1] in the *CloudFormation User Guide*.
@@ -8104,6 +8763,11 @@ module Aws::CloudFormation
8104
8763
  # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stack-resource-configuration-complete.html
8105
8764
  # @return [String]
8106
8765
  #
8766
+ # @!attribute [rw] last_operations
8767
+ # Information about the most recent operations performed on this
8768
+ # stack.
8769
+ # @return [Array<Types::OperationEntry>]
8770
+ #
8107
8771
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/Stack AWS API Documentation
8108
8772
  #
8109
8773
  class Stack < Struct.new(
@@ -8131,7 +8795,8 @@ module Aws::CloudFormation
8131
8795
  :drift_information,
8132
8796
  :retain_except_on_create,
8133
8797
  :deletion_mode,
8134
- :detailed_status)
8798
+ :detailed_status,
8799
+ :last_operations)
8135
8800
  SENSITIVE = []
8136
8801
  include Aws::Structure
8137
8802
  end
@@ -8238,20 +8903,25 @@ module Aws::CloudFormation
8238
8903
  include Aws::Structure
8239
8904
  end
8240
8905
 
8241
- # The StackEvent data type.
8906
+ # The `StackEvent` data type.
8242
8907
  #
8243
8908
  # @!attribute [rw] stack_id
8244
8909
  # The unique ID name of the instance of the stack.
8245
8910
  # @return [String]
8246
8911
  #
8247
8912
  # @!attribute [rw] event_id
8248
- # The unique ID of this event.
8913
+ # The unique identifier of this event.
8249
8914
  # @return [String]
8250
8915
  #
8251
8916
  # @!attribute [rw] stack_name
8252
8917
  # The name associated with a stack.
8253
8918
  # @return [String]
8254
8919
  #
8920
+ # @!attribute [rw] operation_id
8921
+ # The unique identifier of the operation that generated this stack
8922
+ # event.
8923
+ # @return [String]
8924
+ #
8255
8925
  # @!attribute [rw] logical_resource_id
8256
8926
  # The logical name of the resource specified in the template.
8257
8927
  # @return [String]
@@ -8306,24 +8976,28 @@ module Aws::CloudFormation
8306
8976
  # @return [String]
8307
8977
  #
8308
8978
  # @!attribute [rw] hook_type
8309
- # The name of the hook.
8979
+ # The name of the Hook.
8310
8980
  # @return [String]
8311
8981
  #
8312
8982
  # @!attribute [rw] hook_status
8313
- # Provides the status of the change set hook.
8983
+ # Provides the status of the change set Hook.
8314
8984
  # @return [String]
8315
8985
  #
8316
8986
  # @!attribute [rw] hook_status_reason
8317
- # Provides the reason for the hook status.
8987
+ # Provides the reason for the Hook status.
8318
8988
  # @return [String]
8319
8989
  #
8320
8990
  # @!attribute [rw] hook_invocation_point
8321
- # Invocation points are points in provisioning logic where Hooks are
8322
- # initiated.
8991
+ # The specific point in the provisioning process where the Hook is
8992
+ # invoked.
8993
+ # @return [String]
8994
+ #
8995
+ # @!attribute [rw] hook_invocation_id
8996
+ # The unique identifier of the Hook invocation.
8323
8997
  # @return [String]
8324
8998
  #
8325
8999
  # @!attribute [rw] hook_failure_mode
8326
- # Specify the hook failure mode for non-compliant resources in the
9000
+ # Specify the Hook failure mode for non-compliant resources in the
8327
9001
  # followings ways.
8328
9002
  #
8329
9003
  # * `FAIL` Stops provisioning resources.
@@ -8360,6 +9034,7 @@ module Aws::CloudFormation
8360
9034
  :stack_id,
8361
9035
  :event_id,
8362
9036
  :stack_name,
9037
+ :operation_id,
8363
9038
  :logical_resource_id,
8364
9039
  :physical_resource_id,
8365
9040
  :resource_type,
@@ -8372,6 +9047,7 @@ module Aws::CloudFormation
8372
9047
  :hook_status,
8373
9048
  :hook_status_reason,
8374
9049
  :hook_invocation_point,
9050
+ :hook_invocation_id,
8375
9051
  :hook_failure_mode,
8376
9052
  :detailed_status)
8377
9053
  SENSITIVE = []
@@ -8379,16 +9055,16 @@ module Aws::CloudFormation
8379
9055
  end
8380
9056
 
8381
9057
  # A CloudFormation stack, in a specific account and Region, that's part
8382
- # of a stack set operation. A stack instance is a reference to an
9058
+ # of a StackSet operation. A stack instance is a reference to an
8383
9059
  # attempted or actual stack in a given account within a given Region. A
8384
9060
  # stack instance can exist without a stack—for example, if the stack
8385
9061
  # couldn't be created for some reason. A stack instance is associated
8386
- # with only one stack set. Each stack instance contains the ID of its
8387
- # associated stack set, in addition to the ID of the actual stack and
8388
- # the stack status.
9062
+ # with only one StackSet. Each stack instance contains the ID of its
9063
+ # associated StackSet, in addition to the ID of the actual stack and the
9064
+ # stack status.
8389
9065
  #
8390
9066
  # @!attribute [rw] stack_set_id
8391
- # The name or unique ID of the stack set that the stack instance is
9067
+ # The name or unique ID of the StackSet that the stack instance is
8392
9068
  # associated with.
8393
9069
  # @return [String]
8394
9070
  #
@@ -8407,7 +9083,7 @@ module Aws::CloudFormation
8407
9083
  # @return [String]
8408
9084
  #
8409
9085
  # @!attribute [rw] parameter_overrides
8410
- # A list of parameters from the stack set template whose values have
9086
+ # A list of parameters from the StackSet template whose values have
8411
9087
  # been overridden in this stack instance.
8412
9088
  # @return [Array<Types::Parameter>]
8413
9089
  #
@@ -8427,8 +9103,8 @@ module Aws::CloudFormation
8427
9103
  # `StackInstanceSummary` member that is a peer to this `Status`
8428
9104
  # member.
8429
9105
  #
8430
- # * `OUTDATED`: The stack isn't currently up to date with the stack
8431
- # set because:
9106
+ # * `OUTDATED`: The stack isn't currently up to date with the
9107
+ # StackSet because:
8432
9108
  #
8433
9109
  # * The associated stack failed during a `CreateStackSet` or
8434
9110
  # `UpdateStackSet` operation.
@@ -8436,7 +9112,7 @@ module Aws::CloudFormation
8436
9112
  # * The stack was part of a `CreateStackSet` or `UpdateStackSet`
8437
9113
  # operation that failed or was stopped before the stack was
8438
9114
  # created or updated.
8439
- # * `CURRENT`: The stack is currently up to date with the stack set.
9115
+ # * `CURRENT`: The stack is currently up to date with the StackSet.
8440
9116
  # @return [String]
8441
9117
  #
8442
9118
  # @!attribute [rw] stack_instance_status
@@ -8460,19 +9136,19 @@ module Aws::CloudFormation
8460
9136
  #
8461
9137
  # @!attribute [rw] drift_status
8462
9138
  # Status of the stack instance's actual configuration compared to the
8463
- # expected template and parameter configuration of the stack set to
8464
- # which it belongs.
9139
+ # expected template and parameter configuration of the StackSet it
9140
+ # belongs to.
8465
9141
  #
8466
9142
  # * `DRIFTED`: The stack differs from the expected template and
8467
- # parameter configuration of the stack set to which it belongs. A
8468
- # stack instance is considered to have drifted if one or more of the
9143
+ # parameter configuration of the StackSet it belongs to. A stack
9144
+ # instance is considered to have drifted if one or more of the
8469
9145
  # resources in the associated stack have drifted.
8470
9146
  #
8471
9147
  # * `NOT_CHECKED`: CloudFormation hasn't checked if the stack
8472
- # instance differs from its expected stack set configuration.
9148
+ # instance differs from its expected StackSet configuration.
8473
9149
  #
8474
9150
  # * `IN_SYNC`: The stack instance's actual configuration matches its
8475
- # expected stack set configuration.
9151
+ # expected StackSset configuration.
8476
9152
  #
8477
9153
  # * `UNKNOWN`: This value is reserved for future use.
8478
9154
  # @return [String]
@@ -8480,7 +9156,7 @@ module Aws::CloudFormation
8480
9156
  # @!attribute [rw] last_drift_check_timestamp
8481
9157
  # Most recent time when CloudFormation performed a drift detection
8482
9158
  # operation on the stack instance. This value will be `NULL` for any
8483
- # stack instance on which drift detection hasn't yet been performed.
9159
+ # stack instance that drift detection hasn't yet been performed on.
8484
9160
  # @return [Time]
8485
9161
  #
8486
9162
  # @!attribute [rw] last_operation_id
@@ -8511,21 +9187,21 @@ module Aws::CloudFormation
8511
9187
  #
8512
9188
  # @!attribute [rw] detailed_status
8513
9189
  # * `CANCELLED`: The operation in the specified account and Region has
8514
- # been canceled. This is either because a user has stopped the stack
8515
- # set operation, or because the failure tolerance of the stack set
8516
- # operation has been exceeded.
9190
+ # been canceled. This is either because a user has stopped the
9191
+ # StackSet operation, or because the failure tolerance of the
9192
+ # StackSet operation has been exceeded.
8517
9193
  #
8518
9194
  # * `FAILED`: The operation in the specified account and Region
8519
- # failed. If the stack set operation fails in enough accounts within
8520
- # a Region, the failure tolerance for the stack set operation as a
9195
+ # failed. If the StackSet operation fails in enough accounts within
9196
+ # a Region, the failure tolerance for the StackSet operation as a
8521
9197
  # whole might be exceeded.
8522
9198
  #
8523
9199
  # * `FAILED_IMPORT`: The import of the stack instance in the specified
8524
9200
  # account and Region failed and left the stack in an unstable state.
8525
9201
  # Once the issues causing the failure are fixed, the import
8526
- # operation can be retried. If enough stack set operations fail in
9202
+ # operation can be retried. If enough StackSet operations fail in
8527
9203
  # enough accounts within a Region, the failure tolerance for the
8528
- # stack set operation as a whole might be exceeded.
9204
+ # StackSet operation as a whole might be exceeded.
8529
9205
  #
8530
9206
  # * `INOPERABLE`: A `DeleteStackInstances` operation has failed and
8531
9207
  # left the stack in an unstable state. Stacks in this state are
@@ -8661,7 +9337,7 @@ module Aws::CloudFormation
8661
9337
  # instance.
8662
9338
  #
8663
9339
  # @!attribute [rw] stack_set_id
8664
- # The name or unique ID of the stack set that the stack instance is
9340
+ # The name or unique ID of the StackSet that the stack instance is
8665
9341
  # associated with.
8666
9342
  # @return [String]
8667
9343
  #
@@ -8695,8 +9371,8 @@ module Aws::CloudFormation
8695
9371
  # look at the `DetailedStatus` member returned in the
8696
9372
  # `StackInstanceSummary` member.
8697
9373
  #
8698
- # * `OUTDATED`: The stack isn't currently up to date with the stack
8699
- # set because:
9374
+ # * `OUTDATED`: The stack isn't currently up to date with the
9375
+ # StackSet because:
8700
9376
  #
8701
9377
  # * The associated stack failed during a `CreateStackSet` or
8702
9378
  # `UpdateStackSet` operation.
@@ -8704,7 +9380,7 @@ module Aws::CloudFormation
8704
9380
  # * The stack was part of a `CreateStackSet` or `UpdateStackSet`
8705
9381
  # operation that failed or was stopped before the stack was
8706
9382
  # created or updated.
8707
- # * `CURRENT`: The stack is currently up to date with the stack set.
9383
+ # * `CURRENT`: The stack is currently up to date with the StackSet.
8708
9384
  # @return [String]
8709
9385
  #
8710
9386
  # @!attribute [rw] status_reason
@@ -8728,19 +9404,19 @@ module Aws::CloudFormation
8728
9404
  #
8729
9405
  # @!attribute [rw] drift_status
8730
9406
  # Status of the stack instance's actual configuration compared to the
8731
- # expected template and parameter configuration of the stack set to
8732
- # which it belongs.
9407
+ # expected template and parameter configuration of the StackSet it
9408
+ # belongs to.
8733
9409
  #
8734
9410
  # * `DRIFTED`: The stack differs from the expected template and
8735
- # parameter configuration of the stack set to which it belongs. A
8736
- # stack instance is considered to have drifted if one or more of the
9411
+ # parameter configuration of the StackSet it belongs to. A stack
9412
+ # instance is considered to have drifted if one or more of the
8737
9413
  # resources in the associated stack have drifted.
8738
9414
  #
8739
9415
  # * `NOT_CHECKED`: CloudFormation hasn't checked if the stack
8740
- # instance differs from its expected stack set configuration.
9416
+ # instance differs from its expected StackSet configuration.
8741
9417
  #
8742
9418
  # * `IN_SYNC`: The stack instance's actual configuration matches its
8743
- # expected stack set configuration.
9419
+ # expected StackSet configuration.
8744
9420
  #
8745
9421
  # * `UNKNOWN`: This value is reserved for future use.
8746
9422
  # @return [String]
@@ -8748,7 +9424,7 @@ module Aws::CloudFormation
8748
9424
  # @!attribute [rw] last_drift_check_timestamp
8749
9425
  # Most recent time when CloudFormation performed a drift detection
8750
9426
  # operation on the stack instance. This value will be `NULL` for any
8751
- # stack instance on which drift detection hasn't yet been performed.
9427
+ # stack instance that drift detection hasn't yet been performed on.
8752
9428
  # @return [Time]
8753
9429
  #
8754
9430
  # @!attribute [rw] last_operation_id
@@ -8904,7 +9580,7 @@ module Aws::CloudFormation
8904
9580
  include Aws::Structure
8905
9581
  end
8906
9582
 
8907
- # The StackResource data type.
9583
+ # The `StackResource` data type.
8908
9584
  #
8909
9585
  # @!attribute [rw] stack_name
8910
9586
  # The name associated with the stack.
@@ -9359,40 +10035,40 @@ module Aws::CloudFormation
9359
10035
  include Aws::Structure
9360
10036
  end
9361
10037
 
9362
- # A structure that contains information about a stack set. A stack set
9363
- # enables you to provision stacks into Amazon Web Services accounts and
9364
- # across Regions by using a single CloudFormation template. In the stack
9365
- # set, you specify the template to use, in addition to any parameters
9366
- # and capabilities that the template requires.
10038
+ # A structure that contains information about a StackSet. With
10039
+ # StackSets, you can provision stacks across Amazon Web Services
10040
+ # accounts and Regions from a single CloudFormation template. Each stack
10041
+ # is based on the same CloudFormation template, but you can customize
10042
+ # individual stacks using parameters.
9367
10043
  #
9368
10044
  # @!attribute [rw] stack_set_name
9369
- # The name that's associated with the stack set.
10045
+ # The name that's associated with the StackSet.
9370
10046
  # @return [String]
9371
10047
  #
9372
10048
  # @!attribute [rw] stack_set_id
9373
- # The ID of the stack set.
10049
+ # The ID of the StackSet.
9374
10050
  # @return [String]
9375
10051
  #
9376
10052
  # @!attribute [rw] description
9377
- # A description of the stack set that you specify when the stack set
9378
- # is created or updated.
10053
+ # A description of the StackSet that you specify when the StackSet is
10054
+ # created or updated.
9379
10055
  # @return [String]
9380
10056
  #
9381
10057
  # @!attribute [rw] status
9382
- # The status of the stack set.
10058
+ # The status of the StackSet.
9383
10059
  # @return [String]
9384
10060
  #
9385
10061
  # @!attribute [rw] template_body
9386
10062
  # The structure that contains the body of the template that was used
9387
- # to create or update the stack set.
10063
+ # to create or update the StackSet.
9388
10064
  # @return [String]
9389
10065
  #
9390
10066
  # @!attribute [rw] parameters
9391
- # A list of input parameters for a stack set.
10067
+ # A list of input parameters for a StackSet.
9392
10068
  # @return [Array<Types::Parameter>]
9393
10069
  #
9394
10070
  # @!attribute [rw] capabilities
9395
- # The capabilities that are allowed in the stack set. Some stack set
10071
+ # The capabilities that are allowed in the StackSet. Some StackSet
9396
10072
  # templates might include resources that can affect permissions in
9397
10073
  # your Amazon Web Services account—for example, by creating new
9398
10074
  # Identity and Access Management (IAM) users. For more information,
@@ -9404,12 +10080,12 @@ module Aws::CloudFormation
9404
10080
  # @return [Array<String>]
9405
10081
  #
9406
10082
  # @!attribute [rw] tags
9407
- # A list of tags that specify information about the stack set. A
10083
+ # A list of tags that specify information about the StackSet. A
9408
10084
  # maximum number of 50 tags can be specified.
9409
10085
  # @return [Array<Types::Tag>]
9410
10086
  #
9411
10087
  # @!attribute [rw] stack_set_arn
9412
- # The Amazon Resource Name (ARN) of the stack set.
10088
+ # The Amazon Resource Name (ARN) of the StackSet.
9413
10089
  # @return [String]
9414
10090
  #
9415
10091
  # @!attribute [rw] administration_role_arn
@@ -9417,9 +10093,9 @@ module Aws::CloudFormation
9417
10093
  # update the stack set.
9418
10094
  #
9419
10095
  # Use customized administrator roles to control which users or groups
9420
- # can manage specific stack sets within the same administrator
9421
- # account. For more information, see [Prerequisites for using
9422
- # CloudFormation StackSets][1] in the *CloudFormation User Guide*.
10096
+ # can manage specific StackSets within the same administrator account.
10097
+ # For more information, see [Prerequisites for using CloudFormation
10098
+ # StackSets][1] in the *CloudFormation User Guide*.
9423
10099
  #
9424
10100
  #
9425
10101
  #
@@ -9428,28 +10104,29 @@ module Aws::CloudFormation
9428
10104
  #
9429
10105
  # @!attribute [rw] execution_role_name
9430
10106
  # The name of the IAM execution role used to create or update the
9431
- # stack set.
10107
+ # StackSet.
9432
10108
  #
9433
10109
  # Use customized execution roles to control which stack resources
9434
- # users and groups can include in their stack sets.
10110
+ # users and groups can include in their StackSets.
9435
10111
  # @return [String]
9436
10112
  #
9437
10113
  # @!attribute [rw] stack_set_drift_detection_details
9438
- # Detailed information about the drift status of the stack set.
10114
+ # Detailed information about the drift status of the StackSet.
9439
10115
  #
9440
- # For stack sets, contains information about the last *completed*
9441
- # drift operation performed on the stack set. Information about drift
10116
+ # For StackSets, contains information about the last *completed* drift
10117
+ # operation performed on the StackSet. Information about drift
9442
10118
  # operations currently in progress isn't included.
9443
10119
  # @return [Types::StackSetDriftDetectionDetails]
9444
10120
  #
9445
10121
  # @!attribute [rw] auto_deployment
9446
- # \[Service-managed permissions\] Describes whether StackSets
9447
- # automatically deploys to Organizations accounts that are added to a
9448
- # target organization or organizational unit (OU).
10122
+ # Describes whether StackSets automatically deploys to Organizations
10123
+ # accounts that are added to a target organization or organizational
10124
+ # unit (OU). Valid only if the StackSet uses service-managed
10125
+ # permissions.
9449
10126
  # @return [Types::AutoDeployment]
9450
10127
  #
9451
10128
  # @!attribute [rw] permission_model
9452
- # Describes how the IAM roles required for stack set operations are
10129
+ # Describes how the IAM roles required for StackSet operations are
9453
10130
  # created.
9454
10131
  #
9455
10132
  # * With `self-managed` permissions, you must create the administrator
@@ -9459,7 +10136,7 @@ module Aws::CloudFormation
9459
10136
  # * With `service-managed` permissions, StackSets automatically
9460
10137
  # creates the IAM roles required to deploy to accounts managed by
9461
10138
  # Organizations. For more information, see [Activate trusted access
9462
- # for stack sets with Organizations][2].
10139
+ # for StackSets with Organizations][2].
9463
10140
  #
9464
10141
  #
9465
10142
  #
@@ -9512,7 +10189,7 @@ module Aws::CloudFormation
9512
10189
  include Aws::Structure
9513
10190
  end
9514
10191
 
9515
- # One of the targets for the stack set. Returned by the
10192
+ # One of the targets for the StackSet. Returned by the
9516
10193
  # [ListStackSetAutoDeploymentTargets][1] API operation.
9517
10194
  #
9518
10195
  #
@@ -9521,7 +10198,7 @@ module Aws::CloudFormation
9521
10198
  #
9522
10199
  # @!attribute [rw] organizational_unit_id
9523
10200
  # The organization root ID or organizational unit (OU) IDs where the
9524
- # stack set is targeted.
10201
+ # StackSet is targeted.
9525
10202
  # @return [String]
9526
10203
  #
9527
10204
  # @!attribute [rw] regions
@@ -9537,14 +10214,14 @@ module Aws::CloudFormation
9537
10214
  include Aws::Structure
9538
10215
  end
9539
10216
 
9540
- # Detailed information about the drift status of the stack set.
10217
+ # Detailed information about the drift status of the StackSet.
9541
10218
  #
9542
- # For stack sets, contains information about the last *completed* drift
9543
- # operation performed on the stack set. Information about drift
10219
+ # For StackSets, contains information about the last *completed* drift
10220
+ # operation performed on the StackSet. Information about drift
9544
10221
  # operations in-progress isn't included.
9545
10222
  #
9546
- # For stack set operations, includes information about drift operations
9547
- # currently being performed on the stack set.
10223
+ # For StackSet operations, includes information about drift operations
10224
+ # currently being performed on the StackSet.
9548
10225
  #
9549
10226
  # For more information, see [Performing drift detection on
9550
10227
  # CloudFormation StackSets][1] in the *CloudFormation User Guide*.
@@ -9554,27 +10231,23 @@ module Aws::CloudFormation
9554
10231
  # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-drift.html
9555
10232
  #
9556
10233
  # @!attribute [rw] drift_status
9557
- # Status of the stack set's actual configuration compared to its
9558
- # expected template and parameter configuration. A stack set is
9559
- # considered to have drifted if one or more of its stack instances
9560
- # have drifted from their expected template and parameter
9561
- # configuration.
10234
+ # Status of the StackSet's actual configuration compared to its
10235
+ # expected template and parameter configuration.
9562
10236
  #
9563
10237
  # * `DRIFTED`: One or more of the stack instances belonging to the
9564
- # stack set stack differs from the expected template and parameter
10238
+ # StackSet differs from the expected template and parameter
9565
10239
  # configuration. A stack instance is considered to have drifted if
9566
10240
  # one or more of the resources in the associated stack have drifted.
9567
10241
  #
9568
- # * `NOT_CHECKED`: CloudFormation hasn't checked the stack set for
10242
+ # * `NOT_CHECKED`: CloudFormation hasn't checked the StackSet for
9569
10243
  # drift.
9570
10244
  #
9571
- # * `IN_SYNC`: All of the stack instances belonging to the stack set
9572
- # stack match from the expected template and parameter
9573
- # configuration.
10245
+ # * `IN_SYNC`: All of the stack instances belonging to the StackSet
10246
+ # stack match the expected template and parameter configuration.
9574
10247
  # @return [String]
9575
10248
  #
9576
10249
  # @!attribute [rw] drift_detection_status
9577
- # The status of the stack set drift detection operation.
10250
+ # The status of the StackSet drift detection operation.
9578
10251
  #
9579
10252
  # * `COMPLETED`: The drift detection operation completed without
9580
10253
  # failing on any stack instances.
@@ -9593,19 +10266,18 @@ module Aws::CloudFormation
9593
10266
  #
9594
10267
  # @!attribute [rw] last_drift_check_timestamp
9595
10268
  # Most recent time when CloudFormation performed a drift detection
9596
- # operation on the stack set. This value will be `NULL` for any stack
9597
- # set on which drift detection hasn't yet been performed.
10269
+ # operation on the StackSet. This value will be `NULL` for any
10270
+ # StackSet that drift detection hasn't yet been performed on.
9598
10271
  # @return [Time]
9599
10272
  #
9600
10273
  # @!attribute [rw] total_stack_instances_count
9601
- # The total number of stack instances belonging to this stack set.
10274
+ # The total number of stack instances belonging to this StackSet.
9602
10275
  #
9603
10276
  # The total number of stack instances is equal to the total of:
9604
10277
  #
9605
- # * Stack instances that match the stack set configuration.
10278
+ # * Stack instances that match the StackSet configuration.
9606
10279
  #
9607
- # * Stack instances that have drifted from the stack set
9608
- # configuration.
10280
+ # * Stack instances that have drifted from the StackSet configuration.
9609
10281
  #
9610
10282
  # * Stack instances where the drift detection operation has failed.
9611
10283
  #
@@ -9614,7 +10286,7 @@ module Aws::CloudFormation
9614
10286
  #
9615
10287
  # @!attribute [rw] drifted_stack_instances_count
9616
10288
  # The number of stack instances that have drifted from the expected
9617
- # template and parameter configuration of the stack set. A stack
10289
+ # template and parameter configuration of the StackSet. A stack
9618
10290
  # instance is considered to have drifted if one or more of the
9619
10291
  # resources in the associated stack don't match their expected
9620
10292
  # configuration.
@@ -9622,7 +10294,7 @@ module Aws::CloudFormation
9622
10294
  #
9623
10295
  # @!attribute [rw] in_sync_stack_instances_count
9624
10296
  # The number of stack instances which match the expected template and
9625
- # parameter configuration of the stack set.
10297
+ # parameter configuration of the StackSet.
9626
10298
  # @return [Integer]
9627
10299
  #
9628
10300
  # @!attribute [rw] in_progress_stack_instances_count
@@ -9650,36 +10322,36 @@ module Aws::CloudFormation
9650
10322
  include Aws::Structure
9651
10323
  end
9652
10324
 
9653
- # You can't yet delete this stack set, because it still contains one or
9654
- # more stack instances. Delete all stack instances from the stack set
9655
- # before deleting the stack set.
10325
+ # You can't yet delete this StackSet, because it still contains one or
10326
+ # more stack instances. Delete all stack instances from the StackSet
10327
+ # before deleting the StackSet.
9656
10328
  #
9657
10329
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/StackSetNotEmptyException AWS API Documentation
9658
10330
  #
9659
10331
  class StackSetNotEmptyException < Aws::EmptyStructure; end
9660
10332
 
9661
- # The specified stack set doesn't exist.
10333
+ # The specified StackSet doesn't exist.
9662
10334
  #
9663
10335
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/StackSetNotFoundException AWS API Documentation
9664
10336
  #
9665
10337
  class StackSetNotFoundException < Aws::EmptyStructure; end
9666
10338
 
9667
- # The structure that contains information about a stack set operation.
10339
+ # The structure that contains information about a StackSet operation.
9668
10340
  #
9669
10341
  # @!attribute [rw] operation_id
9670
- # The unique ID of a stack set operation.
10342
+ # The unique ID of a StackSet operation.
9671
10343
  # @return [String]
9672
10344
  #
9673
10345
  # @!attribute [rw] stack_set_id
9674
- # The ID of the stack set.
10346
+ # The ID of the StackSet.
9675
10347
  # @return [String]
9676
10348
  #
9677
10349
  # @!attribute [rw] action
9678
- # The type of stack set operation: `CREATE`, `UPDATE`, or `DELETE`.
9679
- # Create and delete operations affect only the specified stack set
9680
- # instances that are associated with the specified stack set. Update
9681
- # operations affect both the stack set itself, in addition to *all*
9682
- # associated stack set instances.
10350
+ # The type of StackSet operation: `CREATE`, `UPDATE`, or `DELETE`.
10351
+ # Create and delete operations affect only the specified stack
10352
+ # instances that are associated with the specified StackSet. Update
10353
+ # operations affect both the StackSet itself, in addition to *all*
10354
+ # associated stack instances.
9683
10355
  # @return [String]
9684
10356
  #
9685
10357
  # @!attribute [rw] status
@@ -9712,29 +10384,29 @@ module Aws::CloudFormation
9712
10384
  #
9713
10385
  #
9714
10386
  #
9715
- # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/what-is-cfnstacksets.html#stackset-status-codes
10387
+ # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-concepts.html#stackset-status-codes
9716
10388
  # @return [String]
9717
10389
  #
9718
10390
  # @!attribute [rw] operation_preferences
9719
- # The preferences for how CloudFormation performs this stack set
10391
+ # The preferences for how CloudFormation performs this StackSet
9720
10392
  # operation.
9721
10393
  # @return [Types::StackSetOperationPreferences]
9722
10394
  #
9723
10395
  # @!attribute [rw] retain_stacks
9724
- # For stack set operations of action type `DELETE`, specifies whether
9725
- # to remove the stack instances from the specified stack set, but
10396
+ # For StackSet operations of action type `DELETE`, specifies whether
10397
+ # to remove the stack instances from the specified StackSet, but
9726
10398
  # doesn't delete the stacks. You can't re-associate a retained
9727
- # stack, or add an existing, saved stack to a new stack set.
10399
+ # stack, or add an existing, saved stack to a new StackSet.
9728
10400
  # @return [Boolean]
9729
10401
  #
9730
10402
  # @!attribute [rw] administration_role_arn
9731
10403
  # The Amazon Resource Name (ARN) of the IAM role used to perform this
9732
- # stack set operation.
10404
+ # StackSet operation.
9733
10405
  #
9734
10406
  # Use customized administrator roles to control which users or groups
9735
- # can manage specific stack sets within the same administrator
9736
- # account. For more information, see [Grant self-managed
9737
- # permissions][1] in the *CloudFormation User Guide*.
10407
+ # can manage specific StackSets within the same administrator account.
10408
+ # For more information, see [Grant self-managed permissions][1] in the
10409
+ # *CloudFormation User Guide*.
9738
10410
  #
9739
10411
  #
9740
10412
  #
@@ -9743,10 +10415,10 @@ module Aws::CloudFormation
9743
10415
  #
9744
10416
  # @!attribute [rw] execution_role_name
9745
10417
  # The name of the IAM execution role used to create or update the
9746
- # stack set.
10418
+ # StackSet.
9747
10419
  #
9748
10420
  # Use customized execution roles to control which stack resources
9749
- # users and groups can include in their stack sets.
10421
+ # users and groups can include in their StackSets.
9750
10422
  # @return [String]
9751
10423
  #
9752
10424
  # @!attribute [rw] creation_timestamp
@@ -9759,23 +10431,23 @@ module Aws::CloudFormation
9759
10431
  # @return [Time]
9760
10432
  #
9761
10433
  # @!attribute [rw] end_timestamp
9762
- # The time at which the stack set operation ended, across all accounts
10434
+ # The time at which the StackSet operation ended, across all accounts
9763
10435
  # and Regions specified. Note that this doesn't necessarily mean that
9764
- # the stack set operation was successful, or even attempted, in each
10436
+ # the StackSet operation was successful, or even attempted, in each
9765
10437
  # account or Region.
9766
10438
  # @return [Time]
9767
10439
  #
9768
10440
  # @!attribute [rw] deployment_targets
9769
- # \[Service-managed permissions\] The Organizations accounts affected
9770
- # by the stack operation.
10441
+ # The Organizations accounts affected by the stack operation. Valid
10442
+ # only if the StackSet uses service-managed permissions.
9771
10443
  # @return [Types::DeploymentTargets]
9772
10444
  #
9773
10445
  # @!attribute [rw] stack_set_drift_detection_details
9774
- # Detailed information about the drift status of the stack set. This
10446
+ # Detailed information about the drift status of the StackSet. This
9775
10447
  # includes information about drift operations currently being
9776
- # performed on the stack set.
10448
+ # performed on the StackSet.
9777
10449
  #
9778
- # This information will only be present for stack set operations whose
10450
+ # This information will only be present for StackSet operations whose
9779
10451
  # `Action` type is `DETECT_DRIFT`.
9780
10452
  #
9781
10453
  # For more information, see [Performing drift detection on
@@ -9815,11 +10487,11 @@ module Aws::CloudFormation
9815
10487
  include Aws::Structure
9816
10488
  end
9817
10489
 
9818
- # The user-specified preferences for how CloudFormation performs a stack
9819
- # set operation.
10490
+ # The user-specified preferences for how CloudFormation performs a
10491
+ # StackSet operation.
9820
10492
  #
9821
10493
  # For more information about maximum concurrent accounts and failure
9822
- # tolerance, see [Stack set operation options][1].
10494
+ # tolerance, see [StackSet operation options][1].
9823
10495
  #
9824
10496
  # <note markdown="1"> `StackSetOperationPreferences` don't apply to `AutoDeployment`, even
9825
10497
  # if it's enabled.
@@ -9828,7 +10500,7 @@ module Aws::CloudFormation
9828
10500
  #
9829
10501
  #
9830
10502
  #
9831
- # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/what-is-cfnstacksets.html#stackset-ops-options
10503
+ # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-concepts.html#stackset-ops-options
9832
10504
  #
9833
10505
  # @!attribute [rw] region_concurrency_type
9834
10506
  # The concurrency type of deploying StackSets operations in Regions,
@@ -9841,10 +10513,10 @@ module Aws::CloudFormation
9841
10513
  # @return [Array<String>]
9842
10514
  #
9843
10515
  # @!attribute [rw] failure_tolerance_count
9844
- # The number of accounts, per Region, for which this operation can
9845
- # fail before CloudFormation stops the operation in that Region. If
9846
- # the operation is stopped in a Region, CloudFormation doesn't
9847
- # attempt the operation in any subsequent Regions.
10516
+ # The number of accounts per Region this operation can fail in before
10517
+ # CloudFormation stops the operation in that Region. If the operation
10518
+ # is stopped in a Region, CloudFormation doesn't attempt the
10519
+ # operation in any subsequent Regions.
9848
10520
  #
9849
10521
  # You can specify either `FailureToleranceCount` or
9850
10522
  # `FailureTolerancePercentage`, but not both.
@@ -9853,10 +10525,10 @@ module Aws::CloudFormation
9853
10525
  # @return [Integer]
9854
10526
  #
9855
10527
  # @!attribute [rw] failure_tolerance_percentage
9856
- # The percentage of accounts, per Region, for which this stack
9857
- # operation can fail before CloudFormation stops the operation in that
9858
- # Region. If the operation is stopped in a Region, CloudFormation
9859
- # doesn't attempt the operation in any subsequent Regions.
10528
+ # The percentage of accounts per Region this stack operation can fail
10529
+ # in before CloudFormation stops the operation in that Region. If the
10530
+ # operation is stopped in a Region, CloudFormation doesn't attempt
10531
+ # the operation in any subsequent Regions.
9860
10532
  #
9861
10533
  # When calculating the number of accounts based on the specified
9862
10534
  # percentage, CloudFormation rounds *down* to the next whole number.
@@ -9922,7 +10594,7 @@ module Aws::CloudFormation
9922
10594
  #
9923
10595
  # * `SOFT_FAILURE_TOLERANCE`: This option decouples
9924
10596
  # `FailureToleranceCount` from the actual concurrency. This allows
9925
- # stack set operations to run at the concurrency level set by the
10597
+ # StackSet operations to run at the concurrency level set by the
9926
10598
  # `MaxConcurrentCount` value, or `MaxConcurrentPercentage`,
9927
10599
  # regardless of the number of failures.
9928
10600
  # @return [String]
@@ -9955,19 +10627,19 @@ module Aws::CloudFormation
9955
10627
  # @return [String]
9956
10628
  #
9957
10629
  # @!attribute [rw] status
9958
- # The result status of the stack set operation for the given account
9959
- # in the given Region.
10630
+ # The result status of the StackSet operation for the given account in
10631
+ # the given Region.
9960
10632
  #
9961
10633
  # * `CANCELLED`: The operation in the specified account and Region has
9962
- # been canceled. This is either because a user has stopped the stack
9963
- # set operation, or because the failure tolerance of the stack set
9964
- # operation has been exceeded.
10634
+ # been canceled. This is either because a user has stopped the
10635
+ # StackSet operation, or because the failure tolerance of the
10636
+ # StackSet operation has been exceeded.
9965
10637
  #
9966
10638
  # * `FAILED`: The operation in the specified account and Region
9967
10639
  # failed.
9968
10640
  #
9969
- # If the stack set operation fails in enough accounts within a
9970
- # Region, the failure tolerance for the stack set operation as a
10641
+ # If the StackSet operation fails in enough accounts within a
10642
+ # Region, the failure tolerance for the StackSet operation as a
9971
10643
  # whole might be exceeded.
9972
10644
  #
9973
10645
  # * `RUNNING`: The operation in the specified account and Region is
@@ -9986,7 +10658,7 @@ module Aws::CloudFormation
9986
10658
  #
9987
10659
  # @!attribute [rw] account_gate_result
9988
10660
  # The results of the account gate function CloudFormation invokes, if
9989
- # present, before proceeding with stack set operations in an account.
10661
+ # present, before proceeding with StackSet operations in an account.
9990
10662
  # @return [Types::AccountGateResult]
9991
10663
  #
9992
10664
  # @!attribute [rw] organizational_unit_id
@@ -10031,14 +10703,14 @@ module Aws::CloudFormation
10031
10703
  # operation.
10032
10704
  #
10033
10705
  # @!attribute [rw] operation_id
10034
- # The unique ID of the stack set operation.
10706
+ # The unique ID of the StackSet operation.
10035
10707
  # @return [String]
10036
10708
  #
10037
10709
  # @!attribute [rw] action
10038
10710
  # The type of operation: `CREATE`, `UPDATE`, or `DELETE`. Create and
10039
10711
  # delete operations affect only the specified stack instances that are
10040
- # associated with the specified stack set. Update operations affect
10041
- # both the stack set itself and *all* associated stack set instances.
10712
+ # associated with the specified StackSet. Update operations affect
10713
+ # both the StackSet itself and *all* associated StackSet instances.
10042
10714
  # @return [String]
10043
10715
  #
10044
10716
  # @!attribute [rw] status
@@ -10055,8 +10727,8 @@ module Aws::CloudFormation
10055
10727
  #
10056
10728
  # * `QUEUED`: \[Service-managed permissions\] For automatic
10057
10729
  # deployments that require a sequence of operations, the operation
10058
- # is queued to be performed. For more information, see the [stack
10059
- # set operation status codes][1] in the *CloudFormation User Guide*.
10730
+ # is queued to be performed. For more information, see the [StackSet
10731
+ # status codes][1] in the *CloudFormation User Guide*.
10060
10732
  #
10061
10733
  # * `RUNNING`: The operation is currently being performed.
10062
10734
  #
@@ -10071,12 +10743,12 @@ module Aws::CloudFormation
10071
10743
  #
10072
10744
  #
10073
10745
  #
10074
- # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/what-is-cfnstacksets.html#stackset-status-codes
10746
+ # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-concepts.html#stackset-status-codes
10075
10747
  # @return [String]
10076
10748
  #
10077
10749
  # @!attribute [rw] creation_timestamp
10078
10750
  # The time at which the operation was initiated. Note that the
10079
- # creation times for the stack set operation might differ from the
10751
+ # creation times for the StackSet operation might differ from the
10080
10752
  # creation time of the individual stacks themselves. This is because
10081
10753
  # CloudFormation needs to perform preparatory work for the operation,
10082
10754
  # such as dispatching the work to the requested Regions, before
@@ -10084,9 +10756,9 @@ module Aws::CloudFormation
10084
10756
  # @return [Time]
10085
10757
  #
10086
10758
  # @!attribute [rw] end_timestamp
10087
- # The time at which the stack set operation ended, across all accounts
10759
+ # The time at which the StackSet operation ended, across all accounts
10088
10760
  # and Regions specified. Note that this doesn't necessarily mean that
10089
- # the stack set operation was successful, or even attempted, in each
10761
+ # the StackSet operation was successful, or even attempted, in each
10090
10762
  # account or Region.
10091
10763
  # @return [Time]
10092
10764
  #
@@ -10095,19 +10767,19 @@ module Aws::CloudFormation
10095
10767
  # @return [String]
10096
10768
  #
10097
10769
  # @!attribute [rw] status_details
10098
- # Detailed information about the stack set operation.
10770
+ # Detailed information about the StackSet operation.
10099
10771
  # @return [Types::StackSetOperationStatusDetails]
10100
10772
  #
10101
10773
  # @!attribute [rw] operation_preferences
10102
10774
  # The user-specified preferences for how CloudFormation performs a
10103
- # stack set operation.
10775
+ # StackSet operation.
10104
10776
  #
10105
10777
  # For more information about maximum concurrent accounts and failure
10106
- # tolerance, see [Stack set operation options][1].
10778
+ # tolerance, see [StackSet operation options][1].
10107
10779
  #
10108
10780
  #
10109
10781
  #
10110
- # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/what-is-cfnstacksets.html#stackset-ops-options
10782
+ # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-concepts.html#stackset-ops-options
10111
10783
  # @return [Types::StackSetOperationPreferences]
10112
10784
  #
10113
10785
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/StackSetOperationSummary AWS API Documentation
@@ -10126,23 +10798,23 @@ module Aws::CloudFormation
10126
10798
  end
10127
10799
 
10128
10800
  # The structures that contain summary information about the specified
10129
- # stack set.
10801
+ # StackSet.
10130
10802
  #
10131
10803
  # @!attribute [rw] stack_set_name
10132
- # The name of the stack set.
10804
+ # The name of the StackSet.
10133
10805
  # @return [String]
10134
10806
  #
10135
10807
  # @!attribute [rw] stack_set_id
10136
- # The ID of the stack set.
10808
+ # The ID of the StackSet.
10137
10809
  # @return [String]
10138
10810
  #
10139
10811
  # @!attribute [rw] description
10140
- # A description of the stack set that you specify when the stack set
10141
- # is created or updated.
10812
+ # A description of the StackSet that you specify when the StackSet is
10813
+ # created or updated.
10142
10814
  # @return [String]
10143
10815
  #
10144
10816
  # @!attribute [rw] status
10145
- # The status of the stack set.
10817
+ # The status of the StackSet.
10146
10818
  # @return [String]
10147
10819
  #
10148
10820
  # @!attribute [rw] auto_deployment
@@ -10152,7 +10824,7 @@ module Aws::CloudFormation
10152
10824
  # @return [Types::AutoDeployment]
10153
10825
  #
10154
10826
  # @!attribute [rw] permission_model
10155
- # Describes how the IAM roles required for stack set operations are
10827
+ # Describes how the IAM roles required for StackSet operations are
10156
10828
  # created.
10157
10829
  #
10158
10830
  # * With `self-managed` permissions, you must create the administrator
@@ -10162,7 +10834,7 @@ module Aws::CloudFormation
10162
10834
  # * With `service-managed` permissions, StackSets automatically
10163
10835
  # creates the IAM roles required to deploy to accounts managed by
10164
10836
  # Organizations. For more information, see [Activate trusted access
10165
- # for stack sets with Organizations][2].
10837
+ # for StackSets with Organizations][2].
10166
10838
  #
10167
10839
  #
10168
10840
  #
@@ -10171,31 +10843,27 @@ module Aws::CloudFormation
10171
10843
  # @return [String]
10172
10844
  #
10173
10845
  # @!attribute [rw] drift_status
10174
- # Status of the stack set's actual configuration compared to its
10175
- # expected template and parameter configuration. A stack set is
10176
- # considered to have drifted if one or more of its stack instances
10177
- # have drifted from their expected template and parameter
10178
- # configuration.
10846
+ # Status of the StackSet's actual configuration compared to its
10847
+ # expected template and parameter configuration.
10179
10848
  #
10180
10849
  # * `DRIFTED`: One or more of the stack instances belonging to the
10181
- # stack set stack differs from the expected template and parameter
10850
+ # StackSet differs from the expected template and parameter
10182
10851
  # configuration. A stack instance is considered to have drifted if
10183
10852
  # one or more of the resources in the associated stack have drifted.
10184
10853
  #
10185
- # * `NOT_CHECKED`: CloudFormation hasn't checked the stack set for
10854
+ # * `NOT_CHECKED`: CloudFormation hasn't checked the StackSet for
10186
10855
  # drift.
10187
10856
  #
10188
- # * `IN_SYNC`: All the stack instances belonging to the stack set
10189
- # stack match from the expected template and parameter
10190
- # configuration.
10857
+ # * `IN_SYNC`: All the stack instances belonging to the StackSet match
10858
+ # the expected template and parameter configuration.
10191
10859
  #
10192
10860
  # * `UNKNOWN`: This value is reserved for future use.
10193
10861
  # @return [String]
10194
10862
  #
10195
10863
  # @!attribute [rw] last_drift_check_timestamp
10196
10864
  # Most recent time when CloudFormation performed a drift detection
10197
- # operation on the stack set. This value will be `NULL` for any stack
10198
- # set on which drift detection hasn't yet been performed.
10865
+ # operation on the StackSet. This value will be `NULL` for any
10866
+ # StackSet that drift detection hasn't yet been performed on.
10199
10867
  # @return [Time]
10200
10868
  #
10201
10869
  # @!attribute [rw] managed_execution
@@ -10219,7 +10887,7 @@ module Aws::CloudFormation
10219
10887
  include Aws::Structure
10220
10888
  end
10221
10889
 
10222
- # The StackSummary Data Type
10890
+ # The `StackSummary` Data Type
10223
10891
  #
10224
10892
  # @!attribute [rw] stack_id
10225
10893
  # Unique stack identifier.
@@ -10292,6 +10960,11 @@ module Aws::CloudFormation
10292
10960
  # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-stack-drift.html
10293
10961
  # @return [Types::StackDriftInformationSummary]
10294
10962
  #
10963
+ # @!attribute [rw] last_operations
10964
+ # Information about the most recent operations performed on this
10965
+ # stack.
10966
+ # @return [Array<Types::OperationEntry>]
10967
+ #
10295
10968
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/StackSummary AWS API Documentation
10296
10969
  #
10297
10970
  class StackSummary < Struct.new(
@@ -10305,12 +10978,13 @@ module Aws::CloudFormation
10305
10978
  :stack_status_reason,
10306
10979
  :parent_id,
10307
10980
  :root_id,
10308
- :drift_information)
10981
+ :drift_information,
10982
+ :last_operations)
10309
10983
  SENSITIVE = []
10310
10984
  include Aws::Structure
10311
10985
  end
10312
10986
 
10313
- # Another operation has been performed on this stack set since the
10987
+ # Another operation has been performed on this StackSet since the
10314
10988
  # specified operation was performed.
10315
10989
  #
10316
10990
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/StaleRequestException AWS API Documentation
@@ -10353,7 +11027,7 @@ module Aws::CloudFormation
10353
11027
  end
10354
11028
 
10355
11029
  # @!attribute [rw] stack_set_name
10356
- # The name or unique ID of the stack set that you want to stop the
11030
+ # The name or unique ID of the StackSet that you want to stop the
10357
11031
  # operation for.
10358
11032
  # @return [String]
10359
11033
  #
@@ -10362,11 +11036,12 @@ module Aws::CloudFormation
10362
11036
  # @return [String]
10363
11037
  #
10364
11038
  # @!attribute [rw] call_as
10365
- # \[Service-managed permissions\] Specifies whether you are acting as
10366
- # an account administrator in the organization's management account
10367
- # or as a delegated administrator in a member account.
11039
+ # Specifies whether you are acting as an account administrator in the
11040
+ # organization's management account or as a delegated administrator
11041
+ # in a member account. Valid only if the StackSet uses service-managed
11042
+ # permissions.
10368
11043
  #
10369
- # By default, `SELF` is specified. Use `SELF` for stack sets with
11044
+ # By default, `SELF` is specified. Use `SELF` for StackSets with
10370
11045
  # self-managed permissions.
10371
11046
  #
10372
11047
  # * If you are signed in to the management account, specify `SELF`.
@@ -10402,14 +11077,14 @@ module Aws::CloudFormation
10402
11077
  # to store information about an CloudFormation stack.
10403
11078
  #
10404
11079
  # @!attribute [rw] key
10405
- # *Required*. A string used to identify this tag. You can specify a
10406
- # maximum of 128 characters for a tag key. Tags owned by Amazon Web
10407
- # Services have the reserved prefix: `aws:`.
11080
+ # A string used to identify this tag. You can specify a maximum of 128
11081
+ # characters for a tag key. Tags owned by Amazon Web Services have the
11082
+ # reserved prefix: `aws:`.
10408
11083
  # @return [String]
10409
11084
  #
10410
11085
  # @!attribute [rw] value
10411
- # *Required*. A string that contains the value for this tag. You can
10412
- # specify a maximum of 256 characters for a tag value.
11086
+ # A string that contains the value for this tag. You can specify a
11087
+ # maximum of 256 characters for a tag value.
10413
11088
  # @return [String]
10414
11089
  #
10415
11090
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/Tag AWS API Documentation
@@ -10466,7 +11141,7 @@ module Aws::CloudFormation
10466
11141
  include Aws::Structure
10467
11142
  end
10468
11143
 
10469
- # The TemplateParameter data type.
11144
+ # The `TemplateParameter` data type.
10470
11145
  #
10471
11146
  # @!attribute [rw] parameter_key
10472
11147
  # The name associated with the parameter.
@@ -10704,8 +11379,7 @@ module Aws::CloudFormation
10704
11379
  # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/registry-set-configuration.html
10705
11380
  #
10706
11381
  # @!attribute [rw] arn
10707
- # The Amazon Resource Name (ARN) for the configuration data, in this
10708
- # account and Region.
11382
+ # The ARN for the configuration data, in this account and Region.
10709
11383
  # @return [String]
10710
11384
  #
10711
11385
  # @!attribute [rw] alias
@@ -10729,8 +11403,7 @@ module Aws::CloudFormation
10729
11403
  # @return [Time]
10730
11404
  #
10731
11405
  # @!attribute [rw] type_arn
10732
- # The Amazon Resource Name (ARN) for the extension, in this account
10733
- # and Region.
11406
+ # The ARN for the extension, in this account and Region.
10734
11407
  #
10735
11408
  # For public extensions, this will be the ARN assigned when you call
10736
11409
  # the [ActivateType][1] API operation in this account and Region. For
@@ -10770,8 +11443,7 @@ module Aws::CloudFormation
10770
11443
  # extension.
10771
11444
  #
10772
11445
  # @!attribute [rw] type_arn
10773
- # The Amazon Resource Name (ARN) for the extension, in this account
10774
- # and Region.
11446
+ # The ARN for the extension, in this account and Region.
10775
11447
  #
10776
11448
  # For public extensions, this will be the ARN assigned when you call
10777
11449
  # the [ActivateType][1] API operation in this account and Region. For
@@ -10790,8 +11462,7 @@ module Aws::CloudFormation
10790
11462
  # @return [String]
10791
11463
  #
10792
11464
  # @!attribute [rw] type_configuration_arn
10793
- # The Amazon Resource Name (ARN) for the configuration, in this
10794
- # account and Region.
11465
+ # The ARN for the configuration, in this account and Region.
10795
11466
  # @return [String]
10796
11467
  #
10797
11468
  # @!attribute [rw] type
@@ -10906,7 +11577,7 @@ module Aws::CloudFormation
10906
11577
  # @return [String]
10907
11578
  #
10908
11579
  # @!attribute [rw] type_arn
10909
- # The Amazon Resource Name (ARN) of the extension.
11580
+ # The ARN of the extension.
10910
11581
  # @return [String]
10911
11582
  #
10912
11583
  # @!attribute [rw] last_updated
@@ -11043,8 +11714,8 @@ module Aws::CloudFormation
11043
11714
  #
11044
11715
  # @!attribute [rw] version_id
11045
11716
  # The ID of a specific version of the extension. The version ID is the
11046
- # value at the end of the Amazon Resource Name (ARN) assigned to the
11047
- # extension version when it's registered.
11717
+ # value at the end of the ARN assigned to the extension version when
11718
+ # it's registered.
11048
11719
  # @return [String]
11049
11720
  #
11050
11721
  # @!attribute [rw] is_default_version
@@ -11057,7 +11728,7 @@ module Aws::CloudFormation
11057
11728
  # @return [Boolean]
11058
11729
  #
11059
11730
  # @!attribute [rw] arn
11060
- # The Amazon Resource Name (ARN) of the extension version.
11731
+ # The ARN of the extension version.
11061
11732
  # @return [String]
11062
11733
  #
11063
11734
  # @!attribute [rw] time_created
@@ -11191,9 +11862,19 @@ module Aws::CloudFormation
11191
11862
  # Reuse the existing template that is associated with the stack that
11192
11863
  # you are updating.
11193
11864
  #
11865
+ # When using templates with the `AWS::LanguageExtensions` transform,
11866
+ # provide the template instead of using `UsePreviousTemplate` to
11867
+ # ensure new parameter values and Systems Manager parameter updates
11868
+ # are applied correctly. For more information, see
11869
+ # [AWS::LanguageExtensions transform][1].
11870
+ #
11194
11871
  # Conditional: You must specify only one of the following parameters:
11195
11872
  # `TemplateBody`, `TemplateURL`, or set the `UsePreviousTemplate` to
11196
11873
  # `true`.
11874
+ #
11875
+ #
11876
+ #
11877
+ # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/transform-aws-languageextensions.html
11197
11878
  # @return [Boolean]
11198
11879
  #
11199
11880
  # @!attribute [rw] stack_policy_during_update_body
@@ -11328,16 +12009,15 @@ module Aws::CloudFormation
11328
12009
  # @return [Array<String>]
11329
12010
  #
11330
12011
  # @!attribute [rw] resource_types
11331
- # The template resource types that you have permissions to work with
11332
- # for this update stack action, such as `AWS::EC2::Instance`,
11333
- # `AWS::EC2::*`, or `Custom::MyCustomInstance`.
12012
+ # Specifies which resource types you can work with, such as
12013
+ # `AWS::EC2::Instance` or `Custom::MyCustomInstance`.
11334
12014
  #
11335
12015
  # If the list of resource types doesn't include a resource that
11336
12016
  # you're updating, the stack update fails. By default, CloudFormation
11337
12017
  # grants permissions to all resource types. IAM uses this parameter
11338
12018
  # for CloudFormation-specific condition keys in IAM policies. For more
11339
- # information, see [Control access with Identity and Access
11340
- # Management][1].
12019
+ # information, see [Control CloudFormation access with Identity and
12020
+ # Access Management][1].
11341
12021
  #
11342
12022
  # <note markdown="1"> Only one of the `Capabilities` and `ResourceType` parameters can be
11343
12023
  # specified.
@@ -11476,13 +12156,13 @@ module Aws::CloudFormation
11476
12156
  end
11477
12157
 
11478
12158
  # @!attribute [rw] stack_set_name
11479
- # The name or unique ID of the stack set associated with the stack
12159
+ # The name or unique ID of the StackSet associated with the stack
11480
12160
  # instances.
11481
12161
  # @return [String]
11482
12162
  #
11483
12163
  # @!attribute [rw] accounts
11484
12164
  # \[Self-managed permissions\] The account IDs of one or more Amazon
11485
- # Web Services accounts for which you want to update parameter values
12165
+ # Web Services accounts in which you want to update parameter values
11486
12166
  # for stack instances. The overridden parameter values will be applied
11487
12167
  # to all stack instances in the specified accounts and Amazon Web
11488
12168
  # Services Regions.
@@ -11491,7 +12171,7 @@ module Aws::CloudFormation
11491
12171
  # @return [Array<String>]
11492
12172
  #
11493
12173
  # @!attribute [rw] deployment_targets
11494
- # \[Service-managed permissions\] The Organizations accounts for which
12174
+ # \[Service-managed permissions\] The Organizations accounts in which
11495
12175
  # you want to update parameter values for stack instances. If your
11496
12176
  # update targets OUs, the overridden parameter values only apply to
11497
12177
  # the accounts that are currently in the target OUs and their child
@@ -11526,22 +12206,22 @@ module Aws::CloudFormation
11526
12206
  # can't specify both a value and set `UsePreviousValue` to `true`.)
11527
12207
  #
11528
12208
  # * To set an overridden parameter back to the value specified in the
11529
- # stack set, specify a parameter list but don't include the
12209
+ # StackSet, specify a parameter list but don't include the
11530
12210
  # parameter in the list.
11531
12211
  #
11532
12212
  # * To leave all parameters set to their present values, don't
11533
12213
  # specify this property at all.
11534
12214
  #
11535
- # During stack set updates, any parameter values overridden for a
11536
- # stack instance aren't updated, but retain their overridden value.
12215
+ # During StackSet updates, any parameter values overridden for a stack
12216
+ # instance aren't updated, but retain their overridden value.
11537
12217
  #
11538
12218
  # You can only override the parameter *values* that are specified in
11539
- # the stack set; to add or delete a parameter itself, use
11540
- # `UpdateStackSet` to update the stack set template. If you add a
12219
+ # the StackSet. To add or delete a parameter itself, use
12220
+ # `UpdateStackSet` to update the StackSet template. If you add a
11541
12221
  # parameter to a template, before you can override the parameter value
11542
- # specified in the stack set you must first use [UpdateStackSet][1] to
12222
+ # specified in the StackSet you must first use [UpdateStackSet][1] to
11543
12223
  # update all stack instances with the updated template and parameter
11544
- # value specified in the stack set. Once a stack instance has been
12224
+ # value specified in the StackSet. Once a stack instance has been
11545
12225
  # updated with the new parameter, you can then override the parameter
11546
12226
  # value using `UpdateStackInstances`.
11547
12227
  #
@@ -11551,16 +12231,15 @@ module Aws::CloudFormation
11551
12231
  # @return [Array<Types::Parameter>]
11552
12232
  #
11553
12233
  # @!attribute [rw] operation_preferences
11554
- # Preferences for how CloudFormation performs this stack set
11555
- # operation.
12234
+ # Preferences for how CloudFormation performs this StackSet operation.
11556
12235
  # @return [Types::StackSetOperationPreferences]
11557
12236
  #
11558
12237
  # @!attribute [rw] operation_id
11559
- # The unique identifier for this stack set operation.
12238
+ # The unique identifier for this StackSet operation.
11560
12239
  #
11561
12240
  # The operation ID also functions as an idempotency token, to ensure
11562
- # that CloudFormation performs the stack set operation only once, even
11563
- # if you retry the request multiple times. You might retry stack set
12241
+ # that CloudFormation performs the StackSet operation only once, even
12242
+ # if you retry the request multiple times. You might retry StackSet
11564
12243
  # operation requests to ensure that CloudFormation successfully
11565
12244
  # received them.
11566
12245
  #
@@ -11576,7 +12255,7 @@ module Aws::CloudFormation
11576
12255
  # an account administrator in the organization's management account
11577
12256
  # or as a delegated administrator in a member account.
11578
12257
  #
11579
- # By default, `SELF` is specified. Use `SELF` for stack sets with
12258
+ # By default, `SELF` is specified. Use `SELF` for StackSets with
11580
12259
  # self-managed permissions.
11581
12260
  #
11582
12261
  # * If you are signed in to the management account, specify `SELF`.
@@ -11610,7 +12289,7 @@ module Aws::CloudFormation
11610
12289
  end
11611
12290
 
11612
12291
  # @!attribute [rw] operation_id
11613
- # The unique identifier for this stack set operation.
12292
+ # The unique identifier for this StackSet operation.
11614
12293
  # @return [String]
11615
12294
  #
11616
12295
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/UpdateStackInstancesOutput AWS API Documentation
@@ -11627,16 +12306,22 @@ module Aws::CloudFormation
11627
12306
  # Unique identifier of the stack.
11628
12307
  # @return [String]
11629
12308
  #
12309
+ # @!attribute [rw] operation_id
12310
+ # A unique identifier for this update operation that can be used to
12311
+ # track the operation's progress and events.
12312
+ # @return [String]
12313
+ #
11630
12314
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/UpdateStackOutput AWS API Documentation
11631
12315
  #
11632
12316
  class UpdateStackOutput < Struct.new(
11633
- :stack_id)
12317
+ :stack_id,
12318
+ :operation_id)
11634
12319
  SENSITIVE = []
11635
12320
  include Aws::Structure
11636
12321
  end
11637
12322
 
11638
12323
  # @!attribute [rw] stack_set_name
11639
- # The name or unique ID of the stack set that you want to update.
12324
+ # The name or unique ID of the StackSet that you want to update.
11640
12325
  # @return [String]
11641
12326
  #
11642
12327
  # @!attribute [rw] description
@@ -11665,7 +12350,7 @@ module Aws::CloudFormation
11665
12350
  # @return [String]
11666
12351
  #
11667
12352
  # @!attribute [rw] use_previous_template
11668
- # Use the existing template that's associated with the stack set that
12353
+ # Use the existing template that's associated with the StackSet that
11669
12354
  # you're updating.
11670
12355
  #
11671
12356
  # Conditional: You must specify only one of the following parameters:
@@ -11674,13 +12359,13 @@ module Aws::CloudFormation
11674
12359
  # @return [Boolean]
11675
12360
  #
11676
12361
  # @!attribute [rw] parameters
11677
- # A list of input parameters for the stack set template.
12362
+ # A list of input parameters for the StackSet template.
11678
12363
  # @return [Array<Types::Parameter>]
11679
12364
  #
11680
12365
  # @!attribute [rw] capabilities
11681
12366
  # In some cases, you must explicitly acknowledge that your stack
11682
12367
  # template contains certain capabilities in order for CloudFormation
11683
- # to update the stack set and its associated stack instances.
12368
+ # to update the StackSet and its associated stack instances.
11684
12369
  #
11685
12370
  # * `CAPABILITY_IAM` and `CAPABILITY_NAMED_IAM`
11686
12371
  #
@@ -11721,21 +12406,21 @@ module Aws::CloudFormation
11721
12406
  #
11722
12407
  # * `CAPABILITY_AUTO_EXPAND`
11723
12408
  #
11724
- # Some templates reference macros. If your stack set template
11725
- # references one or more macros, you must update the stack set
12409
+ # Some templates reference macros. If your StackSet template
12410
+ # references one or more macros, you must update the StackSet
11726
12411
  # directly from the processed template, without first reviewing the
11727
- # resulting changes in a change set. To update the stack set
12412
+ # resulting changes in a change set. To update the StackSet
11728
12413
  # directly, you must acknowledge this capability. For more
11729
12414
  # information, see [Perform custom processing on CloudFormation
11730
12415
  # templates with template macros][9].
11731
12416
  #
11732
- # Stack sets with service-managed permissions do not currently
12417
+ # StackSets with service-managed permissions do not currently
11733
12418
  # support the use of macros in templates. (This includes the
11734
12419
  # [AWS::Include][10] and [AWS::Serverless][11] transforms, which are
11735
12420
  # macros hosted by CloudFormation.) Even if you specify this
11736
- # capability for a stack set with service-managed permissions, if
11737
- # you reference a macro in your template the stack set operation
11738
- # will fail.
12421
+ # capability for a StackSet with service-managed permissions, if you
12422
+ # reference a macro in your template the StackSet operation will
12423
+ # fail.
11739
12424
  #
11740
12425
  #
11741
12426
  #
@@ -11753,24 +12438,24 @@ module Aws::CloudFormation
11753
12438
  # @return [Array<String>]
11754
12439
  #
11755
12440
  # @!attribute [rw] tags
11756
- # The key-value pairs to associate with this stack set and the stacks
12441
+ # The key-value pairs to associate with this StackSet and the stacks
11757
12442
  # created from it. CloudFormation also propagates these tags to
11758
12443
  # supported resources that are created in the stacks. You can specify
11759
12444
  # a maximum number of 50 tags.
11760
12445
  #
11761
12446
  # If you specify tags for this parameter, those tags replace any list
11762
- # of tags that are currently associated with this stack set. This
12447
+ # of tags that are currently associated with this StackSet. This
11763
12448
  # means:
11764
12449
  #
11765
12450
  # * If you don't specify this parameter, CloudFormation doesn't
11766
12451
  # modify the stack's tags.
11767
12452
  #
11768
12453
  # * If you specify *any* tags using this parameter, you must specify
11769
- # *all* the tags that you want associated with this stack set, even
12454
+ # *all* the tags that you want associated with this StackSet, even
11770
12455
  # tags you've specified before (for example, when creating the
11771
- # stack set or during a previous update of the stack set.). Any tags
12456
+ # StackSet or during a previous update of the StackSet.). Any tags
11772
12457
  # that you don't include in the updated list of tags are removed
11773
- # from the stack set, and therefore from the stacks and resources as
12458
+ # from the StackSet, and therefore from the stacks and resources as
11774
12459
  # well.
11775
12460
  #
11776
12461
  # * If you specify an empty value, CloudFormation removes all
@@ -11779,33 +12464,32 @@ module Aws::CloudFormation
11779
12464
  # If you specify new tags as part of an `UpdateStackSet` action,
11780
12465
  # CloudFormation checks to see if you have the required IAM permission
11781
12466
  # to tag resources. If you omit tags that are currently associated
11782
- # with the stack set from the list of tags you specify, CloudFormation
11783
- # assumes that you want to remove those tags from the stack set, and
12467
+ # with the StackSet from the list of tags you specify, CloudFormation
12468
+ # assumes that you want to remove those tags from the StackSet, and
11784
12469
  # checks to see if you have permission to untag resources. If you
11785
12470
  # don't have the necessary permission(s), the entire `UpdateStackSet`
11786
- # action fails with an `access denied` error, and the stack set is not
12471
+ # action fails with an `access denied` error, and the StackSet is not
11787
12472
  # updated.
11788
12473
  # @return [Array<Types::Tag>]
11789
12474
  #
11790
12475
  # @!attribute [rw] operation_preferences
11791
- # Preferences for how CloudFormation performs this stack set
11792
- # operation.
12476
+ # Preferences for how CloudFormation performs this StackSet operation.
11793
12477
  # @return [Types::StackSetOperationPreferences]
11794
12478
  #
11795
12479
  # @!attribute [rw] administration_role_arn
11796
12480
  # \[Self-managed permissions\] The Amazon Resource Name (ARN) of the
11797
- # IAM role to use to update this stack set.
12481
+ # IAM role to use to update this StackSet.
11798
12482
  #
11799
12483
  # Specify an IAM role only if you are using customized administrator
11800
- # roles to control which users or groups can manage specific stack
11801
- # sets within the same administrator account. For more information,
11802
- # see [Grant self-managed permissions][1] in the *CloudFormation User
12484
+ # roles to control which users or groups can manage specific StackSets
12485
+ # within the same administrator account. For more information, see
12486
+ # [Grant self-managed permissions][1] in the *CloudFormation User
11803
12487
  # Guide*.
11804
12488
  #
11805
12489
  # If you specified a customized administrator role when you created
11806
- # the stack set, you must specify a customized administrator role,
11807
- # even if it is the same customized administrator role used with this
11808
- # stack set previously.
12490
+ # the StackSet, you must specify a customized administrator role, even
12491
+ # if it is the same customized administrator role used with this
12492
+ # StackSet previously.
11809
12493
  #
11810
12494
  #
11811
12495
  #
@@ -11816,40 +12500,39 @@ module Aws::CloudFormation
11816
12500
  # \[Self-managed permissions\] The name of the IAM execution role to
11817
12501
  # use to update the stack set. If you do not specify an execution
11818
12502
  # role, CloudFormation uses the
11819
- # `AWSCloudFormationStackSetExecutionRole` role for the stack set
12503
+ # `AWSCloudFormationStackSetExecutionRole` role for the StackSet
11820
12504
  # operation.
11821
12505
  #
11822
12506
  # Specify an IAM role only if you are using customized execution roles
11823
12507
  # to control which stack resources users and groups can include in
11824
- # their stack sets.
12508
+ # their StackSets.
11825
12509
  #
11826
12510
  # If you specify a customized execution role, CloudFormation uses that
11827
12511
  # role to update the stack. If you do not specify a customized
11828
12512
  # execution role, CloudFormation performs the update using the role
11829
- # previously associated with the stack set, so long as you have
11830
- # permissions to perform operations on the stack set.
12513
+ # previously associated with the StackSet, so long as you have
12514
+ # permissions to perform operations on the StackSet.
11831
12515
  # @return [String]
11832
12516
  #
11833
12517
  # @!attribute [rw] deployment_targets
11834
12518
  # \[Service-managed permissions\] The Organizations accounts in which
11835
12519
  # to update associated stack instances.
11836
12520
  #
11837
- # To update all the stack instances associated with this stack set, do
12521
+ # To update all the stack instances associated with this StackSet, do
11838
12522
  # not specify `DeploymentTargets` or `Regions`.
11839
12523
  #
11840
- # If the stack set update includes changes to the template (that is,
11841
- # if `TemplateBody` or `TemplateURL` is specified), or the
11842
- # `Parameters`, CloudFormation marks all stack instances with a status
11843
- # of `OUTDATED` prior to updating the stack instances in the specified
11844
- # accounts and Amazon Web Services Regions. If the stack set update
11845
- # doesn't include changes to the template or parameters,
11846
- # CloudFormation updates the stack instances in the specified accounts
11847
- # and Regions, while leaving all other stack instances with their
11848
- # existing stack instance status.
12524
+ # If the StackSet update includes changes to the template (that is, if
12525
+ # `TemplateBody` or `TemplateURL` is specified), or the `Parameters`,
12526
+ # CloudFormation marks all stack instances with a status of `OUTDATED`
12527
+ # prior to updating the stack instances in the specified accounts and
12528
+ # Amazon Web Services Regions. If the StackSet update doesn't include
12529
+ # changes to the template or parameters, CloudFormation updates the
12530
+ # stack instances in the specified accounts and Regions, while leaving
12531
+ # all other stack instances with their existing stack instance status.
11849
12532
  # @return [Types::DeploymentTargets]
11850
12533
  #
11851
12534
  # @!attribute [rw] permission_model
11852
- # Describes how the IAM roles required for stack set operations are
12535
+ # Describes how the IAM roles required for StackSet operations are
11853
12536
  # created. You cannot modify `PermissionModel` if there are stack
11854
12537
  # instances associated with your stack set.
11855
12538
  #
@@ -11860,7 +12543,7 @@ module Aws::CloudFormation
11860
12543
  # * With `service-managed` permissions, StackSets automatically
11861
12544
  # creates the IAM roles required to deploy to accounts managed by
11862
12545
  # Organizations. For more information, see [Activate trusted access
11863
- # for stack sets with Organizations][2].
12546
+ # for StackSets with Organizations][2].
11864
12547
  #
11865
12548
  #
11866
12549
  #
@@ -11872,9 +12555,8 @@ module Aws::CloudFormation
11872
12555
  # \[Service-managed permissions\] Describes whether StackSets
11873
12556
  # automatically deploys to Organizations accounts that are added to a
11874
12557
  # target organization or organizational unit (OU). For more
11875
- # information, see [Manage automatic deployments for CloudFormation
11876
- # StackSets that use service-managed permissions][1] in the
11877
- # *CloudFormation User Guide*.
12558
+ # information, see [Enable or disable automatic deployments for
12559
+ # StackSets in Organizations][1] in the *CloudFormation User Guide*.
11878
12560
  #
11879
12561
  # If you specify `AutoDeployment`, don't specify `DeploymentTargets`
11880
12562
  # or `Regions`.
@@ -11885,18 +12567,18 @@ module Aws::CloudFormation
11885
12567
  # @return [Types::AutoDeployment]
11886
12568
  #
11887
12569
  # @!attribute [rw] operation_id
11888
- # The unique ID for this stack set operation.
12570
+ # The unique ID for this StackSet operation.
11889
12571
  #
11890
12572
  # The operation ID also functions as an idempotency token, to ensure
11891
- # that CloudFormation performs the stack set operation only once, even
11892
- # if you retry the request multiple times. You might retry stack set
12573
+ # that CloudFormation performs the StackSet operation only once, even
12574
+ # if you retry the request multiple times. You might retry StackSet
11893
12575
  # operation requests to ensure that CloudFormation successfully
11894
12576
  # received them.
11895
12577
  #
11896
12578
  # If you don't specify an operation ID, CloudFormation generates one
11897
12579
  # automatically.
11898
12580
  #
11899
- # Repeating this stack set operation with a new operation ID retries
12581
+ # Repeating this StackSet operation with a new operation ID retries
11900
12582
  # all stack instances whose status is `OUTDATED`.
11901
12583
  #
11902
12584
  # **A suitable default value is auto-generated.** You should normally
@@ -11906,36 +12588,36 @@ module Aws::CloudFormation
11906
12588
  # @!attribute [rw] accounts
11907
12589
  # \[Self-managed permissions\] The accounts in which to update
11908
12590
  # associated stack instances. If you specify accounts, you must also
11909
- # specify the Amazon Web Services Regions in which to update stack set
12591
+ # specify the Amazon Web Services Regions in which to update StackSet
11910
12592
  # instances.
11911
12593
  #
11912
- # To update *all* the stack instances associated with this stack set,
12594
+ # To update *all* the stack instances associated with this StackSet,
11913
12595
  # don't specify the `Accounts` or `Regions` properties.
11914
12596
  #
11915
- # If the stack set update includes changes to the template (that is,
11916
- # if the `TemplateBody` or `TemplateURL` properties are specified), or
12597
+ # If the StackSet update includes changes to the template (that is, if
12598
+ # the `TemplateBody` or `TemplateURL` properties are specified), or
11917
12599
  # the `Parameters` property, CloudFormation marks all stack instances
11918
12600
  # with a status of `OUTDATED` prior to updating the stack instances in
11919
- # the specified accounts and Amazon Web Services Regions. If the stack
11920
- # set update does not include changes to the template or parameters,
11921
- # CloudFormation updates the stack instances in the specified accounts
11922
- # and Amazon Web Services Regions, while leaving all other stack
11923
- # instances with their existing stack instance status.
12601
+ # the specified accounts and Amazon Web Services Regions. If the
12602
+ # StackSet update does not include changes to the template or
12603
+ # parameters, CloudFormation updates the stack instances in the
12604
+ # specified accounts and Amazon Web Services Regions, while leaving
12605
+ # all other stack instances with their existing stack instance status.
11924
12606
  # @return [Array<String>]
11925
12607
  #
11926
12608
  # @!attribute [rw] regions
11927
12609
  # The Amazon Web Services Regions in which to update associated stack
11928
12610
  # instances. If you specify Regions, you must also specify accounts in
11929
- # which to update stack set instances.
12611
+ # which to update StackSet instances.
11930
12612
  #
11931
- # To update *all* the stack instances associated with this stack set,
12613
+ # To update *all* the stack instances associated with this StackSet,
11932
12614
  # do not specify the `Accounts` or `Regions` properties.
11933
12615
  #
11934
- # If the stack set update includes changes to the template (that is,
11935
- # if the `TemplateBody` or `TemplateURL` properties are specified), or
12616
+ # If the StackSet update includes changes to the template (that is, if
12617
+ # the `TemplateBody` or `TemplateURL` properties are specified), or
11936
12618
  # the `Parameters` property, CloudFormation marks all stack instances
11937
12619
  # with a status of `OUTDATED` prior to updating the stack instances in
11938
- # the specified accounts and Regions. If the stack set update does not
12620
+ # the specified accounts and Regions. If the StackSet update does not
11939
12621
  # include changes to the template or parameters, CloudFormation
11940
12622
  # updates the stack instances in the specified accounts and Regions,
11941
12623
  # while leaving all other stack instances with their existing stack
@@ -11947,7 +12629,7 @@ module Aws::CloudFormation
11947
12629
  # an account administrator in the organization's management account
11948
12630
  # or as a delegated administrator in a member account.
11949
12631
  #
11950
- # By default, `SELF` is specified. Use `SELF` for stack sets with
12632
+ # By default, `SELF` is specified. Use `SELF` for StackSets with
11951
12633
  # self-managed permissions.
11952
12634
  #
11953
12635
  # * If you are signed in to the management account, specify `SELF`.
@@ -11966,7 +12648,7 @@ module Aws::CloudFormation
11966
12648
  # @return [String]
11967
12649
  #
11968
12650
  # @!attribute [rw] managed_execution
11969
- # Describes whether StackSets performs non-conflicting operations
12651
+ # Describes whether CloudFormation performs non-conflicting operations
11970
12652
  # concurrently and queues conflicting operations.
11971
12653
  # @return [Types::ManagedExecution]
11972
12654
  #
@@ -11997,7 +12679,7 @@ module Aws::CloudFormation
11997
12679
  end
11998
12680
 
11999
12681
  # @!attribute [rw] operation_id
12000
- # The unique ID for this stack set operation.
12682
+ # The unique ID for this StackSet operation.
12001
12683
  # @return [String]
12002
12684
  #
12003
12685
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/UpdateStackSetOutput AWS API Documentation