aws-sdk-cloudformation 1.52.0 → 1.56.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 971cca68253ba02c30c86c18246529a0b640ea8710308526355b1d4e787d91a8
4
- data.tar.gz: cdefa6548d2916be01a9c402ddf3d7a731e2bff2467e900b95f70200e2b368bb
3
+ metadata.gz: b025ee4315fb41a60eceb4cd6578e2c677aba67b0b60b05c7922c40636805975
4
+ data.tar.gz: a353c99c194db166f2ae77b3caacd7e6d32b94eefe890cc024d9ed427ffa4f82
5
5
  SHA512:
6
- metadata.gz: a04a675fb859f90dce594e9b40a4c5f276ce4893852b6342825753158ee359ee98d7bf361d4ffda0b1a39e774ed931e1a37d7810b49e04037501134eb8307a41
7
- data.tar.gz: 8090c2d4aef986627c2ef804413b0b6f59a356f22afeae98c7cbb85502bfeee654777aef2c6045b40da25eae8ca85fb9b9618184f21d67aa5c026d7aef6cdaff
6
+ metadata.gz: bcc52107f71d24280f51d322b401f9af27385c77941ea96de8a2c681bd19079b7005d9ef3a4cf6e02425611812388d8a86a4bf4109ccb63ed8ad431f252e5631
7
+ data.tar.gz: 6b2348e6ead24b7ffb7b0117184e4681df13b98b0ff4f55d75ea6d8adbd1206ca51a20c91ac35aca3912d5f2e41dae72737ef5c674b1596f7f1a724d7eaea8a5
data/CHANGELOG.md CHANGED
@@ -1,6 +1,26 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.56.0 (2021-08-30)
5
+ ------------------
6
+
7
+ * Feature - AWS CloudFormation allows you to iteratively develop your applications when failures are encountered without rolling back successfully provisioned resources. By specifying stack failure options, you can troubleshoot resources in a CREATE_FAILED or UPDATE_FAILED status.
8
+
9
+ 1.55.0 (2021-07-30)
10
+ ------------------
11
+
12
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
13
+
14
+ 1.54.0 (2021-07-28)
15
+ ------------------
16
+
17
+ * Feature - SDK update to support Importing existing Stacks to new/existing Self Managed StackSet - Stack Import feature.
18
+
19
+ 1.53.0 (2021-06-21)
20
+ ------------------
21
+
22
+ * Feature - CloudFormation registry service now supports 3rd party public type sharing
23
+
4
24
  1.52.0 (2021-04-28)
5
25
  ------------------
6
26
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.52.0
1
+ 1.56.0
@@ -327,6 +327,193 @@ module Aws::CloudFormation
327
327
 
328
328
  # @!group API Operations
329
329
 
330
+ # Activates a public third-party extension, making it available for use
331
+ # in stack templates. For more information, see [Using public
332
+ # extensions][1] in the *CloudFormation User Guide*.
333
+ #
334
+ # Once you have activated a public third-party extension in your account
335
+ # and region, use
336
+ # [SetTypeConfiguration](AWSCloudFormation/latest/APIReference/API_SetTypeConfiguration.html)
337
+ # to specify configuration properties for the extension. For more
338
+ # information, see [Configuring extensions at the account level][2] in
339
+ # the *CloudFormation User Guide*.
340
+ #
341
+ #
342
+ #
343
+ # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/registry-public.html
344
+ # [2]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/registry-register.html#registry-set-configuration
345
+ #
346
+ # @option params [String] :type
347
+ # The extension type.
348
+ #
349
+ # Conditional: You must specify `PublicTypeArn`, or `TypeName`, `Type`,
350
+ # and `PublisherId`.
351
+ #
352
+ # @option params [String] :public_type_arn
353
+ # The Amazon Resource Number (ARN) of the public extension.
354
+ #
355
+ # Conditional: You must specify `PublicTypeArn`, or `TypeName`, `Type`,
356
+ # and `PublisherId`.
357
+ #
358
+ # @option params [String] :publisher_id
359
+ # The ID of the extension publisher.
360
+ #
361
+ # Conditional: You must specify `PublicTypeArn`, or `TypeName`, `Type`,
362
+ # and `PublisherId`.
363
+ #
364
+ # @option params [String] :type_name
365
+ # The name of the extension.
366
+ #
367
+ # Conditional: You must specify `PublicTypeArn`, or `TypeName`, `Type`,
368
+ # and `PublisherId`.
369
+ #
370
+ # @option params [String] :type_name_alias
371
+ # An alias to assign to the public extension, in this account and
372
+ # region. If you specify an alias for the extension, CloudFormation
373
+ # treats the alias as the extension type name within this account and
374
+ # region. You must use the alias to refer to the extension in your
375
+ # templates, API calls, and CloudFormation console.
376
+ #
377
+ # An extension alias must be unique within a given account and region.
378
+ # You can activate the same public resource multiple times in the same
379
+ # account and region, using different type name aliases.
380
+ #
381
+ # @option params [Boolean] :auto_update
382
+ # Whether to automatically update the extension in this account and
383
+ # region when a new *minor* version is published by the extension
384
+ # publisher. Major versions released by the publisher must be manually
385
+ # updated.
386
+ #
387
+ # The default is `true`.
388
+ #
389
+ # @option params [Types::LoggingConfig] :logging_config
390
+ # Contains logging configuration information for an extension.
391
+ #
392
+ # @option params [String] :execution_role_arn
393
+ # The name of the IAM execution role to use to activate the extension.
394
+ #
395
+ # @option params [String] :version_bump
396
+ # Manually updates a previously-activated type to a new major or minor
397
+ # version, if available. You can also use this parameter to update the
398
+ # value of `AutoUpdate`.
399
+ #
400
+ # * `MAJOR`\: CloudFormation updates the extension to the newest major
401
+ # version, if one is available.
402
+ #
403
+ # * `MINOR`\: CloudFormation updates the extension to the newest minor
404
+ # version, if one is available.
405
+ #
406
+ # @option params [Integer] :major_version
407
+ # The major version of this extension you want to activate, if multiple
408
+ # major versions are available. The default is the latest major version.
409
+ # CloudFormation uses the latest available *minor* version of the major
410
+ # version selected.
411
+ #
412
+ # You can specify `MajorVersion` or `VersionBump`, but not both.
413
+ #
414
+ # @return [Types::ActivateTypeOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
415
+ #
416
+ # * {Types::ActivateTypeOutput#arn #arn} => String
417
+ #
418
+ # @example Request syntax with placeholder values
419
+ #
420
+ # resp = client.activate_type({
421
+ # type: "RESOURCE", # accepts RESOURCE, MODULE
422
+ # public_type_arn: "ThirdPartyTypeArn",
423
+ # publisher_id: "PublisherId",
424
+ # type_name: "TypeName",
425
+ # type_name_alias: "TypeName",
426
+ # auto_update: false,
427
+ # logging_config: {
428
+ # log_role_arn: "RoleArn", # required
429
+ # log_group_name: "LogGroupName", # required
430
+ # },
431
+ # execution_role_arn: "RoleArn",
432
+ # version_bump: "MAJOR", # accepts MAJOR, MINOR
433
+ # major_version: 1,
434
+ # })
435
+ #
436
+ # @example Response structure
437
+ #
438
+ # resp.arn #=> String
439
+ #
440
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/ActivateType AWS API Documentation
441
+ #
442
+ # @overload activate_type(params = {})
443
+ # @param [Hash] params ({})
444
+ def activate_type(params = {}, options = {})
445
+ req = build_request(:activate_type, params)
446
+ req.send_request(options)
447
+ end
448
+
449
+ # Returns configuration data for the specified CloudFormation
450
+ # extensions, from the CloudFormation registry for the account and
451
+ # region.
452
+ #
453
+ # For more information, see [Configuring extensions at the account
454
+ # level][1] in the *CloudFormation User Guide*.
455
+ #
456
+ #
457
+ #
458
+ # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/registry-register.html#registry-set-configuration
459
+ #
460
+ # @option params [required, Array<Types::TypeConfigurationIdentifier>] :type_configuration_identifiers
461
+ # The list of identifiers for the desired extension configurations.
462
+ #
463
+ # @return [Types::BatchDescribeTypeConfigurationsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
464
+ #
465
+ # * {Types::BatchDescribeTypeConfigurationsOutput#errors #errors} => Array&lt;Types::BatchDescribeTypeConfigurationsError&gt;
466
+ # * {Types::BatchDescribeTypeConfigurationsOutput#unprocessed_type_configurations #unprocessed_type_configurations} => Array&lt;Types::TypeConfigurationIdentifier&gt;
467
+ # * {Types::BatchDescribeTypeConfigurationsOutput#type_configurations #type_configurations} => Array&lt;Types::TypeConfigurationDetails&gt;
468
+ #
469
+ # @example Request syntax with placeholder values
470
+ #
471
+ # resp = client.batch_describe_type_configurations({
472
+ # type_configuration_identifiers: [ # required
473
+ # {
474
+ # type_arn: "TypeArn",
475
+ # type_configuration_alias: "TypeConfigurationAlias",
476
+ # type_configuration_arn: "TypeConfigurationArn",
477
+ # type: "RESOURCE", # accepts RESOURCE, MODULE
478
+ # type_name: "TypeName",
479
+ # },
480
+ # ],
481
+ # })
482
+ #
483
+ # @example Response structure
484
+ #
485
+ # resp.errors #=> Array
486
+ # resp.errors[0].error_code #=> String
487
+ # resp.errors[0].error_message #=> String
488
+ # resp.errors[0].type_configuration_identifier.type_arn #=> String
489
+ # resp.errors[0].type_configuration_identifier.type_configuration_alias #=> String
490
+ # resp.errors[0].type_configuration_identifier.type_configuration_arn #=> String
491
+ # resp.errors[0].type_configuration_identifier.type #=> String, one of "RESOURCE", "MODULE"
492
+ # resp.errors[0].type_configuration_identifier.type_name #=> String
493
+ # resp.unprocessed_type_configurations #=> Array
494
+ # resp.unprocessed_type_configurations[0].type_arn #=> String
495
+ # resp.unprocessed_type_configurations[0].type_configuration_alias #=> String
496
+ # resp.unprocessed_type_configurations[0].type_configuration_arn #=> String
497
+ # resp.unprocessed_type_configurations[0].type #=> String, one of "RESOURCE", "MODULE"
498
+ # resp.unprocessed_type_configurations[0].type_name #=> String
499
+ # resp.type_configurations #=> Array
500
+ # resp.type_configurations[0].arn #=> String
501
+ # resp.type_configurations[0].alias #=> String
502
+ # resp.type_configurations[0].configuration #=> String
503
+ # resp.type_configurations[0].last_updated #=> Time
504
+ # resp.type_configurations[0].type_arn #=> String
505
+ # resp.type_configurations[0].type_name #=> String
506
+ # resp.type_configurations[0].is_default_configuration #=> Boolean
507
+ #
508
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/BatchDescribeTypeConfigurations AWS API Documentation
509
+ #
510
+ # @overload batch_describe_type_configurations(params = {})
511
+ # @param [Hash] params ({})
512
+ def batch_describe_type_configurations(params = {}, options = {})
513
+ req = build_request(:batch_describe_type_configurations, params)
514
+ req.send_request(options)
515
+ end
516
+
330
517
  # Cancels an update on the specified stack. If the call completes
331
518
  # successfully, the stack rolls back the update and reverts to the
332
519
  # previous stack configuration.
@@ -340,10 +527,10 @@ module Aws::CloudFormation
340
527
  #
341
528
  # @option params [String] :client_request_token
342
529
  # A unique identifier for this `CancelUpdateStack` request. Specify this
343
- # token if you plan to retry requests so that AWS CloudFormation knows
344
- # that you're not attempting to cancel an update on a stack with the
345
- # same name. You might retry `CancelUpdateStack` requests to ensure that
346
- # AWS CloudFormation successfully received them.
530
+ # token if you plan to retry requests so that CloudFormation knows that
531
+ # you're not attempting to cancel an update on a stack with the same
532
+ # name. You might retry `CancelUpdateStack` requests to ensure that
533
+ # CloudFormation successfully received them.
347
534
  #
348
535
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
349
536
  #
@@ -371,11 +558,11 @@ module Aws::CloudFormation
371
558
  # `UPDATE_ROLLBACK_COMPLETE` state), and then try to update the stack
372
559
  # again.
373
560
  #
374
- # A stack goes into the `UPDATE_ROLLBACK_FAILED` state when AWS
561
+ # A stack goes into the `UPDATE_ROLLBACK_FAILED` state when
375
562
  # CloudFormation cannot roll back all changes after a failed stack
376
563
  # update. For example, you might have a stack that is rolling back to an
377
- # old database instance that was deleted outside of AWS CloudFormation.
378
- # Because AWS CloudFormation doesn't know the database was deleted, it
564
+ # old database instance that was deleted outside of CloudFormation.
565
+ # Because CloudFormation doesn't know the database was deleted, it
379
566
  # assumes that the database instance still exists and attempts to roll
380
567
  # back to it, causing the update rollback to fail.
381
568
  #
@@ -395,33 +582,32 @@ module Aws::CloudFormation
395
582
  # </note>
396
583
  #
397
584
  # @option params [String] :role_arn
398
- # The Amazon Resource Name (ARN) of an AWS Identity and Access
399
- # Management (IAM) role that AWS CloudFormation assumes to roll back the
400
- # stack. AWS CloudFormation uses the role's credentials to make calls
401
- # on your behalf. AWS CloudFormation always uses this role for all
402
- # future operations on the stack. As long as users have permission to
403
- # operate on the stack, AWS CloudFormation uses this role even if the
404
- # users don't have permission to pass it. Ensure that the role grants
405
- # least privilege.
406
- #
407
- # If you don't specify a value, AWS CloudFormation uses the role that
408
- # was previously associated with the stack. If no role is available, AWS
585
+ # The Amazon Resource Name (ARN) of an Identity and Access Management
586
+ # (IAM) role that CloudFormation assumes to roll back the stack.
587
+ # CloudFormation uses the role's credentials to make calls on your
588
+ # behalf. CloudFormation always uses this role for all future operations
589
+ # on the stack. As long as users have permission to operate on the
590
+ # stack, CloudFormation uses this role even if the users don't have
591
+ # permission to pass it. Ensure that the role grants least privilege.
592
+ #
593
+ # If you don't specify a value, CloudFormation uses the role that was
594
+ # previously associated with the stack. If no role is available,
409
595
  # CloudFormation uses a temporary session that is generated from your
410
596
  # user credentials.
411
597
  #
412
598
  # @option params [Array<String>] :resources_to_skip
413
- # A list of the logical IDs of the resources that AWS CloudFormation
414
- # skips during the continue update rollback operation. You can specify
415
- # only resources that are in the `UPDATE_FAILED` state because a
416
- # rollback failed. You can't specify resources that are in the
417
- # `UPDATE_FAILED` state for other reasons, for example, because an
418
- # update was cancelled. To check why a resource update failed, use the
419
- # DescribeStackResources action, and view the resource status reason.
420
- #
421
- # Specify this property to skip rolling back resources that AWS
599
+ # A list of the logical IDs of the resources that CloudFormation skips
600
+ # during the continue update rollback operation. You can specify only
601
+ # resources that are in the `UPDATE_FAILED` state because a rollback
602
+ # failed. You can't specify resources that are in the `UPDATE_FAILED`
603
+ # state for other reasons, for example, because an update was cancelled.
604
+ # To check why a resource update failed, use the DescribeStackResources
605
+ # action, and view the resource status reason.
606
+ #
607
+ # Specify this property to skip rolling back resources that
422
608
  # CloudFormation can't successfully roll back. We recommend that you [
423
- # troubleshoot][1] resources before skipping them. AWS CloudFormation
424
- # sets the status of the specified resources to `UPDATE_COMPLETE` and
609
+ # troubleshoot][1] resources before skipping them. CloudFormation sets
610
+ # the status of the specified resources to `UPDATE_COMPLETE` and
425
611
  # continues to roll back the stack. After the rollback is complete, the
426
612
  # state of the skipped resources will be inconsistent with the state of
427
613
  # the resources in the stack template. Before performing another stack
@@ -455,10 +641,10 @@ module Aws::CloudFormation
455
641
  #
456
642
  # @option params [String] :client_request_token
457
643
  # A unique identifier for this `ContinueUpdateRollback` request. Specify
458
- # this token if you plan to retry requests so that AWS CloudFormation
459
- # knows that you're not attempting to continue the rollback to a stack
460
- # with the same name. You might retry `ContinueUpdateRollback` requests
461
- # to ensure that AWS CloudFormation successfully received them.
644
+ # this token if you plan to retry requests so that CloudFormationknows
645
+ # that you're not attempting to continue the rollback to a stack with
646
+ # the same name. You might retry `ContinueUpdateRollback` requests to
647
+ # ensure that CloudFormation successfully received them.
462
648
  #
463
649
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
464
650
  #
@@ -484,25 +670,25 @@ module Aws::CloudFormation
484
670
  # can review the changes before executing them. You can create a change
485
671
  # set for a stack that doesn't exist or an existing stack. If you
486
672
  # create a change set for a stack that doesn't exist, the change set
487
- # shows all of the resources that AWS CloudFormation will create. If you
488
- # create a change set for an existing stack, AWS CloudFormation compares
489
- # the stack's information with the information that you submit in the
673
+ # shows all of the resources that CloudFormation will create. If you
674
+ # create a change set for an existing stack, CloudFormation compares the
675
+ # stack's information with the information that you submit in the
490
676
  # change set and lists the differences. Use change sets to understand
491
- # which resources AWS CloudFormation will create or change, and how it
492
- # will change resources in an existing stack, before you create or
493
- # update a stack.
677
+ # which resources CloudFormation will create or change, and how it will
678
+ # change resources in an existing stack, before you create or update a
679
+ # stack.
494
680
  #
495
681
  # To create a change set for a stack that doesn't exist, for the
496
682
  # `ChangeSetType` parameter, specify `CREATE`. To create a change set
497
683
  # for an existing stack, specify `UPDATE` for the `ChangeSetType`
498
684
  # parameter. To create a change set for an import operation, specify
499
685
  # `IMPORT` for the `ChangeSetType` parameter. After the
500
- # `CreateChangeSet` call successfully completes, AWS CloudFormation
501
- # starts creating the change set. To check the status of the change set
502
- # or to review it, use the DescribeChangeSet action.
686
+ # `CreateChangeSet` call successfully completes, CloudFormation starts
687
+ # creating the change set. To check the status of the change set or to
688
+ # review it, use the DescribeChangeSet action.
503
689
  #
504
690
  # When you are satisfied with the changes the change set will make,
505
- # execute the change set by using the ExecuteChangeSet action. AWS
691
+ # execute the change set by using the ExecuteChangeSet action.
506
692
  # CloudFormation doesn't make changes until you execute the change set.
507
693
  #
508
694
  # To create a change set for the entire stack hierachy, set
@@ -510,13 +696,13 @@ module Aws::CloudFormation
510
696
  #
511
697
  # @option params [required, String] :stack_name
512
698
  # The name or the unique ID of the stack for which you are creating a
513
- # change set. AWS CloudFormation generates the change set by comparing
514
- # this stack's information with the information that you submit, such
515
- # as a modified template or different parameter input values.
699
+ # change set. CloudFormation generates the change set by comparing this
700
+ # stack's information with the information that you submit, such as a
701
+ # modified template or different parameter input values.
516
702
  #
517
703
  # @option params [String] :template_body
518
704
  # A structure that contains the body of the revised template, with a
519
- # minimum length of 1 byte and a maximum length of 51,200 bytes. AWS
705
+ # minimum length of 1 byte and a maximum length of 51,200 bytes.
520
706
  # CloudFormation generates the change set by comparing this template
521
707
  # with the template of the stack that you specified.
522
708
  #
@@ -525,9 +711,9 @@ module Aws::CloudFormation
525
711
  # @option params [String] :template_url
526
712
  # The location of the file that contains the revised template. The URL
527
713
  # must point to a template (max size: 460,800 bytes) that is located in
528
- # an S3 bucket or a Systems Manager document. AWS CloudFormation
529
- # generates the change set by comparing this template with the stack
530
- # that you specified.
714
+ # an S3 bucket or a Systems Manager document. CloudFormation generates
715
+ # the change set by comparing this template with the stack that you
716
+ # specified.
531
717
  #
532
718
  # Conditional: You must specify only `TemplateBody` or `TemplateURL`.
533
719
  #
@@ -541,16 +727,16 @@ module Aws::CloudFormation
541
727
  #
542
728
  # @option params [Array<String>] :capabilities
543
729
  # In some cases, you must explicitly acknowledge that your stack
544
- # template contains certain capabilities in order for AWS CloudFormation
545
- # to create the stack.
730
+ # template contains certain capabilities in order for CloudFormation to
731
+ # create the stack.
546
732
  #
547
733
  # * `CAPABILITY_IAM` and `CAPABILITY_NAMED_IAM`
548
734
  #
549
735
  # Some stack templates might include resources that can affect
550
- # permissions in your AWS account; for example, by creating new AWS
551
- # Identity and Access Management (IAM) users. For those stacks, you
552
- # must explicitly acknowledge this by specifying one of these
553
- # capabilities.
736
+ # permissions in your Amazon Web Services account; for example, by
737
+ # creating new Identity and Access Management (IAM) users. For those
738
+ # stacks, you must explicitly acknowledge this by specifying one of
739
+ # these capabilities.
554
740
  #
555
741
  # The following IAM resources require you to specify either the
556
742
  # `CAPABILITY_IAM` or `CAPABILITY_NAMED_IAM` capability.
@@ -560,8 +746,8 @@ module Aws::CloudFormation
560
746
  # * If you have IAM resources with custom names, you *must* specify
561
747
  # `CAPABILITY_NAMED_IAM`.
562
748
  #
563
- # * If you don't specify either of these capabilities, AWS
564
- # CloudFormation returns an `InsufficientCapabilities` error.
749
+ # * If you don't specify either of these capabilities, CloudFormation
750
+ # returns an `InsufficientCapabilities` error.
565
751
  #
566
752
  # If your stack template contains these resources, we recommend that
567
753
  # you review all permissions associated with them and edit their
@@ -581,7 +767,7 @@ module Aws::CloudFormation
581
767
  #
582
768
  # * [ AWS::IAM::UserToGroupAddition][7]
583
769
  #
584
- # For more information, see [Acknowledging IAM Resources in AWS
770
+ # For more information, see [Acknowledging IAM Resources in
585
771
  # CloudFormation Templates][8].
586
772
  #
587
773
  # * `CAPABILITY_AUTO_EXPAND`
@@ -596,7 +782,7 @@ module Aws::CloudFormation
596
782
  # create a stack directly from the processed template, without first
597
783
  # reviewing the resulting changes in a change set, you must
598
784
  # acknowledge this capability. This includes the [AWS::Include][9] and
