aws-sdk-cloudformation 1.65.0 → 1.66.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -38,21 +38,21 @@ module Aws::CloudFormation
38
38
  # operation in that account and Region.
39
39
  #
40
40
  # * `FAILED`\: The account gate function has determined that the
41
- # account and Region does not meet the requirements for a stack set
42
- # operation to occur. AWS CloudFormation cancels the stack set
43
- # operation in that account and Region, and sets the stack set
44
- # operation result status for that account and Region to `FAILED`.
41
+ # account and Region doesn't meet the requirements for a stack set
42
+ # operation to occur. CloudFormation cancels the stack set operation
43
+ # in that account and Region, and sets the stack set operation
44
+ # result status for that account and Region to `FAILED`.
45
45
  #
46
46
  # * `SKIPPED`\: CloudFormation has skipped calling the account gate
47
47
  # function for this account and Region, for one of the following
48
48
  # reasons:
49
49
  #
50
- # * An account gate function has not been specified for the account
50
+ # * An account gate function hasn't been specified for the account
51
51
  # and Region. CloudFormation proceeds with the stack set operation
52
52
  # in this account and Region.
53
53
  #
54
54
  # * The `AWSCloudFormationStackSetExecutionRole` of the stack set
55
- # adminstration account lacks permissions to invoke the function.
55
+ # administration account lacks permissions to invoke the function.
56
56
  # CloudFormation proceeds with the stack set operation in this
57
57
  # account and Region.
58
58
  #
@@ -86,7 +86,7 @@ module Aws::CloudFormation
86
86
  # * Number of stack outputs
87
87
  #
88
88
  # For more information about these account limits, and other
89
- # CloudFormation limits, see [CloudFormation Limits][1] in the
89
+ # CloudFormation limits, see [CloudFormation quotas][1] in the
90
90
  # *CloudFormation User Guide*.
91
91
  #
92
92
  #
@@ -101,7 +101,7 @@ module Aws::CloudFormation
101
101
  # @return [String]
102
102
  #
103
103
  # @!attribute [rw] value
104
- # The value that is associated with the account limit name.
104
+ # The value that's associated with the account limit name.
105
105
  # @return [Integer]
106
106
  #
107
107
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/AccountLimit AWS API Documentation
@@ -117,7 +117,7 @@ module Aws::CloudFormation
117
117
  # data as a hash:
118
118
  #
119
119
  # {
120
- # type: "RESOURCE", # accepts RESOURCE, MODULE
120
+ # type: "RESOURCE", # accepts RESOURCE, MODULE, HOOK
121
121
  # public_type_arn: "ThirdPartyTypeArn",
122
122
  # publisher_id: "PublisherId",
123
123
  # type_name: "TypeName",
@@ -316,7 +316,7 @@ module Aws::CloudFormation
316
316
  # type_arn: "TypeArn",
317
317
  # type_configuration_alias: "TypeConfigurationAlias",
318
318
  # type_configuration_arn: "TypeConfigurationArn",
319
- # type: "RESOURCE", # accepts RESOURCE, MODULE
319
+ # type: "RESOURCE", # accepts RESOURCE, MODULE, HOOK
320
320
  # type_name: "TypeName",
321
321
  # },
322
322
  # ],
@@ -383,7 +383,7 @@ module Aws::CloudFormation
383
383
  # }
384
384
  #
385
385
  # @!attribute [rw] stack_name
386
- # The name or the unique stack ID that is associated with the stack.
386
+ # The name or the unique stack ID that's associated with the stack.
387
387
  # @return [String]
388
388
  #
389
389
  # @!attribute [rw] client_request_token
@@ -411,6 +411,11 @@ module Aws::CloudFormation
411
411
  # entity type is `Resource`.
412
412
  # @return [String]
413
413
  #
414
+ # @!attribute [rw] hook_invocation_count
415
+ # Is either `null`, if no hooks invoke for the resource, or contains
416
+ # the number of hooks that will invoke for the resource.
417
+ # @return [Integer]
418
+ #
414
419
  # @!attribute [rw] resource_change
415
420
  # A `ResourceChange` structure that describes the resource and action
416
421
  # that CloudFormation will perform.
@@ -420,13 +425,123 @@ module Aws::CloudFormation
420
425
  #
421
426
  class Change < Struct.new(
422
427
  :type,
428
+ :hook_invocation_count,
423
429
  :resource_change)
424
430
  SENSITIVE = []
425
431
  include Aws::Structure
426
432
  end
427
433
 
434
+ # Specifies the resource, the hook, and the hook version to be invoked.
435
+ #
436
+ # @!attribute [rw] invocation_point
437
+ # Specifies the points in provisioning logic where a hook is invoked.
438
+ # @return [String]
439
+ #
440
+ # @!attribute [rw] failure_mode
441
+ # Specify the hook failure mode for non-compliant resources in the
442
+ # followings ways.
443
+ #
444
+ # * `FAIL` Stops provisioning resources.
445
+ #
446
+ # * `WARN` Allows provisioning to continue with a warning message.
447
+ # @return [String]
448
+ #
449
+ # @!attribute [rw] type_name
450
+ # The unique name for your hook. Specifies a three-part namespace for
451
+ # your hook, with a recommended pattern of
452
+ # `Organization::Service::Hook`.
453
+ #
454
+ # <note markdown="1"> The following organization namespaces are reserved and can't be
455
+ # used in your hook type names:
456
+ #
457
+ # * `Alexa`
458
+ #
459
+ # * `AMZN`
460
+ #
461
+ # * `Amazon`
462
+ #
463
+ # * `ASK`
464
+ #
465
+ # * `AWS`
466
+ #
467
+ # * `Custom`
468
+ #
469
+ # * `Dev`
470
+ #
471
+ # </note>
472
+ # @return [String]
473
+ #
474
+ # @!attribute [rw] type_version_id
475
+ # The version ID of the type specified.
476
+ # @return [String]
477
+ #
478
+ # @!attribute [rw] type_configuration_version_id
479
+ # The version ID of the type configuration.
480
+ # @return [String]
481
+ #
482
+ # @!attribute [rw] target_details
483
+ # Specifies details about the target that the hook will run against.
484
+ # @return [Types::ChangeSetHookTargetDetails]
485
+ #
486
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/ChangeSetHook AWS API Documentation
487
+ #
488
+ class ChangeSetHook < Struct.new(
489
+ :invocation_point,
490
+ :failure_mode,
491
+ :type_name,
492
+ :type_version_id,
493
+ :type_configuration_version_id,
494
+ :target_details)
495
+ SENSITIVE = []
496
+ include Aws::Structure
497
+ end
498
+
499
+ # Specifies `RESOURCE` type target details for activated hooks.
500
+ #
501
+ # @!attribute [rw] logical_resource_id
502
+ # The resource's logical ID, which is defined in the stack's
503
+ # template.
504
+ # @return [String]
505
+ #
506
+ # @!attribute [rw] resource_type
507
+ # The type of CloudFormation resource, such as `AWS::S3::Bucket`.
508
+ # @return [String]
509
+ #
510
+ # @!attribute [rw] resource_action
511
+ # Specifies the action of the resource.
512
+ # @return [String]
513
+ #
514
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/ChangeSetHookResourceTargetDetails AWS API Documentation
515
+ #
516
+ class ChangeSetHookResourceTargetDetails < Struct.new(
517
+ :logical_resource_id,
518
+ :resource_type,
519
+ :resource_action)
520
+ SENSITIVE = []
521
+ include Aws::Structure
522
+ end
523
+
524
+ # Specifies target details for an activated hook.
525
+ #
526
+ # @!attribute [rw] target_type
527
+ # The name of the type.
528
+ # @return [String]
529
+ #
530
+ # @!attribute [rw] resource_target_details
531
+ # Required if `TargetType` is `RESOURCE`.
532
+ # @return [Types::ChangeSetHookResourceTargetDetails]
533
+ #
534
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/ChangeSetHookTargetDetails AWS API Documentation
535
+ #
536
+ class ChangeSetHookTargetDetails < Struct.new(
537
+ :target_type,
538
+ :resource_target_details)
539
+ SENSITIVE = []
540
+ include Aws::Structure
541
+ end
542
+
428
543
  # The specified change set name or ID doesn't exit. To view valid
429
- # change sets for a stack, use the `ListChangeSets` action.
544
+ # change sets for a stack, use the `ListChangeSets` operation.
430
545
  #
431
546
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/ChangeSetNotFoundException AWS API Documentation
432
547
  #
@@ -453,7 +568,7 @@ module Aws::CloudFormation
453
568
  #
454
569
  # @!attribute [rw] execution_status
455
570
  # If the change set execution status is `AVAILABLE`, you can execute
456
- # the change set. If you cant execute the change set, the status
571
+ # the change set. If you can't execute the change set, the status
457
572
  # indicates why. For example, a change set might be in an
458
573
  # `UNAVAILABLE` state because CloudFormation is still creating it or
459
574
  # in an `OBSOLETE` state because the stack was already updated.
@@ -539,14 +654,14 @@ module Aws::CloudFormation
539
654
  # (IAM) role that CloudFormation assumes to roll back the stack.
540
655
  # CloudFormation uses the role's credentials to make calls on your
541
656
  # behalf. CloudFormation always uses this role for all future
542
- # operations on the stack. As long as users have permission to operate
543
- # on the stack, CloudFormation uses this role even if the users don't
544
- # have permission to pass it. Ensure that the role grants least
545
- # privilege.
657
+ # operations on the stack. Provided that users have permission to
658
+ # operate on the stack, CloudFormation uses this role even if the
659
+ # users don't have permission to pass it. Ensure that the role grants
660
+ # least permission.
546
661
  #
547
662
  # If you don't specify a value, CloudFormation uses the role that was
548
663
  # previously associated with the stack. If no role is available,
549
- # CloudFormation uses a temporary session that is generated from your
664
+ # CloudFormation uses a temporary session that's generated from your
550
665
  # user credentials.
551
666
  # @return [String]
552
667
  #
@@ -556,7 +671,7 @@ module Aws::CloudFormation
556
671
  # resources that are in the `UPDATE_FAILED` state because a rollback
557
672
  # failed. You can't specify resources that are in the `UPDATE_FAILED`
558
673
  # state for other reasons, for example, because an update was
559
- # cancelled. To check why a resource update failed, use the
674
+ # canceled. To check why a resource update failed, use the
560
675
  # DescribeStackResources action, and view the resource status reason.
561
676
  #
562
677
  # Specify this property to skip rolling back resources that
@@ -615,7 +730,7 @@ module Aws::CloudFormation
615
730
  include Aws::Structure
616
731
  end
617
732
 
618
- # The output for a ContinueUpdateRollback action.
733
+ # The output for a ContinueUpdateRollback operation.
619
734
  #
620
735
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/ContinueUpdateRollbackOutput AWS API Documentation
621
736
  #
@@ -692,8 +807,8 @@ module Aws::CloudFormation
692
807
  #
693
808
  # @!attribute [rw] template_url
694
809
  # The location of the file that contains the revised template. The URL
695
- # must point to a template (max size: 460,800 bytes) that is located
696
- # in an S3 bucket or a Systems Manager document. CloudFormation
810
+ # must point to a template (max size: 460,800 bytes) that's located
811
+ # in an Amazon S3 bucket or a Systems Manager document. CloudFormation
697
812
  # generates the change set by comparing this template with the stack
698
813
  # that you specified.
699
814
  #
@@ -701,7 +816,7 @@ module Aws::CloudFormation
701
816
  # @return [String]
702
817
  #
703
818
  # @!attribute [rw] use_previous_template
704
- # Whether to reuse the template that is associated with the stack to
819
+ # Whether to reuse the template that's associated with the stack to
705
820
  # create the change set.
706
821
  # @return [Boolean]
707
822
  #
@@ -742,7 +857,7 @@ module Aws::CloudFormation
742
857
  #
743
858
  # * [ AWS::IAM::Group][2]
744
859
  #
745
- # * [ AWS::IAM::InstanceProfile][3]
860
+ # * [AWS::IAM::InstanceProfile][3]
746
861
  #
747
862
  # * [ AWS::IAM::Policy][4]
748
863
  #
@@ -750,10 +865,10 @@ module Aws::CloudFormation
750
865
  #
751
866
  # * [ AWS::IAM::User][6]
752
867
  #
753
- # * [ AWS::IAM::UserToGroupAddition][7]
868
+ # * [AWS::IAM::UserToGroupAddition][7]
754
869
  #
755
- # For more information, see [Acknowledging IAM Resources in
756
- # CloudFormation Templates][8].
870
+ # For more information, see [Acknowledging IAM resources in
871
+ # CloudFormation templates][8].
757
872
  #
758
873
  # * `CAPABILITY_AUTO_EXPAND`
759
874
  #
@@ -770,7 +885,7 @@ module Aws::CloudFormation
770
885
  # and [AWS::Serverless][10] transforms, which are macros hosted by
771
886
  # CloudFormation.
772
887
  #
773
- # <note markdown="1"> This capacity does not apply to creating change sets, and
888
+ # <note markdown="1"> This capacity doesn't apply to creating change sets, and
774
889
  # specifying it when creating change sets has no effect.
775
890
  #
776
891
  # If you want to create a stack from a stack template that contains
@@ -780,8 +895,8 @@ module Aws::CloudFormation
780
895
  #
781
896
  # </note>
782
897
  #
783
- # For more information on macros, see [Using CloudFormation Macros
784
- # to Perform Custom Processing on Templates][11].
898
+ # For more information on macros, see [Using CloudFormation macros
899
+ # to perform custom processing on templates][11].
785
900
  #
786
901
  #
787
902
  #
@@ -808,7 +923,7 @@ module Aws::CloudFormation
808
923
  # grants permissions to all resource types. Identity and Access
809
924
  # Management (IAM) uses this parameter for condition keys in IAM
810
925
  # policies for CloudFormation. For more information, see [Controlling
811
- # Access with Identity and Access Management][1] in the CloudFormation
926
+ # access with Identity and Access Management][1] in the CloudFormation
812
927
  # User Guide.
813
928
  #
814
929
  #
@@ -821,9 +936,9 @@ module Aws::CloudFormation
821
936
  # (IAM) role that CloudFormation assumes when executing the change
822
937
  # set. CloudFormation uses the role's credentials to make calls on
823
938
  # your behalf. CloudFormation uses this role for all future operations
824
- # on the stack. As long as users have permission to operate on the
939
+ # on the stack. Provided that users have permission to operate on the
825
940
  # stack, CloudFormation uses this role even if the users don't have
826
- # permission to pass it. Ensure that the role grants least privilege.
941
+ # permission to pass it. Ensure that the role grants least permission.
827
942
  #
828
943
  # If you don't specify a value, CloudFormation uses the role that was
829
944
  # previously associated with the stack. If no role is available,
