aws-sdk-cloudformation 1.143.0 → 1.145.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.
@@ -237,6 +237,54 @@ module Aws::CloudFormation
237
237
  #
238
238
  class AlreadyExistsException < Aws::EmptyStructure; end
239
239
 
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
+
240
288
  # Describes whether StackSets automatically deploys to Organizations
241
289
  # accounts that are added to a target organization or organizational
242
290
  # unit (OU). For more information, see [Enable or disable automatic
@@ -508,7 +556,7 @@ module Aws::CloudFormation
508
556
  # Specifies target details for an activated Hook.
509
557
  #
510
558
  # @!attribute [rw] target_type
511
- # The name of the type.
559
+ # The Hook target type.
512
560
  # @return [String]
513
561
  #
514
562
  # @!attribute [rw] resource_target_details
@@ -738,7 +786,9 @@ module Aws::CloudFormation
738
786
  # CloudFormation generates the change set by comparing this template
739
787
  # with the template of the stack that you specified.
740
788
  #
741
- # Conditional: You must specify only `TemplateBody` or `TemplateURL`.
789
+ # Conditional: You must specify only one of the following parameters:
790
+ # `TemplateBody`, `TemplateURL`, or set the `UsePreviousTemplate` to
791
+ # `true`.
742
792
  # @return [String]
743
793
  #
744
794
  # @!attribute [rw] template_url
@@ -749,12 +799,28 @@ module Aws::CloudFormation
749
799
  # specified. The location for an Amazon S3 bucket must start with
750
800
  # `https://`. URLs from S3 static websites are not supported.
751
801
  #
752
- # Conditional: You must specify only `TemplateBody` or `TemplateURL`.
802
+ # Conditional: You must specify only one of the following parameters:
803
+ # `TemplateBody`, `TemplateURL`, or set the `UsePreviousTemplate` to
804
+ # `true`.
753
805
  # @return [String]
754
806
  #
755
807
  # @!attribute [rw] use_previous_template
756
808
  # Whether to reuse the template that's associated with the stack to
757
809
  # create the change set.
810
+ #
811
+ # When using templates with the `AWS::LanguageExtensions` transform,
812
+ # provide the template instead of using `UsePreviousTemplate` to
813
+ # ensure new parameter values and Systems Manager parameter updates
814
+ # are applied correctly. For more information, see
815
+ # [AWS::LanguageExtensions transform][1].
816
+ #
817
+ # Conditional: You must specify only one of the following parameters:
818
+ # `TemplateBody`, `TemplateURL`, or set the `UsePreviousTemplate` to
819
+ # `true`.
820
+ #
821
+ #
822
+ #
823
+ # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/transform-aws-languageextensions.html
758
824
  # @return [Boolean]
759
825
  #
760
826
  # @!attribute [rw] parameters
@@ -770,7 +836,7 @@ module Aws::CloudFormation
770
836
  # * `CAPABILITY_IAM` and `CAPABILITY_NAMED_IAM`
771
837
  #
772
838
  # Some stack templates might include resources that can affect
773
- # permissions in your Amazon Web Services account; for example, by
839
+ # permissions in your Amazon Web Services account, for example, by
774
840
  # creating new IAM users. For those stacks, you must explicitly
775
841
  # acknowledge this by specifying one of these capabilities.
776
842
  #
@@ -856,16 +922,15 @@ module Aws::CloudFormation
856
922
  # @return [Array<String>]
857
923
  #
858
924
  # @!attribute [rw] resource_types
859
- # The template resource types that you have permissions to work with
860
- # if you execute this change set, such as `AWS::EC2::Instance`,
861
- # `AWS::EC2::*`, or `Custom::MyCustomInstance`.
925
+ # Specifies which resource types you can work with, such as
926
+ # `AWS::EC2::Instance` or `Custom::MyCustomInstance`.
862
927
  #
863
928
  # If the list of resource types doesn't include a resource type that
864
929
  # you're updating, the stack update fails. By default, CloudFormation
865
930
  # grants permissions to all resource types. IAM uses this parameter
866
931
  # for condition keys in IAM policies for CloudFormation. For more
867
- # information, see [Control access with Identity and Access
868
- # Management][1] in the *CloudFormation User Guide*.
932
+ # information, see [Control CloudFormation access with Identity and
933
+ # Access Management][1] in the *CloudFormation User Guide*.
869
934
  #
870
935
  # <note markdown="1"> Only one of the `Capabilities` and `ResourceType` parameters can be
871
936
  # specified.
@@ -1006,6 +1071,25 @@ module Aws::CloudFormation
1006
1071
  # [2]: https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-properties-name.html
1007
1072
  # @return [Boolean]
1008
1073
  #
1074
+ # @!attribute [rw] deployment_mode
1075
+ # Determines how CloudFormation handles configuration drift during
1076
+ # deployment.
1077
+ #
1078
+ # * `REVERT_DRIFT` – Creates a drift-aware change set that brings
1079
+ # actual resource states in line with template definitions. Provides
1080
+ # a three-way comparison between actual state, previous deployment
1081
+ # state, and desired state.
1082
+ #
1083
+ # ^
1084
+ #
1085
+ # For more information, see [Using drift-aware change sets][1] in the
1086
+ # *CloudFormation User Guide*.
1087
+ #
1088
+ #
1089
+ #
1090
+ # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/drift-aware-change-sets.html
1091
+ # @return [String]
1092
+ #
1009
1093
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateChangeSetInput AWS API Documentation
1010
1094
  #
1011
1095
  class CreateChangeSetInput < Struct.new(
@@ -1027,7 +1111,8 @@ module Aws::CloudFormation
1027
1111
  :resources_to_import,
1028
1112
  :include_nested_stacks,
1029
1113
  :on_stack_failure,
1030
- :import_existing_resources)
1114
+ :import_existing_resources,
1115
+ :deployment_mode)
1031
1116
  SENSITIVE = []
1032
1117
  include Aws::Structure
1033
1118
  end
@@ -1260,22 +1345,15 @@ module Aws::CloudFormation
1260
1345
  # @return [Array<String>]
1261
1346
  #
1262
1347
  # @!attribute [rw] resource_types
1263
- # The template resource types that you have permissions to work with
1264
- # for this create stack action, such as `AWS::EC2::Instance`,
1265
- # `AWS::EC2::*`, or `Custom::MyCustomInstance`. Use the following
1266
- # syntax to describe template resource types: `AWS::*` (for all Amazon
1267
- # Web Services resources), `Custom::*` (for all custom resources),
1268
- # `Custom::logical_ID ` (for a specific custom resource),
1269
- # `AWS::service_name::*` (for all resources of a particular Amazon Web
1270
- # Services service), and `AWS::service_name::resource_logical_ID `
1271
- # (for a specific Amazon Web Services resource).
1348
+ # Specifies which resource types you can work with, such as
1349
+ # `AWS::EC2::Instance` or `Custom::MyCustomInstance`.
1272
1350
  #
1273
1351
  # If the list of resource types doesn't include a resource that
1274
1352
  # you're creating, the stack creation fails. By default,
1275
1353
  # CloudFormation grants permissions to all resource types. IAM uses
1276
1354
  # this parameter for CloudFormation-specific condition keys in IAM
1277
- # policies. For more information, see [Control access with Identity
1278
- # and Access Management][1].
1355
+ # policies. For more information, see [Control CloudFormation access
1356
+ # with Identity and Access Management][1].
1279
1357
  #
1280
1358
  # <note markdown="1"> Only one of the `Capabilities` and `ResourceType` parameters can be
1281
1359
  # specified.
@@ -1560,10 +1638,16 @@ module Aws::CloudFormation
1560
1638
  # Unique identifier of the stack.