599
- # [AWS::Serverless][10] transforms, which are macros hosted by AWS
785
+ # [AWS::Serverless][10] transforms, which are macros hosted by
600
786
  # CloudFormation.
601
787
  #
602
788
  # <note markdown="1"> This capacity does not apply to creating change sets, and specifying
@@ -609,8 +795,8 @@ module Aws::CloudFormation
609
795
  #
610
796
  # </note>
611
797
  #
612
- # For more information on macros, see [Using AWS CloudFormation Macros
613
- # to Perform Custom Processing on Templates][11].
798
+ # For more information on macros, see [Using CloudFormation Macros to
799
+ # Perform Custom Processing on Templates][11].
614
800
  #
615
801
  #
616
802
  #
@@ -632,44 +818,43 @@ module Aws::CloudFormation
632
818
  # `AWS::EC2::*`, or `Custom::MyCustomInstance`.
633
819
  #
634
820
  # If the list of resource types doesn't include a resource type that
635
- # you're updating, the stack update fails. By default, AWS
636
- # CloudFormation grants permissions to all resource types. AWS Identity
637
- # and Access Management (IAM) uses this parameter for condition keys in
638
- # IAM policies for AWS CloudFormation. For more information, see
639
- # [Controlling Access with AWS Identity and Access Management][1] in the
640
- # AWS CloudFormation User Guide.
821
+ # you're updating, the stack update fails. By default, CloudFormation
822
+ # grants permissions to all resource types. Identity and Access
823
+ # Management (IAM) uses this parameter for condition keys in IAM
824
+ # policies for CloudFormation. For more information, see [Controlling
825
+ # Access with Identity and Access Management][1] in the CloudFormation
826
+ # User Guide.
641
827
  #
642
828
  #
643
829
  #
644
830
  # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html
645
831
  #
646
832
  # @option params [String] :role_arn
647
- # The Amazon Resource Name (ARN) of an AWS Identity and Access
648
- # Management (IAM) role that AWS CloudFormation assumes when executing
649
- # the change set. AWS CloudFormation uses the role's credentials to
650
- # make calls on your behalf. AWS CloudFormation uses this role for all
651
- # future operations on the stack. As long as users have permission to
652
- # operate on the stack, AWS CloudFormation uses this role even if the
653
- # users don't have permission to pass it. Ensure that the role grants
654
- # least privilege.
655
- #
656
- # If you don't specify a value, AWS CloudFormation uses the role that
657
- # was previously associated with the stack. If no role is available, AWS
833
+ # The Amazon Resource Name (ARN) of an Identity and Access Management
834
+ # (IAM) role that CloudFormation assumes when executing the change set.
835
+ # CloudFormation uses the role's credentials to make calls on your
836
+ # behalf. CloudFormation uses this role for all future operations on the
837
+ # stack. As long as users have permission to operate on the stack,
838
+ # CloudFormation uses this role even if the users don't have permission
839
+ # to pass it. Ensure that the role grants least privilege.
840
+ #
841
+ # If you don't specify a value, CloudFormation uses the role that was
842
+ # previously associated with the stack. If no role is available,
658
843
  # CloudFormation uses a temporary session that is generated from your
659
844
  # user credentials.
660
845
  #
661
846
  # @option params [Types::RollbackConfiguration] :rollback_configuration
662
- # The rollback triggers for AWS CloudFormation to monitor during stack
847
+ # The rollback triggers for CloudFormation to monitor during stack
663
848
  # creation and updating operations, and for the specified monitoring
664
849
  # period afterwards.
665
850
  #
666
851
  # @option params [Array<String>] :notification_arns
667
852
  # The Amazon Resource Names (ARNs) of Amazon Simple Notification Service
668
- # (Amazon SNS) topics that AWS CloudFormation associates with the stack.
669
- # To remove all associated notification topics, specify an empty list.
853
+ # (Amazon SNS) topics that CloudFormation associates with the stack. To
854
+ # remove all associated notification topics, specify an empty list.
670
855
  #
671
856
  # @option params [Array<Types::Tag>] :tags
672
- # Key-value pairs to associate with this stack. AWS CloudFormation also
857
+ # Key-value pairs to associate with this stack. CloudFormation also
673
858
  # propagates these tags to resources in the stack. You can specify a
674
859
  # maximum of 50 tags.
675
860
  #
@@ -683,9 +868,9 @@ module Aws::CloudFormation
683
868
  #
684
869
  # @option params [String] :client_token
685
870
  # A unique identifier for this `CreateChangeSet` request. Specify this
686
- # token if you plan to retry requests so that AWS CloudFormation knows
687
- # that you're not attempting to create another change set with the same
688
- # name. You might retry `CreateChangeSet` requests to ensure that AWS
871
+ # token if you plan to retry requests so that CloudFormation knows that
872
+ # you're not attempting to create another change set with the same
873
+ # name. You might retry `CreateChangeSet` requests to ensure that
689
874
  # CloudFormation successfully received them.
690
875
  #
691
876
  # @option params [String] :description
@@ -697,12 +882,12 @@ module Aws::CloudFormation
697
882
  # specify `UPDATE`. To create a change set for an import operation,
698
883
  # specify `IMPORT`.
699
884
  #
700
- # If you create a change set for a new stack, AWS Cloudformation creates
701
- # a stack with a unique stack ID, but no template or resources. The
702
- # stack will be in the [ `REVIEW_IN_PROGRESS` ][1] state until you
703
- # execute the change set.
885
+ # If you create a change set for a new stack, CloudFormation creates a
886
+ # stack with a unique stack ID, but no template or resources. The stack
887
+ # will be in the [ `REVIEW_IN_PROGRESS` ][1] state until you execute the
888
+ # change set.
704
889
  #
705
- # By default, AWS CloudFormation specifies `UPDATE`. You can't use the
890
+ # By default, CloudFormation specifies `UPDATE`. You can't use the
706
891
  # `UPDATE` type to create a change set for a new stack or the `CREATE`
707
892
  # type to create a change set for an existing stack.
708
893
  #
@@ -796,15 +981,15 @@ module Aws::CloudFormation
796
981
  # the Region in which you are creating the stack.
797
982
  #
798
983
  # <note markdown="1"> A stack name can contain only alphanumeric characters (case sensitive)
799
- # and hyphens. It must start with an alphabetic character and cannot be
800
- # longer than 128 characters.
984
+ # and hyphens. It must start with an alphabetical character and cannot
985
+ # be longer than 128 characters.
801
986
  #
802
987
  # </note>
803
988
  #
804
989
  # @option params [String] :template_body
805
990
  # Structure containing the template body with a minimum length of 1 byte
806
991
  # and a maximum length of 51,200 bytes. For more information, go to
807
- # [Template Anatomy][1] in the AWS CloudFormation User Guide.
992
+ # [Template Anatomy][1] in the CloudFormation User Guide.
808
993
  #
809
994
  # Conditional: You must specify either the `TemplateBody` or the
810
995
  # `TemplateURL` parameter, but not both.
@@ -817,7 +1002,7 @@ module Aws::CloudFormation
817
1002
  # Location of file containing the template body. The URL must point to a
818
1003
  # template (max size: 460,800 bytes) that is located in an Amazon S3
819
1004
  # bucket or a Systems Manager document. For more information, go to the
820
- # [Template Anatomy][1] in the AWS CloudFormation User Guide.
1005
+ # [Template Anatomy][1] in the CloudFormation User Guide.
821
1006
  #
822
1007
  # Conditional: You must specify either the `TemplateBody` or the
823
1008
  # `TemplateURL` parameter, but not both.
@@ -842,7 +1027,7 @@ module Aws::CloudFormation
842
1027
  # Default: `false`
843
1028
  #
844
1029
  # @option params [Types::RollbackConfiguration] :rollback_configuration
845
- # The rollback triggers for AWS CloudFormation to monitor during stack
1030
+ # The rollback triggers for CloudFormation to monitor during stack
846
1031
  # creation and updating operations, and for the specified monitoring
847
1032
  # period afterwards.
848
1033
  #
@@ -858,16 +1043,16 @@ module Aws::CloudFormation
858
1043
  #
859
1044
  # @option params [Array<String>] :capabilities
860
1045
  # In some cases, you must explicitly acknowledge that your stack
861
- # template contains certain capabilities in order for AWS CloudFormation
862
- # to create the stack.
1046
+ # template contains certain capabilities in order for CloudFormation to
1047
+ # create the stack.
863
1048
  #
864
1049
  # * `CAPABILITY_IAM` and `CAPABILITY_NAMED_IAM`
865
1050
  #
866
1051
  # Some stack templates might include resources that can affect
867
- # permissions in your AWS account; for example, by creating new AWS
868
- # Identity and Access Management (IAM) users. For those stacks, you
869
- # must explicitly acknowledge this by specifying one of these
870
- # capabilities.
1052
+ # permissions in your Amazon Web Services account; for example, by
1053
+ # creating new Identity and Access Management (IAM) users. For those
1054
+ # stacks, you must explicitly acknowledge this by specifying one of
1055
+ # these capabilities.
871
1056
  #
872
1057
  # The following IAM resources require you to specify either the
873
1058
  # `CAPABILITY_IAM` or `CAPABILITY_NAMED_IAM` capability.
@@ -877,8 +1062,8 @@ module Aws::CloudFormation
877
1062
  # * If you have IAM resources with custom names, you *must* specify
878
1063
  # `CAPABILITY_NAMED_IAM`.
879
1064
  #
880
- # * If you don't specify either of these capabilities, AWS
881
- # CloudFormation returns an `InsufficientCapabilities` error.
1065
+ # * If you don't specify either of these capabilities, CloudFormation
1066
+ # returns an `InsufficientCapabilities` error.
882
1067
  #
883
1068
  # If your stack template contains these resources, we recommend that
884
1069
  # you review all permissions associated with them and edit their
@@ -898,7 +1083,7 @@ module Aws::CloudFormation
898
1083
  #
899
1084
  # * [ AWS::IAM::UserToGroupAddition][7]
900
1085
  #
901
- # For more information, see [Acknowledging IAM Resources in AWS
1086
+ # For more information, see [Acknowledging IAM Resources in
902
1087
  # CloudFormation Templates][8].
903
1088
  #
904
1089
  # * `CAPABILITY_AUTO_EXPAND`
@@ -913,7 +1098,7 @@ module Aws::CloudFormation
913
1098
  # create a stack directly from the processed template, without first
914
1099
  # reviewing the resulting changes in a change set, you must
915
1100
  # acknowledge this capability. This includes the [AWS::Include][9] and
916
- # [AWS::Serverless][10] transforms, which are macros hosted by AWS
1101
+ # [AWS::Serverless][10] transforms, which are macros hosted by
917
1102
  # CloudFormation.
918
1103
  #
919
1104
  # If you want to create a stack from a stack template that contains
@@ -925,11 +1110,11 @@ module Aws::CloudFormation
925
1110
  #
926
1111
  # Each macro relies on an underlying Lambda service function for
927
1112
  # processing stack templates. Be aware that the Lambda function owner
928
- # can update the function operation without AWS CloudFormation being
1113
+ # can update the function operation without CloudFormation being
929
1114
  # notified.
930
1115
  #
931
- # For more information, see [Using AWS CloudFormation Macros to
932
- # Perform Custom Processing on Templates][11].
1116
+ # For more information, see [Using CloudFormation Macros to Perform
1117
+ # Custom Processing on Templates][11].
933
1118
  #
934
1119
  #
935
1120
  #
@@ -949,35 +1134,35 @@ module Aws::CloudFormation
949
1134
  # The template resource types that you have permissions to work with for
950
1135
  # this create stack action, such as `AWS::EC2::Instance`, `AWS::EC2::*`,
951
1136
  # or `Custom::MyCustomInstance`. Use the following syntax to describe
952
- # template resource types: `AWS::*` (for all AWS resource), `Custom::*`
953
- # (for all custom resources), `Custom::logical_ID ` (for a specific
954
- # custom resource), `AWS::service_name::*` (for all resources of a
955
- # particular AWS service), and `AWS::service_name::resource_logical_ID `
956
- # (for a specific AWS resource).
1137
+ # template resource types: `AWS::*` (for all Amazon Web Services
1138
+ # resources), `Custom::*` (for all custom resources),
1139
+ # `Custom::logical_ID ` (for a specific custom resource),
1140
+ # `AWS::service_name::*` (for all resources of a particular Amazon Web
1141
+ # Services service), and `AWS::service_name::resource_logical_ID ` (for
1142
+ # a specific Amazon Web Services resource).
957
1143
  #
958
1144
  # If the list of resource types doesn't include a resource that you're
959
- # creating, the stack creation fails. By default, AWS CloudFormation
960
- # grants permissions to all resource types. AWS Identity and Access
961
- # Management (IAM) uses this parameter for AWS CloudFormation-specific
962
- # condition keys in IAM policies. For more information, see [Controlling
963
- # Access with AWS Identity and Access Management][1].
1145
+ # creating, the stack creation fails. By default, CloudFormation grants
1146
+ # permissions to all resource types. Identity and Access Management
1147
+ # (IAM) uses this parameter for CloudFormation-specific condition keys
1148
+ # in IAM policies. For more information, see [Controlling Access with
1149
+ # Identity and Access Management][1].
964
1150
  #
965
1151
  #
966
1152
  #
967
1153
  # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html
968
1154
  #
969
1155
  # @option params [String] :role_arn
970
- # The Amazon Resource Name (ARN) of an AWS Identity and Access
971
- # Management (IAM) role that AWS CloudFormation assumes to create the
972
- # stack. AWS CloudFormation uses the role's credentials to make calls
973
- # on your behalf. AWS CloudFormation always uses this role for all
974
- # future operations on the stack. As long as users have permission to
975
- # operate on the stack, AWS CloudFormation uses this role even if the
976
- # users don't have permission to pass it. Ensure that the role grants
977
- # least privilege.
978
- #
979
- # If you don't specify a value, AWS CloudFormation uses the role that
980
- # was previously associated with the stack. If no role is available, AWS
1156
+ # The Amazon Resource Name (ARN) of an Identity and Access Management
1157
+ # (IAM) role that CloudFormation assumes to create the stack.
1158
+ # CloudFormation uses the role's credentials to make calls on your
1159
+ # behalf. CloudFormation always uses this role for all future operations
1160
+ # on the stack. As long as users have permission to operate on the
1161
+ # stack, CloudFormation uses this role even if the users don't have
1162
+ # permission to pass it. Ensure that the role grants least privilege.
1163
+ #
1164
+ # If you don't specify a value, CloudFormation uses the role that was
1165
+ # previously associated with the stack. If no role is available,
981
1166
  # CloudFormation uses a temporary session that is generated from your
982
1167
  # user credentials.
983
1168
  #
@@ -990,7 +1175,7 @@ module Aws::CloudFormation
990
1175
  #
991
1176
  # @option params [String] :stack_policy_body
992
1177
  # Structure containing the stack policy body. For more information, go
993
- # to [ Prevent Updates to Stack Resources][1] in the *AWS CloudFormation
1178
+ # to [ Prevent Updates to Stack Resources][1] in the *CloudFormation
994
1179
  # User Guide*. You can specify either the `StackPolicyBody` or the
995
1180
  # `StackPolicyURL` parameter, but not both.
996
1181
  #
@@ -1005,15 +1190,15 @@ module Aws::CloudFormation
1005
1190
  # the `StackPolicyURL` parameter, but not both.
1006
1191
  #
1007
1192
  # @option params [Array<Types::Tag>] :tags
1008
- # Key-value pairs to associate with this stack. AWS CloudFormation also
1193
+ # Key-value pairs to associate with this stack. CloudFormation also
1009
1194
  # propagates these tags to the resources created in the stack. A maximum
1010
1195
  # number of 50 tags can be specified.
1011
1196
  #
1012
1197
  # @option params [String] :client_request_token
1013
1198
  # A unique identifier for this `CreateStack` request. Specify this token
1014
- # if you plan to retry requests so that AWS CloudFormation knows that
1199
+ # if you plan to retry requests so that CloudFormation knows that
1015
1200
  # you're not attempting to create a stack with the same name. You might
1016
- # retry `CreateStack` requests to ensure that AWS CloudFormation
1201
+ # retry `CreateStack` requests to ensure that CloudFormation
1017
1202
  # successfully received them.
1018
1203
  #
1019
1204
  # All events triggered by a given stack operation are assigned the same
@@ -1035,7 +1220,7 @@ module Aws::CloudFormation
1035
1220
  # user attempts to delete a stack with termination protection enabled,
1036
1221
  # the operation fails and the stack remains unchanged. For more
1037
1222
  # information, see [Protecting a Stack From Being Deleted][1] in the
1038
- # *AWS CloudFormation User Guide*. Termination protection is disabled on
1223
+ # *CloudFormation User Guide*. Termination protection is disabled on
1039
1224
  # stacks by default.
1040
1225
  #
1041
1226
  # For [nested stacks][2], termination protection is set on the root
@@ -1116,21 +1301,21 @@ module Aws::CloudFormation
1116
1301
  # instances from.
1117
1302
  #
1118
1303
  # @option params [Array<String>] :accounts
1119
- # \[Self-managed permissions\] The names of one or more AWS accounts
1120
- # that you want to create stack instances in the specified Region(s)
1121
- # for.
1304
+ # \[Self-managed permissions\] The names of one or more Amazon Web
1305
+ # Services accounts that you want to create stack instances in the
1306
+ # specified Region(s) for.
1122
1307
  #
1123
1308
  # You can specify `Accounts` or `DeploymentTargets`, but not both.
1124
1309
  #
1125
1310
  # @option params [Types::DeploymentTargets] :deployment_targets
1126
- # \[Service-managed permissions\] The AWS Organizations accounts for
1127
- # which to create stack instances in the specified Regions.
1311
+ # \[Service-managed permissions\] The Organizations accounts for which
1312
+ # to create stack instances in the specified Regions.
1128
1313
  #
1129
1314
  # You can specify `Accounts` or `DeploymentTargets`, but not both.
1130
1315
  #
1131
1316
  # @option params [required, Array<String>] :regions
1132
1317
  # The names of one or more Regions where you want to create stack
1133
- # instances using the specified AWS account(s).
1318
+ # instances using the specified Amazon Web Services accounts.
1134
1319
  #
1135
1320
  # @option params [Array<Types::Parameter>] :parameter_overrides
1136
1321
  # A list of stack set parameters whose values you want to override in
@@ -1138,24 +1323,19 @@ module Aws::CloudFormation
1138
1323
  #
1139
1324
  # Any overridden parameter values will be applied to all stack instances
1140
1325
  # in the specified accounts and Regions. When specifying parameters and
1141
- # their values, be aware of how AWS CloudFormation sets parameter values
1326
+ # their values, be aware of how CloudFormation sets parameter values
1142
1327
  # during stack instance operations:
1143
1328
  #
1144
1329
  # * To override the current value for a parameter, include the parameter
1145
1330
  # and specify its value.
1146
1331
  #
1147
- # * To leave a parameter set to its present value, you can do one of the
1148
- # following:
1332
+ # * To leave an overridden parameter set to its present value, include
1333
+ # the parameter and specify `UsePreviousValue` as `true`. (You cannot
1334
+ # specify both a value and set `UsePreviousValue` to `true`.)
1149
1335
  #
1150
- # * Do not include the parameter in the list.
1151
- #
1152
- # * Include the parameter and specify `UsePreviousValue` as `true`.
1153
- # (You cannot specify both a value and set `UsePreviousValue` to
1154
- # `true`.)
1155
- #
1156
- # * To set all overridden parameter back to the values specified in the
1157
- # stack set, specify a parameter list but do not include any
1158
- # parameters.
1336
+ # * To set an overridden parameter back to the value specified in the
1337
+ # stack set, specify a parameter list but do not include the parameter
1338
+ # in the list.
1159
1339
  #
1160
1340
  # * To leave all parameters set to their present values, do not specify
1161
1341
  # this property at all.
@@ -1172,17 +1352,16 @@ module Aws::CloudFormation
1172
1352
  # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_UpdateStackSet.html
1173
1353
  #
1174
1354
  # @option params [Types::StackSetOperationPreferences] :operation_preferences
1175
- # Preferences for how AWS CloudFormation performs this stack set
1176
- # operation.
1355
+ # Preferences for how CloudFormation performs this stack set operation.
1177
1356
  #
1178
1357
  # @option params [String] :operation_id
1179
1358
  # The unique identifier for this stack set operation.
1180
1359
  #
1181
1360
  # The operation ID also functions as an idempotency token, to ensure
1182
- # that AWS CloudFormation performs the stack set operation only once,
1183
- # even if you retry the request multiple times. You might retry stack
1184
- # set operation requests to ensure that AWS CloudFormation successfully
1185
- # received them.
1361
+ # that CloudFormation performs the stack set operation only once, even
1362
+ # if you retry the request multiple times. You might retry stack set
1363
+ # operation requests to ensure that CloudFormation successfully received
1364
+ # them.
1186
1365
  #
1187
1366
  # If you don't specify an operation ID, the SDK generates one
1188
1367
  # automatically.
@@ -1206,9 +1385,10 @@ module Aws::CloudFormation
1206
1385
  # * If you are signed in to a delegated administrator account, specify
1207
1386
  # `DELEGATED_ADMIN`.
1208
1387
  #
1209
- # Your AWS account must be registered as a delegated administrator in
1210
- # the management account. For more information, see [Register a
1211
- # delegated administrator][1] in the *AWS CloudFormation User Guide*.
1388
+ # Your Amazon Web Services account must be registered as a delegated
1389
+ # administrator in the management account. For more information, see
1390
+ # [Register a delegated administrator][1] in the *CloudFormation User
1391
+ # Guide*.
1212
1392
  #
1213
1393
  #
1214
1394
  #
@@ -1281,7 +1461,7 @@ module Aws::CloudFormation
1281
1461
  # @option params [String] :template_body
1282
1462
  # The structure that contains the template body, with a minimum length
1283
1463
  # of 1 byte and a maximum length of 51,200 bytes. For more information,
1284
- # see [Template Anatomy][1] in the AWS CloudFormation User Guide.
1464
+ # see [Template Anatomy][1] in the CloudFormation User Guide.
1285
1465
  #
1286
1466
  # Conditional: You must specify either the TemplateBody or the
1287
1467
  # TemplateURL parameter, but not both.
@@ -1294,7 +1474,7 @@ module Aws::CloudFormation
1294
1474
  # The location of the file that contains the template body. The URL must
1295
1475
  # point to a template (maximum size: 460,800 bytes) that's located in
1296
1476
  # an Amazon S3 bucket or a Systems Manager document. For more
1297
- # information, see [Template Anatomy][1] in the AWS CloudFormation User
1477
+ # information, see [Template Anatomy][1] in the CloudFormation User
1298
1478
  # Guide.
1299
1479
  #
1300
1480
  # Conditional: You must specify either the TemplateBody or the
@@ -1304,21 +1484,25 @@ module Aws::CloudFormation
1304
1484
  #
1305
1485
  # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html
1306
1486
  #