@@ -855,8 +970,8 @@ module Aws::CloudFormation
855
970
  # sets that are associated with the specified stack.
856
971
  #
857
972
  # A change set name can contain only alphanumeric, case sensitive
858
- # characters and hyphens. It must start with an alphabetic character
859
- # and cannot exceed 128 characters.
973
+ # characters, and hyphens. It must start with an alphabetical
974
+ # character and can't exceed 128 characters.
860
975
  # @return [String]
861
976
  #
862
977
  # @!attribute [rw] client_token
@@ -990,12 +1105,12 @@ module Aws::CloudFormation
990
1105
  # }
991
1106
  #
992
1107
  # @!attribute [rw] stack_name
993
- # The name that is associated with the stack. The name must be unique
1108
+ # The name that's associated with the stack. The name must be unique
994
1109
  # in the Region in which you are creating the stack.
995
1110
  #
996
1111
  # <note markdown="1"> A stack name can contain only alphanumeric characters (case
997
1112
  # sensitive) and hyphens. It must start with an alphabetical character
998
- # and cannot be longer than 128 characters.
1113
+ # and can't be longer than 128 characters.
999
1114
  #
1000
1115
  # </note>
1001
1116
  # @return [String]
@@ -1003,7 +1118,7 @@ module Aws::CloudFormation
1003
1118
  # @!attribute [rw] template_body
1004
1119
  # Structure containing the template body with a minimum length of 1
1005
1120
  # byte and a maximum length of 51,200 bytes. For more information, go
1006
- # to [Template Anatomy][1] in the CloudFormation User Guide.
1121
+ # to [Template anatomy][1] in the CloudFormation User Guide.
1007
1122
  #
1008
1123
  # Conditional: You must specify either the `TemplateBody` or the
1009
1124
  # `TemplateURL` parameter, but not both.
@@ -1015,9 +1130,9 @@ module Aws::CloudFormation
1015
1130
  #
1016
1131
  # @!attribute [rw] template_url
1017
1132
  # Location of file containing the template body. The URL must point to
1018
- # a template (max size: 460,800 bytes) that is located in an Amazon S3
1133
+ # a template (max size: 460,800 bytes) that's located in an Amazon S3
1019
1134
  # bucket or a Systems Manager document. For more information, go to
1020
- # the [Template Anatomy][1] in the CloudFormation User Guide.
1135
+ # the [Template anatomy][1] in the CloudFormation User Guide.
1021
1136
  #
1022
1137
  # Conditional: You must specify either the `TemplateBody` or the
1023
1138
  # `TemplateURL` parameter, but not both.
@@ -1057,9 +1172,10 @@ module Aws::CloudFormation
1057
1172
  # @return [Integer]
1058
1173
  #
1059
1174
  # @!attribute [rw] notification_arns
1060
- # The Simple Notification Service (SNS) topic ARNs to publish stack
1061
- # related events. You can find your SNS topic ARNs using the SNS
1062
- # console or your Command Line Interface (CLI).
1175
+ # The Amazon Simple Notification Service (Amazon SNS) topic ARNs to
1176
+ # publish stack related events. You can find your Amazon SNS topic
1177
+ # ARNs using the Amazon SNS console or your Command Line Interface
1178
+ # (CLI).
1063
1179
  # @return [Array<String>]
1064
1180
  #
1065
1181
  # @!attribute [rw] capabilities
@@ -1094,7 +1210,7 @@ module Aws::CloudFormation
1094
1210
  #
1095
1211
  # * [ AWS::IAM::Group][2]
1096
1212
  #
1097
- # * [ AWS::IAM::InstanceProfile][3]
1213
+ # * [AWS::IAM::InstanceProfile][3]
1098
1214
  #
1099
1215
  # * [ AWS::IAM::Policy][4]
1100
1216
  #
@@ -1102,7 +1218,7 @@ module Aws::CloudFormation
1102
1218
  #
1103
1219
  # * [ AWS::IAM::User][6]
1104
1220
  #
1105
- # * [ AWS::IAM::UserToGroupAddition][7]
1221
+ # * [AWS::IAM::UserToGroupAddition][7]
1106
1222
  #
1107
1223
  # For more information, see [Acknowledging IAM Resources in
1108
1224
  # CloudFormation Templates][8].
@@ -1134,8 +1250,8 @@ module Aws::CloudFormation
1134
1250
  # owner can update the function operation without CloudFormation
1135
1251
  # being notified.
1136
1252
  #
1137
- # For more information, see [Using CloudFormation Macros to Perform
1138
- # Custom Processing on Templates][11].
1253
+ # For more information, see [Using CloudFormation macros to perform
1254
+ # custom processing on templates][11].
1139
1255
  #
1140
1256
  #
1141
1257
  #
@@ -1181,21 +1297,21 @@ module Aws::CloudFormation
1181
1297
  # (IAM) role that CloudFormation assumes to create the stack.
1182
1298
  # CloudFormation uses the role's credentials to make calls on your
1183
1299
  # behalf. CloudFormation always uses this role for all future
1184
- # operations on the stack. As long as users have permission to operate
1185
- # on the stack, CloudFormation uses this role even if the users don't
1186
- # have permission to pass it. Ensure that the role grants least
1187
- # privilege.
1300
+ # operations on the stack. Provided that users have permission to
1301
+ # operate on the stack, CloudFormation uses this role even if the
1302
+ # users don't have permission to pass it. Ensure that the role grants
1303
+ # least privilege.
1188
1304
  #
1189
1305
  # If you don't specify a value, CloudFormation uses the role that was
1190
1306
  # previously associated with the stack. If no role is available,
1191
- # CloudFormation uses a temporary session that is generated from your
1307
+ # CloudFormation uses a temporary session that's generated from your
1192
1308
  # user credentials.
1193
1309
  # @return [String]
1194
1310
  #
1195
1311
  # @!attribute [rw] on_failure
1196
1312
  # Determines what action will be taken if stack creation fails. This
1197
- # must be one of: DO\_NOTHING, ROLLBACK, or DELETE. You can specify
1198
- # either `OnFailure` or `DisableRollback`, but not both.
1313
+ # must be one of: `DO_NOTHING`, `ROLLBACK`, or `DELETE`. You can
1314
+ # specify either `OnFailure` or `DisableRollback`, but not both.
1199
1315
  #
1200
1316
  # Default: `ROLLBACK`
1201
1317
  # @return [String]
@@ -1231,7 +1347,7 @@ module Aws::CloudFormation
1231
1347
  # You might retry `CreateStack` requests to ensure that CloudFormation
1232
1348
  # successfully received them.
1233
1349
  #
1234
- # All events triggered by a given stack operation are assigned the
1350
+ # All events initiated by a given stack operation are assigned the
1235
1351
  # same client request token, which you can use to track operations.
1236
1352
  # For example, if you execute a `CreateStack` operation with the token
1237
1353
  # `token1`, then all the `StackEvents` generated by that operation
@@ -1251,11 +1367,11 @@ module Aws::CloudFormation
1251
1367
  # a user attempts to delete a stack with termination protection
1252
1368
  # enabled, the operation fails and the stack remains unchanged. For
1253
1369
  # more information, see [Protecting a Stack From Being Deleted][1] in
1254
- # the *CloudFormation User Guide*. Termination protection is disabled
1255
- # on stacks by default.
1370
+ # the *CloudFormation User Guide*. Termination protection is
1371
+ # deactivated on stacks by default.
1256
1372
  #
1257
1373
  # For [nested stacks][2], termination protection is set on the root
1258
- # stack and cannot be changed directly on the nested stack.
1374
+ # stack and can't be changed directly on the nested stack.
1259
1375
  #
1260
1376
  #
1261
1377
  #
@@ -1334,14 +1450,16 @@ module Aws::CloudFormation
1334
1450
  #
1335
1451
  # @!attribute [rw] deployment_targets
1336
1452
  # \[Service-managed permissions\] The Organizations accounts for which
1337
- # to create stack instances in the specified Regions.
1453
+ # to create stack instances in the specified Amazon Web Services
1454
+ # Regions.
1338
1455
  #
1339
1456
  # You can specify `Accounts` or `DeploymentTargets`, but not both.
1340
1457
  # @return [Types::DeploymentTargets]
1341
1458
  #
1342
1459
  # @!attribute [rw] regions
1343
- # The names of one or more Regions where you want to create stack
1344
- # instances using the specified Amazon Web Services accounts.
1460
+ # The names of one or more Amazon Web Services Regions where you want
1461
+ # to create stack instances using the specified Amazon Web Services
1462
+ # accounts.
1345
1463
  # @return [Array<String>]
1346
1464
  #
1347
1465
  # @!attribute [rw] parameter_overrides
@@ -1349,26 +1467,27 @@ module Aws::CloudFormation
1349
1467
  # the selected stack instances.
1350
1468
  #
1351
1469
  # Any overridden parameter values will be applied to all stack
1352
- # instances in the specified accounts and Regions. When specifying
1353
- # parameters and their values, be aware of how CloudFormation sets
1354
- # parameter values during stack instance operations:
1470
+ # instances in the specified accounts and Amazon Web Services Regions.
1471
+ # When specifying parameters and their values, be aware of how
1472
+ # CloudFormation sets parameter values during stack instance
1473
+ # operations:
1355
1474
  #
1356
1475
  # * To override the current value for a parameter, include the
1357
1476
  # parameter and specify its value.
1358
1477
  #
1359
1478
  # * To leave an overridden parameter set to its present value, include
1360
1479
  # the parameter and specify `UsePreviousValue` as `true`. (You
1361
- # cannot specify both a value and set `UsePreviousValue` to `true`.)
1480
+ # can't specify both a value and set `UsePreviousValue` to `true`.)
1362
1481
  #
1363
1482
  # * To set an overridden parameter back to the value specified in the
1364
- # stack set, specify a parameter list but do not include the
1483
+ # stack set, specify a parameter list but don't include the
1365
1484
  # parameter in the list.
1366
1485
  #
1367
- # * To leave all parameters set to their present values, do not
1486
+ # * To leave all parameters set to their present values, don't
1368
1487
  # specify this property at all.
1369
1488
  #
1370
1489
  # During stack set updates, any parameter values overridden for a
1371
- # stack instance are not updated, but retain their overridden value.
1490
+ # stack instance aren't updated, but retain their overridden value.
1372
1491
  #
1373
1492
  # You can only override the parameter *values* that are specified in
1374
1493
  # the stack set; to add or delete a parameter itself, use
@@ -1591,7 +1710,7 @@ module Aws::CloudFormation
1591
1710
  #
1592
1711
  # * [ AWS::IAM::Group][2]
1593
1712
  #
1594
- # * [ AWS::IAM::InstanceProfile][3]
1713
+ # * [AWS::IAM::InstanceProfile][3]
1595
1714
  #
1596
1715
  # * [ AWS::IAM::Policy][4]
1597
1716
  #
@@ -1599,7 +1718,7 @@ module Aws::CloudFormation
1599
1718
  #
1600
1719
  # * [ AWS::IAM::User][6]
1601
1720
  #
1602
- # * [ AWS::IAM::UserToGroupAddition][7]
1721
+ # * [AWS::IAM::UserToGroupAddition][7]
1603
1722
  #
1604
1723
  # For more information, see [Acknowledging IAM Resources in
1605
1724
  # CloudFormation Templates][8].
@@ -1614,7 +1733,7 @@ module Aws::CloudFormation
1614
1733
  # information, see [Using CloudFormation Macros to Perform Custom
1615
1734
  # Processing on Templates][9].
1616
1735
  #
1617
- # Stack sets with service-managed permissions do not currently
1736
+ # Stack sets with service-managed permissions don't currently
1618
1737
  # support the use of macros in templates. (This includes the
1619
1738
  # [AWS::Include][10] and [AWS::Serverless][11] transforms, which are
1620
1739
  # macros hosted by CloudFormation.) Even if you specify this
@@ -1795,7 +1914,7 @@ module Aws::CloudFormation
1795
1914
  #
1796
1915
  # {
1797
1916
  # type_name: "TypeName",
1798
- # type: "RESOURCE", # accepts RESOURCE, MODULE
1917
+ # type: "RESOURCE", # accepts RESOURCE, MODULE, HOOK
1799
1918
  # arn: "PrivateTypeArn",
1800
1919
  # }
1801
1920
  #
@@ -1854,7 +1973,7 @@ module Aws::CloudFormation
1854
1973
  #
1855
1974
  # @!attribute [rw] stack_name
1856
1975
  # If you specified the name of a change set to delete, specify the
1857
- # stack name or ID (ARN) that is associated with it.
1976
+ # stack name or Amazon Resource Name (ARN) that's associated with it.
1858
1977
  # @return [String]
1859
1978
  #
1860
1979
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/DeleteChangeSetInput AWS API Documentation
@@ -1885,16 +2004,16 @@ module Aws::CloudFormation
1885
2004
  # }
1886
2005
  #
1887
2006
  # @!attribute [rw] stack_name
1888
- # The name or the unique stack ID that is associated with the stack.
2007
+ # The name or the unique stack ID that's associated with the stack.
1889
2008
  # @return [String]
1890
2009
  #
1891
2010
  # @!attribute [rw] retain_resources
1892
2011
  # For stacks in the `DELETE_FAILED` state, a list of resource logical
1893
2012
  # IDs that are associated with the resources you want to retain.
1894
- # During deletion, CloudFormation deletes the stack but does not
2013
+ # During deletion, CloudFormation deletes the stack but doesn't
1895
2014
  # delete the retained resources.
1896
2015
  #
1897
- # Retaining resources is useful when you cannot delete a resource,
2016
+ # Retaining resources is useful when you can't delete a resource,
1898
2017
  # such as a non-empty S3 bucket, but you want to delete the stack.
1899
2018
  # @return [Array<String>]
1900
2019
  #
@@ -1906,7 +2025,7 @@ module Aws::CloudFormation
1906
2025
  #
1907
2026
  # If you don't specify a value, CloudFormation uses the role that was
1908
2027
  # previously associated with the stack. If no role is available,
1909
- # CloudFormation uses a temporary session that is generated from your
2028
+ # CloudFormation uses a temporary session that's generated from your
1910
2029
  # user credentials.
1911
2030
  # @return [String]
1912
2031
  #
@@ -1917,7 +2036,7 @@ module Aws::CloudFormation
1917
2036
  # You might retry `DeleteStack` requests to ensure that CloudFormation
1918
2037
  # successfully received them.
1919
2038
  #
1920
- # All events triggered by a given stack operation are assigned the
2039
+ # All events initiated by a given stack operation are assigned the
1921
2040
  # same client request token, which you can use to track operations.
1922
2041
  # For example, if you execute a `CreateStack` operation with the token
1923
2042
  # `token1`, then all the `StackEvents` generated by that operation
@@ -1988,7 +2107,8 @@ module Aws::CloudFormation
1988
2107
  # @return [Types::DeploymentTargets]