1561
1639
  # @return [String]
1562
1640
  #
1641
+ # @!attribute [rw] operation_id
1642
+ # A unique identifier for this stack operation that can be used to
1643
+ # track the operation's progress and events.
1644
+ # @return [String]
1645
+ #
1563
1646
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateStackOutput AWS API Documentation
1564
1647
  #
1565
1648
  class CreateStackOutput < Struct.new(
1566
- :stack_id)
1649
+ :stack_id,
1650
+ :operation_id)
1567
1651
  SENSITIVE = []
1568
1652
  include Aws::Structure
1569
1653
  end
@@ -2327,8 +2411,8 @@ module Aws::CloudFormation
2327
2411
  # The input for the DescribeAccountLimits action.
2328
2412
  #
2329
2413
  # @!attribute [rw] next_token
2330
- # A string that identifies the next page of limits that you want to
2331
- # retrieve.
2414
+ # The token for the next set of items to return. (You received this
2415
+ # token from a previous call.)
2332
2416
  # @return [String]
2333
2417
  #
2334
2418
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/DescribeAccountLimitsInput AWS API Documentation
@@ -2372,9 +2456,8 @@ module Aws::CloudFormation
2372
2456
  # @return [String]
2373
2457
  #
2374
2458
  # @!attribute [rw] next_token
2375
- # A string, provided by the `DescribeChangeSetHooks` response output,
2376
- # that identifies the next page of information that you want to
2377
- # retrieve.
2459
+ # The token for the next set of items to return. (You received this
2460
+ # token from a previous call.)
2378
2461
  # @return [String]
2379
2462
  #
2380
2463
  # @!attribute [rw] logical_resource_id
@@ -2406,7 +2489,7 @@ module Aws::CloudFormation
2406
2489
  # @return [Array<Types::ChangeSetHook>]
2407
2490
  #
2408
2491
  # @!attribute [rw] status
2409
- # Provides the status of the change set hook.
2492
+ # Provides the status of the change set Hook.
2410
2493
  # @return [String]
2411
2494
  #
2412
2495
  # @!attribute [rw] next_token
@@ -2448,8 +2531,8 @@ module Aws::CloudFormation
2448
2531
  # @return [String]
2449
2532
  #
2450
2533
  # @!attribute [rw] next_token
2451
- # A string (provided by the DescribeChangeSet response output) that
2452
- # identifies the next page of information that you want to retrieve.
2534
+ # The token for the next set of items to return. (You received this
2535
+ # token from a previous call.)
2453
2536
  # @return [String]
2454
2537
  #
2455
2538
  # @!attribute [rw] include_property_values
@@ -2524,6 +2607,22 @@ module Aws::CloudFormation
2524
2607
  # error message.
2525
2608
  # @return [String]
2526
2609
  #
2610
+ # @!attribute [rw] stack_drift_status
2611
+ # The drift status of the stack when the change set was created. Valid
2612
+ # values:
2613
+ #
2614
+ # * `DRIFTED` – The stack has drifted from its last deployment.
2615
+ #
2616
+ # * `IN_SYNC` – The stack is in sync with its last deployment.
2617
+ #
2618
+ # * `NOT_CHECKED` – CloudFormation doesn’t currently return this
2619
+ # value.
2620
+ #
2621
+ # * `UNKNOWN` – The drift status could not be determined.
2622
+ #
2623
+ # Only present for drift-aware change sets.
2624
+ # @return [String]
2625
+ #
2527
2626
  # @!attribute [rw] notification_arns
2528
2627
  # The ARNs of the Amazon SNS topics that will be associated with the
2529
2628
  # stack if you execute the change set.
@@ -2608,6 +2707,11 @@ module Aws::CloudFormation
2608
2707
  # [2]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/resource-import.html
2609
2708
  # @return [Boolean]
2610
2709
  #
2710
+ # @!attribute [rw] deployment_mode
2711
+ # The deployment mode specified when the change set was created. Valid
2712
+ # value is `REVERT_DRIFT`. Only present for drift-aware change sets.
2713
+ # @return [String]
2714
+ #
2611
2715
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/DescribeChangeSetOutput AWS API Documentation
2612
2716
  #
2613
2717
  class DescribeChangeSetOutput < Struct.new(
@@ -2621,6 +2725,7 @@ module Aws::CloudFormation
2621
2725
  :execution_status,
2622
2726
  :status,
2623
2727
  :status_reason,
2728
+ :stack_drift_status,
2624
2729
  :notification_arns,
2625
2730
  :rollback_configuration,
2626
2731
  :capabilities,
@@ -2631,7 +2736,64 @@ module Aws::CloudFormation
2631
2736
  :parent_change_set_id,
2632
2737
  :root_change_set_id,
2633
2738
  :on_stack_failure,
2634
- :import_existing_resources)
2739
+ :import_existing_resources,
2740
+ :deployment_mode)
2741
+ SENSITIVE = []
2742
+ include Aws::Structure
2743
+ end
2744
+
2745
+ # @!attribute [rw] stack_name
2746
+ # The name or unique stack ID for which you want to retrieve events.
2747
+ # @return [String]
2748
+ #
2749
+ # @!attribute [rw] change_set_name
2750
+ # The name or Amazon Resource Name (ARN) of the change set for which
2751
+ # you want to retrieve events.
2752
+ # @return [String]
2753
+ #
2754
+ # @!attribute [rw] operation_id
2755
+ # The unique identifier of the operation for which you want to
2756
+ # retrieve events.
2757
+ # @return [String]
2758
+ #
2759
+ # @!attribute [rw] filters
2760
+ # Filters to apply when retrieving events.
2761
+ # @return [Types::EventFilter]
2762
+ #
2763
+ # @!attribute [rw] next_token
2764
+ # The token for the next set of items to return. (You received this
2765
+ # token from a previous call.)
2766
+ # @return [String]
2767
+ #
2768
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/DescribeEventsInput AWS API Documentation
2769
+ #
2770
+ class DescribeEventsInput < Struct.new(
2771
+ :stack_name,
2772
+ :change_set_name,
2773
+ :operation_id,
2774
+ :filters,
2775
+ :next_token)
2776
+ SENSITIVE = []
2777
+ include Aws::Structure
2778
+ end
2779
+
2780
+ # @!attribute [rw] operation_events
2781
+ # A list of operation events that match the specified criteria.
2782
+ # @return [Array<Types::OperationEvent>]
2783
+ #
2784
+ # @!attribute [rw] next_token
2785
+ # If the request doesn't return all the remaining results,
2786
+ # `NextToken` is set to a token. To retrieve the next set of results,
2787
+ # call `DescribeEvents` again and assign that token to the request
2788
+ # object's `NextToken` parameter. If the request returns all results,
2789
+ # `NextToken` is set to `null`.
2790
+ # @return [String]
2791
+ #
2792
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/DescribeEventsOutput AWS API Documentation
2793
+ #
2794
+ class DescribeEventsOutput < Struct.new(
2795
+ :operation_events,
2796
+ :next_token)
2635
2797
  SENSITIVE = []
2636
2798
  include Aws::Structure
2637
2799
  end
@@ -3035,8 +3197,8 @@ module Aws::CloudFormation
3035
3197
  # @return [String]
3036
3198
  #
3037
3199
  # @!attribute [rw] next_token
3038
- # A string that identifies the next page of events that you want to
3039
- # retrieve.
3200
+ # The token for the next set of items to return. (You received this
3201
+ # token from a previous call.)
3040
3202
  # @return [String]
3041
3203
  #
3042
3204
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/DescribeStackEventsInput AWS API Documentation
@@ -3212,8 +3374,8 @@ module Aws::CloudFormation
3212
3374
  # @return [Array<String>]