1487
+ # @option params [String] :stack_id
1488
+ # The stack ID you are importing into a new stack set. Specify the
1489
+ # Amazon Resource Number (ARN) of the stack.
1490
+ #
1307
1491
  # @option params [Array<Types::Parameter>] :parameters
1308
1492
  # The input parameters for the stack set template.
1309
1493
  #
1310
1494
  # @option params [Array<String>] :capabilities
1311
1495
  # In some cases, you must explicitly acknowledge that your stack set
1312
- # template contains certain capabilities in order for AWS CloudFormation
1313
- # to create the stack set and related stack instances.
1496
+ # template contains certain capabilities in order for CloudFormation to
1497
+ # create the stack set and related stack instances.
1314
1498
  #
1315
1499
  # * `CAPABILITY_IAM` and `CAPABILITY_NAMED_IAM`
1316
1500
  #
1317
1501
  # Some stack templates might include resources that can affect
1318
- # permissions in your AWS account; for example, by creating new AWS
1319
- # Identity and Access Management (IAM) users. For those stack sets,
1320
- # you must explicitly acknowledge this by specifying one of these
1321
- # capabilities.
1502
+ # permissions in your Amazon Web Services account; for example, by
1503
+ # creating new Identity and Access Management (IAM) users. For those
1504
+ # stack sets, you must explicitly acknowledge this by specifying one
1505
+ # of these capabilities.
1322
1506
  #
1323
1507
  # The following IAM resources require you to specify either the
1324
1508
  # `CAPABILITY_IAM` or `CAPABILITY_NAMED_IAM` capability.
@@ -1328,8 +1512,8 @@ module Aws::CloudFormation
1328
1512
  # * If you have IAM resources with custom names, you *must* specify
1329
1513
  # `CAPABILITY_NAMED_IAM`.
1330
1514
  #
1331
- # * If you don't specify either of these capabilities, AWS
1332
- # CloudFormation returns an `InsufficientCapabilities` error.
1515
+ # * If you don't specify either of these capabilities, CloudFormation
1516
+ # returns an `InsufficientCapabilities` error.
1333
1517
  #
1334
1518
  # If your stack template contains these resources, we recommend that
1335
1519
  # you review all permissions associated with them and edit their
@@ -1349,7 +1533,7 @@ module Aws::CloudFormation
1349
1533
  #
1350
1534
  # * [ AWS::IAM::UserToGroupAddition][7]
1351
1535
  #
1352
- # For more information, see [Acknowledging IAM Resources in AWS
1536
+ # For more information, see [Acknowledging IAM Resources in
1353
1537
  # CloudFormation Templates][8].
1354
1538
  #
1355
1539
  # * `CAPABILITY_AUTO_EXPAND`
@@ -1359,13 +1543,13 @@ module Aws::CloudFormation
1359
1543
  # directly from the processed template, without first reviewing the
1360
1544
  # resulting changes in a change set. To create the stack set directly,
1361
1545
  # you must acknowledge this capability. For more information, see
1362
- # [Using AWS CloudFormation Macros to Perform Custom Processing on
1546
+ # [Using CloudFormation Macros to Perform Custom Processing on
1363
1547
  # Templates][9].
1364
1548
  #
1365
1549
  # Stack sets with service-managed permissions do not currently support
1366
1550
  # the use of macros in templates. (This includes the
1367
1551
  # [AWS::Include][10] and [AWS::Serverless][11] transforms, which are
1368
- # macros hosted by AWS CloudFormation.) Even if you specify this
1552
+ # macros hosted by CloudFormation.) Even if you specify this
1369
1553
  # capability for a stack set with service-managed permissions, if you
1370
1554
  # reference a macro in your template the stack set operation will
1371
1555
  # fail.
@@ -1386,11 +1570,11 @@ module Aws::CloudFormation
1386
1570
  #
1387
1571
  # @option params [Array<Types::Tag>] :tags
1388
1572
  # The key-value pairs to associate with this stack set and the stacks
1389
- # created from it. AWS CloudFormation also propagates these tags to
1573
+ # created from it. CloudFormation also propagates these tags to
1390
1574
  # supported resources that are created in the stacks. A maximum number
1391
1575
  # of 50 tags can be specified.
1392
1576
  #
1393
- # If you specify tags as part of a `CreateStackSet` action, AWS
1577
+ # If you specify tags as part of a `CreateStackSet` action,
1394
1578
  # CloudFormation checks to see if you have the required IAM permission
1395
1579
  # to tag resources. If you don't, the entire `CreateStackSet` action
1396
1580
  # fails with an `access denied` error, and the stack set is not created.
@@ -1403,7 +1587,7 @@ module Aws::CloudFormation
1403
1587
  # roles to control which users or groups can manage specific stack sets
1404
1588
  # within the same administrator account. For more information, see
1405
1589
  # [Prerequisites: Granting Permissions for Stack Set Operations][1] in
1406
- # the *AWS CloudFormation User Guide*.
1590
+ # the *CloudFormation User Guide*.
1407
1591
  #
1408
1592
  #
1409
1593
  #
@@ -1411,7 +1595,7 @@ module Aws::CloudFormation
1411
1595
  #
1412
1596
  # @option params [String] :execution_role_name
1413
1597
  # The name of the IAM execution role to use to create the stack set. If
1414
- # you do not specify an execution role, AWS CloudFormation uses the
1598
+ # you do not specify an execution role, CloudFormation uses the
1415
1599
  # `AWSCloudFormationStackSetExecutionRole` role for the stack set
1416
1600
  # operation.
1417
1601
  #
@@ -1428,7 +1612,7 @@ module Aws::CloudFormation
1428
1612
  # information, see [Grant Self-Managed Stack Set Permissions][1].
1429
1613
  #
1430
1614
  # * With `service-managed` permissions, StackSets automatically creates
1431
- # the IAM roles required to deploy to accounts managed by AWS
1615
+ # the IAM roles required to deploy to accounts managed by
1432
1616
  # Organizations. For more information, see [Grant Service-Managed
1433
1617
  # Stack Set Permissions][2].
1434
1618
  #
@@ -1438,7 +1622,7 @@ module Aws::CloudFormation
1438
1622
  # [2]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-prereqs-service-managed.html
1439
1623
  #
1440
1624
  # @option params [Types::AutoDeployment] :auto_deployment
1441
- # Describes whether StackSets automatically deploys to AWS Organizations
1625
+ # Describes whether StackSets automatically deploys to Organizations
1442
1626
  # accounts that are added to the target organization or organizational
1443
1627
  # unit (OU). Specify only if `PermissionModel` is `SERVICE_MANAGED`.
1444
1628
  #
@@ -1456,9 +1640,9 @@ module Aws::CloudFormation
1456
1640
  # * To create a stack set with service-managed permissions while signed
1457
1641
  # in to a delegated administrator account, specify `DELEGATED_ADMIN`.
1458
1642
  #
1459
- # Your AWS account must be registered as a delegated admin in the
1460
- # management account. For more information, see [Register a delegated
1461
- # administrator][1] in the *AWS CloudFormation User Guide*.
1643
+ # Your Amazon Web Services account must be registered as a delegated
1644
+ # admin in the management account. For more information, see [Register
1645
+ # a delegated administrator][1] in the *CloudFormation User Guide*.
1462
1646
  #
1463
1647
  # Stack sets with service-managed permissions are created in the
1464
1648
  # management account, including stack sets that are created by delegated
@@ -1470,9 +1654,9 @@ module Aws::CloudFormation
1470
1654
  #
1471
1655
  # @option params [String] :client_request_token
1472
1656
  # A unique identifier for this `CreateStackSet` request. Specify this
1473
- # token if you plan to retry requests so that AWS CloudFormation knows
1474
- # that you're not attempting to create another stack set with the same
1475
- # name. You might retry `CreateStackSet` requests to ensure that AWS
1657
+ # token if you plan to retry requests so that CloudFormation knows that
1658
+ # you're not attempting to create another stack set with the same name.
1659
+ # You might retry `CreateStackSet` requests to ensure that
1476
1660
  # CloudFormation successfully received them.
1477
1661
  #
1478
1662
  # If you don't specify an operation ID, the SDK generates one
@@ -1492,6 +1676,7 @@ module Aws::CloudFormation
1492
1676
  # description: "Description",
1493
1677
  # template_body: "TemplateBody",
1494
1678
  # template_url: "TemplateURL",
1679
+ # stack_id: "StackId",
1495
1680
  # parameters: [
1496
1681
  # {
1497
1682
  # parameter_key: "ParameterKey",
@@ -1531,10 +1716,56 @@ module Aws::CloudFormation
1531
1716
  req.send_request(options)
1532
1717
  end
1533
1718
 
1719
+ # Deactivates a public extension that was previously activated in this
1720
+ # account and region.
1721
+ #
1722
+ # Once deactivated, an extension cannot be used in any CloudFormation
1723
+ # operation. This includes stack update operations where the stack
1724
+ # template includes the extension, even if no updates are being made to
1725
+ # the extension. In addition, deactivated extensions are not
1726
+ # automatically updated if a new version of the extension is released.
1727
+ #
1728
+ # @option params [String] :type_name
1729
+ # The type name of the extension, in this account and region. If you
1730
+ # specified a type name alias when enabling the extension, use the type
1731
+ # name alias.
1732
+ #
1733
+ # Conditional: You must specify either `Arn`, or `TypeName` and `Type`.
1734
+ #
1735
+ # @option params [String] :type
1736
+ # The extension type.
1737
+ #
1738
+ # Conditional: You must specify either `Arn`, or `TypeName` and `Type`.
1739
+ #
1740
+ # @option params [String] :arn
1741
+ # The Amazon Resource Name (ARN) for the extension, in this account and
1742
+ # region.
1743
+ #
1744
+ # Conditional: You must specify either `Arn`, or `TypeName` and `Type`.
1745
+ #
1746
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
1747
+ #
1748
+ # @example Request syntax with placeholder values
1749
+ #
1750
+ # resp = client.deactivate_type({
1751
+ # type_name: "TypeName",
1752
+ # type: "RESOURCE", # accepts RESOURCE, MODULE
1753
+ # arn: "PrivateTypeArn",
1754
+ # })
1755
+ #
1756
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/DeactivateType AWS API Documentation
1757
+ #
1758
+ # @overload deactivate_type(params = {})
1759
+ # @param [Hash] params ({})
1760
+ def deactivate_type(params = {}, options = {})
1761
+ req = build_request(:deactivate_type, params)
1762
+ req.send_request(options)
1763
+ end
1764
+
1534
1765
  # Deletes the specified change set. Deleting change sets ensures that no
1535
1766
  # one executes the wrong change set.
1536
1767
  #
1537
- # If the call successfully completes, AWS CloudFormation successfully
1768
+ # If the call successfully completes, CloudFormation successfully
1538
1769
  # deleted the change set.
1539
1770
  #
1540
1771
  # If `IncludeNestedStacks` specifies `True` during the creation of the
@@ -1578,28 +1809,28 @@ module Aws::CloudFormation
1578
1809
  # @option params [Array<String>] :retain_resources
1579
1810
  # For stacks in the `DELETE_FAILED` state, a list of resource logical
1580
1811
  # IDs that are associated with the resources you want to retain. During
1581
- # deletion, AWS CloudFormation deletes the stack but does not delete the
1812
+ # deletion, CloudFormation deletes the stack but does not delete the
1582
1813
  # retained resources.
1583
1814
  #
1584
1815
  # Retaining resources is useful when you cannot delete a resource, such
1585
1816
  # as a non-empty S3 bucket, but you want to delete the stack.
1586
1817
  #
1587
1818
  # @option params [String] :role_arn
1588
- # The Amazon Resource Name (ARN) of an AWS Identity and Access
1589
- # Management (IAM) role that AWS CloudFormation assumes to delete the
1590
- # stack. AWS CloudFormation uses the role's credentials to make calls
1591
- # on your behalf.
1819
+ # The Amazon Resource Name (ARN) of an Identity and Access Management
1820
+ # (IAM) role that CloudFormation assumes to delete the stack.
1821
+ # CloudFormation uses the role's credentials to make calls on your
1822
+ # behalf.
1592
1823
  #
1593
- # If you don't specify a value, AWS CloudFormation uses the role that
1594
- # was previously associated with the stack. If no role is available, AWS
1824
+ # If you don't specify a value, CloudFormation uses the role that was
1825
+ # previously associated with the stack. If no role is available,
1595
1826
  # CloudFormation uses a temporary session that is generated from your
1596
1827
  # user credentials.
1597
1828
  #
1598
1829
  # @option params [String] :client_request_token
1599
1830
  # A unique identifier for this `DeleteStack` request. Specify this token
1600
- # if you plan to retry requests so that AWS CloudFormation knows that
1831
+ # if you plan to retry requests so that CloudFormation knows that
1601
1832
  # you're not attempting to delete a stack with the same name. You might
1602
- # retry `DeleteStack` requests to ensure that AWS CloudFormation
1833
+ # retry `DeleteStack` requests to ensure that CloudFormation
1603
1834
  # successfully received them.
1604
1835
  #
1605
1836
  # All events triggered by a given stack operation are assigned the same
@@ -1644,14 +1875,14 @@ module Aws::CloudFormation
1644
1875
  # instances for.
1645
1876
  #
1646
1877
  # @option params [Array<String>] :accounts
1647
- # \[Self-managed permissions\] The names of the AWS accounts that you
1648
- # want to delete stack instances for.
1878
+ # \[Self-managed permissions\] The names of the Amazon Web Services
1879
+ # accounts that you want to delete stack instances for.
1649
1880
  #
1650
1881
  # You can specify `Accounts` or `DeploymentTargets`, but not both.
1651
1882
  #
1652
1883
  # @option params [Types::DeploymentTargets] :deployment_targets
1653
- # \[Service-managed permissions\] The AWS Organizations accounts from
1654
- # which to delete stack instances.
1884
+ # \[Service-managed permissions\] The Organizations accounts from which
1885
+ # to delete stack instances.
1655
1886
  #
1656
1887
  # You can specify `Accounts` or `DeploymentTargets`, but not both.
1657
1888
  #
@@ -1659,8 +1890,7 @@ module Aws::CloudFormation
1659
1890
  # The Regions where you want to delete stack set instances.
1660
1891
  #
1661
1892
  # @option params [Types::StackSetOperationPreferences] :operation_preferences
1662
- # Preferences for how AWS CloudFormation performs this stack set
1663
- # operation.
1893
+ # Preferences for how CloudFormation performs this stack set operation.
1664
1894
  #
1665
1895
  # @option params [required, Boolean] :retain_stacks
1666
1896
  # Removes the stack instances from the specified stack set, but doesn't
@@ -1680,10 +1910,10 @@ module Aws::CloudFormation
1680
1910
  # automatically.
1681
1911
  #
1682
1912
  # The operation ID also functions as an idempotency token, to ensure
1683
- # that AWS CloudFormation performs the stack set operation only once,
1684
- # even if you retry the request multiple times. You can retry stack set
1685
- # operation requests to ensure that AWS CloudFormation successfully
1686
- # received them.
1913
+ # that CloudFormation performs the stack set operation only once, even
1914
+ # if you retry the request multiple times. You can retry stack set
1915
+ # operation requests to ensure that CloudFormation successfully received
1916
+ # them.
1687
1917
  #
1688
1918
  # Repeating this stack set operation with a new operation ID retries all
1689
1919
  # stack instances whose status is `OUTDATED`.
@@ -1704,9 +1934,10 @@ module Aws::CloudFormation
1704
1934
  # * If you are signed in to a delegated administrator account, specify
1705
1935
  # `DELEGATED_ADMIN`.
1706
1936
  #
1707
- # Your AWS account must be registered as a delegated administrator in
1708
- # the management account. For more information, see [Register a
1709
- # delegated administrator][1] in the *AWS CloudFormation User Guide*.
1937
+ # Your Amazon Web Services account must be registered as a delegated
1938
+ # administrator in the management account. For more information, see
1939
+ # [Register a delegated administrator][1] in the *CloudFormation User
1940
+ # Guide*.
1710
1941
  #
1711
1942
  #
1712
1943
  #
@@ -1774,9 +2005,10 @@ module Aws::CloudFormation
1774
2005
  # * If you are signed in to a delegated administrator account, specify
1775
2006
  # `DELEGATED_ADMIN`.
1776
2007
  #
1777
- # Your AWS account must be registered as a delegated administrator in
1778
- # the management account. For more information, see [Register a
1779
- # delegated administrator][1] in the *AWS CloudFormation User Guide*.
2008
+ # Your Amazon Web Services account must be registered as a delegated
2009
+ # administrator in the management account. For more information, see
2010
+ # [Register a delegated administrator][1] in the *CloudFormation User
2011
+ # Guide*.
1780
2012
  #
1781
2013
  #
1782
2014
  #
@@ -1863,10 +2095,10 @@ module Aws::CloudFormation
1863
2095
  req.send_request(options)
1864
2096
  end
1865
2097
 
1866
- # Retrieves your account's AWS CloudFormation limits, such as the
1867
- # maximum number of stacks that you can create in your account. For more
1868
- # information about account limits, see [AWS CloudFormation Limits][1]
1869
- # in the *AWS CloudFormation User Guide*.
2098
+ # Retrieves your account's CloudFormation limits, such as the maximum
2099
+ # number of stacks that you can create in your account. For more
2100
+ # information about account limits, see [CloudFormation Limits][1] in
2101
+ # the *CloudFormation User Guide*.
1870
2102
  #
1871
2103
  #
1872
2104
  #
@@ -1905,9 +2137,9 @@ module Aws::CloudFormation
1905
2137
  req.send_request(options)
1906
2138
  end
1907
2139
 
1908
- # Returns the inputs for the change set and a list of changes that AWS
2140
+ # Returns the inputs for the change set and a list of changes that
1909
2141
  # CloudFormation will make if you execute the change set. For more
1910
- # information, see [Updating Stacks Using Change Sets][1] in the AWS
2142
+ # information, see [Updating Stacks Using Change Sets][1] in the
1911
2143
  # CloudFormation User Guide.
1912
2144
  #
1913
2145
  #
@@ -2021,6 +2253,60 @@ module Aws::CloudFormation
2021
2253
  req.send_request(options)
2022
2254
  end
2023
2255
 
2256
+ # Returns information about a CloudFormation extension publisher.
2257
+ #
2258
+ # If you do not supply a `PublisherId`, and you have registered as an
2259
+ # extension publisher, `DescribePublisher` returns information about
2260
+ # your own publisher account.
2261
+ #
2262
+ # For more information on registering as a publisher, see:
2263
+ #
2264
+ # * [RegisterPublisher][1]
2265
+ #
2266
+ # * [Publishing extensions to make them available for public use][2] in
2267
+ # the *CloudFormation CLI User Guide*
2268
+ #
2269
+ #
2270
+ #
2271
+ # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_RegisterPublisher.html
2272
+ # [2]: https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/publish-extension.html
2273
+ #
2274
+ # @option params [String] :publisher_id
2275
+ # The ID of the extension publisher.
2276
+ #
2277
+ # If you do not supply a `PublisherId`, and you have registered as an
2278
+ # extension publisher, `DescribePublisher` returns information about
2279
+ # your own publisher account.
2280
+ #
2281
+ # @return [Types::DescribePublisherOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2282
+ #
2283
+ # * {Types::DescribePublisherOutput#publisher_id #publisher_id} => String
2284
+ # * {Types::DescribePublisherOutput#publisher_status #publisher_status} => String
2285
+ # * {Types::DescribePublisherOutput#identity_provider #identity_provider} => String
2286
+ # * {Types::DescribePublisherOutput#publisher_profile #publisher_profile} => String
2287
+ #
2288
+ # @example Request syntax with placeholder values
2289
+ #
2290
+ # resp = client.describe_publisher({
2291
+ # publisher_id: "PublisherId",
2292
+ # })
2293
+ #
2294
+ # @example Response structure
2295
+ #
2296
+ # resp.publisher_id #=> String
2297
+ # resp.publisher_status #=> String, one of "VERIFIED", "UNVERIFIED"
2298
+ # resp.identity_provider #=> String, one of "AWS_Marketplace", "GitHub", "Bitbucket"
2299
+ # resp.publisher_profile #=> String
2300
+ #
2301
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/DescribePublisher AWS API Documentation
2302
+ #
2303
+ # @overload describe_publisher(params = {})
2304
+ # @param [Hash] params ({})
2305
+ def describe_publisher(params = {}, options = {})
2306
+ req = build_request(:describe_publisher, params)
2307
+ req.send_request(options)
2308
+ end
2309
+
2024
2310
  # Returns information about a stack drift detection operation. A stack
2025
2311
  # drift detection operation detects whether a stack's actual
2026
2312
  # configuration differs, or has *drifted*, from it's expected
@@ -2044,10 +2330,10 @@ module Aws::CloudFormation
2044
2330
  # @option params [required, String] :stack_drift_detection_id
2045
2331
  # The ID of the drift detection results of this operation.
2046
2332
  #
2047
- # AWS CloudFormation generates new results, with a new drift detection
2048
- # ID, each time this operation is run. However, the number of drift
2049
- # results AWS CloudFormation retains for any given stack, and for how
2050
- # long, may vary.
2333
+ # CloudFormation generates new results, with a new drift detection ID,
2334
+ # each time this operation is run. However, the number of drift results
2335
+ # CloudFormation retains for any given stack, and for how long, may
2336
+ # vary.
2051
2337
  #
2052
2338
  # @return [Types::DescribeStackDriftDetectionStatusOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2053
2339
  #
@@ -2086,7 +2372,7 @@ module Aws::CloudFormation
2086
2372
 
2087
2373
  # Returns all stack related events for a specified stack in reverse
2088
2374
  # chronological order. For more information about a stack's event
2089
- # history, go to [Stacks][1] in the AWS CloudFormation User Guide.
2375
+ # history, go to [Stacks][1] in the CloudFormation User Guide.
2090
2376
  #
2091
2377
  # <note markdown="1"> You can list events for stacks that have failed to create or have been
2092
2378
  # deleted by specifying the unique stack identifier (stack ID).
@@ -2136,7 +2422,7 @@ module Aws::CloudFormation
2136
2422
  # resp.stack_events[0].physical_resource_id #=> String
2137
2423
  # resp.stack_events[0].resource_type #=> String
2138
2424
  # resp.stack_events[0].timestamp #=> Time