1989
2108
  #
1990
2109
  # @!attribute [rw] regions
1991
- # The Regions where you want to delete stack set instances.
2110
+ # The Amazon Web Services Regions where you want to delete stack set
2111
+ # instances.
1992
2112
  # @return [Array<String>]
1993
2113
  #
1994
2114
  # @!attribute [rw] operation_preferences
@@ -2127,7 +2247,7 @@ module Aws::CloudFormation
2127
2247
  class DeleteStackSetOutput < Aws::EmptyStructure; end
2128
2248
 
2129
2249
  # \[Service-managed permissions\] The Organizations accounts to which
2130
- # StackSets deploys. StackSets does not deploy stack instances to the
2250
+ # StackSets deploys. StackSets doesn't deploy stack instances to the
2131
2251
  # organization management account, even if the organization management
2132
2252
  # account is in your organization or in an OU in your organization.
2133
2253
  #
@@ -2173,7 +2293,7 @@ module Aws::CloudFormation
2173
2293
  #
2174
2294
  # {
2175
2295
  # arn: "PrivateTypeArn",
2176
- # type: "RESOURCE", # accepts RESOURCE, MODULE
2296
+ # type: "RESOURCE", # accepts RESOURCE, MODULE, HOOK
2177
2297
  # type_name: "TypeName",
2178
2298
  # version_id: "TypeVersionId",
2179
2299
  # }
@@ -2264,6 +2384,90 @@ module Aws::CloudFormation
2264
2384
  include Aws::Structure
2265
2385
  end
2266
2386
 
2387
+ # @note When making an API call, you may pass DescribeChangeSetHooksInput
2388
+ # data as a hash:
2389
+ #
2390
+ # {
2391
+ # change_set_name: "ChangeSetNameOrId", # required
2392
+ # stack_name: "StackNameOrId",
2393
+ # next_token: "NextToken",
2394
+ # logical_resource_id: "LogicalResourceId",
2395
+ # }
2396
+ #
2397
+ # @!attribute [rw] change_set_name
2398
+ # The name or Amazon Resource Name (ARN) of the change set that you
2399
+ # want to describe.
2400
+ # @return [String]
2401
+ #
2402
+ # @!attribute [rw] stack_name
2403
+ # If you specified the name of a change set, specify the stack name or
2404
+ # stack ID (ARN) of the change set you want to describe.
2405
+ # @return [String]
2406
+ #
2407
+ # @!attribute [rw] next_token
2408
+ # A string, provided by the `DescribeChangeSetHooks` response output,
2409
+ # that identifies the next page of information that you want to
2410
+ # retrieve.
2411
+ # @return [String]
2412
+ #
2413
+ # @!attribute [rw] logical_resource_id
2414
+ # If specified, lists only the hooks related to the specified
2415
+ # `LogicalResourceId`.
2416
+ # @return [String]
2417
+ #
2418
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/DescribeChangeSetHooksInput AWS API Documentation
2419
+ #
2420
+ class DescribeChangeSetHooksInput < Struct.new(
2421
+ :change_set_name,
2422
+ :stack_name,
2423
+ :next_token,
2424
+ :logical_resource_id)
2425
+ SENSITIVE = []
2426
+ include Aws::Structure
2427
+ end
2428
+
2429
+ # @!attribute [rw] change_set_id
2430
+ # The change set identifier (stack ID).
2431
+ # @return [String]
2432
+ #
2433
+ # @!attribute [rw] change_set_name
2434
+ # The change set name.
2435
+ # @return [String]
2436
+ #
2437
+ # @!attribute [rw] hooks
2438
+ # List of hook objects.
2439
+ # @return [Array<Types::ChangeSetHook>]
2440
+ #
2441
+ # @!attribute [rw] status
2442
+ # Provides the status of the change set hook.
2443
+ # @return [String]
2444
+ #
2445
+ # @!attribute [rw] next_token
2446
+ # Pagination token, `null` or empty if no more results.
2447
+ # @return [String]
2448
+ #
2449
+ # @!attribute [rw] stack_id
2450
+ # The stack identifier (stack ID).
2451
+ # @return [String]
2452
+ #
2453
+ # @!attribute [rw] stack_name
2454
+ # The stack name.
2455
+ # @return [String]
2456
+ #
2457
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/DescribeChangeSetHooksOutput AWS API Documentation
2458
+ #
2459
+ class DescribeChangeSetHooksOutput < Struct.new(
2460
+ :change_set_id,
2461
+ :change_set_name,
2462
+ :hooks,
2463
+ :status,
2464
+ :next_token,
2465
+ :stack_id,
2466
+ :stack_name)
2467
+ SENSITIVE = []
2468
+ include Aws::Structure
2469
+ end
2470
+
2267
2471
  # The input for the DescribeChangeSet action.
2268
2472
  #
2269
2473
  # @note When making an API call, you may pass DescribeChangeSetInput
@@ -2307,15 +2511,16 @@ module Aws::CloudFormation
2307
2511
  # @return [String]
2308
2512
  #
2309
2513
  # @!attribute [rw] change_set_id
2310
- # The ARN of the change set.
2514
+ # The Amazon Resource Name (ARN) of the change set.
2311
2515
  # @return [String]
2312
2516
  #
2313
2517
  # @!attribute [rw] stack_id
2314
- # The ARN of the stack that is associated with the change set.
2518
+ # The Amazon Resource Name (ARN) of the stack that's associated with
2519
+ # the change set.
2315
2520
  # @return [String]
2316
2521
  #
2317
2522
  # @!attribute [rw] stack_name
2318
- # The name of the stack that is associated with the change set.
2523
+ # The name of the stack that's associated with the change set.
2319
2524
  # @return [String]
2320
2525
  #
2321
2526
  # @!attribute [rw] description
@@ -2338,7 +2543,7 @@ module Aws::CloudFormation
2338
2543
  #
2339
2544
  # @!attribute [rw] execution_status
2340
2545
  # If the change set execution status is `AVAILABLE`, you can execute
2341
- # the change set. If you cant execute the change set, the status
2546
+ # the change set. If you can't execute the change set, the status
2342
2547
  # indicates why. For example, a change set might be in an
2343
2548
  # `UNAVAILABLE` state because CloudFormation is still creating it or
2344
2549
  # in an `OBSOLETE` state because the stack was already updated.
@@ -2437,7 +2642,7 @@ module Aws::CloudFormation
2437
2642
  # @!attribute [rw] publisher_id
2438
2643
  # The ID of the extension publisher.
2439
2644
  #
2440
- # If you do not supply a `PublisherId`, and you have registered as an
2645
+ # If you don't supply a `PublisherId`, and you have registered as an
2441
2646
  # extension publisher, `DescribePublisher` returns information about
2442
2647
  # your own publisher account.
2443
2648
  # @return [String]
@@ -2524,7 +2729,7 @@ module Aws::CloudFormation
2524
2729
  # configuration. A stack is considered to have drifted if one or
2525
2730
  # more of its resources have drifted.
2526
2731
  #
2527
- # * `NOT_CHECKED`\: CloudFormation has not checked if the stack
2732
+ # * `NOT_CHECKED`\: CloudFormation hasn't checked if the stack
2528
2733
  # differs from its expected template configuration.
2529
2734
  #
2530
2735
  # * `IN_SYNC`\: The stack's actual configuration matches its expected
@@ -2538,7 +2743,7 @@ module Aws::CloudFormation
2538
2743
  #
2539
2744
  # * `DETECTION_COMPLETE`\: The stack drift detection operation has
2540
2745
  # successfully completed for all resources in the stack that support
2541
- # drift detection. (Resources that do not currently support stack
2746
+ # drift detection. (Resources that don't currently support stack
2542
2747
  # detection remain unchecked.)
2543
2748
  #
2544
2749
  # If you specified logical resource IDs for CloudFormation to use as
@@ -2595,8 +2800,8 @@ module Aws::CloudFormation
2595
2800
  # }
2596
2801
  #
2597
2802
  # @!attribute [rw] stack_name
2598
- # The name or the unique stack ID that is associated with the stack,
2599
- # which are not always interchangeable:
2803
+ # The name or the unique stack ID that's associated with the stack,
2804
+ # which aren't always interchangeable:
2600
2805
  #
2601
2806
  # * Running stacks: You can specify either the stack's name or its
2602
2807
  # unique stack ID.
@@ -2735,10 +2940,10 @@ module Aws::CloudFormation
2735
2940
  # * `MODIFIED`\: One or more resource properties differ from their
2736
2941
  # expected template values.
2737
2942
  #
2738
- # * `IN_SYNC`\: The resources's actual configuration matches its
2943
+ # * `IN_SYNC`\: The resource's actual configuration matches its
2739
2944
  # expected template configuration.
2740
2945
  #
2741
- # * `NOT_CHECKED`\: CloudFormation does not currently return this
2946
+ # * `NOT_CHECKED`\: CloudFormation doesn't currently return this
2742
2947
  # value.
2743
2948
  # @return [Array<String>]
2744
2949
  #
@@ -2772,9 +2977,9 @@ module Aws::CloudFormation
2772
2977
  # drift.
2773
2978
  #
2774
2979
  # For a given stack, there will be one `StackResourceDrift` for each
2775
- # stack resource that has been checked for drift. Resources that have
2776
- # not yet been checked for drift are not included. Resources that do
2777
- # not currently support drift detection are not checked, and so not
2980
+ # stack resource that has been checked for drift. Resources that
2981
+ # haven't yet been checked for drift aren't included. Resources that
2982
+ # do not currently support drift detection aren't checked, and so not
2778
2983
  # included. For a list of resources that support drift detection, see
2779
2984
  # [Resources that Support Drift Detection][1].
2780
2985
  #
@@ -2811,8 +3016,8 @@ module Aws::CloudFormation
2811
3016
  # }
2812
3017
  #
2813
3018
  # @!attribute [rw] stack_name
2814
- # The name or the unique stack ID that is associated with the stack,
2815
- # which are not always interchangeable:
3019
+ # The name or the unique stack ID that's associated with the stack,
3020
+ # which aren't always interchangeable:
2816
3021
  #
2817
3022
  # * Running stacks: You can specify either the stack's name or its
2818
3023
  # unique stack ID.
@@ -2865,7 +3070,7 @@ module Aws::CloudFormation
2865
3070
  #
2866
3071
  # @!attribute [rw] stack_name
2867
3072
  # The name or the unique stack ID that is associated with the stack,
2868
- # which are not always interchangeable:
3073
+ # which aren't always interchangeable:
2869
3074
  #
2870
3075
  # * Running stacks: You can specify either the stack's name or its
2871
3076
  # unique stack ID.
@@ -2874,7 +3079,7 @@ module Aws::CloudFormation
2874
3079
  #
2875
3080
  # Default: There is no default value.
2876
3081
  #
2877
- # Required: Conditional. If you do not specify `StackName`, you must
3082
+ # Required: Conditional. If you don't specify `StackName`, you must
2878
3083
  # specify `PhysicalResourceId`.
2879
3084
  # @return [String]
2880
3085
  #
@@ -2894,7 +3099,7 @@ module Aws::CloudFormation
2894
3099
  # the instance belongs to and what other resources are part of the
2895
3100
  # stack.
2896
3101
  #
2897
- # Required: Conditional. If you do not specify `PhysicalResourceId`,
3102
+ # Required: Conditional. If you don't specify `PhysicalResourceId`,
2898
3103
  # you must specify `StackName`.
2899
3104
  #
2900
3105
  # Default: There is no default value.
@@ -3054,8 +3259,8 @@ module Aws::CloudFormation
3054
3259
  # }
3055
3260
  #
3056
3261
  # @!attribute [rw] stack_name
3057
- # The name or the unique stack ID that is associated with the stack,
3058
- # which are not always interchangeable:
3262
+ # The name or the unique stack ID that's associated with the stack,
3263
+ # which aren't always interchangeable:
3059
3264
  #
3060
3265
  # * Running stacks: You can specify either the stack's name or its
3061
3266
  # unique stack ID.
@@ -3104,7 +3309,7 @@ module Aws::CloudFormation
3104
3309
  # data as a hash:
3105
3310
  #
3106
3311
  # {
3107
- # type: "RESOURCE", # accepts RESOURCE, MODULE
3312
+ # type: "RESOURCE", # accepts RESOURCE, MODULE, HOOK
3108
3313
  # type_name: "TypeName",
3109
3314
  # arn: "TypeArn",
3110
3315
  # version_id: "TypeVersionId",
@@ -3188,7 +3393,7 @@ module Aws::CloudFormation
3188
3393
  #
3189
3394
  # @!attribute [rw] default_version_id
3190
3395
  # The ID of the default version of the extension. The default version
3191
- # is used when the extension version is not specified.
3396
+ # is used when the extension version isn't specified.
3192
3397
  #
3193
3398
  # This applies only to private extensions you have registered in your
3194
3399
  # account. For public extensions, both those provided by Amazon and
@@ -3215,11 +3420,11 @@ module Aws::CloudFormation
3215
3420
  #
3216
3421
  # @!attribute [rw] type_tests_status
3217
3422
  # The contract test status of the registered extension version. To
3218
- # return the extension test status of a specifc extension version, you
3219
- # must specify `VersionId`.
3423
+ # return the extension test status of a specific extension version,
3424
+ # you must specify `VersionId`.
3220
3425
  #
3221
3426
  # This applies only to registered private extension versions.
3222
- # CloudFormation does not return this information for public
3427
+ # CloudFormation doesn't return this information for public
3223
3428
  # extensions, whether or not they are activated in your account.
3224
3429
  #
3225
3430
  # * `PASSED`\: The extension has passed all its contract tests.
@@ -3234,7 +3439,7 @@ module Aws::CloudFormation
3234
3439
  # * `IN_PROGRESS`\: Contract tests are currently being performed on
3235
3440
  # the extension.
3236
3441
  #
3237
- # * `NOT_TESTED`\: Contract tests have not been performed on the
3442
+ # * `NOT_TESTED`\: Contract tests haven't been performed on the
3238
3443
  # extension.
3239
3444
  #
3240
3445
  #
@@ -3244,10 +3449,11 @@ module Aws::CloudFormation
3244
3449
  #
3245
3450
  # @!attribute [rw] type_tests_status_description
3246
3451
  # The description of the test status. To return the extension test
3247
- # status of a specifc extension version, you must specify `VersionId`.
3452
+ # status of a specific extension version, you must specify
3453
+ # `VersionId`.
3248
3454
  #
3249
3455
  # This applies only to registered private extension versions.
3250
- # CloudFormation does not return this information for public
3456
+ # CloudFormation doesn't return this information for public
3251
3457
  # extensions, whether or not they are activated in your account.
3252
3458
  # @return [String]
3253
3459
  #
@@ -3277,13 +3483,12 @@ module Aws::CloudFormation
3277
3483
  # * `FULLY_MUTABLE`\: The resource type includes an update handler to