3213
3375
  #
3214
3376
  # @!attribute [rw] next_token
3215
- # A string that identifies the next page of stack resource drift
3216
- # results.
3377
+ # The token for the next set of items to return. (You received this
3378
+ # token from a previous call.)
3217
3379
  # @return [String]
3218
3380
  #
3219
3381
  # @!attribute [rw] max_results
@@ -3499,8 +3661,8 @@ module Aws::CloudFormation
3499
3661
  # @return [String]
3500
3662
  #
3501
3663
  # @!attribute [rw] next_token
3502
- # A string that identifies the next page of stacks that you want to
3503
- # retrieve.
3664
+ # The token for the next set of items to return. (You received this
3665
+ # token from a previous call.)
3504
3666
  # @return [String]
3505
3667
  #
3506
3668
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/DescribeStacksInput AWS API Documentation
@@ -4162,6 +4324,21 @@ module Aws::CloudFormation
4162
4324
  include Aws::Structure
4163
4325
  end
4164
4326
 
4327
+ # Event filter allows you to focus on specific events in an operation.
4328
+ #
4329
+ # @!attribute [rw] failed_events
4330
+ # When set to true, only returns failed events within the operation.
4331
+ # This helps quickly identify root causes for a failed operation.
4332
+ # @return [Boolean]
4333
+ #
4334
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/EventFilter AWS API Documentation
4335
+ #
4336
+ class EventFilter < Struct.new(
4337
+ :failed_events)
4338
+ SENSITIVE = []
4339
+ include Aws::Structure
4340
+ end
4341
+
4165
4342
  # The input for the ExecuteChangeSet action.
4166
4343
  #
4167
4344
  # @!attribute [rw] change_set_name
@@ -4347,6 +4524,114 @@ module Aws::CloudFormation
4347
4524
  include Aws::Structure
4348
4525
  end
4349
4526
 
4527
+ # @!attribute [rw] hook_result_id
4528
+ # The unique identifier (ID) of the Hook invocation result that you
4529
+ # want details about. You can get the ID from the [ListHookResults][1]
4530
+ # operation.
4531
+ #
4532
+ #
4533
+ #
4534
+ # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_ListHookResults.html
4535
+ # @return [String]
4536
+ #
4537
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/GetHookResultInput AWS API Documentation
4538
+ #
4539
+ class GetHookResultInput < Struct.new(
4540
+ :hook_result_id)
4541
+ SENSITIVE = []
4542
+ include Aws::Structure
4543
+ end
4544
+
4545
+ # @!attribute [rw] hook_result_id
4546
+ # The unique identifier of the Hook result.
4547
+ # @return [String]
4548
+ #
4549
+ # @!attribute [rw] invocation_point
4550
+ # The specific point in the provisioning process where the Hook is
4551
+ # invoked.
4552
+ # @return [String]
4553
+ #
4554
+ # @!attribute [rw] failure_mode
4555
+ # The failure mode of the invocation.
4556
+ # @return [String]
4557
+ #
4558
+ # @!attribute [rw] type_name
4559
+ # The name of the Hook that was invoked.
4560
+ # @return [String]
4561
+ #
4562
+ # @!attribute [rw] original_type_name
4563
+ # The original public type name of the Hook when an alias is used.
4564
+ #
4565
+ # For example, if you activate `AWS::Hooks::GuardHook` with alias
4566
+ # `MyCompany::Custom::GuardHook`, then `TypeName` will be
4567
+ # `MyCompany::Custom::GuardHook` and `OriginalTypeName` will be
4568
+ # `AWS::Hooks::GuardHook`.
4569
+ # @return [String]
4570
+ #
4571
+ # @!attribute [rw] type_version_id
4572
+ # The version identifier of the Hook that was invoked.
4573
+ # @return [String]
4574
+ #
4575
+ # @!attribute [rw] type_configuration_version_id
4576
+ # The version identifier of the Hook configuration data that was used
4577
+ # during invocation.
4578
+ # @return [String]
4579
+ #
4580
+ # @!attribute [rw] type_arn
4581
+ # The Amazon Resource Name (ARN) of the Hook.
4582
+ # @return [String]
4583
+ #
4584
+ # @!attribute [rw] status
4585
+ # The status of the Hook invocation. The following statuses are
4586
+ # possible:
4587
+ #
4588
+ # * `HOOK_IN_PROGRESS`: The Hook is currently running.
4589
+ #
4590
+ # * `HOOK_COMPLETE_SUCCEEDED`: The Hook completed successfully.
4591
+ #
4592
+ # * `HOOK_COMPLETE_FAILED`: The Hook completed but failed validation.
4593
+ #
4594
+ # * `HOOK_FAILED`: The Hook encountered an error during execution.
4595
+ # @return [String]
4596
+ #
4597
+ # @!attribute [rw] hook_status_reason
4598
+ # A message that provides additional details about the Hook invocation
4599
+ # status.
4600
+ # @return [String]
4601
+ #
4602
+ # @!attribute [rw] invoked_at
4603
+ # The timestamp when the Hook was invoked.
4604
+ # @return [Time]
4605
+ #
4606
+ # @!attribute [rw] target
4607
+ # Information about the target of the Hook invocation.
4608
+ # @return [Types::HookTarget]
4609
+ #
4610
+ # @!attribute [rw] annotations
4611
+ # A list of objects with additional information and guidance that can
4612
+ # help you resolve a failed Hook invocation.
4613
+ # @return [Array<Types::Annotation>]
4614
+ #
4615
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/GetHookResultOutput AWS API Documentation
4616
+ #
4617
+ class GetHookResultOutput < Struct.new(
4618
+ :hook_result_id,
4619
+ :invocation_point,
4620
+ :failure_mode,
4621
+ :type_name,
4622
+ :original_type_name,
4623
+ :type_version_id,
4624
+ :type_configuration_version_id,
4625
+ :type_arn,
4626
+ :status,
4627
+ :hook_status_reason,
4628
+ :invoked_at,
4629
+ :target,
4630
+ :annotations)
4631
+ SENSITIVE = []
4632
+ include Aws::Structure
4633
+ end
4634
+
4350
4635
  # The input for the GetStackPolicy action.
4351
4636
  #
4352
4637
  # @!attribute [rw] stack_name
@@ -4365,9 +4650,9 @@ module Aws::CloudFormation
4365
4650
  # The output for the GetStackPolicy action.
4366
4651
  #
4367
4652
  # @!attribute [rw] stack_policy_body
4368
- # Structure that contains the stack policy body. (For more
4369
- # information, see [Prevent updates to stack resources][1] in the
4370
- # *CloudFormation User Guide*.)
4653
+ # Structure that contains the stack policy body. For more information,
4654
+ # see [Prevent updates to stack resources][1] in the *CloudFormation
4655
+ # User Guide*.
4371
4656
  #
4372
4657
  #
4373
4658
  #
@@ -4612,8 +4897,7 @@ module Aws::CloudFormation
4612
4897
  #
4613
4898
  class HookResultNotFoundException < Aws::EmptyStructure; end
4614
4899
 
4615
- # Describes a Hook invocation, its status, and the reason for its
4616
- # status.
4900
+ # A `ListHookResults` call returns a summary of a Hook invocation.
4617
4901
  #
4618
4902
  # @!attribute [rw] hook_result_id
4619
4903
  # The unique identifier for this Hook invocation result.
@@ -4679,8 +4963,8 @@ module Aws::CloudFormation
4679
4963
  # @return [String]
4680
4964
  #
4681
4965
  # @!attribute [rw] hook_execution_target