2139
- # resp.stack_events[0].resource_status #=> String, one of "CREATE_IN_PROGRESS", "CREATE_FAILED", "CREATE_COMPLETE", "DELETE_IN_PROGRESS", "DELETE_FAILED", "DELETE_COMPLETE", "DELETE_SKIPPED", "UPDATE_IN_PROGRESS", "UPDATE_FAILED", "UPDATE_COMPLETE", "IMPORT_FAILED", "IMPORT_COMPLETE", "IMPORT_IN_PROGRESS", "IMPORT_ROLLBACK_IN_PROGRESS", "IMPORT_ROLLBACK_FAILED", "IMPORT_ROLLBACK_COMPLETE"
2425
+ # resp.stack_events[0].resource_status #=> String, one of "CREATE_IN_PROGRESS", "CREATE_FAILED", "CREATE_COMPLETE", "DELETE_IN_PROGRESS", "DELETE_FAILED", "DELETE_COMPLETE", "DELETE_SKIPPED", "UPDATE_IN_PROGRESS", "UPDATE_FAILED", "UPDATE_COMPLETE", "IMPORT_FAILED", "IMPORT_COMPLETE", "IMPORT_IN_PROGRESS", "IMPORT_ROLLBACK_IN_PROGRESS", "IMPORT_ROLLBACK_FAILED", "IMPORT_ROLLBACK_COMPLETE", "UPDATE_ROLLBACK_IN_PROGRESS", "UPDATE_ROLLBACK_COMPLETE", "UPDATE_ROLLBACK_FAILED", "ROLLBACK_IN_PROGRESS", "ROLLBACK_COMPLETE", "ROLLBACK_FAILED"
2140
2426
  # resp.stack_events[0].resource_status_reason #=> String
2141
2427
  # resp.stack_events[0].resource_properties #=> String
2142
2428
  # resp.stack_events[0].client_request_token #=> String
@@ -2152,7 +2438,7 @@ module Aws::CloudFormation
2152
2438
  end
2153
2439
 
2154
2440
  # Returns the stack instance that's associated with the specified stack
2155
- # set, AWS account, and Region.
2441
+ # set, Amazon Web Services account, and Region.
2156
2442
  #
2157
2443
  # For a list of stack instances that are associated with a specific
2158
2444
  # stack set, use ListStackInstances.
@@ -2162,7 +2448,8 @@ module Aws::CloudFormation
2162
2448
  # stack instance information for.
2163
2449
  #
2164
2450
  # @option params [required, String] :stack_instance_account
2165
- # The ID of an AWS account that's associated with this stack instance.
2451
+ # The ID of an Amazon Web Services account that's associated with this
2452
+ # stack instance.
2166
2453
  #
2167
2454
  # @option params [required, String] :stack_instance_region
2168
2455
  # The name of a Region that's associated with this stack instance.
@@ -2180,9 +2467,10 @@ module Aws::CloudFormation
2180
2467
  # * If you are signed in to a delegated administrator account, specify
2181
2468
  # `DELEGATED_ADMIN`.
2182
2469
  #
2183
- # Your AWS account must be registered as a delegated administrator in
2184
- # the management account. For more information, see [Register a
2185
- # delegated administrator][1] in the *AWS CloudFormation User Guide*.
2470
+ # Your Amazon Web Services account must be registered as a delegated
2471
+ # administrator in the management account. For more information, see
2472
+ # [Register a delegated administrator][1] in the *CloudFormation User
2473
+ # Guide*.
2186
2474
  #
2187
2475
  #
2188
2476
  #
@@ -2269,7 +2557,7 @@ module Aws::CloudFormation
2269
2557
  # resp.stack_resource_detail.physical_resource_id #=> String
2270
2558
  # resp.stack_resource_detail.resource_type #=> String
2271
2559
  # resp.stack_resource_detail.last_updated_timestamp #=> Time
2272
- # resp.stack_resource_detail.resource_status #=> String, one of "CREATE_IN_PROGRESS", "CREATE_FAILED", "CREATE_COMPLETE", "DELETE_IN_PROGRESS", "DELETE_FAILED", "DELETE_COMPLETE", "DELETE_SKIPPED", "UPDATE_IN_PROGRESS", "UPDATE_FAILED", "UPDATE_COMPLETE", "IMPORT_FAILED", "IMPORT_COMPLETE", "IMPORT_IN_PROGRESS", "IMPORT_ROLLBACK_IN_PROGRESS", "IMPORT_ROLLBACK_FAILED", "IMPORT_ROLLBACK_COMPLETE"
2560
+ # resp.stack_resource_detail.resource_status #=> String, one of "CREATE_IN_PROGRESS", "CREATE_FAILED", "CREATE_COMPLETE", "DELETE_IN_PROGRESS", "DELETE_FAILED", "DELETE_COMPLETE", "DELETE_SKIPPED", "UPDATE_IN_PROGRESS", "UPDATE_FAILED", "UPDATE_COMPLETE", "IMPORT_FAILED", "IMPORT_COMPLETE", "IMPORT_IN_PROGRESS", "IMPORT_ROLLBACK_IN_PROGRESS", "IMPORT_ROLLBACK_FAILED", "IMPORT_ROLLBACK_COMPLETE", "UPDATE_ROLLBACK_IN_PROGRESS", "UPDATE_ROLLBACK_COMPLETE", "UPDATE_ROLLBACK_FAILED", "ROLLBACK_IN_PROGRESS", "ROLLBACK_COMPLETE", "ROLLBACK_FAILED"
2273
2561
  # resp.stack_resource_detail.resource_status_reason #=> String
2274
2562
  # resp.stack_resource_detail.description #=> String
2275
2563
  # resp.stack_resource_detail.metadata #=> String
@@ -2289,7 +2577,7 @@ module Aws::CloudFormation
2289
2577
 
2290
2578
  # Returns drift information for the resources that have been checked for
2291
2579
  # drift in the specified stack. This includes actual and expected
2292
- # configuration values for resources where AWS CloudFormation detects
2580
+ # configuration values for resources where CloudFormation detects
2293
2581
  # configuration drift.
2294
2582
  #
2295
2583
  # For a given stack, there will be one `StackResourceDrift` for each
@@ -2323,8 +2611,7 @@ module Aws::CloudFormation
2323
2611
  # * `IN_SYNC`\: The resources's actual configuration matches its
2324
2612
  # expected template configuration.
2325
2613
  #
2326
- # * `NOT_CHECKED`\: AWS CloudFormation does not currently return this
2327
- # value.
2614
+ # * `NOT_CHECKED`\: CloudFormation does not currently return this value.
2328
2615
  #
2329
2616
  # @option params [String] :next_token
2330
2617
  # A string that identifies the next page of stack resource drift
@@ -2384,11 +2671,11 @@ module Aws::CloudFormation
2384
2671
  req.send_request(options)
2385
2672
  end
2386
2673
 
2387
- # Returns AWS resource descriptions for running and deleted stacks. If
2388
- # `StackName` is specified, all the associated resources that are part
2389
- # of the stack are returned. If `PhysicalResourceId` is specified, the
2390
- # associated resources of the stack that the resource belongs to are
2391
- # returned.
2674
+ # Returns Amazon Web Services resource descriptions for running and
2675
+ # deleted stacks. If `StackName` is specified, all the associated
2676
+ # resources that are part of the stack are returned. If
2677
+ # `PhysicalResourceId` is specified, the associated resources of the
2678
+ # stack that the resource belongs to are returned.
2392
2679
  #
2393
2680
  # <note markdown="1"> Only the first 100 resources will be returned. If your stack has more
2394
2681
  # resources than this, you should use `ListStackResources` instead.
@@ -2401,8 +2688,8 @@ module Aws::CloudFormation
2401
2688
  # You must specify either `StackName` or `PhysicalResourceId`, but not
2402
2689
  # both. In addition, you can specify `LogicalResourceId` to filter the
2403
2690
  # returned result. For more information about resources, the
2404
- # `LogicalResourceId` and `PhysicalResourceId`, go to the [AWS
2405
- # CloudFormation User Guide][1].
2691
+ # `LogicalResourceId` and `PhysicalResourceId`, go to the
2692
+ # [CloudFormation User Guide][1].
2406
2693
  #
2407
2694
  # <note markdown="1"> A `ValidationError` is returned if you specify both `StackName` and
2408
2695
  # `PhysicalResourceId` in the same request.
@@ -2434,7 +2721,7 @@ module Aws::CloudFormation
2434
2721
  #
2435
2722
  # @option params [String] :physical_resource_id
2436
2723
  # The name or unique identifier that corresponds to a physical instance
2437
- # ID of a resource supported by AWS CloudFormation.
2724
+ # ID of a resource supported by CloudFormation.
2438
2725
  #
2439
2726
  # For example, for an Amazon Elastic Compute Cloud (EC2) instance,
2440
2727
  # `PhysicalResourceId` corresponds to the `InstanceId`. You can pass the
@@ -2467,7 +2754,7 @@ module Aws::CloudFormation
2467
2754
  # resp.stack_resources[0].physical_resource_id #=> String
2468
2755
  # resp.stack_resources[0].resource_type #=> String
2469
2756
  # resp.stack_resources[0].timestamp #=> Time
2470
- # resp.stack_resources[0].resource_status #=> String, one of "CREATE_IN_PROGRESS", "CREATE_FAILED", "CREATE_COMPLETE", "DELETE_IN_PROGRESS", "DELETE_FAILED", "DELETE_COMPLETE", "DELETE_SKIPPED", "UPDATE_IN_PROGRESS", "UPDATE_FAILED", "UPDATE_COMPLETE", "IMPORT_FAILED", "IMPORT_COMPLETE", "IMPORT_IN_PROGRESS", "IMPORT_ROLLBACK_IN_PROGRESS", "IMPORT_ROLLBACK_FAILED", "IMPORT_ROLLBACK_COMPLETE"
2757
+ # resp.stack_resources[0].resource_status #=> String, one of "CREATE_IN_PROGRESS", "CREATE_FAILED", "CREATE_COMPLETE", "DELETE_IN_PROGRESS", "DELETE_FAILED", "DELETE_COMPLETE", "DELETE_SKIPPED", "UPDATE_IN_PROGRESS", "UPDATE_FAILED", "UPDATE_COMPLETE", "IMPORT_FAILED", "IMPORT_COMPLETE", "IMPORT_IN_PROGRESS", "IMPORT_ROLLBACK_IN_PROGRESS", "IMPORT_ROLLBACK_FAILED", "IMPORT_ROLLBACK_COMPLETE", "UPDATE_ROLLBACK_IN_PROGRESS", "UPDATE_ROLLBACK_COMPLETE", "UPDATE_ROLLBACK_FAILED", "ROLLBACK_IN_PROGRESS", "ROLLBACK_COMPLETE", "ROLLBACK_FAILED"
2471
2758
  # resp.stack_resources[0].resource_status_reason #=> String
2472
2759
  # resp.stack_resources[0].description #=> String
2473
2760
  # resp.stack_resources[0].drift_information.stack_resource_drift_status #=> String, one of "IN_SYNC", "MODIFIED", "DELETED", "NOT_CHECKED"
@@ -2502,9 +2789,10 @@ module Aws::CloudFormation
2502
2789
  # * If you are signed in to a delegated administrator account, specify
2503
2790
  # `DELEGATED_ADMIN`.
2504
2791
  #
2505
- # Your AWS account must be registered as a delegated administrator in
2506
- # the management account. For more information, see [Register a
2507
- # delegated administrator][1] in the *AWS CloudFormation User Guide*.
2792
+ # Your Amazon Web Services account must be registered as a delegated
2793
+ # administrator in the management account. For more information, see
2794
+ # [Register a delegated administrator][1] in the *CloudFormation User
2795
+ # Guide*.
2508
2796
  #
2509
2797
  #
2510
2798
  #
@@ -2586,9 +2874,10 @@ module Aws::CloudFormation
2586
2874
  # * If you are signed in to a delegated administrator account, specify
2587
2875
  # `DELEGATED_ADMIN`.
2588
2876
  #
2589
- # Your AWS account must be registered as a delegated administrator in
2590
- # the management account. For more information, see [Register a
2591
- # delegated administrator][1] in the *AWS CloudFormation User Guide*.
2877
+ # Your Amazon Web Services account must be registered as a delegated
2878
+ # administrator in the management account. For more information, see
2879
+ # [Register a delegated administrator][1] in the *CloudFormation User
2880
+ # Guide*.
2592
2881
  #
2593
2882
  #
2594
2883
  #
@@ -2703,7 +2992,7 @@ module Aws::CloudFormation
2703
2992
  # resp.stacks[0].rollback_configuration.rollback_triggers[0].arn #=> String
2704
2993
  # resp.stacks[0].rollback_configuration.rollback_triggers[0].type #=> String
2705
2994
  # resp.stacks[0].rollback_configuration.monitoring_time_in_minutes #=> Integer
2706
- # resp.stacks[0].stack_status #=> String, one of "CREATE_IN_PROGRESS", "CREATE_FAILED", "CREATE_COMPLETE", "ROLLBACK_IN_PROGRESS", "ROLLBACK_FAILED", "ROLLBACK_COMPLETE", "DELETE_IN_PROGRESS", "DELETE_FAILED", "DELETE_COMPLETE", "UPDATE_IN_PROGRESS", "UPDATE_COMPLETE_CLEANUP_IN_PROGRESS", "UPDATE_COMPLETE", "UPDATE_ROLLBACK_IN_PROGRESS", "UPDATE_ROLLBACK_FAILED", "UPDATE_ROLLBACK_COMPLETE_CLEANUP_IN_PROGRESS", "UPDATE_ROLLBACK_COMPLETE", "REVIEW_IN_PROGRESS", "IMPORT_IN_PROGRESS", "IMPORT_COMPLETE", "IMPORT_ROLLBACK_IN_PROGRESS", "IMPORT_ROLLBACK_FAILED", "IMPORT_ROLLBACK_COMPLETE"
2995
+ # resp.stacks[0].stack_status #=> String, one of "CREATE_IN_PROGRESS", "CREATE_FAILED", "CREATE_COMPLETE", "ROLLBACK_IN_PROGRESS", "ROLLBACK_FAILED", "ROLLBACK_COMPLETE", "DELETE_IN_PROGRESS", "DELETE_FAILED", "DELETE_COMPLETE", "UPDATE_IN_PROGRESS", "UPDATE_COMPLETE_CLEANUP_IN_PROGRESS", "UPDATE_COMPLETE", "UPDATE_FAILED", "UPDATE_ROLLBACK_IN_PROGRESS", "UPDATE_ROLLBACK_FAILED", "UPDATE_ROLLBACK_COMPLETE_CLEANUP_IN_PROGRESS", "UPDATE_ROLLBACK_COMPLETE", "REVIEW_IN_PROGRESS", "IMPORT_IN_PROGRESS", "IMPORT_COMPLETE", "IMPORT_ROLLBACK_IN_PROGRESS", "IMPORT_ROLLBACK_FAILED", "IMPORT_ROLLBACK_COMPLETE"
2707
2996
  # resp.stacks[0].stack_status_reason #=> String
2708
2997
  # resp.stacks[0].disable_rollback #=> Boolean
2709
2998
  # resp.stacks[0].notification_arns #=> Array
@@ -2777,6 +3066,14 @@ module Aws::CloudFormation
2777
3066
  # that specific extension version. Otherwise, it returns information
2778
3067
  # about the default extension version.
2779
3068
  #
3069
+ # @option params [String] :publisher_id
3070
+ # The publisher ID of the extension publisher.
3071
+ #
3072
+ # Extensions provided by Amazon are not assigned a publisher ID.
3073
+ #
3074
+ # @option params [String] :public_version_number
3075
+ # The version number of a public third-party extension.
3076
+ #
2780
3077
  # @return [Types::DescribeTypeOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2781
3078
  #
2782
3079
  # * {Types::DescribeTypeOutput#arn #arn} => String
@@ -2784,17 +3081,28 @@ module Aws::CloudFormation
2784
3081
  # * {Types::DescribeTypeOutput#type_name #type_name} => String
2785
3082
  # * {Types::DescribeTypeOutput#default_version_id #default_version_id} => String
2786
3083
  # * {Types::DescribeTypeOutput#is_default_version #is_default_version} => Boolean
3084
+ # * {Types::DescribeTypeOutput#type_tests_status #type_tests_status} => String
3085
+ # * {Types::DescribeTypeOutput#type_tests_status_description #type_tests_status_description} => String
2787
3086
  # * {Types::DescribeTypeOutput#description #description} => String
2788
3087
  # * {Types::DescribeTypeOutput#schema #schema} => String
2789
3088
  # * {Types::DescribeTypeOutput#provisioning_type #provisioning_type} => String
2790
3089
  # * {Types::DescribeTypeOutput#deprecated_status #deprecated_status} => String
2791
3090
  # * {Types::DescribeTypeOutput#logging_config #logging_config} => Types::LoggingConfig
3091
+ # * {Types::DescribeTypeOutput#required_activated_types #required_activated_types} => Array&lt;Types::RequiredActivatedType&gt;
2792
3092
  # * {Types::DescribeTypeOutput#execution_role_arn #execution_role_arn} => String
2793
3093
  # * {Types::DescribeTypeOutput#visibility #visibility} => String
2794
3094
  # * {Types::DescribeTypeOutput#source_url #source_url} => String
2795
3095
  # * {Types::DescribeTypeOutput#documentation_url #documentation_url} => String
2796
3096
  # * {Types::DescribeTypeOutput#last_updated #last_updated} => Time
2797
3097
  # * {Types::DescribeTypeOutput#time_created #time_created} => Time
3098
+ # * {Types::DescribeTypeOutput#configuration_schema #configuration_schema} => String
3099
+ # * {Types::DescribeTypeOutput#publisher_id #publisher_id} => String
3100
+ # * {Types::DescribeTypeOutput#original_type_name #original_type_name} => String
3101
+ # * {Types::DescribeTypeOutput#original_type_arn #original_type_arn} => String
3102
+ # * {Types::DescribeTypeOutput#public_version_number #public_version_number} => String
3103
+ # * {Types::DescribeTypeOutput#latest_public_version #latest_public_version} => String
3104
+ # * {Types::DescribeTypeOutput#is_activated #is_activated} => Boolean
3105
+ # * {Types::DescribeTypeOutput#auto_update #auto_update} => Boolean
2798
3106
  #
2799
3107
  # @example Request syntax with placeholder values
2800
3108
  #
@@ -2803,6 +3111,8 @@ module Aws::CloudFormation
2803
3111
  # type_name: "TypeName",
2804
3112
  # arn: "TypeArn",
2805
3113
  # version_id: "TypeVersionId",
3114
+ # publisher_id: "PublisherId",
3115
+ # public_version_number: "PublicVersionNumber",
2806
3116
  # })
2807
3117
  #
2808
3118
  # @example Response structure
@@ -2812,18 +3122,34 @@ module Aws::CloudFormation
2812
3122
  # resp.type_name #=> String
2813
3123
  # resp.default_version_id #=> String
2814
3124
  # resp.is_default_version #=> Boolean
3125
+ # resp.type_tests_status #=> String, one of "PASSED", "FAILED", "IN_PROGRESS", "NOT_TESTED"
3126
+ # resp.type_tests_status_description #=> String
2815
3127
  # resp.description #=> String
2816
3128
  # resp.schema #=> String
2817
3129
  # resp.provisioning_type #=> String, one of "NON_PROVISIONABLE", "IMMUTABLE", "FULLY_MUTABLE"
2818
3130
  # resp.deprecated_status #=> String, one of "LIVE", "DEPRECATED"
2819
3131
  # resp.logging_config.log_role_arn #=> String
2820
3132
  # resp.logging_config.log_group_name #=> String
3133
+ # resp.required_activated_types #=> Array
3134
+ # resp.required_activated_types[0].type_name_alias #=> String
3135
+ # resp.required_activated_types[0].original_type_name #=> String
3136
+ # resp.required_activated_types[0].publisher_id #=> String
3137
+ # resp.required_activated_types[0].supported_major_versions #=> Array
3138
+ # resp.required_activated_types[0].supported_major_versions[0] #=> Integer
2821
3139
  # resp.execution_role_arn #=> String
2822
3140
  # resp.visibility #=> String, one of "PUBLIC", "PRIVATE"
2823
3141
  # resp.source_url #=> String
2824
3142
  # resp.documentation_url #=> String
2825
3143
  # resp.last_updated #=> Time
2826
3144
  # resp.time_created #=> Time
3145
+ # resp.configuration_schema #=> String
3146
+ # resp.publisher_id #=> String
3147
+ # resp.original_type_name #=> String
3148
+ # resp.original_type_arn #=> String
3149
+ # resp.public_version_number #=> String
3150
+ # resp.latest_public_version #=> String
3151
+ # resp.is_activated #=> Boolean
3152
+ # resp.auto_update #=> Boolean
2827
3153
  #
2828
3154
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/DescribeType AWS API Documentation
2829
3155
  #
@@ -2887,14 +3213,13 @@ module Aws::CloudFormation
2887
3213
  # Detects whether a stack's actual configuration differs, or has
2888
3214
  # *drifted*, from it's expected configuration, as defined in the stack
2889
3215
  # template and any values specified as template parameters. For each
2890
- # resource in the stack that supports drift detection, AWS
2891
- # CloudFormation compares the actual configuration of the resource with
2892
- # its expected template configuration. Only resource properties
2893
- # explicitly defined in the stack template are checked for drift. A
2894
- # stack is considered to have drifted if one or more of its resources
2895
- # differ from their expected template configurations. For more
2896
- # information, see [Detecting Unregulated Configuration Changes to
2897
- # Stacks and Resources][1].
3216
+ # resource in the stack that supports drift detection, CloudFormation
3217
+ # compares the actual configuration of the resource with its expected
3218
+ # template configuration. Only resource properties explicitly defined in
3219
+ # the stack template are checked for drift. A stack is considered to
3220
+ # have drifted if one or more of its resources differ from their
3221
+ # expected template configurations. For more information, see [Detecting
3222
+ # Unregulated Configuration Changes to Stacks and Resources][1].
2898
3223
  #
2899
3224
  # Use `DetectStackDrift` to detect drift on all supported resources for
2900
3225
  # a given stack, or DetectStackResourceDrift to detect drift on
@@ -2910,8 +3235,8 @@ module Aws::CloudFormation
2910
3235
  # completed, use DescribeStackResourceDrifts to return drift information
2911
3236
  # about the stack and its resources.
2912
3237
  #
2913
- # When detecting drift on a stack, AWS CloudFormation does not detect
2914
- # drift on any nested stacks belonging to that stack. Perform
3238
+ # When detecting drift on a stack, CloudFormation does not detect drift
3239
+ # on any nested stacks belonging to that stack. Perform
2915
3240
  # `DetectStackDrift` directly on the nested stack itself.
2916
3241
  #
2917
3242
  #
@@ -2953,7 +3278,7 @@ module Aws::CloudFormation
2953
3278
  # differs, or has *drifted*, from it's expected configuration, as
2954
3279
  # defined in the stack template and any values specified as template
2955
3280
  # parameters. This information includes actual and expected property
2956
- # values for resources in which AWS CloudFormation detects drift. Only
3281
+ # values for resources in which CloudFormation detects drift. Only
2957
3282
  # resource properties explicitly defined in the stack template are
2958
3283
  # checked for drift. For more information about stack and resource
2959
3284
  # drift, see [Detecting Unregulated Configuration Changes to Stacks and
@@ -3067,8 +3392,8 @@ module Aws::CloudFormation
3067
3392
  # operation.
3068
3393
  #
3069
3394
  # @option params [Types::StackSetOperationPreferences] :operation_preferences