3278
3484
  # process updates to the type during stack update operations.
3279
3485
  #
3280
- # * `IMMUTABLE`\: The resource type does not include an update
3281
- # handler, so the type cannot be updated and must instead be
3486
+ # * `IMMUTABLE`\: The resource type doesn't include an update
3487
+ # handler, so the type can't be updated and must instead be
3282
3488
  # replaced during stack update operations.
3283
3489
  #
3284
- # * `NON_PROVISIONABLE`\: The resource type does not include all of
3285
- # the following handlers, and therefore cannot actually be
3286
- # provisioned.
3490
+ # * `NON_PROVISIONABLE`\: The resource type doesn't include all the
3491
+ # following handlers, and therefore can't actually be provisioned.
3287
3492
  #
3288
3493
  # * create
3289
3494
  #
@@ -3356,8 +3561,8 @@ module Aws::CloudFormation
3356
3561
  # account in which it is registered. CloudFormation marks any
3357
3562
  # extensions you register as `PRIVATE`.
3358
3563
  #
3359
- # * `PUBLIC`\: The extension is publically visible and usable within
3360
- # any Amazon account.
3564
+ # * `PUBLIC`\: The extension is publicly visible and usable within any
3565
+ # Amazon account.
3361
3566
  # @return [String]
3362
3567
  #
3363
3568
  # @!attribute [rw] source_url
@@ -3410,8 +3615,8 @@ module Aws::CloudFormation
3410
3615
  # The publisher ID of the extension publisher.
3411
3616
  #
3412
3617
  # This applies only to public third-party extensions. For private
3413
- # registered extensions, and extensions provided by Amazon,
3414
- # CloudFormation returns `null`.
3618
+ # registered extensions, and extensions provided by Amazon Web
3619
+ # Services, CloudFormation returns `null`.
3415
3620
  # @return [String]
3416
3621
  #
3417
3622
  # @!attribute [rw] original_type_name
@@ -3448,7 +3653,7 @@ module Aws::CloudFormation
3448
3653
  # The latest version of a public extension *that is available* for
3449
3654
  # use.
3450
3655
  #
3451
- # This only applies if you specify a public extension, and you do not
3656
+ # This only applies if you specify a public extension, and you don't
3452
3657
  # specify a version. For all other requests, CloudFormation returns
3453
3658
  # `null`.
3454
3659
  # @return [String]
@@ -3720,7 +3925,7 @@ module Aws::CloudFormation
3720
3925
  # @!attribute [rw] operation_id
3721
3926
  # The ID of the drift detection stack set operation.
3722
3927
  #
3723
- # you can use this operation id with ` DescribeStackSetOperation ` to
3928
+ # You can use this operation ID with ` DescribeStackSetOperation ` to
3724
3929
  # monitor the progress of the drift detection operation.
3725
3930
  # @return [String]
3726
3931
  #
@@ -3765,7 +3970,7 @@ module Aws::CloudFormation
3765
3970
  #
3766
3971
  # @!attribute [rw] template_url
3767
3972
  # Location of file containing the template body. The URL must point to
3768
- # a template that is located in an Amazon S3 bucket or a Systems
3973
+ # a template that's located in an Amazon S3 bucket or a Systems
3769
3974
  # Manager document. For more information, go to [Template Anatomy][1]
3770
3975
  # in the CloudFormation User Guide.
3771
3976
  #
@@ -3819,13 +4024,14 @@ module Aws::CloudFormation
3819
4024
  # }
3820
4025
  #
3821
4026
  # @!attribute [rw] change_set_name
3822
- # The name or ARN of the change set that you want use to update the
3823
- # specified stack.
4027
+ # The name or Amazon Resource Name (ARN) of the change set that you
4028
+ # want use to update the specified stack.
3824
4029
  # @return [String]
3825
4030
  #
3826
4031
  # @!attribute [rw] stack_name
3827
4032
  # If you specified the name of a change set, specify the stack name or
3828
- # ID (ARN) that is associated with the change set you want to execute.
4033
+ # Amazon Resource Name (ARN) that's associated with the change set
4034
+ # you want to execute.
3829
4035
  # @return [String]
3830
4036
  #
3831
4037
  # @!attribute [rw] client_request_token
@@ -3900,7 +4106,7 @@ module Aws::CloudFormation
3900
4106
  # }
3901
4107
  #
3902
4108
  # @!attribute [rw] stack_name
3903
- # The name or unique stack ID that is associated with the stack whose
4109
+ # The name or unique stack ID that's associated with the stack whose
3904
4110
  # policy you want to get.
3905
4111
  # @return [String]
3906
4112
  #
@@ -3944,8 +4150,8 @@ module Aws::CloudFormation
3944
4150
  # }
3945
4151
  #
3946
4152
  # @!attribute [rw] stack_name
3947
- # The name or the unique stack ID that is associated with the stack,
3948
- # which are not always interchangeable:
4153
+ # The name or the unique stack ID that's associated with the stack,
4154
+ # which aren't always interchangeable:
3949
4155
  #
3950
4156
  # * Running stacks: You can specify either the stack's name or its
3951
4157
  # unique stack ID.
@@ -4029,7 +4235,7 @@ module Aws::CloudFormation
4029
4235
  # @!attribute [rw] template_body
4030
4236
  # Structure containing the template body with a minimum length of 1
4031
4237
  # byte and a maximum length of 51,200 bytes. For more information
4032
- # about templates, see [Template Anatomy][1] in the CloudFormation
4238
+ # about templates, see [Template anatomy][1] in the CloudFormation
4033
4239
  # User Guide.
4034
4240
  #
4035
4241
  # Conditional: You must specify only one of the following parameters:
@@ -4042,9 +4248,9 @@ module Aws::CloudFormation
4042
4248
  #
4043
4249
  # @!attribute [rw] template_url
4044
4250
  # Location of file containing the template body. The URL must point to
4045
- # a template (max size: 460,800 bytes) that is located in an Amazon S3
4251
+ # a template (max size: 460,800 bytes) that's located in an Amazon S3
4046
4252
  # bucket or a Systems Manager document. For more information about
4047
- # templates, see [Template Anatomy][1] in the CloudFormation User
4253
+ # templates, see [Template anatomy][1] in the CloudFormation User
4048
4254
  # Guide.
4049
4255
  #
4050
4256
  # Conditional: You must specify only one of the following parameters:
@@ -4056,8 +4262,8 @@ module Aws::CloudFormation
4056
4262
  # @return [String]
4057
4263
  #
4058
4264
  # @!attribute [rw] stack_name
4059
- # The name or the stack ID that is associated with the stack, which
4060
- # are not always interchangeable. For running stacks, you can specify
4265
+ # The name or the stack ID that's associated with the stack, which
4266
+ # aren't always interchangeable. For running stacks, you can specify
4061
4267
  # either the stack's name or its unique stack ID. For deleted stack,
4062
4268
  # you must specify the unique stack ID.
4063
4269
  #
@@ -4116,7 +4322,7 @@ module Aws::CloudFormation
4116
4322
  # @return [Array<Types::ParameterDeclaration>]
4117
4323
  #
4118
4324
  # @!attribute [rw] description
4119
- # The value that is defined in the `Description` property of the
4325
+ # The value that's defined in the `Description` property of the
4120
4326
  # template.
4121
4327
  # @return [String]
4122
4328
  #
@@ -4152,7 +4358,7 @@ module Aws::CloudFormation
4152
4358
  # @return [String]
4153
4359
  #
4154
4360
  # @!attribute [rw] metadata
4155
- # The value that is defined for the `Metadata` property of the
4361
+ # The value that's defined for the `Metadata` property of the
4156
4362
  # template.
4157
4363
  # @return [String]
4158
4364
  #
@@ -4223,7 +4429,7 @@ module Aws::CloudFormation
4223
4429
  # @return [String]
4224
4430
  #
4225
4431
  # @!attribute [rw] organizational_unit_ids
4226
- # The list of OU IDs to which the stacks being imported has to be
4432
+ # The list of OU ID's to which the stacks being imported has to be
4227
4433
  # mapped as deployment target.
4228
4434
  # @return [Array<String>]
4229
4435
  #
@@ -4303,7 +4509,7 @@ module Aws::CloudFormation
4303
4509
  class InvalidOperationException < Aws::EmptyStructure; end
4304
4510
 
4305
4511
  # Error reserved for use by the [CloudFormation CLI][1]. CloudFormation
4306
- # does not return this error to users.
4512
+ # doesn't return this error to users.
4307
4513
  #
4308
4514
  #
4309
4515
  #
@@ -4315,8 +4521,8 @@ module Aws::CloudFormation
4315
4521
 
4316
4522
  # The quota for the resource has already been reached.
4317
4523
  #
4318
- # For information on resource and stack limitations, see [Limits][1] in
4319
- # the *CloudFormation User Guide*.
4524
+ # For information on resource and stack limitations, see [CloudFormation
4525
+ # quotas][1] in the *CloudFormation User Guide*.
4320
4526
  #
4321
4527
  #
4322
4528
  #
@@ -4364,7 +4570,8 @@ module Aws::CloudFormation
4364
4570
  #
4365
4571
  # @!attribute [rw] next_token
4366
4572
  # If the output exceeds 1 MB, a string that identifies the next page
4367
- # of change sets. If there is no additional page, this value is null.
4573
+ # of change sets. If there is no additional page, this value is
4574
+ # `null`.
4368
4575
  # @return [String]
4369
4576
  #
4370
4577
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/ListChangeSetsOutput AWS API Documentation
@@ -4558,7 +4765,7 @@ module Aws::CloudFormation
4558
4765
  # @return [Array<Types::StackInstanceSummary>]
4559
4766
  #
4560
4767
  # @!attribute [rw] next_token
4561
- # If the request doesn't return all of the remaining results,
4768
+ # If the request doesn't return all the remaining results,
4562
4769
  # `NextToken` is set to a token. To retrieve the next set of results,
4563
4770
  # call `ListStackInstances` again and assign that token to the request
4564
4771
  # object's `NextToken` parameter. If the request returns all results,
@@ -4586,7 +4793,7 @@ module Aws::CloudFormation
4586
4793
  #
4587
4794
  # @!attribute [rw] stack_name
4588
4795
  # The name or the unique stack ID that is associated with the stack,
4589
- # which are not always interchangeable:
4796
+ # which aren't always interchangeable:
4590
4797
  #
4591
4798
  # * Running stacks: You can specify either the stack's name or its
4592
4799
  # unique stack ID.
@@ -4706,7 +4913,7 @@ module Aws::CloudFormation
4706
4913
  # @!attribute [rw] summaries
4707
4914
  # A list of `StackSetOperationResultSummary` structures that contain
4708
4915
  # information about the specified operation results, for accounts and
4709
- # Regions that are included in the operation.
4916
+ # Amazon Web Services Regions that are included in the operation.
4710
4917
  # @return [Array<Types::StackSetOperationResultSummary>]
4711
4918
  #
4712
4919
  # @!attribute [rw] next_token
@@ -4825,9 +5032,9 @@ module Aws::CloudFormation
4825
5032
  # }
4826
5033
  #
4827
5034
  # @!attribute [rw] next_token
4828
- # If the previous paginated request didn't return all of the
4829
- # remaining results, the response object's `NextToken` parameter
4830
- # value is set to a token. To retrieve the next set of results, call
5035
+ # If the previous paginated request didn't return all the remaining
5036
+ # results, the response object's `NextToken` parameter value is set
5037
+ # to a token. To retrieve the next set of results, call
4831
5038
  # `ListStackSets` again and assign that token to the request object's
4832
5039
  # `NextToken` parameter. If there are no remaining results, the
4833
5040
  # previous response object's `NextToken` parameter is set to `null`.
@@ -4958,7 +5165,7 @@ module Aws::CloudFormation
4958
5165
  # data as a hash:
4959
5166
  #
4960
5167
  # {
4961
- # type: "RESOURCE", # accepts RESOURCE, MODULE
5168
+ # type: "RESOURCE", # accepts RESOURCE, MODULE, HOOK
4962
5169
  # type_name: "TypeName",
4963
5170
  # type_arn: "TypeArn",
4964
5171
  # registration_status_filter: "COMPLETE", # accepts COMPLETE, IN_PROGRESS, FAILED
@@ -5001,12 +5208,12 @@ module Aws::CloudFormation
5001
5208
  # @return [Integer]
5002
5209
  #
5003
5210
  # @!attribute [rw] next_token
5004
- # If the previous paginated request didn't return all of the
5005
- # remaining results, the response object's `NextToken` parameter
5006
- # value is set to a token. To retrieve the next set of results, call
5007
- # this action again and assign that token to the request object's
5008
- # `NextToken` parameter. If there are no remaining results, the
5009
- # previous response object's `NextToken` parameter is set to `null`.
5211
+ # If the previous paginated request didn't return all the remaining
5212
+ # results, the response object's `NextToken` parameter value is set
5213
+ # to a token. To retrieve the next set of results, call this action
5214
+ # again and assign that token to the request object's `NextToken`
5215
+ # parameter. If there are no remaining results, the previous response
5216
+ # object's `NextToken` parameter is set to `null`.
5010
5217
  # @return [String]
5011
5218
  #
5012
5219
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/ListTypeRegistrationsInput AWS API Documentation
@@ -5050,7 +5257,7 @@ module Aws::CloudFormation
5050
5257
  # data as a hash:
5051
5258
  #
5052
5259
  # {
5053
- # type: "RESOURCE", # accepts RESOURCE, MODULE
5260
+ # type: "RESOURCE", # accepts RESOURCE, MODULE, HOOK
5054
5261
  # type_name: "TypeName",
5055
5262
  # arn: "TypeArn",
5056
5263
  # max_results: 1,
@@ -5117,7 +5324,7 @@ module Aws::CloudFormation
5117
5324
  # @!attribute [rw] publisher_id
5118
5325
  # The publisher ID of the extension publisher.
5119
5326
  #
5120
- # Extensions published by Amazon are not assigned a publisher ID.
5327
+ # Extensions published by Amazon aren't assigned a publisher ID.
5121
5328
  # @return [String]
5122
5329
  #
5123
5330
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/ListTypeVersionsInput AWS API Documentation
@@ -5163,7 +5370,7 @@ module Aws::CloudFormation
5163
5370
  # visibility: "PUBLIC", # accepts PUBLIC, PRIVATE
5164
5371
  # provisioning_type: "NON_PROVISIONABLE", # accepts NON_PROVISIONABLE, IMMUTABLE, FULLY_MUTABLE
5165
5372
  # deprecated_status: "LIVE", # accepts LIVE, DEPRECATED
5166
- # type: "RESOURCE", # accepts RESOURCE, MODULE
5373
+ # type: "RESOURCE", # accepts RESOURCE, MODULE, HOOK
5167
5374
  # filters: {