4682
- # The ARN of the target stack or request token of the Cloud Control
4683
- # API operation.
4966
+ # The Amazon Resource Name (ARN) of the target stack or request token
4967
+ # of the Cloud Control API operation.
4684
4968
  #
4685
4969
  # Only shown in responses when the request does not specify
4686
4970
  # `TargetType` and `TargetId` filters.
@@ -4706,6 +4990,35 @@ module Aws::CloudFormation
4706
4990
  include Aws::Structure
4707
4991
  end
4708
4992
 
4993
+ # The `HookTarget` data type.
4994
+ #
4995
+ # @!attribute [rw] target_type
4996
+ # The target type.
4997
+ # @return [String]
4998
+ #
4999
+ # @!attribute [rw] target_type_name
5000
+ # The target name, for example, `AWS::S3::Bucket`.
5001
+ # @return [String]
5002
+ #
5003
+ # @!attribute [rw] target_id
5004
+ # The unique identifier of the Hook invocation target.
5005
+ # @return [String]
5006
+ #
5007
+ # @!attribute [rw] action
5008
+ # The action that invoked the Hook.
5009
+ # @return [String]
5010
+ #
5011
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/HookTarget AWS API Documentation
5012
+ #
5013
+ class HookTarget < Struct.new(
5014
+ :target_type,
5015
+ :target_type_name,
5016
+ :target_id,
5017
+ :action)
5018
+ SENSITIVE = []
5019
+ include Aws::Structure
5020
+ end
5021
+
4709
5022
  # @!attribute [rw] stack_set_name
4710
5023
  # The name of the StackSet. The name must be unique in the Region
4711
5024
  # where you create your StackSet.
@@ -4836,8 +5149,8 @@ module Aws::CloudFormation
4836
5149
  # @return [String]
4837
5150
  #
4838
5151
  # @!attribute [rw] next_token
4839
- # A string (provided by the ListChangeSets response output) that
4840
- # identifies the next page of change sets that you want to retrieve.
5152
+ # The token for the next set of items to return. (You received this
5153
+ # token from a previous call.)
4841
5154
  # @return [String]
4842
5155
  #
4843
5156
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/ListChangeSetsInput AWS API Documentation
@@ -4872,9 +5185,8 @@ module Aws::CloudFormation
4872
5185
  end
4873
5186
 
4874
5187
  # @!attribute [rw] next_token
4875
- # A string (provided by the ListExports response output) that
4876
- # identifies the next page of exported output values that you asked to
4877
- # retrieve.
5188
+ # The token for the next set of items to return. (You received this
5189
+ # token from a previous call.)
4878
5190
  # @return [String]
4879
5191
  #
4880
5192
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/ListExportsInput AWS API Documentation
@@ -4905,7 +5217,8 @@ module Aws::CloudFormation
4905
5217
  end
4906
5218
 
4907
5219
  # @!attribute [rw] next_token
4908
- # A string that identifies the next page of resource scan results.
5220
+ # The token for the next set of items to return. (You received this
5221
+ # token from a previous call.)
4909
5222
  # @return [String]
4910
5223
  #
4911
5224
  # @!attribute [rw] max_results
@@ -4989,8 +5302,8 @@ module Aws::CloudFormation
4989
5302
  # @return [String]
4990
5303
  #
4991
5304
  # @!attribute [rw] next_token
4992
- # A string that identifies the next page of events that you want to
4993
- # retrieve.
5305
+ # The token for the next set of items to return. (You received this
5306
+ # token from a previous call.)
4994
5307
  # @return [String]
4995
5308
  #
4996
5309
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/ListHookResultsInput AWS API Documentation
@@ -5040,9 +5353,8 @@ module Aws::CloudFormation
5040
5353
  # @return [String]
5041
5354
  #
5042
5355
  # @!attribute [rw] next_token
5043
- # A string (provided by the ListImports response output) that
5044
- # identifies the next page of stacks that are importing the specified
5045
- # exported output value.
5356
+ # The token for the next set of items to return. (You received this
5357
+ # token from a previous call.)
5046
5358
  # @return [String]
5047
5359
  #
5048
5360
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/ListImportsInput AWS API Documentation
@@ -5083,7 +5395,8 @@ module Aws::CloudFormation
5083
5395
  # @return [Array<Types::ScannedResourceIdentifier>]
5084
5396
  #
5085
5397
  # @!attribute [rw] next_token
5086
- # A string that identifies the next page of resource scan results.
5398
+ # The token for the next set of items to return. (You received this
5399
+ # token from a previous call.)
5087
5400
  # @return [String]
5088
5401
  #
5089
5402
  # @!attribute [rw] max_results
@@ -5151,7 +5464,8 @@ module Aws::CloudFormation
5151
5464
  # @return [String]
5152
5465
  #
5153
5466
  # @!attribute [rw] next_token
5154
- # A string that identifies the next page of resource scan results.
5467
+ # The token for the next set of items to return. (You received this
5468
+ # token from a previous call.)
5155
5469
  # @return [String]
5156
5470
  #
5157
5471
  # @!attribute [rw] max_results
@@ -5199,7 +5513,8 @@ module Aws::CloudFormation
5199
5513
  end
5200
5514
 
5201
5515
  # @!attribute [rw] next_token
5202
- # A string that identifies the next page of resource scan results.
5516
+ # The token for the next set of items to return. (You received this
5517
+ # token from a previous call.)
5203
5518
  # @return [String]
5204
5519
  #
5205
5520
  # @!attribute [rw] max_results
@@ -5251,12 +5566,8 @@ module Aws::CloudFormation
5251
5566
  # @return [String]
5252
5567
  #
5253
5568
  # @!attribute [rw] next_token
5254
- # If the previous paginated request didn't return all of the
5255
- # remaining results, the response object's `NextToken` parameter
5256
- # value is set to a token. To retrieve the next set of results, call
5257
- # this action again and assign that token to the request object's
5258
- # `NextToken` parameter. If there are no remaining results, the
5259
- # previous response object's `NextToken` parameter is set to `null`.
5569
+ # The token for the next set of items to return. (You received this
5570
+ # token from a previous call.)
5260
5571
  # @return [String]
5261
5572
  #
5262
5573
  # @!attribute [rw] max_results
@@ -5362,12 +5673,8 @@ module Aws::CloudFormation
5362
5673
  # @return [String]
5363
5674
  #
5364
5675
  # @!attribute [rw] next_token
5365
- # If the previous request didn't return all the remaining results,
5366
- # the response's `NextToken` parameter value is set to a token. To
5367
- # retrieve the next set of results, call `ListStackInstances` again
5368
- # and assign that token to the request object's `NextToken`
5369
- # parameter. If there are no remaining results, the previous response
5370
- # object's `NextToken` parameter is set to `null`.
5676
+ # The token for the next set of items to return. (You received this
5677
+ # token from a previous call.)
5371
5678
  # @return [String]
5372
5679
  #
5373
5680
  # @!attribute [rw] max_results
@@ -5455,11 +5762,8 @@ module Aws::CloudFormation
5455
5762
  # @return [String]
5456
5763
  #
5457
5764
  # @!attribute [rw] next_token
5458
- # If the request doesn't return all the remaining results,
5459
- # `NextToken` is set to a token. To retrieve the next set of results,
5460
- # call this action again and assign that token to the request
5461
- # object's `NextToken` parameter. If the request returns all results,
5462
- # `NextToken` is set to `null`.
5765
+ # The token for the next set of items to return. (You received this
5766
+ # token from a previous call.)
5463
5767
  # @return [String]
5464
5768
  #
5465
5769
  # @!attribute [rw] max_results
@@ -5507,11 +5811,8 @@ module Aws::CloudFormation
5507
5811
  # @return [Array<String>]
5508
5812
  #