3070
- # The user-specified preferences for how AWS CloudFormation performs a
3071
- # stack set operation.
3395
+ # The user-specified preferences for how CloudFormation performs a stack
3396
+ # set operation.
3072
3397
  #
3073
3398
  # For more information on maximum concurrent accounts and failure
3074
3399
  # tolerance, see [Stack set operation options][1].
@@ -3096,9 +3421,10 @@ module Aws::CloudFormation
3096
3421
  # * If you are signed in to a delegated administrator account, specify
3097
3422
  # `DELEGATED_ADMIN`.
3098
3423
  #
3099
- # Your AWS account must be registered as a delegated administrator in
3100
- # the management account. For more information, see [Register a
3101
- # delegated administrator][1] in the *AWS CloudFormation User Guide*.
3424
+ # Your Amazon Web Services account must be registered as a delegated
3425
+ # administrator in the management account. For more information, see
3426
+ # [Register a delegated administrator][1] in the *CloudFormation User
3427
+ # Guide*.
3102
3428
  #
3103
3429
  #
3104
3430
  #
@@ -3138,13 +3464,13 @@ module Aws::CloudFormation
3138
3464
  end
3139
3465
 
3140
3466
  # Returns the estimated monthly cost of a template. The return value is
3141
- # an AWS Simple Monthly Calculator URL with a query string that
3142
- # describes the resources required to run the template.
3467
+ # an Amazon Web Services Simple Monthly Calculator URL with a query
3468
+ # string that describes the resources required to run the template.
3143
3469
  #
3144
3470
  # @option params [String] :template_body
3145
3471
  # Structure containing the template body with a minimum length of 1 byte
3146
3472
  # and a maximum length of 51,200 bytes. (For more information, go to
3147
- # [Template Anatomy][1] in the AWS CloudFormation User Guide.)
3473
+ # [Template Anatomy][1] in the CloudFormation User Guide.)
3148
3474
  #
3149
3475
  # Conditional: You must pass `TemplateBody` or `TemplateURL`. If both
3150
3476
  # are passed, only `TemplateBody` is used.
@@ -3156,7 +3482,7 @@ module Aws::CloudFormation
3156
3482
  # @option params [String] :template_url
3157
3483
  # Location of file containing the template body. The URL must point to a
3158
3484
  # template that is located in an Amazon S3 bucket or a Systems Manager
3159
- # document. For more information, go to [Template Anatomy][1] in the AWS
3485
+ # document. For more information, go to [Template Anatomy][1] in the
3160
3486
  # CloudFormation User Guide.
3161
3487
  #
3162
3488
  # Conditional: You must pass `TemplateURL` or `TemplateBody`. If both
@@ -3203,14 +3529,14 @@ module Aws::CloudFormation
3203
3529
 
3204
3530
  # Updates a stack using the input information that was provided when the
3205
3531
  # specified change set was created. After the call successfully
3206
- # completes, AWS CloudFormation starts updating the stack. Use the
3532
+ # completes, CloudFormation starts updating the stack. Use the
3207
3533
  # DescribeStacks action to view the status of the update.
3208
3534
  #
3209
- # When you execute a change set, AWS CloudFormation deletes all other
3210
- # change sets associated with the stack because they aren't valid for
3211
- # the updated stack.
3535
+ # When you execute a change set, CloudFormation deletes all other change
3536
+ # sets associated with the stack because they aren't valid for the
3537
+ # updated stack.
3212
3538
  #
3213
- # If a stack policy is associated with the stack, AWS CloudFormation
3539
+ # If a stack policy is associated with the stack, CloudFormation
3214
3540
  # enforces the policy during the update. You can't specify a temporary
3215
3541
  # stack policy that overrides the current policy.
3216
3542
  #
@@ -3227,10 +3553,16 @@ module Aws::CloudFormation
3227
3553
  #
3228
3554
  # @option params [String] :client_request_token
3229
3555
  # A unique identifier for this `ExecuteChangeSet` request. Specify this
3230
- # token if you plan to retry requests so that AWS CloudFormation knows
3231
- # that you're not attempting to execute a change set to update a stack
3232
- # with the same name. You might retry `ExecuteChangeSet` requests to
3233
- # ensure that AWS CloudFormation successfully received them.
3556
+ # token if you plan to retry requests so that CloudFormation knows that
3557
+ # you're not attempting to execute a change set to update a stack with
3558
+ # the same name. You might retry `ExecuteChangeSet` requests to ensure
3559
+ # that CloudFormation successfully received them.
3560
+ #
3561
+ # @option params [Boolean] :disable_rollback
3562
+ # Preserves the state of previously provisioned resources when an
3563
+ # operation fails.
3564
+ #
3565
+ # Default: `True`
3234
3566
  #
3235
3567
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
3236
3568
  #
@@ -3240,6 +3572,7 @@ module Aws::CloudFormation
3240
3572
  # change_set_name: "ChangeSetNameOrId", # required
3241
3573
  # stack_name: "StackNameOrId",
3242
3574
  # client_request_token: "ClientRequestToken",
3575
+ # disable_rollback: false,
3243
3576
  # })
3244
3577
  #
3245
3578
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/ExecuteChangeSet AWS API Documentation
@@ -3303,19 +3636,19 @@ module Aws::CloudFormation
3303
3636
  # Default: There is no default value.
3304
3637
  #
3305
3638
  # @option params [String] :change_set_name
3306
- # The name or Amazon Resource Name (ARN) of a change set for which AWS
3639
+ # The name or Amazon Resource Name (ARN) of a change set for which
3307
3640
  # CloudFormation returns the associated template. If you specify a name,
3308
3641
  # you must also specify the `StackName`.
3309
3642
  #
3310
3643
  # @option params [String] :template_stage
3311
3644
  # For templates that include transforms, the stage of the template that
3312
- # AWS CloudFormation returns. To get the user-submitted template,
3313
- # specify `Original`. To get the template after AWS CloudFormation has
3314
- # processed all transforms, specify `Processed`.
3645
+ # CloudFormation returns. To get the user-submitted template, specify
3646
+ # `Original`. To get the template after CloudFormation has processed all
3647
+ # transforms, specify `Processed`.
3315
3648
  #
3316
3649
  # If the template doesn't include transforms, `Original` and
3317
- # `Processed` return the same template. By default, AWS CloudFormation
3318
- # specifies `Original`.
3650
+ # `Processed` return the same template. By default, CloudFormation
3651
+ # specifies `Processed`.
3319
3652
  #
3320
3653
  # @return [Types::GetTemplateOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
3321
3654
  #
@@ -3361,8 +3694,7 @@ module Aws::CloudFormation
3361
3694
  # @option params [String] :template_body
3362
3695
  # Structure containing the template body with a minimum length of 1 byte
3363
3696
  # and a maximum length of 51,200 bytes. For more information about
3364
- # templates, see [Template Anatomy][1] in the AWS CloudFormation User
3365
- # Guide.
3697
+ # templates, see [Template Anatomy][1] in the CloudFormation User Guide.
3366
3698
  #
3367
3699
  # Conditional: You must specify only one of the following parameters:
3368
3700
  # `StackName`, `StackSetName`, `TemplateBody`, or `TemplateURL`.
@@ -3375,8 +3707,7 @@ module Aws::CloudFormation
3375
3707
  # Location of file containing the template body. The URL must point to a
3376
3708
  # template (max size: 460,800 bytes) that is located in an Amazon S3
3377
3709
  # bucket or a Systems Manager document. For more information about
3378
- # templates, see [Template Anatomy][1] in the AWS CloudFormation User
3379
- # Guide.
3710
+ # templates, see [Template Anatomy][1] in the CloudFormation User Guide.
3380
3711
  #
3381
3712
  # Conditional: You must specify only one of the following parameters:
3382
3713
  # `StackName`, `StackSetName`, `TemplateBody`, or `TemplateURL`.
@@ -3414,9 +3745,10 @@ module Aws::CloudFormation
3414
3745
  # * If you are signed in to a delegated administrator account, specify
3415
3746
  # `DELEGATED_ADMIN`.
3416
3747
  #
3417
- # Your AWS account must be registered as a delegated administrator in
3418
- # the management account. For more information, see [Register a
3419
- # delegated administrator][1] in the *AWS CloudFormation User Guide*.
3748
+ # Your Amazon Web Services account must be registered as a delegated
3749
+ # administrator in the management account. For more information, see
3750
+ # [Register a delegated administrator][1] in the *CloudFormation User
3751
+ # Guide*.
3420
3752
  #
3421
3753
  #
3422
3754
  #
@@ -3480,8 +3812,86 @@ module Aws::CloudFormation
3480
3812
  req.send_request(options)
3481
3813
  end
3482
3814
 
3815
+ # Import existing stacks into a new stack sets. Use the stack import
3816
+ # operation to import up to 10 stacks into a new stack set in the same
3817
+ # account as the source stack or in a different administrator account
3818
+ # and Region, by specifying the stack ID of the stack you intend to
3819
+ # import.
3820
+ #
3821
+ # <note markdown="1"> `ImportStacksToStackSet` is only supported by self-managed
3822
+ # permissions.
3823
+ #
3824
+ # </note>
3825
+ #
3826
+ # @option params [required, String] :stack_set_name
3827
+ # The name of the stack set. The name must be unique in the Region where
3828
+ # you create your stack set.
3829
+ #
3830
+ # @option params [required, Array<String>] :stack_ids
3831
+ # The IDs of the stacks you are importing into a stack set. You import
3832
+ # up to 10 stacks per stack set at a time.
3833
+ #
3834
+ # @option params [Types::StackSetOperationPreferences] :operation_preferences
3835
+ # The user-specified preferences for how CloudFormation performs a stack
3836
+ # set operation.
3837
+ #
3838
+ # For more information on maximum concurrent accounts and failure
3839
+ # tolerance, see [Stack set operation options][1].
3840
+ #
3841
+ #
3842
+ #
3843
+ # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-concepts.html#stackset-ops-options
3844
+ #
3845
+ # @option params [String] :operation_id
3846
+ # A unique, user defined, identifier for the stack set operation.
3847
+ #
3848
+ # **A suitable default value is auto-generated.** You should normally
3849
+ # not need to pass this option.**
3850
+ #
3851
+ # @option params [String] :call_as
3852
+ # By default, `SELF` is specified. Use `SELF` for stack sets with
3853
+ # self-managed permissions.
3854
+ #
3855
+ # * If you are signed in to the management account, specify `SELF`.
3856
+ #
3857
+ # * For service managed stack sets, specify `DELEGATED_ADMIN`.
3858
+ #
3859
+ # @return [Types::ImportStacksToStackSetOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
3860
+ #
3861
+ # * {Types::ImportStacksToStackSetOutput#operation_id #operation_id} => String
3862
+ #
3863
+ # @example Request syntax with placeholder values
3864
+ #
3865
+ # resp = client.import_stacks_to_stack_set({
3866
+ # stack_set_name: "StackSetNameOrId", # required
3867
+ # stack_ids: ["StackId"], # required
3868
+ # operation_preferences: {
3869
+ # region_concurrency_type: "SEQUENTIAL", # accepts SEQUENTIAL, PARALLEL
3870
+ # region_order: ["Region"],
3871
+ # failure_tolerance_count: 1,
3872
+ # failure_tolerance_percentage: 1,
3873
+ # max_concurrent_count: 1,
3874
+ # max_concurrent_percentage: 1,
3875
+ # },
3876
+ # operation_id: "ClientRequestToken",
3877
+ # call_as: "SELF", # accepts SELF, DELEGATED_ADMIN
3878
+ # })
3879
+ #
3880
+ # @example Response structure
3881
+ #
3882
+ # resp.operation_id #=> String
3883
+ #
3884
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/ImportStacksToStackSet AWS API Documentation
3885
+ #
3886
+ # @overload import_stacks_to_stack_set(params = {})
3887
+ # @param [Hash] params ({})
3888
+ def import_stacks_to_stack_set(params = {}, options = {})
3889
+ req = build_request(:import_stacks_to_stack_set, params)
3890
+ req.send_request(options)
3891
+ end
3892
+
3483
3893
  # Returns the ID and status of each active change set for a stack. For
3484
- # example, AWS CloudFormation lists change sets that are in the
3894
+ # example, CloudFormation lists change sets that are in the
3485
3895
  # `CREATE_IN_PROGRESS` or `CREATE_PENDING` state.
3486
3896
  #
3487
3897
  # @option params [required, String] :stack_name
@@ -3537,7 +3947,7 @@ module Aws::CloudFormation
3537
3947
  # values that you can import into other stacks. To import values, use
3538
3948
  # the [ `Fn::ImportValue` ][1] function.
3539
3949
  #
3540
- # For more information, see [ AWS CloudFormation Export Stack Output
3950
+ # For more information, see [ CloudFormation Export Stack Output
3541
3951
  # Values][2].
3542
3952
  #
3543
3953
  #
@@ -3592,7 +4002,7 @@ module Aws::CloudFormation
3592
4002
  # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-importvalue.html
3593
4003
  #
3594
4004
  # @option params [required, String] :export_name
3595
- # The name of the exported output value. AWS CloudFormation returns the
4005
+ # The name of the exported output value. CloudFormation returns the
3596
4006
  # stack names that are importing this value.
3597
4007
  #
3598
4008
  # @option params [String] :next_token
@@ -3631,8 +4041,8 @@ module Aws::CloudFormation
3631
4041
 
3632
4042
  # Returns summary information about stack instances that are associated
3633
4043
  # with the specified stack set. You can filter for stack instances that
3634
- # are associated with a specific AWS account name or Region, or that
3635
- # have a specific status.
4044
+ # are associated with a specific Amazon Web Services account name or
4045
+ # Region, or that have a specific status.
3636
4046
  #
3637
4047
  # @option params [required, String] :stack_set_name
3638
4048
  # The name or unique ID of the stack set that you want to list stack
@@ -3656,7 +4066,8 @@ module Aws::CloudFormation
3656
4066
  # The status that stack instances are filtered by.
3657
4067
  #
3658
4068
  # @option params [String] :stack_instance_account
3659
- # The name of the AWS account that you want to list stack instances for.
4069
+ # The name of the Amazon Web Services account that you want to list
4070
+ # stack instances for.
3660
4071
  #
3661
4072
  # @option params [String] :stack_instance_region
3662
4073
  # The name of the Region where you want to list stack instances.
@@ -3674,9 +4085,10 @@ module Aws::CloudFormation
3674
4085
  # * If you are signed in to a delegated administrator account, specify
3675
4086
  # `DELEGATED_ADMIN`.
3676
4087
  #
3677
- # Your AWS account must be registered as a delegated administrator in
3678
- # the management account. For more information, see [Register a
3679
- # delegated administrator][1] in the *AWS CloudFormation User Guide*.
4088
+ # Your Amazon Web Services account must be registered as a delegated
4089
+ # administrator in the management account. For more information, see
4090
+ # [Register a delegated administrator][1] in the *CloudFormation User
4091
+ # Guide*.
3680
4092
  #
3681
4093
  #
3682
4094
  #
@@ -3771,7 +4183,7 @@ module Aws::CloudFormation
3771
4183
  # resp.stack_resource_summaries[0].physical_resource_id #=> String
3772
4184
  # resp.stack_resource_summaries[0].resource_type #=> String
3773
4185
  # resp.stack_resource_summaries[0].last_updated_timestamp #=> Time
3774
- # resp.stack_resource_summaries[0].resource_status #=> String, one of "CREATE_IN_PROGRESS", "CREATE_FAILED", "CREATE_COMPLETE", "DELETE_IN_PROGRESS", "DELETE_FAILED", "DELETE_COMPLETE", "DELETE_SKIPPED", "UPDATE_IN_PROGRESS", "UPDATE_FAILED", "UPDATE_COMPLETE", "IMPORT_FAILED", "IMPORT_COMPLETE", "IMPORT_IN_PROGRESS", "IMPORT_ROLLBACK_IN_PROGRESS", "IMPORT_ROLLBACK_FAILED", "IMPORT_ROLLBACK_COMPLETE"
4186
+ # resp.stack_resource_summaries[0].resource_status #=> String, one of "CREATE_IN_PROGRESS", "CREATE_FAILED", "CREATE_COMPLETE", "DELETE_IN_PROGRESS", "DELETE_FAILED", "DELETE_COMPLETE", "DELETE_SKIPPED", "UPDATE_IN_PROGRESS", "UPDATE_FAILED", "UPDATE_COMPLETE", "IMPORT_FAILED", "IMPORT_COMPLETE", "IMPORT_IN_PROGRESS", "IMPORT_ROLLBACK_IN_PROGRESS", "IMPORT_ROLLBACK_FAILED", "IMPORT_ROLLBACK_COMPLETE", "UPDATE_ROLLBACK_IN_PROGRESS", "UPDATE_ROLLBACK_COMPLETE", "UPDATE_ROLLBACK_FAILED", "ROLLBACK_IN_PROGRESS", "ROLLBACK_COMPLETE", "ROLLBACK_FAILED"
3775
4187
  # resp.stack_resource_summaries[0].resource_status_reason #=> String
3776
4188
  # resp.stack_resource_summaries[0].drift_information.stack_resource_drift_status #=> String, one of "IN_SYNC", "MODIFIED", "DELETED", "NOT_CHECKED"
3777
4189
  # resp.stack_resource_summaries[0].drift_information.last_check_timestamp #=> Time
@@ -3826,9 +4238,10 @@ module Aws::CloudFormation
3826
4238
  # * If you are signed in to a delegated administrator account, specify
3827
4239
  # `DELEGATED_ADMIN`.
3828
4240
  #
3829
- # Your AWS account must be registered as a delegated administrator in
3830
- # the management account. For more information, see [Register a
3831
- # delegated administrator][1] in the *AWS CloudFormation User Guide*.
4241
+ # Your Amazon Web Services account must be registered as a delegated
4242
+ # administrator in the management account. For more information, see
4243
+ # [Register a delegated administrator][1] in the *CloudFormation User
4244
+ # Guide*.
3832
4245
  #
3833
4246
  #
3834
4247
  #
@@ -3906,9 +4319,10 @@ module Aws::CloudFormation
3906
4319
  # * If you are signed in to a delegated administrator account, specify
3907
4320
  # `DELEGATED_ADMIN`.
3908
4321
  #
3909
- # Your AWS account must be registered as a delegated administrator in
3910
- # the management account. For more information, see [Register a
3911
- # delegated administrator][1] in the *AWS CloudFormation User Guide*.
4322
+ # Your Amazon Web Services account must be registered as a delegated
4323
+ # administrator in the management account. For more information, see
4324
+ # [Register a delegated administrator][1] in the *CloudFormation User
4325
+ # Guide*.
3912
4326
  #
3913
4327
  #
3914
4328
  #
@@ -3953,8 +4367,9 @@ module Aws::CloudFormation
3953
4367
  # the user.
3954
4368
  #
3955
4369
  # * \[Self-managed permissions\] If you set the `CallAs` parameter to
3956
- # `SELF` while signed in to your AWS account, `ListStackSets` returns
3957
- # all self-managed stack sets in your AWS account.
4370
+ # `SELF` while signed in to your Amazon Web Services account,
4371
+ # `ListStackSets` returns all self-managed stack sets in your Amazon
4372
+ # Web Services account.
3958
4373
  #
3959
4374
  # * \[Service-managed permissions\] If you set the `CallAs` parameter to
3960
4375
  # `SELF` while signed in to the organization's management account,
@@ -3996,9 +4411,10 @@ module Aws::CloudFormation
3996
4411
  # * If you are signed in to a delegated administrator account, specify
3997
4412
  # `DELEGATED_ADMIN`.
3998
4413
  #
3999
- # Your AWS account must be registered as a delegated administrator in
4000
- # the management account. For more information, see [Register a
4001
- # delegated administrator][1] in the *AWS CloudFormation User Guide*.
4414
+ # Your Amazon Web Services account must be registered as a delegated
4415
+ # administrator in the management account. For more information, see
4416
+ # [Register a delegated administrator][1] in the *CloudFormation User
4417
+ # Guide*.
4002
4418
  #
4003
4419
  #
4004
4420
  #
@@ -4071,7 +4487,7 @@ module Aws::CloudFormation
4071
4487
  #
4072
4488
  # resp = client.list_stacks({
4073
4489
  # next_token: "NextToken",
4074
- # stack_status_filter: ["CREATE_IN_PROGRESS"], # accepts CREATE_IN_PROGRESS, CREATE_FAILED, CREATE_COMPLETE, ROLLBACK_IN_PROGRESS, ROLLBACK_FAILED, ROLLBACK_COMPLETE, DELETE_IN_PROGRESS, DELETE_FAILED, DELETE_COMPLETE, UPDATE_IN_PROGRESS, UPDATE_COMPLETE_CLEANUP_IN_PROGRESS, UPDATE_COMPLETE, UPDATE_ROLLBACK_IN_PROGRESS, UPDATE_ROLLBACK_FAILED, UPDATE_ROLLBACK_COMPLETE_CLEANUP_IN_PROGRESS, UPDATE_ROLLBACK_COMPLETE, REVIEW_IN_PROGRESS, IMPORT_IN_PROGRESS, IMPORT_COMPLETE, IMPORT_ROLLBACK_IN_PROGRESS, IMPORT_ROLLBACK_FAILED, IMPORT_ROLLBACK_COMPLETE
4490
+ # stack_status_filter: ["CREATE_IN_PROGRESS"], # accepts CREATE_IN_PROGRESS, CREATE_FAILED, CREATE_COMPLETE, ROLLBACK_IN_PROGRESS, ROLLBACK_FAILED, ROLLBACK_COMPLETE, DELETE_IN_PROGRESS, DELETE_FAILED, DELETE_COMPLETE, UPDATE_IN_PROGRESS, UPDATE_COMPLETE_CLEANUP_IN_PROGRESS, UPDATE_COMPLETE, UPDATE_FAILED, UPDATE_ROLLBACK_IN_PROGRESS, UPDATE_ROLLBACK_FAILED, UPDATE_ROLLBACK_COMPLETE_CLEANUP_IN_PROGRESS, UPDATE_ROLLBACK_COMPLETE, REVIEW_IN_PROGRESS, IMPORT_IN_PROGRESS, IMPORT_COMPLETE, IMPORT_ROLLBACK_IN_PROGRESS, IMPORT_ROLLBACK_FAILED, IMPORT_ROLLBACK_COMPLETE
4075
4491
  # })
4076
4492
  #
4077
4493
  # @example Response structure
@@ -4083,7 +4499,7 @@ module Aws::CloudFormation
4083
4499
  # resp.stack_summaries[0].creation_time #=> Time
4084
4500
  # resp.stack_summaries[0].last_updated_time #=> Time
4085
4501
  # resp.stack_summaries[0].deletion_time #=> Time