5168
5375
  # category: "REGISTERED", # accepts REGISTERED, ACTIVATED, THIRD_PARTY, AWS_TYPES
5169
5376
  # publisher_id: "PublisherId",
@@ -5206,12 +5413,12 @@ module Aws::CloudFormation
5206
5413
  # * `FULLY_MUTABLE`\: The resource type includes an update handler to
5207
5414
  # process updates to the type during stack update operations.
5208
5415
  #
5209
- # * `IMMUTABLE`\: The resource type does not include an update
5210
- # handler, so the type cannot be updated and must instead be
5416
+ # * `IMMUTABLE`\: The resource type doesn't include an update
5417
+ # handler, so the type can't be updated and must instead be
5211
5418
  # replaced during stack update operations.
5212
5419
  #
5213
- # * `NON_PROVISIONABLE`\: The resource type does not include create,
5214
- # read, and delete handlers, and therefore cannot actually be
5420
+ # * `NON_PROVISIONABLE`\: The resource type doesn't include create,
5421
+ # read, and delete handlers, and therefore can't actually be
5215
5422
  # provisioned.
5216
5423
  #
5217
5424
  # The default is `FULLY_MUTABLE`.
@@ -5279,7 +5486,7 @@ module Aws::CloudFormation
5279
5486
  # @return [Array<Types::TypeSummary>]
5280
5487
  #
5281
5488
  # @!attribute [rw] next_token
5282
- # If the request doesn't return all of the remaining results,
5489
+ # If the request doesn't return all the remaining results,
5283
5490
  # `NextToken` is set to a token. To retrieve the next set of results,
5284
5491
  # call this action again and assign that token to the request
5285
5492
  # object's `NextToken` parameter. If the request returns all results,
@@ -5306,12 +5513,12 @@ module Aws::CloudFormation
5306
5513
  # }
5307
5514
  #
5308
5515
  # @!attribute [rw] log_role_arn
5309
- # The ARN of the role that CloudFormation should assume when sending
5310
- # log entries to CloudWatch logs.
5516
+ # The Amazon Resource Name (ARN) of the role that CloudFormation
5517
+ # should assume when sending log entries to CloudWatch Logs.
5311
5518
  # @return [String]
5312
5519
  #
5313
5520
  # @!attribute [rw] log_group_name
5314
- # The Amazon CloudWatch log group to which CloudFormation sends error
5521
+ # The Amazon CloudWatch Logs group to which CloudFormation sends error
5315
5522
  # logging information when invoking the extension's handlers.
5316
5523
  # @return [String]
5317
5524
  #
@@ -5370,24 +5577,24 @@ module Aws::CloudFormation
5370
5577
  # the *CloudFormation User Guide*.
5371
5578
  #
5372
5579
  # @!attribute [rw] type_hierarchy
5373
- # A concantenated list of the the module type or types containing the
5580
+ # A concatenated list of the module type or types containing the
5374
5581
  # resource. Module types are listed starting with the inner-most
5375
5582
  # nested module, and separated by `/`.
5376
5583
  #
5377
5584
  # In the following example, the resource was created from a module of
5378
- # type `AWS::First::Example::MODULE`, that is nested inside a parent
5585
+ # type `AWS::First::Example::MODULE`, that's nested inside a parent
5379
5586
  # module of type `AWS::Second::Example::MODULE`.
5380
5587
  #
5381
5588
  # `AWS::First::Example::MODULE/AWS::Second::Example::MODULE`
5382
5589
  # @return [String]
5383
5590
  #
5384
5591
  # @!attribute [rw] logical_id_hierarchy
5385
- # A concantenated list of the logical IDs of the module or modules
5592
+ # A concatenated list of the logical IDs of the module or modules
5386
5593
  # containing the resource. Modules are listed starting with the
5387
5594
  # inner-most nested module, and separated by `/`.
5388
5595
  #
5389
5596
  # In the following example, the resource was created from a module,
5390
- # `moduleA`, that is nested inside a parent module, `moduleB`.
5597
+ # `moduleA`, that's nested inside a parent module, `moduleB`.
5391
5598
  #
5392
5599
  # `moduleA/moduleB`
5393
5600
  #
@@ -5431,7 +5638,7 @@ module Aws::CloudFormation
5431
5638
  class OperationNotFoundException < Aws::EmptyStructure; end
5432
5639
 
5433
5640
  # Error reserved for use by the [CloudFormation CLI][1]. CloudFormation
5434
- # does not return this error to users.
5641
+ # doesn't return this error to users.
5435
5642
  #
5436
5643
  #
5437
5644
  #
@@ -5485,7 +5692,7 @@ module Aws::CloudFormation
5485
5692
  # @!attribute [rw] parameter_key
5486
5693
  # The key associated with the parameter. If you don't specify a key
5487
5694
  # and value for a particular parameter, CloudFormation uses the
5488
- # default value that is specified in your template.
5695
+ # default value that's specified in your template.
5489
5696
  # @return [String]
5490
5697
  #
5491
5698
  # @!attribute [rw] parameter_value
@@ -5499,9 +5706,9 @@ module Aws::CloudFormation
5499
5706
  # @return [Boolean]
5500
5707
  #
5501
5708
  # @!attribute [rw] resolved_value
5502
- # Read-only. Read-only. The value that corresponds to a SSM parameter
5503
- # key. This field is returned only for [ `SSM` ][1] parameter types in
5504
- # the template.
5709
+ # Read-only. The value that corresponds to a SSM parameter key. This
5710
+ # field is returned only for [ `SSM` ][1] parameter types in the
5711
+ # template.
5505
5712
  #
5506
5713
  #
5507
5714
  #
@@ -5538,7 +5745,7 @@ module Aws::CloudFormation
5538
5745
  # The ParameterDeclaration data type.
5539
5746
  #
5540
5747
  # @!attribute [rw] parameter_key
5541
- # The name that is associated with the parameter.
5748
+ # The name that's associated with the parameter.
5542
5749
  # @return [String]
5543
5750
  #
5544
5751
  # @!attribute [rw] default_value
@@ -5555,7 +5762,7 @@ module Aws::CloudFormation
5555
5762
  # @return [Boolean]
5556
5763
  #
5557
5764
  # @!attribute [rw] description
5558
- # The description that is associate with the parameter.
5765
+ # The description that's associate with the parameter.
5559
5766
  # @return [String]
5560
5767
  #
5561
5768
  # @!attribute [rw] parameter_constraints
@@ -5577,7 +5784,7 @@ module Aws::CloudFormation
5577
5784
 
5578
5785
  # Context information that enables CloudFormation to uniquely identify a
5579
5786
  # resource. CloudFormation uses context key-value pairs in cases where a
5580
- # resource's logical and physical IDs are not enough to uniquely
5787
+ # resource's logical and physical IDs aren't enough to uniquely
5581
5788
  # identify that resource. Each context key-value pair specifies a
5582
5789
  # resource that contains the targeted resource.
5583
5790
  #
@@ -5625,7 +5832,7 @@ module Aws::CloudFormation
5625
5832
  # @!attribute [rw] difference_type
5626
5833
  # The type of property difference.
5627
5834
  #
5628
- # * `ADD`\: A value has been added to a resource property that is an
5835
+ # * `ADD`\: A value has been added to a resource property that's an
5629
5836
  # array or list data type.
5630
5837
  #
5631
5838
  # * `REMOVE`\: The property has been removed from the current resource
@@ -5651,7 +5858,7 @@ module Aws::CloudFormation
5651
5858
  # data as a hash:
5652
5859
  #
5653
5860
  # {
5654
- # type: "RESOURCE", # accepts RESOURCE, MODULE
5861
+ # type: "RESOURCE", # accepts RESOURCE, MODULE, HOOK
5655
5862
  # arn: "PrivateTypeArn",
5656
5863
  # type_name: "TypeName",
5657
5864
  # public_version_number: "PublicVersionNumber",
@@ -5685,7 +5892,7 @@ module Aws::CloudFormation
5685
5892
  #
5686
5893
  # For more information, see [Semantic Versioning 2.0.0][1].
5687
5894
  #
5688
- # If you do not specify a version number, CloudFormation increments
5895
+ # If you don't specify a version number, CloudFormation increments
5689
5896
  # the version number by one minor version release.
5690
5897
  #
5691
5898
  # You cannot specify a version number the first time you publish a
@@ -5869,7 +6076,7 @@ module Aws::CloudFormation
5869
6076
  # data as a hash:
5870
6077
  #
5871
6078
  # {
5872
- # type: "RESOURCE", # accepts RESOURCE, MODULE
6079
+ # type: "RESOURCE", # accepts RESOURCE, MODULE, HOOK
5873
6080
  # type_name: "TypeName", # required
5874
6081
  # schema_handler_package: "S3Url", # required
5875
6082
  # logging_config: {
@@ -5895,7 +6102,7 @@ module Aws::CloudFormation
5895
6102
  # * For modules,
5896
6103
  # *company\_or\_organization*\::*service*\::*type*\::MODULE.
5897
6104
  #
5898
- # <note markdown="1"> The following organization namespaces are reserved and cannot be
6105
+ # <note markdown="1"> The following organization namespaces are reserved and can't be
5899
6106
  # used in your extension names:
5900
6107
  #
5901
6108
  # * `Alexa`
@@ -5914,16 +6121,15 @@ module Aws::CloudFormation
5914
6121
  # @return [String]
5915
6122
  #
5916
6123
  # @!attribute [rw] schema_handler_package
5917
- # A url to the S3 bucket containing the extension project package that
5918
- # contains the neccessary files for the extension you want to
5919
- # register.
6124
+ # A URL to the S3 bucket containing the extension project package that
6125
+ # contains the necessary files for the extension you want to register.
5920
6126
  #
5921
6127
  # For information on generating a schema handler package for the
5922
6128
  # extension you want to register, see [submit][1] in the
5923
6129
  # *CloudFormation CLI User Guide*.
5924
6130
  #
5925
6131
  # <note markdown="1"> The user registering the extension must be able to access the
5926
- # package in the S3 bucket. That is, the user needs to have
6132
+ # package in the S3 bucket. That's, the user needs to have
5927
6133
  # [GetObject][2] permissions for the schema handler package. For more
5928
6134
  # information, see [Actions, Resources, and Condition Keys for Amazon
5929
6135
  # S3][3] in the *Identity and Access Management User Guide*.
@@ -5969,8 +6175,8 @@ module Aws::CloudFormation
5969
6175
  # A unique identifier that acts as an idempotency key for this
5970
6176
  # registration request. Specifying a client request token prevents
5971
6177
  # CloudFormation from generating more than one version of an extension
5972
- # from the same registeration request, even if the request is
5973
- # submitted multiple times.
6178
+ # from the same registration request, even if the request is submitted
6179
+ # multiple times.
5974
6180
  # @return [String]
5975
6181
  #
5976
6182
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/RegisterTypeInput AWS API Documentation
@@ -6063,7 +6269,7 @@ module Aws::CloudFormation
6063
6269
  # The action that CloudFormation takes on the resource, such as `Add`
6064
6270
  # (adds a new resource), `Modify` (changes a resource), `Remove`
6065
6271
  # (deletes a resource), `Import` (imports a resource), or `Dynamic`
6066
- # (exact action for the resource cannot be determined).
6272
+ # (exact action for the resource can't be determined).
6067
6273
  # @return [String]
6068
6274
  #
6069
6275
  # @!attribute [rw] logical_resource_id
@@ -6155,10 +6361,10 @@ module Aws::CloudFormation
6155
6361
  # CloudFormation knows that this property value will change, and its
6156
6362
  # value, so this is a `Static` evaluation.
6157
6363
  #
6158
- # For `Dynamic` evaluations, cannot determine the target value because
6364
+ # For `Dynamic` evaluations, can't determine the target value because
6159
6365
  # it depends on the result of an intrinsic function, such as a `Ref`
6160
6366
  # or `Fn::GetAtt` intrinsic function, when the stack is updated. For
6161
- # example, if your template includes a reference to a resource that is
6367
+ # example, if your template includes a reference to a resource that's
6162
6368
  # conditionally recreated, the value of the reference (the physical ID
6163
6369
  # of the resource) might change, depending on if the resource is
6164
6370
  # recreated. If the resource is recreated, it will have a new physical
@@ -6195,7 +6401,7 @@ module Aws::CloudFormation
6195
6401
  #
6196
6402
  # @!attribute [rw] causing_entity
6197
6403
  # The identity of the entity that triggered this change. This entity
6198
- # is a member of the group that is specified by the `ChangeSource`
6404
+ # is a member of the group that's specified by the `ChangeSource`
6199
6405
  # field. For example, if you modified the value of the `KeyPairName`
6200
6406
  # parameter, the `CausingEntity` is the name of the parameter
6201
6407
  # (`KeyPairName`).
@@ -6368,7 +6574,7 @@ module Aws::CloudFormation
6368
6574
  #
6369
6575
  # * To specify new or updated rollback triggers, you must specify
6370
6576
  # *all* the triggers that you want used for this stack, even
6371
- # triggers you've specifed before (for example, when creating the
6577
+ # triggers you've specified before (for example, when creating the
6372
6578
  # stack or during a previous stack update). Any triggers that you
6373
6579
  # don't include in the updated list of triggers are no longer
6374
6580
  # applied to the stack.
@@ -6387,7 +6593,7 @@ module Aws::CloudFormation
6387
6593
  #
6388
6594
  # The default is 0 minutes.
6389
6595
  #
6390
- # If you specify a monitoring period but do not specify any rollback
6596
+ # If you specify a monitoring period but don't specify any rollback
6391
6597
  # triggers, CloudFormation still waits the specified period of time
6392
6598
  # before cleaning up old resources after update operations. You can
6393
6599
  # use this monitoring period to perform any manual stack validation
@@ -6423,7 +6629,7 @@ module Aws::CloudFormation
6423
6629
  # }
6424
6630
  #
6425
6631
  # @!attribute [rw] stack_name
6426
- # The name that is associated with the stack.
6632
+ # The name that's associated with the stack.
6427
6633
  # @return [String]
6428
6634
  #
6429
6635
  # @!attribute [rw] role_arn
@@ -6516,7 +6722,7 @@ module Aws::CloudFormation
6516
6722
  #
6517
6723
  # @!attribute [rw] stack_policy_body
6518
6724
  # Structure containing the stack policy body. For more information, go
6519
- # to [ Prevent Updates to Stack Resources][1] in the CloudFormation
6725
+ # to [ Prevent updates to stack resources][1] in the CloudFormation
6520
6726
  # User Guide. You can specify either the `StackPolicyBody` or the
6521
6727
  # `StackPolicyURL` parameter, but not both.
6522
6728
  #
@@ -6527,9 +6733,10 @@ module Aws::CloudFormation
6527
6733
  #
6528
6734
  # @!attribute [rw] stack_policy_url