5509
5813
  # @!attribute [rw] next_token
5510
- # If the request doesn't return all the remaining results,
5511
- # `NextToken` is set to a token. To retrieve the next set of results,
5512
- # call this action again and assign that token to the request
5513
- # object's `NextToken` parameter. If the request returns all results,
5514
- # `NextToken` is set to `null`.
5814
+ # The token for the next set of items to return. (You received this
5815
+ # token from a previous call.)
5515
5816
  # @return [String]
5516
5817
  #
5517
5818
  # @!attribute [rw] max_results
@@ -5577,8 +5878,8 @@ module Aws::CloudFormation
5577
5878
  # @return [String]
5578
5879
  #
5579
5880
  # @!attribute [rw] next_token
5580
- # A string that identifies the next page of stack resources that you
5581
- # want to retrieve.
5881
+ # The token for the next set of items to return. (You received this
5882
+ # token from a previous call.)
5582
5883
  # @return [String]
5583
5884
  #
5584
5885
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/ListStackResourcesInput AWS API Documentation
@@ -5617,8 +5918,8 @@ module Aws::CloudFormation
5617
5918
  # @return [String]
5618
5919
  #
5619
5920
  # @!attribute [rw] next_token
5620
- # A string that identifies the next page of deployment targets that
5621
- # you want to retrieve.
5921
+ # The token for the next set of items to return. (You received this
5922
+ # token from a previous call.)
5622
5923
  # @return [String]
5623
5924
  #
5624
5925
  # @!attribute [rw] max_results
@@ -5697,13 +5998,8 @@ module Aws::CloudFormation
5697
5998
  # @return [String]
5698
5999
  #
5699
6000
  # @!attribute [rw] next_token
5700
- # If the previous request didn't return all the remaining results,
5701
- # the response object's `NextToken` parameter value is set to a
5702
- # token. To retrieve the next set of results, call
5703
- # `ListStackSetOperationResults` again and assign that token to the
5704
- # request object's `NextToken` parameter. If there are no remaining
5705
- # results, the previous response object's `NextToken` parameter is
5706
- # set to `null`.
6001
+ # The token for the next set of items to return. (You received this
6002
+ # token from a previous call.)
5707
6003
  # @return [String]
5708
6004
  #
5709
6005
  # @!attribute [rw] max_results
@@ -5782,13 +6078,8 @@ module Aws::CloudFormation
5782
6078
  # @return [String]
5783
6079
  #
5784
6080
  # @!attribute [rw] next_token
5785
- # If the previous paginated request didn't return all of the
5786
- # remaining results, the response object's `NextToken` parameter
5787
- # value is set to a token. To retrieve the next set of results, call
5788
- # `ListStackSetOperations` again and assign that token to the request
5789
- # object's `NextToken` parameter. If there are no remaining results,
5790
- # the previous response object's `NextToken` parameter is set to
5791
- # `null`.
6081
+ # The token for the next set of items to return. (You received this
6082
+ # token from a previous call.)
5792
6083
  # @return [String]
5793
6084
  #
5794
6085
  # @!attribute [rw] max_results
@@ -5855,12 +6146,8 @@ module Aws::CloudFormation
5855
6146
  end
5856
6147
 
5857
6148
  # @!attribute [rw] next_token
5858
- # If the previous paginated request didn't return all the remaining
5859
- # results, the response object's `NextToken` parameter value is set
5860
- # to a token. To retrieve the next set of results, call
5861
- # `ListStackSets` again and assign that token to the request object's
5862
- # `NextToken` parameter. If there are no remaining results, the
5863
- # previous response object's `NextToken` parameter is set to `null`.
6149
+ # The token for the next set of items to return. (You received this
6150
+ # token from a previous call.)
5864
6151
  # @return [String]
5865
6152
  #
5866
6153
  # @!attribute [rw] max_results
@@ -5934,8 +6221,8 @@ module Aws::CloudFormation
5934
6221
  # The input for ListStacks action.
5935
6222
  #
5936
6223
  # @!attribute [rw] next_token
5937
- # A string that identifies the next page of stacks that you want to
5938
- # retrieve.
6224
+ # The token for the next set of items to return. (You received this
6225
+ # token from a previous call.)
5939
6226
  # @return [String]
5940
6227
  #
5941
6228
  # @!attribute [rw] stack_status_filter
@@ -6011,12 +6298,8 @@ module Aws::CloudFormation
6011
6298
  # @return [Integer]
6012
6299
  #
6013
6300
  # @!attribute [rw] next_token
6014
- # If the previous paginated request didn't return all the remaining
6015
- # results, the response object's `NextToken` parameter value is set
6016
- # to a token. To retrieve the next set of results, call this action
6017
- # again and assign that token to the request object's `NextToken`
6018
- # parameter. If there are no remaining results, the previous response
6019
- # object's `NextToken` parameter is set to `null`.
6301
+ # The token for the next set of items to return. (You received this
6302
+ # token from a previous call.)
6020
6303
  # @return [String]
6021
6304
  #
6022
6305
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/ListTypeRegistrationsInput AWS API Documentation
@@ -6087,12 +6370,8 @@ module Aws::CloudFormation
6087
6370
  # @return [Integer]
6088
6371
  #
6089
6372
  # @!attribute [rw] next_token
6090
- # If the previous paginated request didn't return all of the
6091
- # remaining results, the response object's `NextToken` parameter
6092
- # value is set to a token. To retrieve the next set of results, call
6093
- # this action again and assign that token to the request object's
6094
- # `NextToken` parameter. If there are no remaining results, the
6095
- # previous response object's `NextToken` parameter is set to `null`.
6373
+ # The token for the next set of items to return. (You received this
6374
+ # token from a previous call.)
6096
6375
  # @return [String]
6097
6376
  #
6098
6377
  # @!attribute [rw] deprecated_status
@@ -6230,12 +6509,8 @@ module Aws::CloudFormation
6230
6509
  # @return [Integer]
6231
6510
  #
6232
6511
  # @!attribute [rw] next_token
6233
- # If the previous paginated request didn't return all the remaining
6234
- # results, the response object's `NextToken` parameter value is set
6235
- # to a token. To retrieve the next set of results, call this action
6236
- # again and assign that token to the request object's `NextToken`
6237
- # parameter. If there are no remaining results, the previous response
6238
- # object's `NextToken` parameter is set to `null`.
6512
+ # The token for the next set of items to return. (You received this
6513
+ # token from a previous call.)
6239
6514
  # @return [String]
6240
6515
  #
6241
6516
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/ListTypesInput AWS API Documentation
@@ -6274,6 +6549,31 @@ module Aws::CloudFormation
6274
6549
  include Aws::Structure
6275
6550
  end
6276
6551
 
6552
+ # Contains drift information for a resource property, including actual
6553
+ # value, previous deployment value, and drift detection timestamp.
6554
+ #
6555
+ # @!attribute [rw] previous_value
6556
+ # The configuration value from the previous CloudFormation deployment.
6557
+ # @return [String]
6558
+ #
6559
+ # @!attribute [rw] actual_value
6560
+ # The current live configuration value of the resource property.
6561
+ # @return [String]
6562
+ #
6563
+ # @!attribute [rw] drift_detection_timestamp
6564
+ # The timestamp when drift was detected for this resource property.
6565
+ # @return [Time]
6566
+ #
6567
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/LiveResourceDrift AWS API Documentation
6568
+ #
6569
+ class LiveResourceDrift < Struct.new(
6570
+ :previous_value,
6571
+ :actual_value,
6572
+ :drift_detection_timestamp)
6573
+ SENSITIVE = []
6574
+ include Aws::Structure
6575
+ end
6576
+
6277
6577
  # Contains logging configuration information for an extension.