4086
- # resp.stack_summaries[0].stack_status #=> String, one of "CREATE_IN_PROGRESS", "CREATE_FAILED", "CREATE_COMPLETE", "ROLLBACK_IN_PROGRESS", "ROLLBACK_FAILED", "ROLLBACK_COMPLETE", "DELETE_IN_PROGRESS", "DELETE_FAILED", "DELETE_COMPLETE", "UPDATE_IN_PROGRESS", "UPDATE_COMPLETE_CLEANUP_IN_PROGRESS", "UPDATE_COMPLETE", "UPDATE_ROLLBACK_IN_PROGRESS", "UPDATE_ROLLBACK_FAILED", "UPDATE_ROLLBACK_COMPLETE_CLEANUP_IN_PROGRESS", "UPDATE_ROLLBACK_COMPLETE", "REVIEW_IN_PROGRESS", "IMPORT_IN_PROGRESS", "IMPORT_COMPLETE", "IMPORT_ROLLBACK_IN_PROGRESS", "IMPORT_ROLLBACK_FAILED", "IMPORT_ROLLBACK_COMPLETE"
4502
+ # resp.stack_summaries[0].stack_status #=> String, one of "CREATE_IN_PROGRESS", "CREATE_FAILED", "CREATE_COMPLETE", "ROLLBACK_IN_PROGRESS", "ROLLBACK_FAILED", "ROLLBACK_COMPLETE", "DELETE_IN_PROGRESS", "DELETE_FAILED", "DELETE_COMPLETE", "UPDATE_IN_PROGRESS", "UPDATE_COMPLETE_CLEANUP_IN_PROGRESS", "UPDATE_COMPLETE", "UPDATE_FAILED", "UPDATE_ROLLBACK_IN_PROGRESS", "UPDATE_ROLLBACK_FAILED", "UPDATE_ROLLBACK_COMPLETE_CLEANUP_IN_PROGRESS", "UPDATE_ROLLBACK_COMPLETE", "REVIEW_IN_PROGRESS", "IMPORT_IN_PROGRESS", "IMPORT_COMPLETE", "IMPORT_ROLLBACK_IN_PROGRESS", "IMPORT_ROLLBACK_FAILED", "IMPORT_ROLLBACK_COMPLETE"
4087
4503
  # resp.stack_summaries[0].stack_status_reason #=> String
4088
4504
  # resp.stack_summaries[0].parent_id #=> String
4089
4505
  # resp.stack_summaries[0].root_id #=> String
@@ -4217,6 +4633,11 @@ module Aws::CloudFormation
4217
4633
  #
4218
4634
  # The default is `LIVE`.
4219
4635
  #
4636
+ # @option params [String] :publisher_id
4637
+ # The publisher ID of the extension publisher.
4638
+ #
4639
+ # Extensions published by Amazon are not assigned a publisher ID.
4640
+ #
4220
4641
  # @return [Types::ListTypeVersionsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
4221
4642
  #
4222
4643
  # * {Types::ListTypeVersionsOutput#type_version_summaries #type_version_summaries} => Array&lt;Types::TypeVersionSummary&gt;
@@ -4229,10 +4650,11 @@ module Aws::CloudFormation
4229
4650
  # resp = client.list_type_versions({
4230
4651
  # type: "RESOURCE", # accepts RESOURCE, MODULE
4231
4652
  # type_name: "TypeName",
4232
- # arn: "PrivateTypeArn",
4653
+ # arn: "TypeArn",
4233
4654
  # max_results: 1,
4234
4655
  # next_token: "NextToken",
4235
4656
  # deprecated_status: "LIVE", # accepts LIVE, DEPRECATED
4657
+ # publisher_id: "PublisherId",
4236
4658
  # })
4237
4659
  #
4238
4660
  # @example Response structure
@@ -4245,6 +4667,7 @@ module Aws::CloudFormation
4245
4667
  # resp.type_version_summaries[0].arn #=> String
4246
4668
  # resp.type_version_summaries[0].time_created #=> Time
4247
4669
  # resp.type_version_summaries[0].description #=> String
4670
+ # resp.type_version_summaries[0].public_version_number #=> String
4248
4671
  # resp.next_token #=> String
4249
4672
  #
4250
4673
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/ListTypeVersions AWS API Documentation
@@ -4260,36 +4683,45 @@ module Aws::CloudFormation
4260
4683
  # with CloudFormation.
4261
4684
  #
4262
4685
  # @option params [String] :visibility
4263
- # The scope at which the extension is visible and usable in
4686
+ # The scope at which the extensions are visible and usable in
4264
4687
  # CloudFormation operations.
4265
4688
  #
4266
4689
  # Valid values include:
4267
4690
  #
4268
- # * `PRIVATE`\: The extension is only visible and usable within the
4269
- # account in which it is registered. Currently, AWS CloudFormation
4270
- # marks any extension you create as `PRIVATE`.
4691
+ # * `PRIVATE`\: Extensions that are visible and usable within this
4692
+ # account and region. This includes:
4693
+ #
4694
+ # * Private extensions you have registered in this account and region.
4271
4695
  #
4272
- # * `PUBLIC`\: The extension is publically visible and usable within any
4273
- # Amazon account.
4696
+ # * Public extensions that you have activated in this account and
4697
+ # region.
4698
+ #
4699
+ # * `PUBLIC`\: Extensions that are publicly visible and available to be
4700
+ # activated within any Amazon account. This includes extensions from
4701
+ # Amazon, as well as third-party publishers.
4274
4702
  #
4275
4703
  # The default is `PRIVATE`.
4276
4704
  #
4277
4705
  # @option params [String] :provisioning_type
4278
- # The provisioning behavior of the type. AWS CloudFormation determines
4279
- # the provisioning type during registration, based on the types of
4280
- # handlers in the schema handler package submitted.
4706
+ # For resource types, the provisioning behavior of the resource type.
4707
+ # CloudFormation determines the provisioning type during registration,
4708
+ # based on the types of handlers in the schema handler package
4709
+ # submitted.
4281
4710
  #
4282
4711
  # Valid values include:
4283
4712
  #
4284
- # * `FULLY_MUTABLE`\: The extension includes an update handler to
4285
- # process updates to the extension during stack update operations.
4713
+ # * `FULLY_MUTABLE`\: The resource type includes an update handler to
4714
+ # process updates to the type during stack update operations.
4286
4715
  #
4287
- # * `IMMUTABLE`\: The extension does not include an update handler, so
4288
- # the extension cannot be updated and must instead be replaced during
4716
+ # * `IMMUTABLE`\: The resource type does not include an update handler,
4717
+ # so the type cannot be updated and must instead be replaced during
4289
4718
  # stack update operations.
4290
4719
  #
4291
- # * `NON_PROVISIONABLE`\: The extension does not include create, read,
4292
- # and delete handlers, and therefore cannot actually be provisioned.
4720
+ # * `NON_PROVISIONABLE`\: The resource type does not include create,
4721
+ # read, and delete handlers, and therefore cannot actually be
4722
+ # provisioned.
4723
+ #
4724
+ # The default is `FULLY_MUTABLE`.
4293
4725
  #
4294
4726
  # @option params [String] :deprecated_status
4295
4727
  # The deprecation status of the extension that you want to get summary
@@ -4306,6 +4738,12 @@ module Aws::CloudFormation
4306
4738
  # @option params [String] :type
4307
4739
  # The type of extension.
4308
4740
  #
4741
+ # @option params [Types::TypeFilters] :filters
4742
+ # Filter criteria to use in determining which extensions to return.
4743
+ #
4744
+ # If you specify a filter, CloudFormation ignores any specified
4745
+ # `Visibility` value when returning the list of types.
4746
+ #
4309
4747
  # @option params [Integer] :max_results
4310
4748
  # The maximum number of results to be returned with a single call. If
4311
4749
  # the number of available results exceeds this maximum, the response
@@ -4334,6 +4772,11 @@ module Aws::CloudFormation
4334
4772
  # provisioning_type: "NON_PROVISIONABLE", # accepts NON_PROVISIONABLE, IMMUTABLE, FULLY_MUTABLE
4335
4773
  # deprecated_status: "LIVE", # accepts LIVE, DEPRECATED
4336
4774
  # type: "RESOURCE", # accepts RESOURCE, MODULE
4775
+ # filters: {
4776
+ # category: "REGISTERED", # accepts REGISTERED, ACTIVATED, THIRD_PARTY, AWS_TYPES
4777
+ # publisher_id: "PublisherId",
4778
+ # type_name_prefix: "TypeNamePrefix",
4779
+ # },
4337
4780
  # max_results: 1,
4338
4781
  # next_token: "NextToken",
4339
4782
  # })
@@ -4347,6 +4790,13 @@ module Aws::CloudFormation
4347
4790
  # resp.type_summaries[0].type_arn #=> String
4348
4791
  # resp.type_summaries[0].last_updated #=> Time
4349
4792
  # resp.type_summaries[0].description #=> String
4793
+ # resp.type_summaries[0].publisher_id #=> String
4794
+ # resp.type_summaries[0].original_type_name #=> String
4795
+ # resp.type_summaries[0].public_version_number #=> String
4796
+ # resp.type_summaries[0].latest_public_version #=> String
4797
+ # resp.type_summaries[0].publisher_identity #=> String, one of "AWS_Marketplace", "GitHub", "Bitbucket"
4798
+ # resp.type_summaries[0].publisher_name #=> String
4799
+ # resp.type_summaries[0].is_activated #=> Boolean
4350
4800
  # resp.next_token #=> String
4351
4801
  #
4352
4802
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/ListTypes AWS API Documentation
@@ -4358,6 +4808,81 @@ module Aws::CloudFormation
4358
4808
  req.send_request(options)
4359
4809
  end
4360
4810
 
4811
+ # Publishes the specified extension to the CloudFormation registry as a
4812
+ # public extension in this region. Public extensions are available for
4813
+ # use by all CloudFormation users. For more information on publishing
4814
+ # extensions, see [Publishing extensions to make them available for
4815
+ # public use][1] in the *CloudFormation CLI User Guide*.
4816
+ #
4817
+ # To publish an extension, you must be registered as a publisher with
4818
+ # CloudFormation. For more information, see [RegisterPublisher][2].
4819
+ #
4820
+ #
4821
+ #
4822
+ # [1]: https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/publish-extension.html
4823
+ # [2]: https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_RegisterPublisher.html
4824
+ #
4825
+ # @option params [String] :type
4826
+ # The type of the extension.
4827
+ #
4828
+ # Conditional: You must specify `Arn`, or `TypeName` and `Type`.
4829
+ #
4830
+ # @option params [String] :arn
4831
+ # The Amazon Resource Number (ARN) of the extension.
4832
+ #
4833
+ # Conditional: You must specify `Arn`, or `TypeName` and `Type`.
4834
+ #
4835
+ # @option params [String] :type_name
4836
+ # The name of the extension.
4837
+ #
4838
+ # Conditional: You must specify `Arn`, or `TypeName` and `Type`.
4839
+ #
4840
+ # @option params [String] :public_version_number
4841
+ # The version number to assign to this version of the extension.
4842
+ #
4843
+ # Use the following format, and adhere to semantic versioning when
4844
+ # assigning a version number to your extension:
4845
+ #
4846
+ # `MAJOR.MINOR.PATCH`
4847
+ #
4848
+ # For more information, see [Semantic Versioning 2.0.0][1].
4849
+ #
4850
+ # If you do not specify a version number, CloudFormation increments the
4851
+ # version number by one minor version release.
4852
+ #
4853
+ # The first time you publish a type, CloudFormation sets the version
4854
+ # number to `1.0.0`, regardless of the value you specify.
4855
+ #
4856
+ #
4857
+ #
4858
+ # [1]: https://semver.org/
4859
+ #
4860
+ # @return [Types::PublishTypeOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
4861
+ #
4862
+ # * {Types::PublishTypeOutput#public_type_arn #public_type_arn} => String
4863
+ #
4864
+ # @example Request syntax with placeholder values
4865
+ #
4866
+ # resp = client.publish_type({
4867
+ # type: "RESOURCE", # accepts RESOURCE, MODULE
4868
+ # arn: "PrivateTypeArn",
4869
+ # type_name: "TypeName",
4870
+ # public_version_number: "PublicVersionNumber",
4871
+ # })
4872
+ #
4873
+ # @example Response structure
4874
+ #
4875
+ # resp.public_type_arn #=> String
4876
+ #
4877
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/PublishType AWS API Documentation
4878
+ #
4879
+ # @overload publish_type(params = {})
4880
+ # @param [Hash] params ({})
4881
+ def publish_type(params = {}, options = {})
4882
+ req = build_request(:publish_type, params)
4883
+ req.send_request(options)
4884
+ end
4885
+
4361
4886
  # Reports progress of a resource handler to CloudFormation.
4362
4887
  #
4363
4888
  # Reserved for use by the [CloudFormation CLI][1]. Do not use this API
@@ -4425,7 +4950,7 @@ module Aws::CloudFormation
4425
4950
  # operation_status: "PENDING", # required, accepts PENDING, IN_PROGRESS, SUCCESS, FAILED
4426
4951
  # current_operation_status: "PENDING", # accepts PENDING, IN_PROGRESS, SUCCESS, FAILED
4427
4952
  # status_message: "StatusMessage",
4428
- # error_code: "NotUpdatable", # accepts NotUpdatable, InvalidRequest, AccessDenied, InvalidCredentials, AlreadyExists, NotFound, ResourceConflict, Throttling, ServiceLimitExceeded, NotStabilized, GeneralServiceException, ServiceInternalError, NetworkFailure, InternalFailure
4953
+ # error_code: "NotUpdatable", # accepts NotUpdatable, InvalidRequest, AccessDenied, InvalidCredentials, AlreadyExists, NotFound, ResourceConflict, Throttling, ServiceLimitExceeded, NotStabilized, GeneralServiceException, ServiceInternalError, NetworkFailure, InternalFailure, InvalidTypeConfiguration
4429
4954
  # resource_model: "ResourceModel",
4430
4955
  # client_request_token: "ClientRequestToken",
4431
4956
  # })
@@ -4439,9 +4964,72 @@ module Aws::CloudFormation
4439
4964
  req.send_request(options)
4440
4965
  end
4441
4966
 
4967
+ # Registers your account as a publisher of public extensions in the
4968
+ # CloudFormation registry. Public extensions are available for use by
4969
+ # all CloudFormation users. This publisher ID applies to your account in
4970
+ # all Amazon Web Services Regions.
4971
+ #
4972
+ # For information on requirements for registering as a public extension
4973
+ # publisher, see [Registering your account to publish CloudFormation
4974
+ # extensions][1] in the *CloudFormation CLI User Guide*.
4975
+ #
4976
+ #
4977
+ #
4978
+ #
4979
+ #
4980
+ # [1]: https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/publish-extension.html#publish-extension-prereqs
4981
+ #
4982
+ # @option params [Boolean] :accept_terms_and_conditions
4983
+ # Whether you accept the [Terms and Conditions][1] for publishing
4984
+ # extensions in the CloudFormation registry. You must accept the terms
4985
+ # and conditions in order to register to publish public extensions to
4986
+ # the CloudFormation registry.
4987
+ #
4988
+ # The default is `false`.
4989
+ #
4990
+ #
4991
+ #
4992
+ # [1]: https://cloudformation-registry-documents.s3.amazonaws.com/Terms_and_Conditions_for_AWS_CloudFormation_Registry_Publishers.pdf
4993
+ #
4994
+ # @option params [String] :connection_arn
4995
+ # If you are using a Bitbucket or GitHub account for identity
4996
+ # verification, the Amazon Resource Name (ARN) for your connection to
4997
+ # that account.
4998
+ #
4999
+ # For more information, see [Registering your account to publish
5000
+ # CloudFormation extensions][1] in the *CloudFormation CLI User Guide*.
5001
+ #
5002
+ #
5003
+ #
5004
+ # [1]: https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/publish-extension.html#publish-extension-prereqs
5005
+ #
5006
+ # @return [Types::RegisterPublisherOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
5007
+ #
5008
+ # * {Types::RegisterPublisherOutput#publisher_id #publisher_id} => String
5009
+ #
5010
+ # @example Request syntax with placeholder values
5011
+ #
5012
+ # resp = client.register_publisher({
5013
+ # accept_terms_and_conditions: false,
5014
+ # connection_arn: "ConnectionArn",
5015
+ # })
5016
+ #
5017
+ # @example Response structure
5018
+ #
5019
+ # resp.publisher_id #=> String
5020
+ #
5021
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/RegisterPublisher AWS API Documentation
5022
+ #
5023
+ # @overload register_publisher(params = {})
5024
+ # @param [Hash] params ({})
5025
+ def register_publisher(params = {}, options = {})
5026
+ req = build_request(:register_publisher, params)
5027
+ req.send_request(options)
5028
+ end
5029
+
4442
5030
  # Registers an extension with the CloudFormation service. Registering an
4443
5031
  # extension makes it available for use in CloudFormation templates in
4444
- # your AWS account, and includes:
5032
+ # your Amazon Web Services account, and includes:
4445
5033
  #
4446
5034
  # * Validating the extension schema
4447
5035
  #
@@ -4463,9 +5051,17 @@ module Aws::CloudFormation
4463
5051
  # you can use ` DescribeTypeRegistration ` to monitor the progress of
4464
5052
  # the registration request.
4465
5053
  #
5054
+ # Once you have registered a private extension in your account and
5055
+ # region, use
5056
+ # [SetTypeConfiguration](AWSCloudFormation/latest/APIReference/API_SetTypeConfiguration.html)
5057
+ # to specify configuration properties for the extension. For more
5058
+ # information, see [Configuring extensions at the account level][2] in
5059
+ # the *CloudFormation User Guide*.
5060
+ #
4466
5061
  #
4467
5062
  #
4468
5063
  # [1]: https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/resource-types.html
5064
+ # [2]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/registry-register.html#registry-set-configuration
4469
5065
  #
4470
5066
  # @option params [String] :type
4471
5067
  # The kind of extension.
@@ -4473,8 +5069,13 @@ module Aws::CloudFormation
4473
5069
  # @option params [required, String] :type_name
4474
5070
  # The name of the extension being registered.
4475
5071
  #
4476
- # We recommend that extension names adhere to the following pattern:
4477
- # *company\_or\_organization*\::*service*\::*type*.
5072
+ # We recommend that extension names adhere to the following patterns:
5073
+ #
5074
+ # * For resource types,
5075
+ # *company\_or\_organization*\::*service*\::*type*.
5076
+ #
5077
+ # * For modules,
5078
+ # *company\_or\_organization*\::*service*\::*type*\::MODULE.
4478
5079
  #
4479
5080
  # <note markdown="1"> The following organization namespaces are reserved and cannot be used
4480
5081
  # in your extension names:
@@ -4504,8 +5105,8 @@ module Aws::CloudFormation
4504
5105
  # <note markdown="1"> The user registering the extension must be able to access the package
4505
5106
  # in the S3 bucket. That is, the user needs to have [GetObject][2]
4506
5107
  # permissions for the schema handler package. For more information, see
4507
- # [Actions, Resources, and Condition Keys for Amazon S3][3] in the *AWS
4508
- # Identity and Access Management User Guide*.
5108
+ # [Actions, Resources, and Condition Keys for Amazon S3][3] in the
5109
+ # *Identity and Access Management User Guide*.
4509
5110
  #
4510
5111
  # </note>
4511
5112
  #
@@ -4520,15 +5121,25 @@ module Aws::CloudFormation
4520
5121
  #
4521
5122
  # @option params [String] :execution_role_arn
4522
5123
  # The Amazon Resource Name (ARN) of the IAM role for CloudFormation to
4523
- # assume when invoking the extension. If your extension calls AWS APIs
4524
- # in any of its handlers, you must create an <i> <a
5124
+ # assume when invoking the extension.
5125
+ #
5126
+ # For CloudFormation to assume the specified execution role, the role
5127
+ # must contain a trust relationship with the CloudFormation service
5128
+ # principle (`resources.cloudformation.amazonaws.com`). For more
5129
+ # information on adding trust relationships, see [Modifying a role trust
5130
+ # policy](IAM/latest/UserGuide/roles-managingrole-editing-console.html#roles-managingrole_edit-trust-policy)
5131
+ # in the *Identity and Access Management User Guide*.
5132
+ #
5133
+ # If your extension calls Amazon Web Services APIs in any of its
5134
+ # handlers, you must create an <i> <a
4525
5135
  # href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html">IAM
4526
5136
  # execution role</a> </i> that includes the necessary permissions to
4527
- # call those AWS APIs, and provision that execution role in your
4528
- # account. When CloudFormation needs to invoke the extension handler,
4529
- # CloudFormation assumes this execution role to create a temporary
4530
- # session token, which it then passes to the extension handler, thereby
4531
- # supplying your extension with the appropriate credentials.
5137
+ # call those Amazon Web Services APIs, and provision that execution role
5138
+ # in your account. When CloudFormation needs to invoke the resource type
5139
+ # handler, CloudFormation assumes this execution role to create a
5140
+ # temporary session token, which it then passes to the resource type
5141
+ # handler, thereby supplying your resource type with the appropriate
5142
+ # credentials.
4532
5143
  #
4533
5144
  # @option params [String] :client_request_token
4534
5145
  # A unique identifier that acts as an idempotency key for this
@@ -4568,6 +5179,62 @@ module Aws::CloudFormation
4568
5179
  req.send_request(options)
4569
5180
  end
4570
5181
 
5182
+ # When specifying `RollbackStack`, you preserve the state of previously
5183
+ # provisioned resources when an operation fails. You can check the
5184
+ # status of the stack through the DescribeStacks API.
5185
+ #
5186
+ # Rolls back the specified stack to the last known stable state from
5187
+ # `CREATE_FAILED` or `UPDATE_FAILED` stack statuses.
5188
+ #
5189
+ # This operation will delete a stack if it doesn't contain a last known
5190
+ # stable state. A last known stable state includes any status in a
5191
+ # `*_COMPLETE`. This includes the following stack statuses.
5192
+ #
5193
+ # * `CREATE_COMPLETE`
5194
+ #
5195
+ # * `UPDATE_COMPLETE`
5196
+ #
5197
+ # * `UPDATE_ROLLBACK_COMPLETE`
5198
+ #
5199
+ # * `IMPORT_COMPLETE`
5200
+ #
5201
+ # * `IMPORT_ROLLBACK_COMPLETE`
5202
+ #
5203
+ # @option params [required, String] :stack_name
5204
+ # The name that is associated with the stack.
5205
+ #
5206
+ # @option params [String] :role_arn
5207
+ # The Amazon Resource Name (ARN) of an Identity and Access Management
5208
+ # role that CloudFormation assumes to rollback the stack.
5209
+ #
5210
+ # @option params [String] :client_request_token
5211
+ # A unique identifier for this `RollbackStack` request.
5212
+ #
5213
+ # @return [Types::RollbackStackOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
5214
+ #
5215
+ # * {Types::RollbackStackOutput#stack_id #stack_id} => String
5216
+ #
5217
+ # @example Request syntax with placeholder values
5218
+ #
5219
+ # resp = client.rollback_stack({
5220
+ # stack_name: "StackNameOrId", # required
5221
+ # role_arn: "RoleARN",
5222
+ # client_request_token: "ClientRequestToken",
5223
+ # })
5224
+ #
5225
+ # @example Response structure
5226
+ #
5227
+ # resp.stack_id #=> String
5228
+ #
5229
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/RollbackStack AWS API Documentation
5230
+ #
5231
+ # @overload rollback_stack(params = {})
5232
+ # @param [Hash] params ({})
5233
+ def rollback_stack(params = {}, options = {})
5234
+ req = build_request(:rollback_stack, params)
5235
+ req.send_request(options)
5236
+ end
5237
+
4571
5238
  # Sets a stack policy for a specified stack.