6529
6735
  # Location of a file containing the stack policy. The URL must point
6530
- # to a policy (maximum size: 16 KB) located in an S3 bucket in the
6531
- # same Region as the stack. You can specify either the
6532
- # `StackPolicyBody` or the `StackPolicyURL` parameter, but not both.
6736
+ # to a policy (maximum size: 16 KB) located in an Amazon S3 bucket in
6737
+ # the same Amazon Web Services Region as the stack. You can specify
6738
+ # either the `StackPolicyBody` or the `StackPolicyURL` parameter, but
6739
+ # not both.
6533
6740
  # @return [String]
6534
6741
  #
6535
6742
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/SetStackPolicyInput AWS API Documentation
@@ -6550,7 +6757,7 @@ module Aws::CloudFormation
6550
6757
  # configuration: "TypeConfiguration", # required
6551
6758
  # configuration_alias: "TypeConfigurationAlias",
6552
6759
  # type_name: "TypeName",
6553
- # type: "RESOURCE", # accepts RESOURCE, MODULE
6760
+ # type: "RESOURCE", # accepts RESOURCE, MODULE, HOOK
6554
6761
  # }
6555
6762
  #
6556
6763
  # @!attribute [rw] type_arn
@@ -6642,7 +6849,7 @@ module Aws::CloudFormation
6642
6849
  #
6643
6850
  # {
6644
6851
  # arn: "PrivateTypeArn",
6645
- # type: "RESOURCE", # accepts RESOURCE, MODULE
6852
+ # type: "RESOURCE", # accepts RESOURCE, MODULE, HOOK
6646
6853
  # type_name: "TypeName",
6647
6854
  # version_id: "TypeVersionId",
6648
6855
  # }
@@ -6789,13 +6996,14 @@ module Aws::CloudFormation
6789
6996
  # @!attribute [rw] disable_rollback
6790
6997
  # Boolean to enable or disable rollback on stack creation failures:
6791
6998
  #
6792
- # * `true`\: disable rollback
6999
+ # * `true`\: disable rollback.
6793
7000
  #
6794
- # * `false`\: enable rollback
7001
+ # * `false`\: enable rollback.
6795
7002
  # @return [Boolean]
6796
7003
  #
6797
7004
  # @!attribute [rw] notification_arns
6798
- # SNS topic ARNs to which stack related events are published.
7005
+ # Amazon SNS topic Amazon Resource Names (ARNs) to which stack related
7006
+ # events are published.
6799
7007
  # @return [Array<String>]
6800
7008
  #
6801
7009
  # @!attribute [rw] timeout_in_minutes
@@ -6812,7 +7020,7 @@ module Aws::CloudFormation
6812
7020
  #
6813
7021
  # @!attribute [rw] role_arn
6814
7022
  # The Amazon Resource Name (ARN) of an Identity and Access Management
6815
- # (IAM) role that is associated with the stack. During a stack
7023
+ # (IAM) role that's associated with the stack. During a stack
6816
7024
  # operation, CloudFormation uses this role's credentials to make
6817
7025
  # calls on your behalf.
6818
7026
  # @return [String]
@@ -6917,7 +7125,7 @@ module Aws::CloudFormation
6917
7125
  # configuration. A stack is considered to have drifted if one or
6918
7126
  # more of its resources have drifted.
6919
7127
  #
6920
- # * `NOT_CHECKED`\: CloudFormation has not checked if the stack
7128
+ # * `NOT_CHECKED`\: CloudFormation hasn't checked if the stack
6921
7129
  # differs from its expected template configuration.
6922
7130
  #
6923
7131
  # * `IN_SYNC`\: The stack's actual configuration matches its expected
@@ -6955,7 +7163,7 @@ module Aws::CloudFormation
6955
7163
  # configuration. A stack is considered to have drifted if one or
6956
7164
  # more of its resources have drifted.
6957
7165
  #
6958
- # * `NOT_CHECKED`\: CloudFormation has not checked if the stack
7166
+ # * `NOT_CHECKED`\: CloudFormation hasn't checked if the stack
6959
7167
  # differs from its expected template configuration.
6960
7168
  #
6961
7169
  # * `IN_SYNC`\: The stack's actual configuration matches its expected
@@ -7045,6 +7253,32 @@ module Aws::CloudFormation
7045
7253
  # `Console-CreateStack-7f59c3cf-00d2-40c7-b2ff-e75db0987002`.
7046
7254
  # @return [String]
7047
7255
  #
7256
+ # @!attribute [rw] hook_type
7257
+ # The name of the hook.
7258
+ # @return [String]
7259
+ #
7260
+ # @!attribute [rw] hook_status
7261
+ # Provides the status of the change set hook.
7262
+ # @return [String]
7263
+ #
7264
+ # @!attribute [rw] hook_status_reason
7265
+ # Provides the reason for the hook status.
7266
+ # @return [String]
7267
+ #
7268
+ # @!attribute [rw] hook_invocation_point
7269
+ # Invocation points are points in provisioning logic where hooks are
7270
+ # initiated.
7271
+ # @return [String]
7272
+ #
7273
+ # @!attribute [rw] hook_failure_mode
7274
+ # Specify the hook failure mode for non-compliant resources in the
7275
+ # followings ways.
7276
+ #
7277
+ # * `FAIL` Stops provisioning resources.
7278
+ #
7279
+ # * `WARN` Allows provisioning to continue with a warning message.
7280
+ # @return [String]
7281
+ #
7048
7282
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/StackEvent AWS API Documentation
7049
7283
  #
7050
7284
  class StackEvent < Struct.new(
@@ -7058,7 +7292,12 @@ module Aws::CloudFormation
7058
7292
  :resource_status,
7059
7293
  :resource_status_reason,
7060
7294
  :resource_properties,
7061
- :client_request_token)
7295
+ :client_request_token,
7296
+ :hook_type,
7297
+ :hook_status,
7298
+ :hook_status_reason,
7299
+ :hook_invocation_point,
7300
+ :hook_failure_mode)
7062
7301
  SENSITIVE = []
7063
7302
  include Aws::Structure
7064
7303
  end
@@ -7069,8 +7308,8 @@ module Aws::CloudFormation
7069
7308
  # stack instance can exist without a stack—for example, if the stack
7070
7309
  # couldn't be created for some reason. A stack instance is associated
7071
7310
  # with only one stack set. Each stack instance contains the ID of its
7072
- # associated stack set, as well as the ID of the actual stack and the
7073
- # stack status.
7311
+ # associated stack set, in addition to the ID of the actual stack and
7312
+ # the stack status.
7074
7313
  #
7075
7314
  # @!attribute [rw] stack_set_id
7076
7315
  # The name or unique ID of the stack set that the stack instance is
@@ -7125,7 +7364,7 @@ module Aws::CloudFormation
7125
7364
  # @return [Types::StackInstanceComprehensiveStatus]
7126
7365
  #
7127
7366
  # @!attribute [rw] status_reason
7128
- # The explanation for the specific status code that is assigned to
7367
+ # The explanation for the specific status code that's assigned to
7129
7368
  # this stack instance.
7130
7369
  # @return [String]
7131
7370
  #
@@ -7149,7 +7388,7 @@ module Aws::CloudFormation
7149
7388
  # stack instance is considered to have drifted if one or more of the
7150
7389
  # resources in the associated stack have drifted.
7151
7390
  #
7152
- # * `NOT_CHECKED`\: CloudFormation has not checked if the stack
7391
+ # * `NOT_CHECKED`\: CloudFormation hasn't checked if the stack
7153
7392
  # instance differs from its expected stack set configuration.
7154
7393
  #
7155
7394
  # * `IN_SYNC`\: The stack instance's actual configuration matches its
@@ -7161,7 +7400,7 @@ module Aws::CloudFormation
7161
7400
  # @!attribute [rw] last_drift_check_timestamp
7162
7401
  # Most recent time when CloudFormation performed a drift detection
7163
7402
  # operation on the stack instance. This value will be `NULL` for any
7164
- # stack instance on which drift detection has not yet been performed.
7403
+ # stack instance on which drift detection hasn't yet been performed.
7165
7404
  # @return [Time]
7166
7405
  #
7167
7406
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/StackInstance AWS API Documentation
@@ -7186,7 +7425,7 @@ module Aws::CloudFormation
7186
7425
  #
7187
7426
  # @!attribute [rw] detailed_status
7188
7427
  # * `CANCELLED`\: The operation in the specified account and Region
7189
- # has been cancelled. This is either because a user has stopped the
7428
+ # has been canceled. This is either because a user has stopped the
7190
7429
  # stack set operation, or because the failure tolerance of the stack
7191
7430
  # set operation has been exceeded.
7192
7431
  #
@@ -7328,7 +7567,7 @@ module Aws::CloudFormation
7328
7567
  # stack instance is considered to have drifted if one or more of the
7329
7568
  # resources in the associated stack have drifted.
7330
7569
  #
7331
- # * `NOT_CHECKED`\: CloudFormation has not checked if the stack
7570
+ # * `NOT_CHECKED`\: CloudFormation hasn't checked if the stack
7332
7571
  # instance differs from its expected stack set configuration.
7333
7572
  #
7334
7573
  # * `IN_SYNC`\: The stack instance's actual configuration matches its
@@ -7340,7 +7579,7 @@ module Aws::CloudFormation
7340
7579
  # @!attribute [rw] last_drift_check_timestamp
7341
7580
  # Most recent time when CloudFormation performed a drift detection
7342
7581
  # operation on the stack instance. This value will be `NULL` for any
7343
- # stack instance on which drift detection has not yet been performed.
7582
+ # stack instance on which drift detection hasn't yet been performed.
7344
7583
  # @return [Time]
7345
7584
  #
7346
7585
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/StackInstanceSummary AWS API Documentation
@@ -7360,7 +7599,7 @@ module Aws::CloudFormation
7360
7599
  include Aws::Structure
7361
7600
  end
7362
7601
 
7363
- # The specified stack ARN doesnt exist or stack doesnt exist
7602
+ # The specified stack ARN doesn't exist or stack doesn't exist
7364
7603
  # corresponding to the ARN in input.
7365
7604
  #
7366
7605
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/StackNotFoundException AWS API Documentation
@@ -7387,8 +7626,8 @@ module Aws::CloudFormation
7387
7626
  # @return [String]
7388
7627
  #
7389
7628
  # @!attribute [rw] resource_type
7390
- # Type of resource. (For more information, go to [Amazon Web Services
7391
- # Resource Types Reference][1] in the CloudFormation User Guide.)
7629
+ # Type of resource. For more information, go to [Amazon Web Services
7630
+ # Resource Types Reference][1] in the CloudFormation User Guide.
7392
7631
  #
7393
7632
  #
7394
7633
  #
@@ -7467,8 +7706,8 @@ module Aws::CloudFormation
7467
7706
  # @return [String]
7468
7707
  #
7469
7708
  # @!attribute [rw] resource_type
7470
- # Type of resource. ((For more information, go to [Amazon Web Services
7471
- # Resource Types Reference][1] in the CloudFormation User Guide.)
7709
+ # Type of resource. For more information, go to [Amazon Web Services
7710
+ # Resource Types Reference][1] in the CloudFormation User Guide.
7472
7711
  #
7473
7712
  #
7474
7713
  #
@@ -7545,7 +7784,7 @@ module Aws::CloudFormation
7545
7784
  # drift. For more information, see [Detecting Unregulated Configuration
7546
7785
  # Changes to Stacks and Resources][1].
7547
7786
  #
7548
- # Resources that do not currently support drift detection cannot be
7787
+ # Resources that don't currently support drift detection can't be
7549
7788
  # checked. For a list of resources that support drift detection, see
7550
7789
  # [Resources that Support Drift Detection][2].
7551
7790
  #
@@ -7574,7 +7813,7 @@ module Aws::CloudFormation
7574
7813
  # @!attribute [rw] physical_resource_id_context
7575
7814
  # Context information that enables CloudFormation to uniquely identify
7576
7815
  # a resource. CloudFormation uses context key-value pairs in cases
7577
- # where a resource's logical and physical IDs are not enough to
7816
+ # where a resource's logical and physical IDs aren't enough to
7578
7817
  # uniquely identify that resource. Each context key-value pair
7579
7818
  # specifies a unique resource that contains the targeted resource.
7580
7819
  # @return [Array<Types::PhysicalResourceIdContextKeyValuePair>]
@@ -7608,7 +7847,7 @@ module Aws::CloudFormation
7608
7847
  #
7609
7848
  # @!attribute [rw] stack_resource_drift_status
7610
7849
  # Status of the resource's actual configuration compared to its
7611
- # expected configuration
7850
+ # expected configuration.
7612
7851
  #
7613
7852
  # * `DELETED`\: The resource differs from its expected template
7614
7853
  # configuration because the resource has been deleted.
@@ -7617,7 +7856,7 @@ module Aws::CloudFormation
7617
7856
  # expected values (as defined in the stack template and any values
7618
7857
  # specified as template parameters).
7619
7858
  #
7620
- # * `IN_SYNC`\: The resources's actual configuration matches its
7859
+ # * `IN_SYNC`\: The resource's actual configuration matches its
7621
7860
  # expected template configuration.
7622
7861
  #
7623
7862
  # * `NOT_CHECKED`\: CloudFormation does not currently return this
@@ -7673,7 +7912,7 @@ module Aws::CloudFormation
7673
7912
  # status of `NOT_CHECKED`. For more information, see [Resources that
7674
7913
  # Support Drift Detection][1].
7675
7914
  #
7676
- # * `IN_SYNC`\: The resources's actual configuration matches its
7915
+ # * `IN_SYNC`\: The resource's actual configuration matches its
7677
7916
  # expected configuration.
7678
7917
  #
7679
7918
  #
@@ -7701,17 +7940,17 @@ module Aws::CloudFormation
7701
7940
  #
7702
7941
  # @!attribute [rw] stack_resource_drift_status
7703
7942
  # Status of the resource's actual configuration compared to its
7704
- # expected configuration
7943
+ # expected configuration.
7705
7944
  #
7706
7945
  # * `DELETED`\: The resource differs from its expected configuration
7707
7946
  # in that it has been deleted.
7708
7947
  #
7709
7948
  # * `MODIFIED`\: The resource differs from its expected configuration.
7710
7949
  #
7711
- # * `NOT_CHECKED`\: CloudFormation has not checked if the resource
7950
+ # * `NOT_CHECKED`\: CloudFormation hasn't checked if the resource
7712
7951
  # differs from its expected configuration.
7713
7952
  #
7714
- # Any resources that do not currently support drift detection have a
7953
+ # Any resources that don't currently support drift detection have a
7715
7954
  # status of `NOT_CHECKED`. For more information, see [Resources that
7716
7955
  # Support Drift Detection][1]. If you performed an
7717
7956
  # ContinueUpdateRollback operation on a stack, any resources