6278
6578
  #
6279
6579
  # @!attribute [rw] log_role_arn
@@ -6381,6 +6681,171 @@ module Aws::CloudFormation
6381
6681
  #
6382
6682
  class NameAlreadyExistsException < Aws::EmptyStructure; end
6383
6683
 
6684
+ # Contains information about a CloudFormation operation.
6685
+ #
6686
+ # @!attribute [rw] operation_type
6687
+ # The type of operation.
6688
+ # @return [String]
6689
+ #
6690
+ # @!attribute [rw] operation_id
6691
+ # The unique identifier for the operation.
6692
+ # @return [String]
6693
+ #
6694
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/OperationEntry AWS API Documentation
6695
+ #
6696
+ class OperationEntry < Struct.new(
6697
+ :operation_type,
6698
+ :operation_id)
6699
+ SENSITIVE = []
6700
+ include Aws::Structure
6701
+ end
6702
+
6703
+ # Contains detailed information about an event that occurred during a
6704
+ # CloudFormation operation.
6705
+ #
6706
+ # @!attribute [rw] event_id
6707
+ # A unique identifier for this event.
6708
+ # @return [String]
6709
+ #
6710
+ # @!attribute [rw] stack_id
6711
+ # The unique ID name of the instance of the stack.
6712
+ # @return [String]
6713
+ #
6714
+ # @!attribute [rw] operation_id
6715
+ # The unique identifier of the operation this event belongs to.
6716
+ # @return [String]
6717
+ #
6718
+ # @!attribute [rw] operation_type
6719
+ # The type of operation.
6720
+ # @return [String]
6721
+ #
6722
+ # @!attribute [rw] operation_status
6723
+ # The current status of the operation.
6724
+ # @return [String]
6725
+ #
6726
+ # @!attribute [rw] event_type
6727
+ # The type of event.
6728
+ # @return [String]
6729
+ #
6730
+ # @!attribute [rw] logical_resource_id
6731
+ # The logical name of the resource as specified in the template.
6732
+ # @return [String]
6733
+ #
6734
+ # @!attribute [rw] physical_resource_id
6735
+ # The name or unique identifier that corresponds to a physical
6736
+ # instance ID of a resource.
6737
+ # @return [String]
6738
+ #
6739
+ # @!attribute [rw] resource_type
6740
+ # Type of resource.
6741
+ # @return [String]
6742
+ #
6743
+ # @!attribute [rw] timestamp
6744
+ # Time the status was updated.
6745
+ # @return [Time]
6746
+ #
6747
+ # @!attribute [rw] start_time
6748
+ # The time when the event started.
6749
+ # @return [Time]
6750
+ #
6751
+ # @!attribute [rw] end_time
6752
+ # The time when the event ended.
6753
+ # @return [Time]
6754
+ #
6755
+ # @!attribute [rw] resource_status
6756
+ # Current status of the resource.
6757
+ # @return [String]
6758
+ #
6759
+ # @!attribute [rw] resource_status_reason
6760
+ # Success or failure message associated with the resource.
6761
+ # @return [String]
6762
+ #
6763
+ # @!attribute [rw] resource_properties
6764
+ # The properties used to create the resource.
6765
+ # @return [String]
6766
+ #
6767
+ # @!attribute [rw] client_request_token
6768
+ # A unique identifier for the request that initiated this operation.
6769
+ # @return [String]
6770
+ #
6771
+ # @!attribute [rw] hook_type
6772
+ # The type name of the Hook that was invoked.
6773
+ # @return [String]
6774
+ #
6775
+ # @!attribute [rw] hook_status
6776
+ # The status of the Hook invocation.
6777
+ # @return [String]
6778
+ #
6779
+ # @!attribute [rw] hook_status_reason
6780
+ # Additional information about the Hook status.
6781
+ # @return [String]
6782
+ #
6783
+ # @!attribute [rw] hook_invocation_point
6784
+ # The point in the operation lifecycle when the Hook was invoked.
6785
+ # @return [String]
6786
+ #
6787
+ # @!attribute [rw] hook_failure_mode
6788
+ # Specifies how Hook failures are handled.
6789
+ # @return [String]
6790
+ #
6791
+ # @!attribute [rw] detailed_status
6792
+ # Additional status information about the operation.
6793
+ # @return [String]
6794
+ #
6795
+ # @!attribute [rw] validation_failure_mode
6796
+ # Specifies how validation failures are handled.
6797
+ # @return [String]
6798
+ #
6799
+ # @!attribute [rw] validation_name
6800
+ # The name of the validation that was performed.
6801
+ # @return [String]
6802
+ #
6803
+ # @!attribute [rw] validation_status
6804
+ # The status of the validation.
6805
+ # @return [String]
6806
+ #
6807
+ # @!attribute [rw] validation_status_reason
6808
+ # Additional information about the validation status.
6809
+ # @return [String]
6810
+ #
6811
+ # @!attribute [rw] validation_path
6812
+ # The path within the resource where the validation was applied.
6813
+ # @return [String]
6814
+ #
6815
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/OperationEvent AWS API Documentation
6816
+ #
6817
+ class OperationEvent < Struct.new(
6818
+ :event_id,
6819
+ :stack_id,
6820
+ :operation_id,
6821
+ :operation_type,
6822
+ :operation_status,
6823
+ :event_type,
6824
+ :logical_resource_id,
6825
+ :physical_resource_id,
6826
+ :resource_type,
6827
+ :timestamp,
6828
+ :start_time,
6829
+ :end_time,
6830
+ :resource_status,
6831
+ :resource_status_reason,
6832
+ :resource_properties,
6833
+ :client_request_token,
6834
+ :hook_type,
6835
+ :hook_status,
6836
+ :hook_status_reason,
6837
+ :hook_invocation_point,
6838
+ :hook_failure_mode,
6839
+ :detailed_status,
6840
+ :validation_failure_mode,
6841
+ :validation_name,
6842
+ :validation_status,
6843
+ :validation_status_reason,
6844
+ :validation_path)
6845
+ SENSITIVE = []
6846
+ include Aws::Structure
6847
+ end
6848
+
6384
6849
  # The specified operation ID already exists.
6385
6850
  #
6386
6851
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/OperationIdAlreadyExistsException AWS API Documentation
@@ -6430,7 +6895,7 @@ module Aws::CloudFormation
6430
6895
  #
6431
6896
  class OperationStatusCheckFailedException < Aws::EmptyStructure; end
6432
6897
 
6433
- # The Output data type.
6898
+ # The `Output` data type.
6434
6899
  #
6435
6900
  # @!attribute [rw] output_key
6436
6901
  # The key associated with the output.
@@ -6459,7 +6924,7 @@ module Aws::CloudFormation
6459
6924
  include Aws::Structure
6460
6925
  end
6461
6926
 
6462
- # The Parameter data type.
6927
+ # The `Parameter` data type.
6463
6928
  #
6464
6929
  # @!attribute [rw] parameter_key
6465
6930
  # The key associated with the parameter. If you don't specify a key
@@ -6516,7 +6981,7 @@ module Aws::CloudFormation
6516
6981
  include Aws::Structure
6517
6982
  end
6518
6983
 
6519
- # The ParameterDeclaration data type.
6984
+ # The `ParameterDeclaration` data type.
6520
6985
  #
6521
6986
  # @!attribute [rw] parameter_key
6522
6987
  # The name that's associated with the parameter.
@@ -7017,8 +7482,10 @@ module Aws::CloudFormation
7017
7482
  # @!attribute [rw] action
7018
7483
  # The action that CloudFormation takes on the resource, such as `Add`
7019
7484
  # (adds a new resource), `Modify` (changes a resource), `Remove`