4572
5239
  #
4573
5240
  # @option params [required, String] :stack_name
@@ -4575,8 +5242,8 @@ module Aws::CloudFormation
4575
5242
  #
4576
5243
  # @option params [String] :stack_policy_body
4577
5244
  # Structure containing the stack policy body. For more information, go
4578
- # to [ Prevent Updates to Stack Resources][1] in the AWS CloudFormation
4579
- # User Guide. You can specify either the `StackPolicyBody` or the
5245
+ # to [ Prevent Updates to Stack Resources][1] in the CloudFormation User
5246
+ # Guide. You can specify either the `StackPolicyBody` or the
4580
5247
  # `StackPolicyURL` parameter, but not both.
4581
5248
  #
4582
5249
  #
@@ -4608,6 +5275,101 @@ module Aws::CloudFormation
4608
5275
  req.send_request(options)
4609
5276
  end
4610
5277
 
5278
+ # Specifies the configuration data for a registered CloudFormation
5279
+ # extension, in the given account and region.
5280
+ #
5281
+ # To view the current configuration data for an extension, refer to the
5282
+ # `ConfigurationSchema` element of
5283
+ # [DescribeType](AWSCloudFormation/latest/APIReference/API_DescribeType.html).
5284
+ # For more information, see [Configuring extensions at the account
5285
+ # level][1] in the *CloudFormation User Guide*.
5286
+ #
5287
+ # It is strongly recommended that you use dynamic references to restrict
5288
+ # sensitive configuration definitions, such as third-party credentials.
5289
+ # For more details on dynamic references, see [Using dynamic references
5290
+ # to specify template values][2] in the *CloudFormation User Guide*.
5291
+ #
5292
+ #
5293
+ #
5294
+ # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/registry-register.html#registry-set-configuration
5295
+ # [2]: https://docs.aws.amazon.com/
5296
+ #
5297
+ # @option params [String] :type_arn
5298
+ # The Amazon Resource Name (ARN) for the extension, in this account and
5299
+ # region.
5300
+ #
5301
+ # For public extensions, this will be the ARN assigned when you
5302
+ # [activate the type][1] in this account and region. For private
5303
+ # extensions, this will be the ARN assigned when you [register the
5304
+ # type][2] in this account and region.
5305
+ #
5306
+ # Do not include the extension versions suffix at the end of the ARN.
5307
+ # You can set the configuration for an extension, but not for a specific
5308
+ # extension version.
5309
+ #
5310
+ #
5311
+ #
5312
+ # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_ActivateType.html
5313
+ # [2]: https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_RegisterType.html
5314
+ #
5315
+ # @option params [required, String] :configuration
5316
+ # The configuration data for the extension, in this account and region.
5317
+ #
5318
+ # The configuration data must be formatted as JSON, and validate against
5319
+ # the schema returned in the `ConfigurationSchema` response element of
5320
+ # [API\_DescribeType](AWSCloudFormation/latest/APIReference/API_DescribeType.html).
5321
+ # For more information, see [Defining account-level configuration data
5322
+ # for an extension][1] in the *CloudFormation CLI User Guide*.
5323
+ #
5324
+ #
5325
+ #
5326
+ # [1]: https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/resource-type-model.html#resource-type-howto-configuration
5327
+ #
5328
+ # @option params [String] :configuration_alias
5329
+ # An alias by which to refer to this extension configuration data.
5330
+ #
5331
+ # Conditional: Specifying a configuration alias is required when setting
5332
+ # a configuration for a resource type extension.
5333
+ #
5334
+ # @option params [String] :type_name
5335
+ # The name of the extension.
5336
+ #
5337
+ # Conditional: You must specify `ConfigurationArn`, or `Type` and
5338
+ # `TypeName`.
5339
+ #
5340
+ # @option params [String] :type
5341
+ # The type of extension.
5342
+ #
5343
+ # Conditional: You must specify `ConfigurationArn`, or `Type` and
5344
+ # `TypeName`.
5345
+ #
5346
+ # @return [Types::SetTypeConfigurationOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
5347
+ #
5348
+ # * {Types::SetTypeConfigurationOutput#configuration_arn #configuration_arn} => String
5349
+ #
5350
+ # @example Request syntax with placeholder values
5351
+ #
5352
+ # resp = client.set_type_configuration({
5353
+ # type_arn: "TypeArn",
5354
+ # configuration: "TypeConfiguration", # required
5355
+ # configuration_alias: "TypeConfigurationAlias",
5356
+ # type_name: "TypeName",
5357
+ # type: "RESOURCE", # accepts RESOURCE, MODULE
5358
+ # })
5359
+ #
5360
+ # @example Response structure
5361
+ #
5362
+ # resp.configuration_arn #=> String
5363
+ #
5364
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/SetTypeConfiguration AWS API Documentation
5365
+ #
5366
+ # @overload set_type_configuration(params = {})
5367
+ # @param [Hash] params ({})
5368
+ def set_type_configuration(params = {}, options = {})
5369
+ req = build_request(:set_type_configuration, params)
5370
+ req.send_request(options)
5371
+ end
5372
+
4611
5373
  # Specify the default version of an extension. The default version of an
4612
5374
  # extension will be used in CloudFormation operations.
4613
5375
  #
@@ -4654,11 +5416,11 @@ module Aws::CloudFormation
4654
5416
 
4655
5417
  # Sends a signal to the specified resource with a success or failure
4656
5418
  # status. You can use the SignalResource API in conjunction with a
4657
- # creation policy or update policy. AWS CloudFormation doesn't proceed
4658
- # with a stack creation or update until resources receive the required
4659
- # number of signals or the timeout period is exceeded. The
4660
- # SignalResource API is useful in cases where you want to send signals
4661
- # from anywhere other than an Amazon EC2 instance.
5419
+ # creation policy or update policy. CloudFormation doesn't proceed with
5420
+ # a stack creation or update until resources receive the required number
5421
+ # of signals or the timeout period is exceeded. The SignalResource API
5422
+ # is useful in cases where you want to send signals from anywhere other
5423
+ # than an Amazon EC2 instance.
4662
5424
  #
4663
5425
  # @option params [required, String] :stack_name
4664
5426
  # The stack name or unique stack ID that includes the resource that you
@@ -4677,7 +5439,7 @@ module Aws::CloudFormation
4677
5439
  #
4678
5440
  # @option params [required, String] :status
4679
5441
  # The status of the signal, which is either success or failure. A
4680
- # failure signal causes AWS CloudFormation to immediately fail the stack
5442
+ # failure signal causes CloudFormation to immediately fail the stack
4681
5443
  # creation or update.
4682
5444
  #
4683
5445
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
@@ -4723,9 +5485,10 @@ module Aws::CloudFormation
4723
5485
  # * If you are signed in to a delegated administrator account, specify
4724
5486
  # `DELEGATED_ADMIN`.
4725
5487
  #
4726
- # Your AWS account must be registered as a delegated administrator in
4727
- # the management account. For more information, see [Register a
4728
- # delegated administrator][1] in the *AWS CloudFormation User Guide*.
5488
+ # Your Amazon Web Services account must be registered as a delegated
5489
+ # administrator in the management account. For more information, see
5490
+ # [Register a delegated administrator][1] in the *CloudFormation User
5491
+ # Guide*.
4729
5492
  #
4730
5493
  #
4731
5494
  #
@@ -4750,6 +5513,115 @@ module Aws::CloudFormation
4750
5513
  req.send_request(options)
4751
5514
  end
4752
5515
 
5516
+ # Tests a registered extension to make sure it meets all necessary
5517
+ # requirements for being published in the CloudFormation registry.
5518
+ #
5519
+ # * For resource types, this includes passing all contracts tests
5520
+ # defined for the type.
5521
+ #
5522
+ # * For modules, this includes determining if the module's model meets
5523
+ # all necessary requirements.
5524
+ #
5525
+ # For more information, see [Testing your public extension prior to
5526
+ # publishing][1] in the *CloudFormation CLI User Guide*.
5527
+ #
5528
+ # If you do not specify a version, CloudFormation uses the default
5529
+ # version of the extension in your account and region for testing.
5530
+ #
5531
+ # To perform testing, CloudFormation assumes the execution role
5532
+ # specified when the type was registered. For more information, see
5533
+ # [RegisterType](AWSCloudFormation/latest/APIReference/API_RegisterType.html).
5534
+ #
5535
+ # Once you've initiated testing on an extension using `TestType`, you
5536
+ # can use [DescribeType][2] to monitor the current test status and test
5537
+ # status description for the extension.
5538
+ #
5539
+ # An extension must have a test status of `PASSED` before it can be
5540
+ # published. For more information, see [Publishing extensions to make
5541
+ # them available for public use][3] in the *CloudFormation CLI User
5542
+ # Guide*.
5543
+ #
5544
+ #
5545
+ #
5546
+ # [1]: https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/publish-extension.html#publish-extension-testing
5547
+ # [2]: https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_DescribeType.html
5548
+ # [3]: https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/resource-type-publish.html
5549
+ #
5550
+ # @option params [String] :arn
5551
+ # The Amazon Resource Number (ARN) of the extension.
5552
+ #
5553
+ # Conditional: You must specify `Arn`, or `TypeName` and `Type`.
5554
+ #
5555
+ # @option params [String] :type
5556
+ # The type of the extension to test.
5557
+ #
5558
+ # Conditional: You must specify `Arn`, or `TypeName` and `Type`.
5559
+ #
5560
+ # @option params [String] :type_name
5561
+ # The name of the extension to test.
5562
+ #
5563
+ # Conditional: You must specify `Arn`, or `TypeName` and `Type`.
5564
+ #
5565
+ # @option params [String] :version_id
5566
+ # The version of the extension to test.
5567
+ #
5568
+ # You can specify the version id with either `Arn`, or with `TypeName`
5569
+ # and `Type`.
5570
+ #
5571
+ # If you do not specify a version, CloudFormation uses the default
5572
+ # version of the extension in this account and region for testing.
5573
+ #
5574
+ # @option params [String] :log_delivery_bucket
5575
+ # The S3 bucket to which CloudFormation delivers the contract test
5576
+ # execution logs.
5577
+ #
5578
+ # CloudFormation delivers the logs by the time contract testing has
5579
+ # completed and the extension has been assigned a test type status of
5580
+ # `PASSED` or `FAILED`.
5581
+ #
5582
+ # The user calling `TestType` must be able to access items in the
5583
+ # specified S3 bucket. Specifically, the user needs the following
5584
+ # permissions:
5585
+ #
5586
+ # * GetObject
5587
+ #
5588
+ # * PutObject
5589
+ #
5590
+ # For more information, see [Actions, Resources, and Condition Keys for
5591
+ # Amazon S3][1] in the *Amazon Web Services Identity and Access
5592
+ # Management User Guide*.
5593
+ #
5594
+ #
5595
+ #
5596
+ # [1]: https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazons3.html
5597
+ #
5598
+ # @return [Types::TestTypeOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
5599
+ #
5600
+ # * {Types::TestTypeOutput#type_version_arn #type_version_arn} => String
5601
+ #
5602
+ # @example Request syntax with placeholder values
5603
+ #
5604
+ # resp = client.test_type({
5605
+ # arn: "TypeArn",
5606
+ # type: "RESOURCE", # accepts RESOURCE, MODULE
5607
+ # type_name: "TypeName",
5608
+ # version_id: "TypeVersionId",
5609
+ # log_delivery_bucket: "S3Bucket",
5610
+ # })
5611
+ #
5612
+ # @example Response structure
5613
+ #
5614
+ # resp.type_version_arn #=> String
5615
+ #
5616
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/TestType AWS API Documentation
5617
+ #
5618
+ # @overload test_type(params = {})
5619
+ # @param [Hash] params ({})
5620
+ def test_type(params = {}, options = {})
5621
+ req = build_request(:test_type, params)
5622
+ req.send_request(options)
5623
+ end
5624
+
4753
5625
  # Updates a stack as specified in the template. After the call completes
4754
5626
  # successfully, the stack update starts. You can check the status of the
4755
5627
  # stack via the DescribeStacks action.
@@ -4771,7 +5643,7 @@ module Aws::CloudFormation
4771
5643
  # @option params [String] :template_body
4772
5644
  # Structure containing the template body with a minimum length of 1 byte
4773
5645
  # and a maximum length of 51,200 bytes. (For more information, go to
4774
- # [Template Anatomy][1] in the AWS CloudFormation User Guide.)
5646
+ # [Template Anatomy][1] in the CloudFormation User Guide.)
4775
5647
  #
4776
5648
  # Conditional: You must specify only one of the following parameters:
4777
5649
  # `TemplateBody`, `TemplateURL`, or set the `UsePreviousTemplate` to
@@ -4784,7 +5656,7 @@ module Aws::CloudFormation
4784
5656
  # @option params [String] :template_url
4785
5657
  # Location of file containing the template body. The URL must point to a
4786
5658
  # template that is located in an Amazon S3 bucket or a Systems Manager
4787
- # document. For more information, go to [Template Anatomy][1] in the AWS
5659
+ # document. For more information, go to [Template Anatomy][1] in the
4788
5660
  # CloudFormation User Guide.
4789
5661
  #
4790
5662
  # Conditional: You must specify only one of the following parameters:
@@ -4835,16 +5707,16 @@ module Aws::CloudFormation
4835
5707
  #
4836
5708
  # @option params [Array<String>] :capabilities
4837
5709
  # In some cases, you must explicitly acknowledge that your stack
4838
- # template contains certain capabilities in order for AWS CloudFormation
4839
- # to update the stack.
5710
+ # template contains certain capabilities in order for CloudFormation to
5711
+ # update the stack.
4840
5712
  #
4841
5713
  # * `CAPABILITY_IAM` and `CAPABILITY_NAMED_IAM`
4842
5714
  #
4843
5715
  # Some stack templates might include resources that can affect
4844
- # permissions in your AWS account; for example, by creating new AWS
4845
- # Identity and Access Management (IAM) users. For those stacks, you
4846
- # must explicitly acknowledge this by specifying one of these
4847
- # capabilities.
5716
+ # permissions in your Amazon Web Services account; for example, by
5717
+ # creating new Identity and Access Management (IAM) users. For those
5718
+ # stacks, you must explicitly acknowledge this by specifying one of
5719
+ # these capabilities.
4848
5720
  #
4849
5721
  # The following IAM resources require you to specify either the
4850
5722
  # `CAPABILITY_IAM` or `CAPABILITY_NAMED_IAM` capability.
@@ -4854,8 +5726,8 @@ module Aws::CloudFormation
4854
5726
  # * If you have IAM resources with custom names, you *must* specify
4855
5727
  # `CAPABILITY_NAMED_IAM`.
4856
5728
  #
4857
- # * If you don't specify either of these capabilities, AWS
4858
- # CloudFormation returns an `InsufficientCapabilities` error.
5729
+ # * If you don't specify either of these capabilities, CloudFormation
5730
+ # returns an `InsufficientCapabilities` error.
4859
5731
  #
4860
5732
  # If your stack template contains these resources, we recommend that
4861
5733
  # you review all permissions associated with them and edit their
@@ -4875,7 +5747,7 @@ module Aws::CloudFormation
4875
5747
  #
4876
5748
  # * [ AWS::IAM::UserToGroupAddition][7]
4877
5749
  #
4878
- # For more information, see [Acknowledging IAM Resources in AWS
5750
+ # For more information, see [Acknowledging IAM Resources in
4879
5751
  # CloudFormation Templates][8].
4880
5752
  #
4881
5753
  # * `CAPABILITY_AUTO_EXPAND`
@@ -4890,7 +5762,7 @@ module Aws::CloudFormation
4890
5762
  # update a stack directly from the processed template, without first
4891
5763
  # reviewing the resulting changes in a change set, you must
4892
5764
  # acknowledge this capability. This includes the [AWS::Include][9] and
4893
- # [AWS::Serverless][10] transforms, which are macros hosted by AWS
5765
+ # [AWS::Serverless][10] transforms, which are macros hosted by
4894
5766
  # CloudFormation.
4895
5767
  #
4896
5768
  # If you want to update a stack from a stack template that contains
@@ -4902,11 +5774,11 @@ module Aws::CloudFormation
4902
5774
  #
4903
5775
  # Each macro relies on an underlying Lambda service function for
4904
5776
  # processing stack templates. Be aware that the Lambda function owner
4905
- # can update the function operation without AWS CloudFormation being
5777
+ # can update the function operation without CloudFormation being
4906
5778
  # notified.
4907
5779
  #
4908
- # For more information, see [Using AWS CloudFormation Macros to
4909
- # Perform Custom Processing on Templates][11].
5780
+ # For more information, see [Using CloudFormation Macros to Perform
5781
+ # Custom Processing on Templates][11].
4910
5782
  #
4911
5783
  #
4912
5784
  #
@@ -4928,33 +5800,32 @@ module Aws::CloudFormation
4928
5800
  # or `Custom::MyCustomInstance`.
4929
5801
  #
4930
5802
  # If the list of resource types doesn't include a resource that you're
4931
- # updating, the stack update fails. By default, AWS CloudFormation
4932
- # grants permissions to all resource types. AWS Identity and Access
4933
- # Management (IAM) uses this parameter for AWS CloudFormation-specific
4934
- # condition keys in IAM policies. For more information, see [Controlling
4935
- # Access with AWS Identity and Access Management][1].
5803
+ # updating, the stack update fails. By default, CloudFormation grants
5804
+ # permissions to all resource types. Identity and Access Management
5805
+ # (IAM) uses this parameter for CloudFormation-specific condition keys
5806
+ # in IAM policies. For more information, see [Controlling Access with
5807
+ # Identity and Access Management][1].
4936
5808
  #
4937
5809
  #
4938
5810
  #
4939
5811
  # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html
4940
5812
  #
4941
5813
  # @option params [String] :role_arn
4942
- # The Amazon Resource Name (ARN) of an AWS Identity and Access
4943
- # Management (IAM) role that AWS CloudFormation assumes to update the
4944
- # stack. AWS CloudFormation uses the role's credentials to make calls
4945
- # on your behalf. AWS CloudFormation always uses this role for all
4946
- # future operations on the stack. As long as users have permission to
4947
- # operate on the stack, AWS CloudFormation uses this role even if the
4948
- # users don't have permission to pass it. Ensure that the role grants
4949
- # least privilege.
4950
- #
4951
- # If you don't specify a value, AWS CloudFormation uses the role that
4952
- # was previously associated with the stack. If no role is available, AWS
5814
+ # The Amazon Resource Name (ARN) of an Identity and Access Management
5815
+ # (IAM) role that CloudFormation assumes to update the stack.
5816
+ # CloudFormation uses the role's credentials to make calls on your
5817
+ # behalf. CloudFormation always uses this role for all future operations
5818
+ # on the stack. As long as users have permission to operate on the
5819
+ # stack, CloudFormation uses this role even if the users don't have
5820
+ # permission to pass it. Ensure that the role grants least privilege.
5821
+ #
5822
+ # If you don't specify a value, CloudFormation uses the role that was
5823
+ # previously associated with the stack. If no role is available,
4953
5824
  # CloudFormation uses a temporary session that is generated from your
4954
5825
  # user credentials.
4955
5826
  #
4956
5827
  # @option params [Types::RollbackConfiguration] :rollback_configuration
4957
- # The rollback triggers for AWS CloudFormation to monitor during stack
5828
+ # The rollback triggers for CloudFormation to monitor during stack
4958
5829
  # creation and updating operations, and for the specified monitoring
4959
5830
  # period afterwards.
4960
5831
  #
@@ -4980,23 +5851,29 @@ module Aws::CloudFormation
4980
5851
  #
4981
5852
  # @option params [Array<String>] :notification_arns
4982
5853
  # Amazon Simple Notification Service topic Amazon Resource Names (ARNs)
4983
- # that AWS CloudFormation associates with the stack. Specify an empty
4984
- # list to remove all notification topics.
5854
+ # that CloudFormation associates with the stack. Specify an empty list
5855
+ # to remove all notification topics.
4985
5856
  #
4986
5857
  # @option params [Array<Types::Tag>] :tags
4987
- # Key-value pairs to associate with this stack. AWS CloudFormation also
5858
+ # Key-value pairs to associate with this stack. CloudFormation also
4988
5859
  # propagates these tags to supported resources in the stack. You can
4989
5860
  # specify a maximum number of 50 tags.
4990
5861
  #
4991
- # If you don't specify this parameter, AWS CloudFormation doesn't
4992
- # modify the stack's tags. If you specify an empty value, AWS
4993
- # CloudFormation removes all associated tags.
5862
+ # If you don't specify this parameter, CloudFormation doesn't modify
5863
+ # the stack's tags. If you specify an empty value, CloudFormation
5864
+ # removes all associated tags.
5865
+ #
5866
+ # @option params [Boolean] :disable_rollback
5867
+ # Preserve the state of previously provisioned resources when an
5868
+ # operation fails.
5869
+ #
5870
+ # Default: `False`
4994
5871
  #
4995
5872
  # @option params [String] :client_request_token
4996
5873
  # A unique identifier for this `UpdateStack` request. Specify this token
4997
- # if you plan to retry requests so that AWS CloudFormation knows that
5874
+ # if you plan to retry requests so that CloudFormation knows that
4998
5875
  # you're not attempting to update a stack with the same name. You might
4999
- # retry `UpdateStack` requests to ensure that AWS CloudFormation
5876
+ # retry `UpdateStack` requests to ensure that CloudFormation
5000
5877
  # successfully received them.
5001
5878
  #
5002
5879
  # All events triggered by a given stack operation are assigned the same
@@ -5055,6 +5932,7 @@ module Aws::CloudFormation
5055
5932
  # value: "TagValue", # required
5056
5933
  # },
5057
5934
  # ],
5935
+ # disable_rollback: false,
5058
5936
  # client_request_token: "ClientRequestToken",
5059
5937
  # })
5060
5938
  #
@@ -5102,16 +5980,16 @@ module Aws::CloudFormation
5102
5980
  # instances.
5103
5981
  #
5104
5982
  # @option params [Array<String>] :accounts
5105
- # \[Self-managed permissions\] The names of one or more AWS accounts for
5106
- # which you want to update parameter values for stack instances. The
5107
- # overridden parameter values will be applied to all stack instances in
5108
- # the specified accounts and Regions.
5983
+ # \[Self-managed permissions\] The names of one or more Amazon Web
5984
+ # Services accounts for which you want to update parameter values for
5985
+ # stack instances. The overridden parameter values will be applied to
5986
+ # all stack instances in the specified accounts and Regions.
5109
5987
  #