@@ -7720,7 +7959,7 @@ module Aws::CloudFormation
7720
7959
  # rollback operations, see [Continue Rolling Back an Update][2] in
7721
7960
  # the CloudFormation User Guide.
7722
7961
  #
7723
- # * `IN_SYNC`\: The resources's actual configuration matches its
7962
+ # * `IN_SYNC`\: The resource's actual configuration matches its
7724
7963
  # expected configuration.
7725
7964
  #
7726
7965
  #
@@ -7811,8 +8050,8 @@ module Aws::CloudFormation
7811
8050
  # A structure that contains information about a stack set. A stack set
7812
8051
  # enables you to provision stacks into Amazon Web Services accounts and
7813
8052
  # across Regions by using a single CloudFormation template. In the stack
7814
- # set, you specify the template to use, as well as any parameters and
7815
- # capabilities that the template requires.
8053
+ # set, you specify the template to use, in addition to any parameters
8054
+ # and capabilities that the template requires.
7816
8055
  #
7817
8056
  # @!attribute [rw] stack_set_name
7818
8057
  # The name that's associated with the stack set.
@@ -7889,7 +8128,7 @@ module Aws::CloudFormation
7889
8128
  #
7890
8129
  # For stack sets, contains information about the last *completed*
7891
8130
  # drift operation performed on the stack set. Information about drift
7892
- # operations currently in progress is not included.
8131
+ # operations currently in progress isn't included.
7893
8132
  # @return [Types::StackSetDriftDetectionDetails]
7894
8133
  #
7895
8134
  # @!attribute [rw] auto_deployment
@@ -7960,13 +8199,13 @@ module Aws::CloudFormation
7960
8199
  #
7961
8200
  # For stack sets, contains information about the last *completed* drift
7962
8201
  # operation performed on the stack set. Information about drift
7963
- # operations in-progress is not included.
8202
+ # operations in-progress isn't included.
7964
8203
  #
7965
8204
  # For stack set operations, includes information about drift operations
7966
8205
  # currently being performed on the stack set.
7967
8206
  #
7968
- # For more information, see [Detecting Unmanaged Changes in Stack
7969
- # Sets][1] in the *CloudFormation User Guide*.
8207
+ # For more information, see [Detecting unmanaged changes in stack
8208
+ # sets][1] in the *CloudFormation User Guide*.
7970
8209
  #
7971
8210
  #
7972
8211
  #
@@ -7984,7 +8223,7 @@ module Aws::CloudFormation
7984
8223
  # configuration. A stack instance is considered to have drifted if
7985
8224
  # one or more of the resources in the associated stack have drifted.
7986
8225
  #
7987
- # * `NOT_CHECKED`\: CloudFormation has not checked the stack set for
8226
+ # * `NOT_CHECKED`\: CloudFormation hasn't checked the stack set for
7988
8227
  # drift.
7989
8228
  #
7990
8229
  # * `IN_SYNC`\: All of the stack instances belonging to the stack set
@@ -8007,13 +8246,13 @@ module Aws::CloudFormation
8007
8246
  # * `IN_PROGRESS`\: The drift detection operation is currently being
8008
8247
  # performed.
8009
8248
  #
8010
- # * `STOPPED`\: The user has cancelled the drift detection operation.
8249
+ # * `STOPPED`\: The user has canceled the drift detection operation.
8011
8250
  # @return [String]
8012
8251
  #
8013
8252
  # @!attribute [rw] last_drift_check_timestamp
8014
8253
  # Most recent time when CloudFormation performed a drift detection
8015
8254
  # operation on the stack set. This value will be `NULL` for any stack
8016
- # set on which drift detection has not yet been performed.
8255
+ # set on which drift detection hasn't yet been performed.
8017
8256
  # @return [Time]
8018
8257
  #
8019
8258
  # @!attribute [rw] total_stack_instances_count
@@ -8035,7 +8274,7 @@ module Aws::CloudFormation
8035
8274
  # The number of stack instances that have drifted from the expected
8036
8275
  # template and parameter configuration of the stack set. A stack
8037
8276
  # instance is considered to have drifted if one or more of the
8038
- # resources in the associated stack do not match their expected
8277
+ # resources in the associated stack don't match their expected
8039
8278
  # configuration.
8040
8279
  # @return [Integer]
8041
8280
  #
@@ -8097,7 +8336,7 @@ module Aws::CloudFormation
8097
8336
  # The type of stack set operation: `CREATE`, `UPDATE`, or `DELETE`.
8098
8337
  # Create and delete operations affect only the specified stack set
8099
8338
  # instances that are associated with the specified stack set. Update
8100
- # operations affect both the stack set itself, as well as *all*
8339
+ # operations affect both the stack set itself, in addition to *all*
8101
8340
  # associated stack set instances.
8102
8341
  # @return [String]
8103
8342
  #
@@ -8120,7 +8359,7 @@ module Aws::CloudFormation
8120
8359
  #
8121
8360
  # * `RUNNING`\: The operation is currently being performed.
8122
8361
  #
8123
- # * `STOPPED`\: The user has cancelled the operation.
8362
+ # * `STOPPED`\: The user has canceled the operation.
8124
8363
  #
8125
8364
  # * `STOPPING`\: The operation is in the process of stopping, at user
8126
8365
  # request.
@@ -8142,8 +8381,8 @@ module Aws::CloudFormation
8142
8381
  # @!attribute [rw] retain_stacks
8143
8382
  # For stack set operations of action type `DELETE`, specifies whether
8144
8383
  # to remove the stack instances from the specified stack set, but
8145
- # doesn't delete the stacks. You can't reassociate a retained stack,
8146
- # or add an existing, saved stack to a new stack set.
8384
+ # doesn't delete the stacks. You can't re-associate a retained
8385
+ # stack, or add an existing, saved stack to a new stack set.
8147
8386
  # @return [Boolean]
8148
8387
  #
8149
8388
  # @!attribute [rw] administration_role_arn
@@ -8194,7 +8433,7 @@ module Aws::CloudFormation
8194
8433
  # includes information about drift operations currently being
8195
8434
  # performed on the stack set.
8196
8435
  #
8197
- # this information will only be present for stack set operations whose
8436
+ # This information will only be present for stack set operations whose
8198
8437
  # `Action` type is `DETECT_DRIFT`.
8199
8438
  #
8200
8439
  # For more information, see [Detecting Unmanaged Changes in Stack
@@ -8285,9 +8524,9 @@ module Aws::CloudFormation
8285
8524
  #
8286
8525
  # @!attribute [rw] max_concurrent_count
8287
8526
  # The maximum number of accounts in which to perform this operation at
8288
- # one time. This is dependent on the value of `FailureToleranceCount`.
8289
- # `MaxConcurrentCount` is at most one more than the
8290
- # `FailureToleranceCount`.
8527
+ # one time. This is dependent on the value of
8528
+ # `FailureToleranceCount`.`MaxConcurrentCount` is at most one more
8529
+ # than the `FailureToleranceCount`.
8291
8530
  #
8292
8531
  # Note that this setting lets you specify the *maximum* for
8293
8532
  # operations. For large deployments, under certain circumstances the
@@ -8351,7 +8590,7 @@ module Aws::CloudFormation
8351
8590
  # in the given Region.
8352
8591
  #
8353
8592
  # * `CANCELLED`\: The operation in the specified account and Region
8354
- # has been cancelled. This is either because a user has stopped the
8593
+ # has been canceled. This is either because a user has stopped the
8355
8594
  # stack set operation, or because the failure tolerance of the stack
8356
8595
  # set operation has been exceeded.
8357
8596
  #
@@ -8378,7 +8617,7 @@ module Aws::CloudFormation
8378
8617
  #
8379
8618
  # @!attribute [rw] account_gate_result
8380
8619
  # The results of the account gate function CloudFormation invokes, if
8381
- # present, before proceeding with stack set operations in an account
8620
+ # present, before proceeding with stack set operations in an account.
8382
8621
  # @return [Types::AccountGateResult]
8383
8622
  #
8384
8623
  # @!attribute [rw] organizational_unit_id
@@ -8415,8 +8654,7 @@ module Aws::CloudFormation
8415
8654
  # The type of operation: `CREATE`, `UPDATE`, or `DELETE`. Create and
8416
8655
  # delete operations affect only the specified stack instances that are
8417
8656
  # associated with the specified stack set. Update operations affect
8418
- # both the stack set itself as well as *all* associated stack set
8419
- # instances.
8657
+ # both the stack set itself and *all* associated stack set instances.
8420
8658
  # @return [String]
8421
8659
  #
8422
8660
  # @!attribute [rw] status
@@ -8438,7 +8676,7 @@ module Aws::CloudFormation
8438
8676
  #
8439
8677
  # * `RUNNING`\: The operation is currently being performed.
8440
8678
  #
8441
- # * `STOPPED`\: The user has cancelled the operation.
8679
+ # * `STOPPED`\: The user has canceled the operation.
8442
8680
  #
8443
8681
  # * `STOPPING`\: The operation is in the process of stopping, at user
8444
8682
  # request.
@@ -8538,10 +8776,10 @@ module Aws::CloudFormation
8538
8776
  # configuration. A stack instance is considered to have drifted if
8539
8777
  # one or more of the resources in the associated stack have drifted.
8540
8778
  #
8541
- # * `NOT_CHECKED`\: CloudFormation has not checked the stack set for
8779
+ # * `NOT_CHECKED`\: CloudFormation hasn't checked the stack set for
8542
8780
  # drift.
8543
8781
  #
8544
- # * `IN_SYNC`\: All of the stack instances belonging to the stack set
8782
+ # * `IN_SYNC`\: All the stack instances belonging to the stack set
8545
8783
  # stack match from the expected template and parameter
8546
8784
  # configuration.
8547
8785
  #
@@ -8551,7 +8789,7 @@ module Aws::CloudFormation
8551
8789
  # @!attribute [rw] last_drift_check_timestamp
8552
8790
  # Most recent time when CloudFormation performed a drift detection
8553
8791
  # operation on the stack set. This value will be `NULL` for any stack
8554
- # set on which drift detection has not yet been performed.
8792
+ # set on which drift detection hasn't yet been performed.
8555
8793
  # @return [Time]
8556
8794
  #
8557
8795
  # @!attribute [rw] managed_execution
@@ -8795,14 +9033,14 @@ module Aws::CloudFormation
8795
9033
  #
8796
9034
  # {
8797
9035
  # arn: "TypeArn",
8798
- # type: "RESOURCE", # accepts RESOURCE, MODULE
9036
+ # type: "RESOURCE", # accepts RESOURCE, MODULE, HOOK
8799
9037
  # type_name: "TypeName",
8800
9038
  # version_id: "TypeVersionId",
8801
9039
  # log_delivery_bucket: "S3Bucket",
8802
9040
  # }
8803
9041
  #
8804
9042
  # @!attribute [rw] arn
8805
- # The Amazon Resource Number (ARN) of the extension.
9043
+ # The Amazon Resource Name (ARN) of the extension.
8806
9044
  #
8807
9045
  # Conditional: You must specify `Arn`, or `TypeName` and `Type`.
8808
9046
  # @return [String]
@@ -8825,7 +9063,7 @@ module Aws::CloudFormation
8825
9063
  # You can specify the version id with either `Arn`, or with `TypeName`
8826
9064
  # and `Type`.
8827
9065
  #
8828
- # If you do not specify a version, CloudFormation uses the default
9066
+ # If you don't specify a version, CloudFormation uses the default
8829
9067
  # version of the extension in this account and region for testing.
8830
9068
  # @return [String]
8831
9069
  #
@@ -8841,9 +9079,9 @@ module Aws::CloudFormation
8841
9079
  # specified S3 bucket. Specifically, the user needs the following
8842
9080
  # permissions:
8843
9081
  #
8844
- # * GetObject
9082
+ # * `GetObject`
8845
9083
  #
8846
- # * PutObject
9084
+ # * `PutObject`
8847
9085
  #
8848
9086
  # For more information, see [Actions, Resources, and Condition Keys
8849
9087
  # for Amazon S3][1] in the *Amazon Web Services Identity and Access
@@ -8867,7 +9105,7 @@ module Aws::CloudFormation
8867
9105
  end
8868
9106
 
8869
9107
  # @!attribute [rw] type_version_arn
8870
- # The Amazon Resource Number (ARN) of the extension.
9108
+ # The Amazon Resource Name (ARN) of the extension.
8871
9109
  # @return [String]
8872
9110
  #
8873
9111
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/TestTypeOutput AWS API Documentation
@@ -8908,14 +9146,14 @@ module Aws::CloudFormation
8908
9146
  # A JSON string specifying the configuration data for the extension,
8909
9147
  # in this account and region.
8910
9148
  #
8911
- # If a configuration has not been set for a specified extension,
9149
+ # If a configuration hasn't been set for a specified extension,
8912
9150
  # CloudFormation returns `\{\}`.
8913
9151
  # @return [String]
8914
9152
  #
8915
9153
  # @!attribute [rw] last_updated
8916
9154
  # When the configuration data was last updated for this extension.
8917
9155
  #
8918
- # If a configuration has not been set for a specified extension,
9156
+ # If a configuration hasn't been set for a specified extension,
8919
9157
  # CloudFormation returns `null`.
8920
9158
  # @return [Time]
8921
9159
  #
@@ -8967,7 +9205,7 @@ module Aws::CloudFormation
8967
9205
  # type_arn: "TypeArn",
8968
9206
  # type_configuration_alias: "TypeConfigurationAlias",
8969
9207
  # type_configuration_arn: "TypeConfigurationArn",
8970
- # type: "RESOURCE", # accepts RESOURCE, MODULE
9208
+ # type: "RESOURCE", # accepts RESOURCE, MODULE, HOOK
8971
9209
  # type_name: "TypeName",
8972
9210
  # }
8973
9211
  #
@@ -9016,7 +9254,7 @@ module Aws::CloudFormation
9016
9254
  include Aws::Structure
9017
9255
  end
9018
9256
 
9019
- # The specified extension configuration cannot be found.
9257
+ # The specified extension configuration can't be found.
9020
9258
  #
9021
9259
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/TypeConfigurationNotFoundException AWS API Documentation
9022
9260
  #
@@ -9056,8 +9294,8 @@ module Aws::CloudFormation
9056
9294
  # @!attribute [rw] publisher_id
9057
9295
  # The id of the publisher of the extension.
9058
9296
  #
9059
- # Extensions published by Amazon are not assigned a publisher ID. Use
9060
- # the `AWS_TYPE` category to specify a list of types published by
9297
+ # Extensions published by Amazon aren't assigned a publisher ID. Use
9298
+ # the `AWS_TYPES` category to specify a list of types published by
9061
9299
  # Amazon.
9062
9300
  # @return [String]
9063
9301
  #