7020
- # (deletes a resource), `Import` (imports a resource), or `Dynamic`
7021
- # (exact action for the resource can't be determined).
7485
+ # (deletes a resource), `Import` (imports a resource), `Dynamic`
7486
+ # (exact action for the resource can't be determined), or
7487
+ # `SyncWithActual` (resource will not be changed, only CloudFormation
7488
+ # metadata will change).
7022
7489
  # @return [String]
7023
7490
  #
7024
7491
  # @!attribute [rw] logical_resource_id
@@ -7057,6 +7524,31 @@ module Aws::CloudFormation
7057
7524
  # attribute's `Metadata`, `Properties`, or `Tags`.
7058
7525
  # @return [Array<String>]
7059
7526
  #
7527
+ # @!attribute [rw] resource_drift_status
7528
+ # The drift status of the resource. Valid values:
7529
+ #
7530
+ # * `IN_SYNC` – The resource matches its template definition.
7531
+ #
7532
+ # * `MODIFIED` – Resource properties were modified outside
7533
+ # CloudFormation.
7534
+ #
7535
+ # * `DELETED` – The resource was deleted outside CloudFormation.
7536
+ #
7537
+ # * `NOT_CHECKED` – CloudFormation doesn’t currently return this
7538
+ # value.
7539
+ #
7540
+ # * `UNKNOWN` – Drift status could not be determined.
7541
+ #
7542
+ # * `UNSUPPORTED` – Resource type does not support actual state
7543
+ # comparison.
7544
+ #
7545
+ # Only present for drift-aware change sets.
7546
+ # @return [String]
7547
+ #
7548
+ # @!attribute [rw] resource_drift_ignored_attributes
7549
+ # List of resource attributes for which drift was ignored.
7550
+ # @return [Array<Types::ResourceDriftIgnoredAttribute>]
7551
+ #
7060
7552
  # @!attribute [rw] details
7061
7553
  # For the `Modify` action, a list of `ResourceChangeDetail` structures
7062
7554
  # that describes the changes that CloudFormation will make to the
@@ -7083,6 +7575,11 @@ module Aws::CloudFormation
7083
7575
  # after the change is executed.
7084
7576
  # @return [String]
7085
7577
  #
7578
+ # @!attribute [rw] previous_deployment_context
7579
+ # Information about the resource's state from the previous
7580
+ # CloudFormation deployment.
7581
+ # @return [String]
7582
+ #
7086
7583
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/ResourceChange AWS API Documentation
7087
7584
  #
7088
7585
  class ResourceChange < Struct.new(
@@ -7093,11 +7590,14 @@ module Aws::CloudFormation
7093
7590
  :resource_type,
7094
7591
  :replacement,
7095
7592
  :scope,
7593
+ :resource_drift_status,
7594
+ :resource_drift_ignored_attributes,
7096
7595
  :details,
7097
7596
  :change_set_id,
7098
7597
  :module_info,
7099
7598
  :before_context,
7100
- :after_context)
7599
+ :after_context,
7600
+ :previous_deployment_context)
7101
7601
  SENSITIVE = []
7102
7602
  include Aws::Structure
7103
7603
  end
@@ -7159,6 +7659,9 @@ module Aws::CloudFormation
7159
7659
  # nested stack's template might have changed. Changes to a nested
7160
7660
  # stack's template aren't visible to CloudFormation until you run
7161
7661
  # an update on the parent stack.
7662
+ #
7663
+ # * `NoModification` entities are changes made to the template that
7664
+ # matches the actual state of the resource.
7162
7665
  # @return [String]
7163
7666
  #
7164
7667
  # @!attribute [rw] causing_entity
@@ -7301,6 +7804,32 @@ module Aws::CloudFormation
7301
7804
  include Aws::Structure
7302
7805
  end
7303
7806
 
7807
+ # The `ResourceDriftIgnoredAttribute` data type.
7808
+ #
7809
+ # @!attribute [rw] path
7810
+ # Path of the resource attribute for which drift was ignored.
7811
+ # @return [String]
7812
+ #
7813
+ # @!attribute [rw] reason
7814
+ # Reason why drift was ignored for the attribute, can have 2 possible
7815
+ # values:
7816
+ #
7817
+ # * `WRITE_ONLY_PROPERTY` - Property is not included in read response
7818
+ # for the resource’s live state.
7819
+ #
7820
+ # * `MANAGED_BY_AWS` - Property is managed by an Amazon Web Services
7821
+ # service and is expected to be dynamically modified.
7822
+ # @return [String]
7823
+ #
7824
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/ResourceDriftIgnoredAttribute AWS API Documentation
7825
+ #
7826
+ class ResourceDriftIgnoredAttribute < Struct.new(
7827
+ :path,
7828
+ :reason)
7829
+ SENSITIVE = []
7830
+ include Aws::Structure
7831
+ end
7832
+
7304
7833
  # Describes the target resources of a specific type in your import
7305
7834
  # template (for example, all `AWS::S3::Bucket` resources) and the
7306
7835
  # properties you can provide during the import to identify resources of
@@ -7504,6 +8033,33 @@ module Aws::CloudFormation
7504
8033
  # can be truncated.
7505
8034
  # @return [String]
7506
8035
  #
8036
+ # @!attribute [rw] before_value_from
8037
+ # Indicates the source of the before value. Valid values:
8038
+ #
8039
+ # * `ACTUAL_STATE` – The before value represents current actual state.
8040
+ #
8041
+ # * `PREVIOUS_DEPLOYMENT_STATE` – The before value represents the
8042
+ # previous CloudFormation deployment state.
8043
+ #
8044
+ # Only present for drift-aware change sets.
8045
+ # @return [String]
8046
+ #
8047
+ # @!attribute [rw] after_value_from
8048
+ # Indicates the source of the after value. Valid value:
8049
+ #
8050
+ # * `TEMPLATE` – The after value comes from the new template.
8051
+ #
8052
+ # ^
8053
+ #
8054
+ # Only present for drift-aware change sets.
8055
+ # @return [String]
8056
+ #
8057
+ # @!attribute [rw] drift
8058
+ # Detailed drift information for the resource property, including
8059
+ # actual values, previous deployment values, and drift detection
8060
+ # timestamps.
8061
+ # @return [Types::LiveResourceDrift]
8062
+ #
7507
8063
  # @!attribute [rw] attribute_change_type
7508
8064
  # The type of change to be made to the property if the change is
7509
8065
  # executed.
@@ -7513,6 +8069,9 @@ module Aws::CloudFormation
7513
8069
  # * `Remove` The item will be removed.
7514
8070
  #
7515
8071
  # * `Modify` The item will be modified.
8072
+ #
8073
+ # * `SyncWithActual` The drift status of this item will be reset but
8074
+ # the item will not be modified.
7516
8075
  # @return [String]
7517
8076
  #
7518
8077
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/ResourceTargetDefinition AWS API Documentation
@@ -7524,6 +8083,9 @@ module Aws::CloudFormation
7524
8083
  :path,
7525
8084
  :before_value,
7526
8085
  :after_value,
8086
+ :before_value_from,
8087
+ :after_value_from,
8088
+ :drift,
7527
8089
  :attribute_change_type)
7528
8090
  SENSITIVE = []
7529
8091
  include Aws::Structure
@@ -7672,10 +8234,16 @@ module Aws::CloudFormation
7672
8234
  # Unique identifier of the stack.
7673
8235
  # @return [String]
7674
8236
  #
8237
+ # @!attribute [rw] operation_id
8238
+ # A unique identifier for this rollback operation that can be used to
8239
+ # track the operation's progress and events.
8240
+ # @return [String]
8241
+ #
7675
8242
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/RollbackStackOutput AWS API Documentation
7676
8243
  #