5110
5988
  # You can specify `Accounts` or `DeploymentTargets`, but not both.
5111
5989
  #
5112
5990
  # @option params [Types::DeploymentTargets] :deployment_targets
5113
- # \[Service-managed permissions\] The AWS Organizations accounts for
5114
- # which you want to update parameter values for stack instances. If your
5991
+ # \[Service-managed permissions\] The Organizations accounts for which
5992
+ # you want to update parameter values for stack instances. If your
5115
5993
  # update targets OUs, the overridden parameter values only apply to the
5116
5994
  # accounts that are currently in the target OUs and their child OUs.
5117
5995
  # Accounts added to the target OUs and their child OUs in the future
@@ -5130,24 +6008,19 @@ module Aws::CloudFormation
5130
6008
  #
5131
6009
  # Any overridden parameter values will be applied to all stack instances
5132
6010
  # in the specified accounts and Regions. When specifying parameters and
5133
- # their values, be aware of how AWS CloudFormation sets parameter values
6011
+ # their values, be aware of how CloudFormation sets parameter values
5134
6012
  # during stack instance update operations:
5135
6013
  #
5136
6014
  # * To override the current value for a parameter, include the parameter
5137
6015
  # and specify its value.
5138
6016
  #
5139
- # * To leave a parameter set to its present value, you can do one of the
5140
- # following:
5141
- #
5142
- # * Do not include the parameter in the list.
5143
- #
5144
- # * Include the parameter and specify `UsePreviousValue` as `true`.
5145
- # (You cannot specify both a value and set `UsePreviousValue` to
5146
- # `true`.)
6017
+ # * To leave an overridden parameter set to its present value, include
6018
+ # the parameter and specify `UsePreviousValue` as `true`. (You cannot
6019
+ # specify both a value and set `UsePreviousValue` to `true`.)
5147
6020
  #
5148
- # * To set all overridden parameter back to the values specified in the
5149
- # stack set, specify a parameter list but do not include any
5150
- # parameters.
6021
+ # * To set an overridden parameter back to the value specified in the
6022
+ # stack set, specify a parameter list but do not include the parameter
6023
+ # in the list.
5151
6024
  #
5152
6025
  # * To leave all parameters set to their present values, do not specify
5153
6026
  # this property at all.
@@ -5170,17 +6043,16 @@ module Aws::CloudFormation
5170
6043
  # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_UpdateStackSet.html
5171
6044
  #
5172
6045
  # @option params [Types::StackSetOperationPreferences] :operation_preferences
5173
- # Preferences for how AWS CloudFormation performs this stack set
5174
- # operation.
6046
+ # Preferences for how CloudFormation performs this stack set operation.
5175
6047
  #
5176
6048
  # @option params [String] :operation_id
5177
6049
  # The unique identifier for this stack set operation.
5178
6050
  #
5179
6051
  # The operation ID also functions as an idempotency token, to ensure
5180
- # that AWS CloudFormation performs the stack set operation only once,
5181
- # even if you retry the request multiple times. You might retry stack
5182
- # set operation requests to ensure that AWS CloudFormation successfully
5183
- # received them.
6052
+ # that CloudFormation performs the stack set operation only once, even
6053
+ # if you retry the request multiple times. You might retry stack set
6054
+ # operation requests to ensure that CloudFormation successfully received
6055
+ # them.
5184
6056
  #
5185
6057
  # If you don't specify an operation ID, the SDK generates one
5186
6058
  # automatically.
@@ -5201,9 +6073,10 @@ module Aws::CloudFormation
5201
6073
  # * If you are signed in to a delegated administrator account, specify
5202
6074
  # `DELEGATED_ADMIN`.
5203
6075
  #
5204
- # Your AWS account must be registered as a delegated administrator in
5205
- # the management account. For more information, see [Register a
5206
- # delegated administrator][1] in the *AWS CloudFormation User Guide*.
6076
+ # Your Amazon Web Services account must be registered as a delegated
6077
+ # administrator in the management account. For more information, see
6078
+ # [Register a delegated administrator][1] in the *CloudFormation User
6079
+ # Guide*.
5207
6080
  #
5208
6081
  #
5209
6082
  #
@@ -5275,7 +6148,7 @@ module Aws::CloudFormation
5275
6148
  # @option params [String] :template_body
5276
6149
  # The structure that contains the template body, with a minimum length
5277
6150
  # of 1 byte and a maximum length of 51,200 bytes. For more information,
5278
- # see [Template Anatomy][1] in the AWS CloudFormation User Guide.
6151
+ # see [Template Anatomy][1] in the CloudFormation User Guide.
5279
6152
  #
5280
6153
  # Conditional: You must specify only one of the following parameters:
5281
6154
  # `TemplateBody` or `TemplateURL`—or set `UsePreviousTemplate` to true.
@@ -5288,7 +6161,7 @@ module Aws::CloudFormation
5288
6161
  # The location of the file that contains the template body. The URL must
5289
6162
  # point to a template (maximum size: 460,800 bytes) that is located in
5290
6163
  # an Amazon S3 bucket or a Systems Manager document. For more
5291
- # information, see [Template Anatomy][1] in the AWS CloudFormation User
6164
+ # information, see [Template Anatomy][1] in the CloudFormation User
5292
6165
  # Guide.
5293
6166
  #
5294
6167
  # Conditional: You must specify only one of the following parameters:
@@ -5310,16 +6183,16 @@ module Aws::CloudFormation
5310
6183
  #
5311
6184
  # @option params [Array<String>] :capabilities
5312
6185
  # In some cases, you must explicitly acknowledge that your stack
5313
- # template contains certain capabilities in order for AWS CloudFormation
5314
- # to update the stack set and its associated stack instances.
6186
+ # template contains certain capabilities in order for CloudFormation to
6187
+ # update the stack set and its associated stack instances.
5315
6188
  #
5316
6189
  # * `CAPABILITY_IAM` and `CAPABILITY_NAMED_IAM`
5317
6190
  #
5318
6191
  # Some stack templates might include resources that can affect
5319
- # permissions in your AWS account; for example, by creating new AWS
5320
- # Identity and Access Management (IAM) users. For those stacks sets,
5321
- # you must explicitly acknowledge this by specifying one of these
5322
- # capabilities.
6192
+ # permissions in your Amazon Web Services account; for example, by
6193
+ # creating new Identity and Access Management (IAM) users. For those
6194
+ # stacks sets, you must explicitly acknowledge this by specifying one
6195
+ # of these capabilities.
5323
6196
  #
5324
6197
  # The following IAM resources require you to specify either the
5325
6198
  # `CAPABILITY_IAM` or `CAPABILITY_NAMED_IAM` capability.
@@ -5329,8 +6202,8 @@ module Aws::CloudFormation
5329
6202
  # * If you have IAM resources with custom names, you *must* specify
5330
6203
  # `CAPABILITY_NAMED_IAM`.
5331
6204
  #
5332
- # * If you don't specify either of these capabilities, AWS
5333
- # CloudFormation returns an `InsufficientCapabilities` error.
6205
+ # * If you don't specify either of these capabilities, CloudFormation
6206
+ # returns an `InsufficientCapabilities` error.
5334
6207
  #
5335
6208
  # If your stack template contains these resources, we recommend that
5336
6209
  # you review all permissions associated with them and edit their
@@ -5350,7 +6223,7 @@ module Aws::CloudFormation
5350
6223
  #
5351
6224
  # * [ AWS::IAM::UserToGroupAddition][7]
5352
6225
  #
5353
- # For more information, see [Acknowledging IAM Resources in AWS
6226
+ # For more information, see [Acknowledging IAM Resources in
5354
6227
  # CloudFormation Templates][8].
5355
6228
  #
5356
6229
  # * `CAPABILITY_AUTO_EXPAND`
@@ -5360,13 +6233,13 @@ module Aws::CloudFormation
5360
6233
  # directly from the processed template, without first reviewing the
5361
6234
  # resulting changes in a change set. To update the stack set directly,
5362
6235
  # you must acknowledge this capability. For more information, see
5363
- # [Using AWS CloudFormation Macros to Perform Custom Processing on
6236
+ # [Using CloudFormation Macros to Perform Custom Processing on
5364
6237
  # Templates][9].
5365
6238
  #
5366
6239
  # Stack sets with service-managed permissions do not currently support
5367
6240
  # the use of macros in templates. (This includes the
5368
6241
  # [AWS::Include][10] and [AWS::Serverless][11] transforms, which are
5369
- # macros hosted by AWS CloudFormation.) Even if you specify this
6242
+ # macros hosted by CloudFormation.) Even if you specify this
5370
6243
  # capability for a stack set with service-managed permissions, if you
5371
6244
  # reference a macro in your template the stack set operation will
5372
6245
  # fail.
@@ -5387,15 +6260,15 @@ module Aws::CloudFormation
5387
6260
  #
5388
6261
  # @option params [Array<Types::Tag>] :tags
5389
6262
  # The key-value pairs to associate with this stack set and the stacks
5390
- # created from it. AWS CloudFormation also propagates these tags to
6263
+ # created from it. CloudFormation also propagates these tags to
5391
6264
  # supported resources that are created in the stacks. You can specify a
5392
6265
  # maximum number of 50 tags.
5393
6266
  #
5394
6267
  # If you specify tags for this parameter, those tags replace any list of
5395
6268
  # tags that are currently associated with this stack set. This means:
5396
6269
  #
5397
- # * If you don't specify this parameter, AWS CloudFormation doesn't
5398
- # modify the stack's tags.
6270
+ # * If you don't specify this parameter, CloudFormation doesn't modify
6271
+ # the stack's tags.
5399
6272
  #
5400
6273
  # * If you specify *any* tags using this parameter, you must specify
5401
6274
  # *all* the tags that you want associated with this stack set, even
@@ -5404,21 +6277,20 @@ module Aws::CloudFormation
5404
6277
  # you don't include in the updated list of tags are removed from the
5405
6278
  # stack set, and therefore from the stacks and resources as well.
5406
6279
  #
5407
- # * If you specify an empty value, AWS CloudFormation removes all
5408
- # currently associated tags.
6280
+ # * If you specify an empty value, CloudFormation removes all currently
6281
+ # associated tags.
5409
6282
  #
5410
- # If you specify new tags as part of an `UpdateStackSet` action, AWS
6283
+ # If you specify new tags as part of an `UpdateStackSet` action,
5411
6284
  # CloudFormation checks to see if you have the required IAM permission
5412
6285
  # to tag resources. If you omit tags that are currently associated with
5413
- # the stack set from the list of tags you specify, AWS CloudFormation
6286
+ # the stack set from the list of tags you specify, CloudFormation
5414
6287
  # assumes that you want to remove those tags from the stack set, and
5415
6288
  # checks to see if you have permission to untag resources. If you don't
5416
6289
  # have the necessary permission(s), the entire `UpdateStackSet` action
5417
6290
  # fails with an `access denied` error, and the stack set is not updated.
5418
6291
  #
5419
6292
  # @option params [Types::StackSetOperationPreferences] :operation_preferences
5420
- # Preferences for how AWS CloudFormation performs this stack set
5421
- # operation.
6293
+ # Preferences for how CloudFormation performs this stack set operation.
5422
6294
  #
5423
6295
  # @option params [String] :administration_role_arn
5424
6296
  # The Amazon Resource Number (ARN) of the IAM role to use to update this
@@ -5427,8 +6299,8 @@ module Aws::CloudFormation
5427
6299
  # Specify an IAM role only if you are using customized administrator
5428
6300
  # roles to control which users or groups can manage specific stack sets
5429
6301
  # within the same administrator account. For more information, see
5430
- # [Granting Permissions for Stack Set Operations][1] in the *AWS
5431
- # CloudFormation User Guide*.
6302
+ # [Granting Permissions for Stack Set Operations][1] in the
6303
+ # *CloudFormation User Guide*.
5432
6304
  #
5433
6305
  # If you specified a customized administrator role when you created the
5434
6306
  # stack set, you must specify a customized administrator role, even if
@@ -5441,7 +6313,7 @@ module Aws::CloudFormation
5441
6313
  #
5442
6314
  # @option params [String] :execution_role_name
5443
6315
  # The name of the IAM execution role to use to update the stack set. If
5444
- # you do not specify an execution role, AWS CloudFormation uses the
6316
+ # you do not specify an execution role, CloudFormation uses the
5445
6317
  # `AWSCloudFormationStackSetExecutionRole` role for the stack set
5446
6318
  # operation.
5447
6319
  #
@@ -5449,27 +6321,27 @@ module Aws::CloudFormation
5449
6321
  # to control which stack resources users and groups can include in their
5450
6322
  # stack sets.
5451
6323
  #
5452
- # If you specify a customized execution role, AWS CloudFormation uses
5453
- # that role to update the stack. If you do not specify a customized
5454
- # execution role, AWS CloudFormation performs the update using the role
5455
- # previously associated with the stack set, so long as you have
5456
- # permissions to perform operations on the stack set.
6324
+ # If you specify a customized execution role, CloudFormation uses that
6325
+ # role to update the stack. If you do not specify a customized execution
6326
+ # role, CloudFormation performs the update using the role previously
6327
+ # associated with the stack set, so long as you have permissions to
6328
+ # perform operations on the stack set.
5457
6329
  #
5458
6330
  # @option params [Types::DeploymentTargets] :deployment_targets
5459
- # \[Service-managed permissions\] The AWS Organizations accounts in
5460
- # which to update associated stack instances.
6331
+ # \[Service-managed permissions\] The Organizations accounts in which to
6332
+ # update associated stack instances.
5461
6333
  #
5462
6334
  # To update all the stack instances associated with this stack set, do
5463
6335
  # not specify `DeploymentTargets` or `Regions`.
5464
6336
  #
5465
6337
  # If the stack set update includes changes to the template (that is, if
5466
6338
  # `TemplateBody` or `TemplateURL` is specified), or the `Parameters`,
5467
- # AWS CloudFormation marks all stack instances with a status of
5468
- # `OUTDATED` prior to updating the stack instances in the specified
5469
- # accounts and Regions. If the stack set update does not include changes
5470
- # to the template or parameters, AWS CloudFormation updates the stack
5471
- # instances in the specified accounts and Regions, while leaving all
5472
- # other stack instances with their existing stack instance status.
6339
+ # CloudFormation marks all stack instances with a status of `OUTDATED`
6340
+ # prior to updating the stack instances in the specified accounts and
6341
+ # Regions. If the stack set update does not include changes to the
6342
+ # template or parameters, CloudFormation updates the stack instances in
6343
+ # the specified accounts and Regions, while leaving all other stack
6344
+ # instances with their existing stack instance status.
5473
6345
  #
5474
6346
  # @option params [String] :permission_model
5475
6347
  # Describes how the IAM roles required for stack set operations are
@@ -5481,7 +6353,7 @@ module Aws::CloudFormation
5481
6353
  # information, see [Grant Self-Managed Stack Set Permissions][1].
5482
6354
  #
5483
6355
  # * With `service-managed` permissions, StackSets automatically creates
5484
- # the IAM roles required to deploy to accounts managed by AWS
6356
+ # the IAM roles required to deploy to accounts managed by
5485
6357
  # Organizations. For more information, see [Grant Service-Managed
5486
6358
  # Stack Set Permissions][2].
5487
6359
  #
@@ -5492,8 +6364,8 @@ module Aws::CloudFormation
5492
6364
  #
5493
6365
  # @option params [Types::AutoDeployment] :auto_deployment
5494
6366
  # \[Service-managed permissions\] Describes whether StackSets
5495
- # automatically deploys to AWS Organizations accounts that are added to
5496
- # a target organization or organizational unit (OU).
6367
+ # automatically deploys to Organizations accounts that are added to a
6368
+ # target organization or organizational unit (OU).
5497
6369
  #
5498
6370
  # If you specify `AutoDeployment`, do not specify `DeploymentTargets` or
5499
6371
  # `Regions`.
@@ -5502,13 +6374,13 @@ module Aws::CloudFormation
5502
6374
  # The unique ID for this stack set operation.
5503
6375
  #
5504
6376
  # The operation ID also functions as an idempotency token, to ensure
5505
- # that AWS CloudFormation performs the stack set operation only once,
5506
- # even if you retry the request multiple times. You might retry stack
5507
- # set operation requests to ensure that AWS CloudFormation successfully
5508
- # received them.
6377
+ # that CloudFormation performs the stack set operation only once, even
6378
+ # if you retry the request multiple times. You might retry stack set
6379
+ # operation requests to ensure that CloudFormation successfully received
6380
+ # them.
5509
6381
  #
5510
- # If you don't specify an operation ID, AWS CloudFormation generates
5511
- # one automatically.
6382
+ # If you don't specify an operation ID, CloudFormation generates one
6383
+ # automatically.
5512
6384
  #
5513
6385
  # Repeating this stack set operation with a new operation ID retries all
5514
6386
  # stack instances whose status is `OUTDATED`.
@@ -5526,13 +6398,13 @@ module Aws::CloudFormation
5526
6398
  #
5527
6399
  # If the stack set update includes changes to the template (that is, if
5528
6400
  # the `TemplateBody` or `TemplateURL` properties are specified), or the
5529
- # `Parameters` property, AWS CloudFormation marks all stack instances
5530
- # with a status of `OUTDATED` prior to updating the stack instances in
5531
- # the specified accounts and Regions. If the stack set update does not
5532
- # include changes to the template or parameters, AWS CloudFormation
5533
- # updates the stack instances in the specified accounts and Regions,
5534
- # while leaving all other stack instances with their existing stack
5535
- # instance status.
6401
+ # `Parameters` property, CloudFormation marks all stack instances with a
6402
+ # status of `OUTDATED` prior to updating the stack instances in the
6403
+ # specified accounts and Regions. If the stack set update does not
6404
+ # include changes to the template or parameters, CloudFormation updates
6405
+ # the stack instances in the specified accounts and Regions, while
6406
+ # leaving all other stack instances with their existing stack instance
6407
+ # status.
5536
6408
  #
5537
6409
  # @option params [Array<String>] :regions
5538
6410
  # The Regions in which to update associated stack instances. If you
@@ -5544,13 +6416,13 @@ module Aws::CloudFormation
5544
6416
  #
5545
6417
  # If the stack set update includes changes to the template (that is, if
5546
6418
  # the `TemplateBody` or `TemplateURL` properties are specified), or the
5547
- # `Parameters` property, AWS CloudFormation marks all stack instances
5548
- # with a status of `OUTDATED` prior to updating the stack instances in
5549
- # the specified accounts and Regions. If the stack set update does not
5550
- # include changes to the template or parameters, AWS CloudFormation
5551
- # updates the stack instances in the specified accounts and Regions,
5552
- # while leaving all other stack instances with their existing stack
5553
- # instance status.
6419
+ # `Parameters` property, CloudFormation marks all stack instances with a
6420
+ # status of `OUTDATED` prior to updating the stack instances in the
6421
+ # specified accounts and Regions. If the stack set update does not
6422
+ # include changes to the template or parameters, CloudFormation updates
6423
+ # the stack instances in the specified accounts and Regions, while
6424
+ # leaving all other stack instances with their existing stack instance
6425
+ # status.
5554
6426
  #
5555
6427
  # @option params [String] :call_as
5556
6428
  # \[Service-managed permissions\] Specifies whether you are acting as an
@@ -5565,9 +6437,10 @@ module Aws::CloudFormation
5565
6437
  # * If you are signed in to a delegated administrator account, specify
5566
6438
  # `DELEGATED_ADMIN`.
5567
6439
  #
5568
- # Your AWS account must be registered as a delegated administrator in
5569
- # the management account. For more information, see [Register a
5570
- # delegated administrator][1] in the *AWS CloudFormation User Guide*.
6440
+ # Your Amazon Web Services account must be registered as a delegated
6441
+ # administrator in the management account. For more information, see
6442
+ # [Register a delegated administrator][1] in the *CloudFormation User
6443
+ # Guide*.
5571
6444
  #
5572
6445
  #
5573
6446
  #
@@ -5642,8 +6515,8 @@ module Aws::CloudFormation
5642
6515
  # Updates termination protection for the specified stack. If a user
5643
6516
  # attempts to delete a stack with termination protection enabled, the
5644
6517
  # operation fails and the stack remains unchanged. For more information,
5645
- # see [Protecting a Stack From Being Deleted][1] in the *AWS
5646
- # CloudFormation User Guide*.
6518
+ # see [Protecting a Stack From Being Deleted][1] in the *CloudFormation
6519
+ # User Guide*.
5647
6520
  #
5648
6521
  # For [nested stacks][2], termination protection is set on the root
5649
6522
  # stack and cannot be changed directly on the nested stack.
@@ -5684,15 +6557,15 @@ module Aws::CloudFormation
5684
6557
  req.send_request(options)
5685
6558
  end
5686
6559
 
5687
- # Validates a specified template. AWS CloudFormation first checks if the
5688
- # template is valid JSON. If it isn't, AWS CloudFormation checks if the
5689
- # template is valid YAML. If both these checks fail, AWS CloudFormation
6560
+ # Validates a specified template. CloudFormation first checks if the
6561
+ # template is valid JSON. If it isn't, CloudFormation checks if the
6562
+ # template is valid YAML. If both these checks fail, CloudFormation
5690
6563
  # returns a template validation error.
5691
6564
  #
5692
6565
  # @option params [String] :template_body
5693
6566
  # Structure containing the template body with a minimum length of 1 byte
5694
6567
  # and a maximum length of 51,200 bytes. For more information, go to
5695
- # [Template Anatomy][1] in the AWS CloudFormation User Guide.
6568
+ # [Template Anatomy][1] in the CloudFormation User Guide.
5696
6569
  #
5697
6570
  # Conditional: You must pass `TemplateURL` or `TemplateBody`. If both
5698
6571
  # are passed, only `TemplateBody` is used.
@@ -5705,7 +6578,7 @@ module Aws::CloudFormation
5705
6578
  # Location of file containing the template body. The URL must point to a
5706
6579
  # template (max size: 460,800 bytes) that is located in an Amazon S3
5707
6580
  # bucket or a Systems Manager document. For more information, go to
5708
- # [Template Anatomy][1] in the AWS CloudFormation User Guide.
6581
+ # [Template Anatomy][1] in the CloudFormation User Guide.
5709
6582
  #
5710
6583
  # Conditional: You must pass `TemplateURL` or `TemplateBody`. If both
5711
6584
  # are passed, only `TemplateBody` is used.
@@ -5765,7 +6638,7 @@ module Aws::CloudFormation
5765
6638
  params: params,
5766
6639
  config: config)
5767
6640
  context[:gem_name] = 'aws-sdk-cloudformation'
5768
- context[:gem_version] = '1.52.0'
6641
+ context[:gem_version] = '1.56.0'
5769
6642
  Seahorse::Client::Request.new(handlers, context)
5770
6643
  end
5771
6644