@@ -9075,7 +9313,7 @@ module Aws::CloudFormation
9075
9313
  include Aws::Structure
9076
9314
  end
9077
9315
 
9078
- # The specified extension does not exist in the CloudFormation registry.
9316
+ # The specified extension doesn't exist in the CloudFormation registry.
9079
9317
  #
9080
9318
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/TypeNotFoundException AWS API Documentation
9081
9319
  #
@@ -9102,7 +9340,7 @@ module Aws::CloudFormation
9102
9340
  #
9103
9341
  # @!attribute [rw] default_version_id
9104
9342
  # The ID of the default version of the extension. The default version
9105
- # is used when the extension version is not specified.
9343
+ # is used when the extension version isn't specified.
9106
9344
  #
9107
9345
  # This applies only to private extensions you have registered in your
9108
9346
  # account. For public extensions, both those provided by Amazon and
@@ -9146,7 +9384,7 @@ module Aws::CloudFormation
9146
9384
  #
9147
9385
  # @!attribute [rw] publisher_id
9148
9386
  # The ID of the extension publisher, if the extension is published by
9149
- # a third party. Extensions published by Amazon do not return a
9387
+ # a third party. Extensions published by Amazon don't return a
9150
9388
  # publisher ID.
9151
9389
  # @return [String]
9152
9390
  #
@@ -9169,10 +9407,10 @@ module Aws::CloudFormation
9169
9407
  # @!attribute [rw] public_version_number
9170
9408
  # For public extensions that have been activated for this account and
9171
9409
  # region, the version of the public extension to be used for
9172
- # CloudFormation operations in this account and region.
9410
+ # CloudFormation operations in this account and Region.
9173
9411
  #
9174
9412
  # How you specified `AutoUpdate` when enabling the extension affects
9175
- # whether CloudFormation automatically updates the extention in this
9413
+ # whether CloudFormation automatically updates the extension in this
9176
9414
  # account and region when a new version is released. For more
9177
9415
  # information, see [Setting CloudFormation to automatically use new
9178
9416
  # versions of extensions][1] in the *CloudFormation User Guide*.
@@ -9189,7 +9427,7 @@ module Aws::CloudFormation
9189
9427
  # extensions, CloudFormation returns `null`.
9190
9428
  #
9191
9429
  # How you specified `AutoUpdate` when enabling the extension affects
9192
- # whether CloudFormation automatically updates the extention in this
9430
+ # whether CloudFormation automatically updates the extension in this
9193
9431
  # account and region when a new version is released. For more
9194
9432
  # information, see [Setting CloudFormation to automatically use new
9195
9433
  # versions of extensions][1] in the *CloudFormation User Guide*.
@@ -9258,7 +9496,7 @@ module Aws::CloudFormation
9258
9496
  # @!attribute [rw] version_id
9259
9497
  # The ID of a specific version of the extension. The version ID is the
9260
9498
  # value at the end of the Amazon Resource Name (ARN) assigned to the
9261
- # extension version when it is registered.
9499
+ # extension version when it's registered.
9262
9500
  # @return [String]
9263
9501
  #
9264
9502
  # @!attribute [rw] is_default_version
@@ -9267,8 +9505,7 @@ module Aws::CloudFormation
9267
9505
  #
9268
9506
  # This applies only to private extensions you have registered in your
9269
9507
  # account, and extensions published by Amazon. For public third-party
9270
- # extensions, whether or not they are activated in your account,
9271
- # CloudFormation returns `null`.
9508
+ # extensions, CloudFormation returns `null`.
9272
9509
  # @return [Boolean]
9273
9510
  #
9274
9511
  # @!attribute [rw] arn
@@ -9291,7 +9528,7 @@ module Aws::CloudFormation
9291
9528
  # CloudFormation returns `null`.
9292
9529
  #
9293
9530
  # How you specified `AutoUpdate` when enabling the extension affects
9294
- # whether CloudFormation automatically updates the extention in this
9531
+ # whether CloudFormation automatically updates the extension in this
9295
9532
  # account and region when a new version is released. For more
9296
9533
  # information, see [Setting CloudFormation to automatically use new
9297
9534
  # versions of extensions][1] in the *CloudFormation User Guide*.
@@ -9381,7 +9618,7 @@ module Aws::CloudFormation
9381
9618
  #
9382
9619
  # @!attribute [rw] template_url
9383
9620
  # Location of file containing the template body. The URL must point to
9384
- # a template that is located in an Amazon S3 bucket or a Systems
9621
+ # a template that's located in an Amazon S3 bucket or a Systems
9385
9622
  # Manager document. For more information, go to [Template Anatomy][1]
9386
9623
  # in the CloudFormation User Guide.
9387
9624
  #
@@ -9468,7 +9705,7 @@ module Aws::CloudFormation
9468
9705
  #
9469
9706
  # * [ AWS::IAM::Group][2]
9470
9707
  #
9471
- # * [ AWS::IAM::InstanceProfile][3]
9708
+ # * [AWS::IAM::InstanceProfile][3]
9472
9709
  #
9473
9710
  # * [ AWS::IAM::Policy][4]
9474
9711
  #
@@ -9476,7 +9713,7 @@ module Aws::CloudFormation
9476
9713
  #
9477
9714
  # * [ AWS::IAM::User][6]
9478
9715
  #
9479
- # * [ AWS::IAM::UserToGroupAddition][7]
9716
+ # * [AWS::IAM::UserToGroupAddition][7]
9480
9717
  #
9481
9718
  # For more information, see [Acknowledging IAM Resources in
9482
9719
  # CloudFormation Templates][8].
@@ -9548,10 +9785,10 @@ module Aws::CloudFormation
9548
9785
  # (IAM) role that CloudFormation assumes to update the stack.
9549
9786
  # CloudFormation uses the role's credentials to make calls on your
9550
9787
  # behalf. CloudFormation always uses this role for all future
9551
- # operations on the stack. As long as users have permission to operate
9552
- # on the stack, CloudFormation uses this role even if the users don't
9553
- # have permission to pass it. Ensure that the role grants least
9554
- # privilege.
9788
+ # operations on the stack. Provided that users have permission to
9789
+ # operate on the stack, CloudFormation uses this role even if the
9790
+ # users don't have permission to pass it. Ensure that the role grants
9791
+ # least privilege.
9555
9792
  #
9556
9793
  # If you don't specify a value, CloudFormation uses the role that was
9557
9794
  # previously associated with the stack. If no role is available,
@@ -9571,7 +9808,7 @@ module Aws::CloudFormation
9571
9808
  # both.
9572
9809
  #
9573
9810
  # You might update the stack policy, for example, in order to protect
9574
- # a new resource that you created during a stack update. If you do not
9811
+ # a new resource that you created during a stack update. If you don't
9575
9812
  # specify a stack policy, the current policy that is associated with
9576
9813
  # the stack is unchanged.
9577
9814
  # @return [String]
@@ -9583,7 +9820,7 @@ module Aws::CloudFormation
9583
9820
  # `StackPolicyBody` or the `StackPolicyURL` parameter, but not both.
9584
9821
  #
9585
9822
  # You might update the stack policy, for example, in order to protect
9586
- # a new resource that you created during a stack update. If you do not
9823
+ # a new resource that you created during a stack update. If you don't
9587
9824
  # specify a stack policy, the current policy that is associated with
9588
9825
  # the stack is unchanged.
9589
9826
  # @return [String]
@@ -9698,7 +9935,8 @@ module Aws::CloudFormation
9698
9935
  # \[Self-managed permissions\] The names of one or more Amazon Web
9699
9936
  # Services accounts for which you want to update parameter values for
9700
9937
  # stack instances. The overridden parameter values will be applied to
9701
- # all stack instances in the specified accounts and Regions.
9938
+ # all stack instances in the specified accounts and Amazon Web
9939
+ # Services Regions.
9702
9940
  #
9703
9941
  # You can specify `Accounts` or `DeploymentTargets`, but not both.
9704
9942
  # @return [Array<String>]
@@ -9715,10 +9953,10 @@ module Aws::CloudFormation
9715
9953
  # @return [Types::DeploymentTargets]
9716
9954
  #
9717
9955
  # @!attribute [rw] regions
9718
- # The names of one or more Regions in which you want to update
9719
- # parameter values for stack instances. The overridden parameter
9720
- # values will be applied to all stack instances in the specified
9721
- # accounts and Regions.
9956
+ # The names of one or more Amazon Web Services Regions in which you
9957
+ # want to update parameter values for stack instances. The overridden
9958
+ # parameter values will be applied to all stack instances in the
9959
+ # specified accounts and Amazon Web Services Regions.
9722
9960
  # @return [Array<String>]
9723
9961
  #
9724
9962
  # @!attribute [rw] parameter_overrides
@@ -9726,26 +9964,27 @@ module Aws::CloudFormation
9726
9964
  # specified stack instances.
9727
9965
  #
9728
9966
  # Any overridden parameter values will be applied to all stack
9729
- # instances in the specified accounts and Regions. When specifying
9730
- # parameters and their values, be aware of how CloudFormation sets
9731
- # parameter values during stack instance update operations:
9967
+ # instances in the specified accounts and Amazon Web Services Regions.
9968
+ # When specifying parameters and their values, be aware of how
9969
+ # CloudFormation sets parameter values during stack instance update
9970
+ # operations:
9732
9971
  #
9733
9972
  # * To override the current value for a parameter, include the
9734
9973
  # parameter and specify its value.
9735
9974
  #
9736
9975
  # * To leave an overridden parameter set to its present value, include
9737
9976
  # the parameter and specify `UsePreviousValue` as `true`. (You
9738
- # cannot specify both a value and set `UsePreviousValue` to `true`.)
9977
+ # can't specify both a value and set `UsePreviousValue` to `true`.)
9739
9978
  #
9740
9979
  # * To set an overridden parameter back to the value specified in the
9741
- # stack set, specify a parameter list but do not include the
9980
+ # stack set, specify a parameter list but don't include the
9742
9981
  # parameter in the list.
9743
9982
  #
9744
- # * To leave all parameters set to their present values, do not
9983
+ # * To leave all parameters set to their present values, don't
9745
9984
  # specify this property at all.
9746
9985
  #
9747
9986
  # During stack set updates, any parameter values overridden for a
9748
- # stack instance are not updated, but retain their overridden value.
9987
+ # stack instance aren't updated, but retain their overridden value.
9749
9988
  #
9750
9989
  # You can only override the parameter *values* that are specified in
9751
9990
  # the stack set; to add or delete a parameter itself, use
@@ -10045,10 +10284,10 @@ module Aws::CloudFormation
10045
10284
  #
10046
10285
  # * If you specify *any* tags using this parameter, you must specify
10047
10286
  # *all* the tags that you want associated with this stack set, even
10048
- # tags you've specifed before (for example, when creating the stack
10049
- # set or during a previous update of the stack set.). Any tags that
10050
- # you don't include in the updated list of tags are removed from
10051
- # the stack set, and therefore from the stacks and resources as
10287
+ # tags you've specified before (for example, when creating the
10288
+ # stack set or during a previous update of the stack set.). Any tags
10289
+ # that you don't include in the updated list of tags are removed
10290
+ # from the stack set, and therefore from the stacks and resources as
10052
10291
  # well.
10053
10292
  #
10054
10293
  # * If you specify an empty value, CloudFormation removes all
@@ -10118,10 +10357,11 @@ module Aws::CloudFormation
10118
10357
  # if `TemplateBody` or `TemplateURL` is specified), or the
10119
10358
  # `Parameters`, CloudFormation marks all stack instances with a status
10120
10359
  # of `OUTDATED` prior to updating the stack instances in the specified
10121
- # accounts and Regions. If the stack set update does not include
10122
- # changes to the template or parameters, CloudFormation updates the
10123
- # stack instances in the specified accounts and Regions, while leaving
10124
- # all other stack instances with their existing stack instance status.
10360
+ # accounts and Amazon Web Services Regions. If the stack set update
10361
+ # doesn't include changes to the template or parameters,
10362
+ # CloudFormation updates the stack instances in the specified accounts
10363
+ # and Regions, while leaving all other stack instances with their
10364
+ # existing stack instance status.
10125
10365
  # @return [Types::DeploymentTargets]
10126
10366
  #
10127
10367
  # @!attribute [rw] permission_model
@@ -10150,7 +10390,7 @@ module Aws::CloudFormation
10150
10390
  # automatically deploys to Organizations accounts that are added to a
10151
10391
  # target organization or organizational unit (OU).
10152
10392
  #
10153
- # If you specify `AutoDeployment`, do not specify `DeploymentTargets`
10393
+ # If you specify `AutoDeployment`, don't specify `DeploymentTargets`
10154
10394
  # or `Regions`.
10155
10395
  # @return [Types::AutoDeployment]
10156
10396
  #
@@ -10176,26 +10416,27 @@ module Aws::CloudFormation
10176
10416
  # @!attribute [rw] accounts
10177
10417
  # \[Self-managed permissions\] The accounts in which to update
10178
10418
  # associated stack instances. If you specify accounts, you must also
10179
- # specify the Regions in which to update stack set instances.
10419
+ # specify the Amazon Web Services Regions in which to update stack set
10420
+ # instances.
10180
10421
  #
10181
10422
  # To update *all* the stack instances associated with this stack set,
10182
- # do not specify the `Accounts` or `Regions` properties.
10423
+ # don't specify the `Accounts` or `Regions` properties.
10183
10424
  #
10184
10425
  # If the stack set update includes changes to the template (that is,
10185
10426
  # if the `TemplateBody` or `TemplateURL` properties are specified), or
10186
10427
  # the `Parameters` property, CloudFormation marks all stack instances
10187
10428
  # with a status of `OUTDATED` prior to updating the stack instances in
10188
- # the specified accounts and Regions. If the stack set update does not
10189
- # include changes to the template or parameters, CloudFormation
10190
- # updates the stack instances in the specified accounts and Regions,
10191
- # while leaving all other stack instances with their existing stack
10192
- # instance status.
10429
+ # the specified accounts and Amazon Web Services Regions. If the stack
10430
+ # set update does not include changes to the template or parameters,
10431
+ # CloudFormation updates the stack instances in the specified accounts
10432
+ # and Amazon Web Services Regions, while leaving all other stack
10433
+ # instances with their existing stack instance status.
10193
10434
  # @return [Array<String>]
10194
10435
  #
10195
10436
  # @!attribute [rw] regions
10196
- # The Regions in which to update associated stack instances. If you
10197
- # specify Regions, you must also specify accounts in which to update
10198
- # stack set instances.
10437
+ # The Amazon Web Services Regions in which to update associated stack
10438
+ # instances. If you specify Regions, you must also specify accounts in
10439
+ # which to update stack set instances.
10199
10440
  #
10200
10441
  # To update *all* the stack instances associated with this stack set,
10201
10442
  # do not specify the `Accounts` or `Regions` properties.