7677
8244
  class RollbackStackOutput < Struct.new(
7678
- :stack_id)
8245
+ :stack_id,
8246
+ :operation_id)
7679
8247
  SENSITIVE = []
7680
8248
  include Aws::Structure
7681
8249
  end
@@ -8020,7 +8588,7 @@ module Aws::CloudFormation
8020
8588
  include Aws::Structure
8021
8589
  end
8022
8590
 
8023
- # The Stack data type.
8591
+ # The `Stack` data type.
8024
8592
  #
8025
8593
  # @!attribute [rw] stack_id
8026
8594
  # Unique identifier of the stack.
@@ -8187,6 +8755,11 @@ module Aws::CloudFormation
8187
8755
  # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stack-resource-configuration-complete.html
8188
8756
  # @return [String]
8189
8757
  #
8758
+ # @!attribute [rw] last_operations
8759
+ # Information about the most recent operations performed on this
8760
+ # stack.
8761
+ # @return [Array<Types::OperationEntry>]
8762
+ #
8190
8763
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/Stack AWS API Documentation
8191
8764
  #
8192
8765
  class Stack < Struct.new(
@@ -8214,7 +8787,8 @@ module Aws::CloudFormation
8214
8787
  :drift_information,
8215
8788
  :retain_except_on_create,
8216
8789
  :deletion_mode,
8217
- :detailed_status)
8790
+ :detailed_status,
8791
+ :last_operations)
8218
8792
  SENSITIVE = []
8219
8793
  include Aws::Structure
8220
8794
  end
@@ -8321,7 +8895,7 @@ module Aws::CloudFormation
8321
8895
  include Aws::Structure
8322
8896
  end
8323
8897
 
8324
- # The StackEvent data type.
8898
+ # The `StackEvent` data type.
8325
8899
  #
8326
8900
  # @!attribute [rw] stack_id
8327
8901
  # The unique ID name of the instance of the stack.
@@ -8335,6 +8909,11 @@ module Aws::CloudFormation
8335
8909
  # The name associated with a stack.
8336
8910
  # @return [String]
8337
8911
  #
8912
+ # @!attribute [rw] operation_id
8913
+ # The unique identifier of the operation that generated this stack
8914
+ # event.
8915
+ # @return [String]
8916
+ #
8338
8917
  # @!attribute [rw] logical_resource_id
8339
8918
  # The logical name of the resource specified in the template.
8340
8919
  # @return [String]
@@ -8447,6 +9026,7 @@ module Aws::CloudFormation
8447
9026
  :stack_id,
8448
9027
  :event_id,
8449
9028
  :stack_name,
9029
+ :operation_id,
8450
9030
  :logical_resource_id,
8451
9031
  :physical_resource_id,
8452
9032
  :resource_type,
@@ -8992,7 +9572,7 @@ module Aws::CloudFormation
8992
9572
  include Aws::Structure
8993
9573
  end
8994
9574
 
8995
- # The StackResource data type.
9575
+ # The `StackResource` data type.
8996
9576
  #
8997
9577
  # @!attribute [rw] stack_name
8998
9578
  # The name associated with the stack.
@@ -10299,7 +10879,7 @@ module Aws::CloudFormation
10299
10879
  include Aws::Structure
10300
10880
  end
10301
10881
 
10302
- # The StackSummary Data Type
10882
+ # The `StackSummary` Data Type
10303
10883
  #
10304
10884
  # @!attribute [rw] stack_id
10305
10885
  # Unique stack identifier.
@@ -10372,6 +10952,11 @@ module Aws::CloudFormation
10372
10952
  # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-stack-drift.html
10373
10953
  # @return [Types::StackDriftInformationSummary]
10374
10954
  #
10955
+ # @!attribute [rw] last_operations
10956
+ # Information about the most recent operations performed on this
10957
+ # stack.
10958
+ # @return [Array<Types::OperationEntry>]
10959
+ #
10375
10960
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/StackSummary AWS API Documentation
10376
10961
  #
10377
10962
  class StackSummary < Struct.new(
@@ -10385,7 +10970,8 @@ module Aws::CloudFormation
10385
10970
  :stack_status_reason,
10386
10971
  :parent_id,
10387
10972
  :root_id,
10388
- :drift_information)
10973
+ :drift_information,
10974
+ :last_operations)
10389
10975
  SENSITIVE = []
10390
10976
  include Aws::Structure
10391
10977
  end
@@ -10547,7 +11133,7 @@ module Aws::CloudFormation
10547
11133
  include Aws::Structure
10548
11134
  end
10549
11135
 
10550
- # The TemplateParameter data type.
11136
+ # The `TemplateParameter` data type.
10551
11137
  #
10552
11138
  # @!attribute [rw] parameter_key
10553
11139
  # The name associated with the parameter.
@@ -11268,9 +11854,19 @@ module Aws::CloudFormation
11268
11854
  # Reuse the existing template that is associated with the stack that
11269
11855
  # you are updating.
11270
11856
  #
11857
+ # When using templates with the `AWS::LanguageExtensions` transform,
11858
+ # provide the template instead of using `UsePreviousTemplate` to
11859
+ # ensure new parameter values and Systems Manager parameter updates
11860
+ # are applied correctly. For more information, see
11861
+ # [AWS::LanguageExtensions transform][1].
11862
+ #
11271
11863
  # Conditional: You must specify only one of the following parameters:
11272
11864
  # `TemplateBody`, `TemplateURL`, or set the `UsePreviousTemplate` to
11273
11865
  # `true`.
11866
+ #
11867
+ #
11868
+ #
11869
+ # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/transform-aws-languageextensions.html
11274
11870
  # @return [Boolean]
11275
11871
  #
11276
11872
  # @!attribute [rw] stack_policy_during_update_body
@@ -11405,16 +12001,15 @@ module Aws::CloudFormation
11405
12001
  # @return [Array<String>]
11406
12002
  #
11407
12003
  # @!attribute [rw] resource_types
11408
- # The template resource types that you have permissions to work with
11409
- # for this update stack action, such as `AWS::EC2::Instance`,
11410
- # `AWS::EC2::*`, or `Custom::MyCustomInstance`.
12004
+ # Specifies which resource types you can work with, such as
12005
+ # `AWS::EC2::Instance` or `Custom::MyCustomInstance`.
11411
12006
  #
11412
12007
  # If the list of resource types doesn't include a resource that
11413
12008
  # you're updating, the stack update fails. By default, CloudFormation
11414
12009
  # grants permissions to all resource types. IAM uses this parameter
11415
12010
  # for CloudFormation-specific condition keys in IAM policies. For more
11416
- # information, see [Control access with Identity and Access
11417
- # Management][1].
12011
+ # information, see [Control CloudFormation access with Identity and
12012
+ # Access Management][1].
11418
12013
  #
11419
12014
  # <note markdown="1"> Only one of the `Capabilities` and `ResourceType` parameters can be
11420
12015
  # specified.
@@ -11703,10 +12298,16 @@ module Aws::CloudFormation
11703
12298
  # Unique identifier of the stack.
11704
12299
  # @return [String]
11705
12300
  #
12301
+ # @!attribute [rw] operation_id
12302
+ # A unique identifier for this update operation that can be used to
12303
+ # track the operation's progress and events.
12304
+ # @return [String]
12305
+ #
11706
12306
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/UpdateStackOutput AWS API Documentation
11707
12307
  #
11708
12308
  class UpdateStackOutput < Struct.new(
11709
- :stack_id)
12309
+ :stack_id,
12310
+ :operation_id)
11710
12311
  SENSITIVE = []
11711
12312
  include Aws::Structure
11712
12313
  end