aws-sdk-cloudformation 1.50.0 → 1.54.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: 4d8aa954ce3dc01f20c230764fc9bba2a21b98b6dfe462cb1b4fa26792d23c2e
4
- data.tar.gz: 7ff174bd0c7e7133ea5b864c6892ef91f2c9156496474e23622d691e3e47245f
3
+ metadata.gz: 642a8c36978ebf152ba0b7df35f3c1e627e0101432269f02eee095dcc3f18f3e
4
+ data.tar.gz: 4573401978788bdecf9a7d29a0e4117bc194e86017bbc24ff29d3bb9ad7103a3
5
5
  SHA512:
6
- metadata.gz: d2bd5917bda8cc4bceef8ac32e07eec50de00e0b2ab79f3be1b9dbd0f8b23598d892cdfd8d6f482e941c5297183c20b760f5c8098b09169e3ffa5c0cca4cee97
7
- data.tar.gz: 5243862e4dbf3afc8093f6ff1387249ae1178d2a14b64a941a6372ad76229d84132c26d59c2a184747829bd76624668611cbfc7f43189abc51d84283c0579245
6
+ metadata.gz: c7025f03f4433653da5cfea4f11d2ac755edee61fa291f5b4036b0c4d1af311d59f95ed0e94aa49f99c97f1bf5905c597f805731e6879329c9835886d944a96c
7
+ data.tar.gz: 3df65c06788d3e4384895b3447c29f37b34030c3ff31dc66ec626aa978bbc43ab150e249053d9f772eb18b0c91370cc3e58b70db39842a9b8faaff621aa1262b
data/CHANGELOG.md CHANGED
@@ -1,6 +1,26 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.54.0 (2021-07-28)
5
+ ------------------
6
+
7
+ * Feature - SDK update to support Importing existing Stacks to new/existing Self Managed StackSet - Stack Import feature.
8
+
9
+ 1.53.0 (2021-06-21)
10
+ ------------------
11
+
12
+ * Feature - CloudFormation registry service now supports 3rd party public type sharing
13
+
14
+ 1.52.0 (2021-04-28)
15
+ ------------------
16
+
17
+ * Feature - Add CallAs parameter to GetTemplateSummary to enable use with StackSets delegated administrator integration
18
+
19
+ 1.51.0 (2021-04-21)
20
+ ------------------
21
+
22
+ * Feature - Added support for creating and updating stack sets with self-managed permissions from templates that reference macros.
23
+
4
24
  1.50.0 (2021-03-31)
5
25
  ------------------
6
26
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.50.0
1
+ 1.54.0
@@ -33,7 +33,7 @@ require_relative 'aws-sdk-cloudformation/customizations'
33
33
  # structure.
34
34
  #
35
35
  # cloud_formation = Aws::CloudFormation::Client.new
36
- # resp = cloud_formation.cancel_update_stack(params)
36
+ # resp = cloud_formation.activate_type(params)
37
37
  #
38
38
  # See {Client} for more information.
39
39
  #
@@ -53,6 +53,6 @@ require_relative 'aws-sdk-cloudformation/customizations'
53
53
  # @!group service
54
54
  module Aws::CloudFormation
55
55
 
56
- GEM_VERSION = '1.50.0'
56
+ GEM_VERSION = '1.54.0'
57
57
 
58
58
  end
@@ -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,15 @@ 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 account; for example, by creating new Identity
737
+ # and Access Management (IAM) users. For those stacks, you must
738
+ # explicitly acknowledge this by specifying one of these capabilities.
554
739
  #
555
740
  # The following IAM resources require you to specify either the
556
741
  # `CAPABILITY_IAM` or `CAPABILITY_NAMED_IAM` capability.
@@ -560,8 +745,8 @@ module Aws::CloudFormation
560
745
  # * If you have IAM resources with custom names, you *must* specify
561
746
  # `CAPABILITY_NAMED_IAM`.
562
747
  #
563
- # * If you don't specify either of these capabilities, AWS
564
- # CloudFormation returns an `InsufficientCapabilities` error.
748
+ # * If you don't specify either of these capabilities, CloudFormation
749
+ # returns an `InsufficientCapabilities` error.
565
750
  #
566
751
  # If your stack template contains these resources, we recommend that
567
752
  # you review all permissions associated with them and edit their
@@ -581,7 +766,7 @@ module Aws::CloudFormation
581
766
  #
582
767
  # * [ AWS::IAM::UserToGroupAddition][7]
583
768
  #
584
- # For more information, see [Acknowledging IAM Resources in AWS
769
+ # For more information, see [Acknowledging IAM Resources in
585
770
  # CloudFormation Templates][8].
586
771
  #
587
772
  # * `CAPABILITY_AUTO_EXPAND`
@@ -596,7 +781,7 @@ module Aws::CloudFormation
596
781
  # create a stack directly from the processed template, without first
597
782
  # reviewing the resulting changes in a change set, you must
598
783
  # acknowledge this capability. This includes the [AWS::Include][9] and
599
- # [AWS::Serverless][10] transforms, which are macros hosted by AWS
784
+ # [AWS::Serverless][10] transforms, which are macros hosted by
600
785
  # CloudFormation.
601
786
  #
602
787
  # <note markdown="1"> This capacity does not apply to creating change sets, and specifying
@@ -609,8 +794,8 @@ module Aws::CloudFormation
609
794
  #
610
795
  # </note>
611
796
  #
612
- # For more information on macros, see [Using AWS CloudFormation Macros
613
- # to Perform Custom Processing on Templates][11].
797
+ # For more information on macros, see [Using CloudFormation Macros to
798
+ # Perform Custom Processing on Templates][11].
614
799
  #
615
800
  #
616
801
  #
@@ -632,44 +817,43 @@ module Aws::CloudFormation
632
817
  # `AWS::EC2::*`, or `Custom::MyCustomInstance`.
633
818
  #
634
819
  # 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.
820
+ # you're updating, the stack update fails. By default, CloudFormation
821
+ # grants permissions to all resource types. Identity and Access
822
+ # Management (IAM) uses this parameter for condition keys in IAM
823
+ # policies for CloudFormation. For more information, see [Controlling
824
+ # Access with Identity and Access Management][1] in the CloudFormation
825
+ # User Guide.
641
826
  #
642
827
  #
643
828
  #
644
829
  # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html
645
830
  #
646
831
  # @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
832
+ # The Amazon Resource Name (ARN) of an Identity and Access Management
833
+ # (IAM) role that CloudFormation assumes when executing the change set.
834
+ # CloudFormation uses the role's credentials to make calls on your
835
+ # behalf. CloudFormation uses this role for all future operations on the
836
+ # stack. As long as users have permission to operate on the stack,
837
+ # CloudFormation uses this role even if the users don't have permission
838
+ # to pass it. Ensure that the role grants least privilege.
839
+ #
840
+ # If you don't specify a value, CloudFormation uses the role that was
841
+ # previously associated with the stack. If no role is available,
658
842
  # CloudFormation uses a temporary session that is generated from your
659
843
  # user credentials.
660
844
  #
661
845
  # @option params [Types::RollbackConfiguration] :rollback_configuration
662
- # The rollback triggers for AWS CloudFormation to monitor during stack
846
+ # The rollback triggers for CloudFormation to monitor during stack
663
847
  # creation and updating operations, and for the specified monitoring
664
848
  # period afterwards.
665
849
  #
666
850
  # @option params [Array<String>] :notification_arns
667
851
  # 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.
852
+ # (Amazon SNS) topics that CloudFormation associates with the stack. To
853
+ # remove all associated notification topics, specify an empty list.
670
854
  #
671
855
  # @option params [Array<Types::Tag>] :tags
672
- # Key-value pairs to associate with this stack. AWS CloudFormation also
856
+ # Key-value pairs to associate with this stack. CloudFormation also
673
857
  # propagates these tags to resources in the stack. You can specify a
674
858
  # maximum of 50 tags.
675
859
  #
@@ -683,9 +867,9 @@ module Aws::CloudFormation
683
867
  #
684
868
  # @option params [String] :client_token
685
869
  # 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
870
+ # token if you plan to retry requests so that CloudFormation knows that
871
+ # you're not attempting to create another change set with the same
872
+ # name. You might retry `CreateChangeSet` requests to ensure that
689
873
  # CloudFormation successfully received them.
690
874
  #
691
875
  # @option params [String] :description
@@ -697,12 +881,12 @@ module Aws::CloudFormation
697
881
  # specify `UPDATE`. To create a change set for an import operation,
698
882
  # specify `IMPORT`.
699
883
  #
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.
884
+ # If you create a change set for a new stack, CloudFormation creates a
885
+ # stack with a unique stack ID, but no template or resources. The stack
886
+ # will be in the [ `REVIEW_IN_PROGRESS` ][1] state until you execute the
887
+ # change set.
704
888
  #
705
- # By default, AWS CloudFormation specifies `UPDATE`. You can't use the
889
+ # By default, CloudFormation specifies `UPDATE`. You can't use the
706
890
  # `UPDATE` type to create a change set for a new stack or the `CREATE`
707
891
  # type to create a change set for an existing stack.
708
892
  #
@@ -804,7 +988,7 @@ module Aws::CloudFormation
804
988
  # @option params [String] :template_body
805
989
  # Structure containing the template body with a minimum length of 1 byte
806
990
  # and a maximum length of 51,200 bytes. For more information, go to
807
- # [Template Anatomy][1] in the AWS CloudFormation User Guide.
991
+ # [Template Anatomy][1] in the CloudFormation User Guide.
808
992
  #
809
993
  # Conditional: You must specify either the `TemplateBody` or the
810
994
  # `TemplateURL` parameter, but not both.
@@ -817,7 +1001,7 @@ module Aws::CloudFormation
817
1001
  # Location of file containing the template body. The URL must point to a
818
1002
  # template (max size: 460,800 bytes) that is located in an Amazon S3
819
1003
  # bucket or a Systems Manager document. For more information, go to the
820
- # [Template Anatomy][1] in the AWS CloudFormation User Guide.
1004
+ # [Template Anatomy][1] in the CloudFormation User Guide.
821
1005
  #
822
1006
  # Conditional: You must specify either the `TemplateBody` or the
823
1007
  # `TemplateURL` parameter, but not both.
@@ -842,7 +1026,7 @@ module Aws::CloudFormation
842
1026
  # Default: `false`
843
1027
  #
844
1028
  # @option params [Types::RollbackConfiguration] :rollback_configuration
845
- # The rollback triggers for AWS CloudFormation to monitor during stack
1029
+ # The rollback triggers for CloudFormation to monitor during stack
846
1030
  # creation and updating operations, and for the specified monitoring
847
1031
  # period afterwards.
848
1032
  #
@@ -858,16 +1042,15 @@ module Aws::CloudFormation
858
1042
  #
859
1043
  # @option params [Array<String>] :capabilities
860
1044
  # 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.
1045
+ # template contains certain capabilities in order for CloudFormation to
1046
+ # create the stack.
863
1047
  #
864
1048
  # * `CAPABILITY_IAM` and `CAPABILITY_NAMED_IAM`
865
1049
  #
866
1050
  # 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.
1051
+ # permissions in your account; for example, by creating new Identity
1052
+ # and Access Management (IAM) users. For those stacks, you must
1053
+ # explicitly acknowledge this by specifying one of these capabilities.
871
1054
  #
872
1055
  # The following IAM resources require you to specify either the
873
1056
  # `CAPABILITY_IAM` or `CAPABILITY_NAMED_IAM` capability.
@@ -877,8 +1060,8 @@ module Aws::CloudFormation
877
1060
  # * If you have IAM resources with custom names, you *must* specify
878
1061
  # `CAPABILITY_NAMED_IAM`.
879
1062
  #
880
- # * If you don't specify either of these capabilities, AWS
881
- # CloudFormation returns an `InsufficientCapabilities` error.
1063
+ # * If you don't specify either of these capabilities, CloudFormation
1064
+ # returns an `InsufficientCapabilities` error.
882
1065
  #
883
1066
  # If your stack template contains these resources, we recommend that
884
1067
  # you review all permissions associated with them and edit their
@@ -898,7 +1081,7 @@ module Aws::CloudFormation
898
1081
  #
899
1082
  # * [ AWS::IAM::UserToGroupAddition][7]
900
1083
  #
901
- # For more information, see [Acknowledging IAM Resources in AWS
1084
+ # For more information, see [Acknowledging IAM Resources in
902
1085
  # CloudFormation Templates][8].
903
1086
  #
904
1087
  # * `CAPABILITY_AUTO_EXPAND`
@@ -913,7 +1096,7 @@ module Aws::CloudFormation
913
1096
  # create a stack directly from the processed template, without first
914
1097
  # reviewing the resulting changes in a change set, you must
915
1098
  # acknowledge this capability. This includes the [AWS::Include][9] and
916
- # [AWS::Serverless][10] transforms, which are macros hosted by AWS
1099
+ # [AWS::Serverless][10] transforms, which are macros hosted by
917
1100
  # CloudFormation.
918
1101
  #
919
1102
  # If you want to create a stack from a stack template that contains
@@ -925,11 +1108,11 @@ module Aws::CloudFormation
925
1108
  #
926
1109
  # Each macro relies on an underlying Lambda service function for
927
1110
  # processing stack templates. Be aware that the Lambda function owner
928
- # can update the function operation without AWS CloudFormation being
1111
+ # can update the function operation without CloudFormation being
929
1112
  # notified.
930
1113
  #
931
- # For more information, see [Using AWS CloudFormation Macros to
932
- # Perform Custom Processing on Templates][11].
1114
+ # For more information, see [Using CloudFormation Macros to Perform
1115
+ # Custom Processing on Templates][11].
933
1116
  #
934
1117
  #
935
1118
  #
@@ -949,35 +1132,35 @@ module Aws::CloudFormation
949
1132
  # The template resource types that you have permissions to work with for
950
1133
  # this create stack action, such as `AWS::EC2::Instance`, `AWS::EC2::*`,
951
1134
  # 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).
1135
+ # template resource types: `AWS::*` (for all Amazon Web Services
1136
+ # resources), `Custom::*` (for all custom resources),
1137
+ # `Custom::logical_ID ` (for a specific custom resource),
1138
+ # `AWS::service_name::*` (for all resources of a particular Amazon Web
1139
+ # Services service), and `AWS::service_name::resource_logical_ID ` (for
1140
+ # a specific Amazon Web Services resource).
957
1141
  #
958
1142
  # 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].
1143
+ # creating, the stack creation fails. By default, CloudFormation grants
1144
+ # permissions to all resource types. Identity and Access Management
1145
+ # (IAM) uses this parameter for CloudFormation-specific condition keys
1146
+ # in IAM policies. For more information, see [Controlling Access with
1147
+ # Identity and Access Management][1].
964
1148
  #
965
1149
  #
966
1150
  #
967
1151
  # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html
968
1152
  #
969
1153
  # @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
1154
+ # The Amazon Resource Name (ARN) of an Identity and Access Management
1155
+ # (IAM) role that CloudFormation assumes to create the stack.
1156
+ # CloudFormation uses the role's credentials to make calls on your
1157
+ # behalf. CloudFormation always uses this role for all future operations
1158
+ # on the stack. As long as users have permission to operate on the
1159
+ # stack, CloudFormation uses this role even if the users don't have
1160
+ # permission to pass it. Ensure that the role grants least privilege.
1161
+ #
1162
+ # If you don't specify a value, CloudFormation uses the role that was
1163
+ # previously associated with the stack. If no role is available,
981
1164
  # CloudFormation uses a temporary session that is generated from your
982
1165
  # user credentials.
983
1166
  #
@@ -990,7 +1173,7 @@ module Aws::CloudFormation
990
1173
  #
991
1174
  # @option params [String] :stack_policy_body
992
1175
  # Structure containing the stack policy body. For more information, go
993
- # to [ Prevent Updates to Stack Resources][1] in the *AWS CloudFormation
1176
+ # to [ Prevent Updates to Stack Resources][1] in the *CloudFormation
994
1177
  # User Guide*. You can specify either the `StackPolicyBody` or the
995
1178
  # `StackPolicyURL` parameter, but not both.
996
1179
  #
@@ -1005,15 +1188,15 @@ module Aws::CloudFormation
1005
1188
  # the `StackPolicyURL` parameter, but not both.
1006
1189
  #
1007
1190
  # @option params [Array<Types::Tag>] :tags
1008
- # Key-value pairs to associate with this stack. AWS CloudFormation also
1191
+ # Key-value pairs to associate with this stack. CloudFormation also
1009
1192
  # propagates these tags to the resources created in the stack. A maximum
1010
1193
  # number of 50 tags can be specified.
1011
1194
  #
1012
1195
  # @option params [String] :client_request_token
1013
1196
  # A unique identifier for this `CreateStack` request. Specify this token
1014
- # if you plan to retry requests so that AWS CloudFormation knows that
1197
+ # if you plan to retry requests so that CloudFormation knows that
1015
1198
  # you're not attempting to create a stack with the same name. You might
1016
- # retry `CreateStack` requests to ensure that AWS CloudFormation
1199
+ # retry `CreateStack` requests to ensure that CloudFormation
1017
1200
  # successfully received them.
1018
1201
  #
1019
1202
  # All events triggered by a given stack operation are assigned the same
@@ -1035,7 +1218,7 @@ module Aws::CloudFormation
1035
1218
  # user attempts to delete a stack with termination protection enabled,
1036
1219
  # the operation fails and the stack remains unchanged. For more
1037
1220
  # information, see [Protecting a Stack From Being Deleted][1] in the
1038
- # *AWS CloudFormation User Guide*. Termination protection is disabled on
1221
+ # *CloudFormation User Guide*. Termination protection is disabled on
1039
1222
  # stacks by default.
1040
1223
  #
1041
1224
  # For [nested stacks][2], termination protection is set on the root
@@ -1116,21 +1299,20 @@ module Aws::CloudFormation
1116
1299
  # instances from.
1117
1300
  #
1118
1301
  # @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.
1302
+ # \[Self-managed permissions\] The names of one or more accounts that
1303
+ # you want to create stack instances in the specified Region(s) for.
1122
1304
  #
1123
1305
  # You can specify `Accounts` or `DeploymentTargets`, but not both.
1124
1306
  #
1125
1307
  # @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.
1308
+ # \[Service-managed permissions\] The Organizations accounts for which
1309
+ # to create stack instances in the specified Regions.
1128
1310
  #
1129
1311
  # You can specify `Accounts` or `DeploymentTargets`, but not both.
1130
1312
  #
1131
1313
  # @option params [required, Array<String>] :regions
1132
1314
  # The names of one or more Regions where you want to create stack
1133
- # instances using the specified AWS account(s).
1315
+ # instances using the specified accounts.
1134
1316
  #
1135
1317
  # @option params [Array<Types::Parameter>] :parameter_overrides
1136
1318
  # A list of stack set parameters whose values you want to override in
@@ -1138,24 +1320,19 @@ module Aws::CloudFormation
1138
1320
  #
1139
1321
  # Any overridden parameter values will be applied to all stack instances
1140
1322
  # in the specified accounts and Regions. When specifying parameters and
1141
- # their values, be aware of how AWS CloudFormation sets parameter values
1323
+ # their values, be aware of how CloudFormation sets parameter values
1142
1324
  # during stack instance operations:
1143
1325
  #
1144
1326
  # * To override the current value for a parameter, include the parameter
1145
1327
  # and specify its value.
1146
1328
  #
1147
- # * To leave a parameter set to its present value, you can do one of the
1148
- # following:
1149
- #
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`.)
1329
+ # * To leave an overridden parameter set to its present value, include
1330
+ # the parameter and specify `UsePreviousValue` as `true`. (You cannot
1331
+ # specify both a value and set `UsePreviousValue` to `true`.)
1155
1332
  #
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.
1333
+ # * To set an overridden parameter back to the value specified in the
1334
+ # stack set, specify a parameter list but do not include the parameter
1335
+ # in the list.
1159
1336
  #
1160
1337
  # * To leave all parameters set to their present values, do not specify
1161
1338
  # this property at all.
@@ -1172,17 +1349,16 @@ module Aws::CloudFormation
1172
1349
  # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_UpdateStackSet.html
1173
1350
  #
1174
1351
  # @option params [Types::StackSetOperationPreferences] :operation_preferences
1175
- # Preferences for how AWS CloudFormation performs this stack set
1176
- # operation.
1352
+ # Preferences for how CloudFormation performs this stack set operation.
1177
1353
  #
1178
1354
  # @option params [String] :operation_id
1179
1355
  # The unique identifier for this stack set operation.
1180
1356
  #
1181
1357
  # 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.
1358
+ # that CloudFormation performs the stack set operation only once, even
1359
+ # if you retry the request multiple times. You might retry stack set
1360
+ # operation requests to ensure that CloudFormation successfully received
1361
+ # them.
1186
1362
  #
1187
1363
  # If you don't specify an operation ID, the SDK generates one
1188
1364
  # automatically.
@@ -1206,9 +1382,9 @@ module Aws::CloudFormation
1206
1382
  # * If you are signed in to a delegated administrator account, specify
1207
1383
  # `DELEGATED_ADMIN`.
1208
1384
  #
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*.
1385
+ # Your account must be registered as a delegated administrator in the
1386
+ # management account. For more information, see [Register a delegated
1387
+ # administrator][1] in the *CloudFormation User Guide*.
1212
1388
  #
1213
1389
  #
1214
1390
  #
@@ -1281,7 +1457,7 @@ module Aws::CloudFormation
1281
1457
  # @option params [String] :template_body
1282
1458
  # The structure that contains the template body, with a minimum length
1283
1459
  # 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.
1460
+ # see [Template Anatomy][1] in the CloudFormation User Guide.
1285
1461
  #
1286
1462
  # Conditional: You must specify either the TemplateBody or the
1287
1463
  # TemplateURL parameter, but not both.
@@ -1294,7 +1470,7 @@ module Aws::CloudFormation
1294
1470
  # The location of the file that contains the template body. The URL must
1295
1471
  # point to a template (maximum size: 460,800 bytes) that's located in
1296
1472
  # an Amazon S3 bucket or a Systems Manager document. For more
1297
- # information, see [Template Anatomy][1] in the AWS CloudFormation User
1473
+ # information, see [Template Anatomy][1] in the CloudFormation User
1298
1474
  # Guide.
1299
1475
  #
1300
1476
  # Conditional: You must specify either the TemplateBody or the
@@ -1304,21 +1480,24 @@ module Aws::CloudFormation
1304
1480
  #
1305
1481
  # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html
1306
1482
  #
1483
+ # @option params [String] :stack_id
1484
+ # The stack ID you are importing into a new stack set. Specify the
1485
+ # Amazon Resource Number (ARN) of the stack.
1486
+ #
1307
1487
  # @option params [Array<Types::Parameter>] :parameters
1308
1488
  # The input parameters for the stack set template.
1309
1489
  #
1310
1490
  # @option params [Array<String>] :capabilities
1311
1491
  # 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.
1492
+ # template contains certain capabilities in order for CloudFormation to
1493
+ # create the stack set and related stack instances.
1314
1494
  #
1315
1495
  # * `CAPABILITY_IAM` and `CAPABILITY_NAMED_IAM`
1316
1496
  #
1317
1497
  # 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.
1498
+ # permissions in your account; for example, by creating new Identity
1499
+ # and Access Management (IAM) users. For those stack sets, you must
1500
+ # explicitly acknowledge this by specifying one of these capabilities.
1322
1501
  #
1323
1502
  # The following IAM resources require you to specify either the
1324
1503
  # `CAPABILITY_IAM` or `CAPABILITY_NAMED_IAM` capability.
@@ -1328,8 +1507,8 @@ module Aws::CloudFormation
1328
1507
  # * If you have IAM resources with custom names, you *must* specify
1329
1508
  # `CAPABILITY_NAMED_IAM`.
1330
1509
  #
1331
- # * If you don't specify either of these capabilities, AWS
1332
- # CloudFormation returns an `InsufficientCapabilities` error.
1510
+ # * If you don't specify either of these capabilities, CloudFormation
1511
+ # returns an `InsufficientCapabilities` error.
1333
1512
  #
1334
1513
  # If your stack template contains these resources, we recommend that
1335
1514
  # you review all permissions associated with them and edit their
@@ -1349,25 +1528,26 @@ module Aws::CloudFormation
1349
1528
  #
1350
1529
  # * [ AWS::IAM::UserToGroupAddition][7]
1351
1530
  #
1352
- # For more information, see [Acknowledging IAM Resources in AWS
1531
+ # For more information, see [Acknowledging IAM Resources in
1353
1532
  # CloudFormation Templates][8].
1354
1533
  #
1355
1534
  # * `CAPABILITY_AUTO_EXPAND`
1356
1535
  #
1357
- # Some templates contain macros. If your stack template contains one
1358
- # or more macros, and you choose to create a stack directly from the
1359
- # processed template, without first reviewing the resulting changes in
1360
- # a change set, you must acknowledge this capability. For more
1361
- # information, see [Using AWS CloudFormation Macros to Perform Custom
1362
- # Processing on Templates][9].
1536
+ # Some templates reference macros. If your stack set template
1537
+ # references one or more macros, you must create the stack set
1538
+ # directly from the processed template, without first reviewing the
1539
+ # resulting changes in a change set. To create the stack set directly,
1540
+ # you must acknowledge this capability. For more information, see
1541
+ # [Using CloudFormation Macros to Perform Custom Processing on
1542
+ # Templates][9].
1363
1543
  #
1364
- # <note markdown="1"> Stack sets do not currently support macros in stack templates. (This
1365
- # includes the [AWS::Include][10] and [AWS::Serverless][11]
1366
- # transforms, which are macros hosted by AWS CloudFormation.) Even if
1367
- # you specify this capability, if you include a macro in your template
1368
- # the stack set operation will fail.
1369
- #
1370
- # </note>
1544
+ # Stack sets with service-managed permissions do not currently support
1545
+ # the use of macros in templates. (This includes the
1546
+ # [AWS::Include][10] and [AWS::Serverless][11] transforms, which are
1547
+ # macros hosted by CloudFormation.) Even if you specify this
1548
+ # capability for a stack set with service-managed permissions, if you
1549
+ # reference a macro in your template the stack set operation will
1550
+ # fail.
1371
1551
  #
1372
1552
  #
1373
1553
  #
@@ -1385,11 +1565,11 @@ module Aws::CloudFormation
1385
1565
  #
1386
1566
  # @option params [Array<Types::Tag>] :tags
1387
1567
  # The key-value pairs to associate with this stack set and the stacks
1388
- # created from it. AWS CloudFormation also propagates these tags to
1568
+ # created from it. CloudFormation also propagates these tags to
1389
1569
  # supported resources that are created in the stacks. A maximum number
1390
1570
  # of 50 tags can be specified.
1391
1571
  #
1392
- # If you specify tags as part of a `CreateStackSet` action, AWS
1572
+ # If you specify tags as part of a `CreateStackSet` action,
1393
1573
  # CloudFormation checks to see if you have the required IAM permission
1394
1574
  # to tag resources. If you don't, the entire `CreateStackSet` action
1395
1575
  # fails with an `access denied` error, and the stack set is not created.
@@ -1402,7 +1582,7 @@ module Aws::CloudFormation
1402
1582
  # roles to control which users or groups can manage specific stack sets
1403
1583
  # within the same administrator account. For more information, see
1404
1584
  # [Prerequisites: Granting Permissions for Stack Set Operations][1] in
1405
- # the *AWS CloudFormation User Guide*.
1585
+ # the *CloudFormation User Guide*.
1406
1586
  #
1407
1587
  #
1408
1588
  #
@@ -1410,7 +1590,7 @@ module Aws::CloudFormation
1410
1590
  #
1411
1591
  # @option params [String] :execution_role_name
1412
1592
  # The name of the IAM execution role to use to create the stack set. If
1413
- # you do not specify an execution role, AWS CloudFormation uses the
1593
+ # you do not specify an execution role, CloudFormation uses the
1414
1594
  # `AWSCloudFormationStackSetExecutionRole` role for the stack set
1415
1595
  # operation.
1416
1596
  #
@@ -1427,7 +1607,7 @@ module Aws::CloudFormation
1427
1607
  # information, see [Grant Self-Managed Stack Set Permissions][1].
1428
1608
  #
1429
1609
  # * With `service-managed` permissions, StackSets automatically creates
1430
- # the IAM roles required to deploy to accounts managed by AWS
1610
+ # the IAM roles required to deploy to accounts managed by
1431
1611
  # Organizations. For more information, see [Grant Service-Managed
1432
1612
  # Stack Set Permissions][2].
1433
1613
  #
@@ -1437,7 +1617,7 @@ module Aws::CloudFormation
1437
1617
  # [2]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-prereqs-service-managed.html
1438
1618
  #
1439
1619
  # @option params [Types::AutoDeployment] :auto_deployment
1440
- # Describes whether StackSets automatically deploys to AWS Organizations
1620
+ # Describes whether StackSets automatically deploys to Organizations
1441
1621
  # accounts that are added to the target organization or organizational
1442
1622
  # unit (OU). Specify only if `PermissionModel` is `SERVICE_MANAGED`.
1443
1623
  #
@@ -1455,9 +1635,9 @@ module Aws::CloudFormation
1455
1635
  # * To create a stack set with service-managed permissions while signed
1456
1636
  # in to a delegated administrator account, specify `DELEGATED_ADMIN`.
1457
1637
  #
1458
- # Your AWS account must be registered as a delegated admin in the
1638
+ # Your account must be registered as a delegated admin in the
1459
1639
  # management account. For more information, see [Register a delegated
1460
- # administrator][1] in the *AWS CloudFormation User Guide*.
1640
+ # administrator][1] in the *CloudFormation User Guide*.
1461
1641
  #
1462
1642
  # Stack sets with service-managed permissions are created in the
1463
1643
  # management account, including stack sets that are created by delegated
@@ -1469,9 +1649,9 @@ module Aws::CloudFormation
1469
1649
  #
1470
1650
  # @option params [String] :client_request_token
1471
1651
  # A unique identifier for this `CreateStackSet` request. Specify this
1472
- # token if you plan to retry requests so that AWS CloudFormation knows
1473
- # that you're not attempting to create another stack set with the same
1474
- # name. You might retry `CreateStackSet` requests to ensure that AWS
1652
+ # token if you plan to retry requests so that CloudFormation knows that
1653
+ # you're not attempting to create another stack set with the same name.
1654
+ # You might retry `CreateStackSet` requests to ensure that
1475
1655
  # CloudFormation successfully received them.
1476
1656
  #
1477
1657
  # If you don't specify an operation ID, the SDK generates one
@@ -1491,6 +1671,7 @@ module Aws::CloudFormation
1491
1671
  # description: "Description",
1492
1672
  # template_body: "TemplateBody",
1493
1673
  # template_url: "TemplateURL",
1674
+ # stack_id: "StackId",
1494
1675
  # parameters: [
1495
1676
  # {
1496
1677
  # parameter_key: "ParameterKey",
@@ -1530,10 +1711,56 @@ module Aws::CloudFormation
1530
1711
  req.send_request(options)
1531
1712
  end
1532
1713
 
1714
+ # Deactivates a public extension that was previously activated in this
1715
+ # account and region.
1716
+ #
1717
+ # Once deactivated, an extension cannot be used in any CloudFormation
1718
+ # operation. This includes stack update operations where the stack
1719
+ # template includes the extension, even if no updates are being made to
1720
+ # the extension. In addition, deactivated extensions are not
1721
+ # automatically updated if a new version of the extension is released.
1722
+ #
1723
+ # @option params [String] :type_name
1724
+ # The type name of the extension, in this account and region. If you
1725
+ # specified a type name alias when enabling the extension, use the type
1726
+ # name alias.
1727
+ #
1728
+ # Conditional: You must specify either `Arn`, or `TypeName` and `Type`.
1729
+ #
1730
+ # @option params [String] :type
1731
+ # The extension type.
1732
+ #
1733
+ # Conditional: You must specify either `Arn`, or `TypeName` and `Type`.
1734
+ #
1735
+ # @option params [String] :arn
1736
+ # The Amazon Resource Name (ARN) for the extension, in this account and
1737
+ # region.
1738
+ #
1739
+ # Conditional: You must specify either `Arn`, or `TypeName` and `Type`.
1740
+ #
1741
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
1742
+ #
1743
+ # @example Request syntax with placeholder values
1744
+ #
1745
+ # resp = client.deactivate_type({
1746
+ # type_name: "TypeName",
1747
+ # type: "RESOURCE", # accepts RESOURCE, MODULE
1748
+ # arn: "PrivateTypeArn",
1749
+ # })
1750
+ #
1751
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/DeactivateType AWS API Documentation
1752
+ #
1753
+ # @overload deactivate_type(params = {})
1754
+ # @param [Hash] params ({})
1755
+ def deactivate_type(params = {}, options = {})
1756
+ req = build_request(:deactivate_type, params)
1757
+ req.send_request(options)
1758
+ end
1759
+
1533
1760
  # Deletes the specified change set. Deleting change sets ensures that no
1534
1761
  # one executes the wrong change set.
1535
1762
  #
1536
- # If the call successfully completes, AWS CloudFormation successfully
1763
+ # If the call successfully completes, CloudFormation successfully
1537
1764
  # deleted the change set.
1538
1765
  #
1539
1766
  # If `IncludeNestedStacks` specifies `True` during the creation of the
@@ -1577,28 +1804,28 @@ module Aws::CloudFormation
1577
1804
  # @option params [Array<String>] :retain_resources
1578
1805
  # For stacks in the `DELETE_FAILED` state, a list of resource logical
1579
1806
  # IDs that are associated with the resources you want to retain. During
1580
- # deletion, AWS CloudFormation deletes the stack but does not delete the
1807
+ # deletion, CloudFormation deletes the stack but does not delete the
1581
1808
  # retained resources.
1582
1809
  #
1583
1810
  # Retaining resources is useful when you cannot delete a resource, such
1584
1811
  # as a non-empty S3 bucket, but you want to delete the stack.
1585
1812
  #
1586
1813
  # @option params [String] :role_arn
1587
- # The Amazon Resource Name (ARN) of an AWS Identity and Access
1588
- # Management (IAM) role that AWS CloudFormation assumes to delete the
1589
- # stack. AWS CloudFormation uses the role's credentials to make calls
1590
- # on your behalf.
1814
+ # The Amazon Resource Name (ARN) of an Identity and Access Management
1815
+ # (IAM) role that CloudFormation assumes to delete the stack.
1816
+ # CloudFormation uses the role's credentials to make calls on your
1817
+ # behalf.
1591
1818
  #
1592
- # If you don't specify a value, AWS CloudFormation uses the role that
1593
- # was previously associated with the stack. If no role is available, AWS
1819
+ # If you don't specify a value, CloudFormation uses the role that was
1820
+ # previously associated with the stack. If no role is available,
1594
1821
  # CloudFormation uses a temporary session that is generated from your
1595
1822
  # user credentials.
1596
1823
  #
1597
1824
  # @option params [String] :client_request_token
1598
1825
  # A unique identifier for this `DeleteStack` request. Specify this token
1599
- # if you plan to retry requests so that AWS CloudFormation knows that
1826
+ # if you plan to retry requests so that CloudFormation knows that
1600
1827
  # you're not attempting to delete a stack with the same name. You might
1601
- # retry `DeleteStack` requests to ensure that AWS CloudFormation
1828
+ # retry `DeleteStack` requests to ensure that CloudFormation
1602
1829
  # successfully received them.
1603
1830
  #
1604
1831
  # All events triggered by a given stack operation are assigned the same
@@ -1643,14 +1870,14 @@ module Aws::CloudFormation
1643
1870
  # instances for.
1644
1871
  #
1645
1872
  # @option params [Array<String>] :accounts
1646
- # \[Self-managed permissions\] The names of the AWS accounts that you
1647
- # want to delete stack instances for.
1873
+ # \[Self-managed permissions\] The names of the accounts that you want
1874
+ # to delete stack instances for.
1648
1875
  #
1649
1876
  # You can specify `Accounts` or `DeploymentTargets`, but not both.
1650
1877
  #
1651
1878
  # @option params [Types::DeploymentTargets] :deployment_targets
1652
- # \[Service-managed permissions\] The AWS Organizations accounts from
1653
- # which to delete stack instances.
1879
+ # \[Service-managed permissions\] The Organizations accounts from which
1880
+ # to delete stack instances.
1654
1881
  #
1655
1882
  # You can specify `Accounts` or `DeploymentTargets`, but not both.
1656
1883
  #
@@ -1658,8 +1885,7 @@ module Aws::CloudFormation
1658
1885
  # The Regions where you want to delete stack set instances.
1659
1886
  #
1660
1887
  # @option params [Types::StackSetOperationPreferences] :operation_preferences
1661
- # Preferences for how AWS CloudFormation performs this stack set
1662
- # operation.
1888
+ # Preferences for how CloudFormation performs this stack set operation.
1663
1889
  #
1664
1890
  # @option params [required, Boolean] :retain_stacks
1665
1891
  # Removes the stack instances from the specified stack set, but doesn't
@@ -1679,10 +1905,10 @@ module Aws::CloudFormation
1679
1905
  # automatically.
1680
1906
  #
1681
1907
  # The operation ID also functions as an idempotency token, to ensure
1682
- # that AWS CloudFormation performs the stack set operation only once,
1683
- # even if you retry the request multiple times. You can retry stack set
1684
- # operation requests to ensure that AWS CloudFormation successfully
1685
- # received them.
1908
+ # that CloudFormation performs the stack set operation only once, even
1909
+ # if you retry the request multiple times. You can retry stack set
1910
+ # operation requests to ensure that CloudFormation successfully received
1911
+ # them.
1686
1912
  #
1687
1913
  # Repeating this stack set operation with a new operation ID retries all
1688
1914
  # stack instances whose status is `OUTDATED`.
@@ -1703,9 +1929,9 @@ module Aws::CloudFormation
1703
1929
  # * If you are signed in to a delegated administrator account, specify
1704
1930
  # `DELEGATED_ADMIN`.
1705
1931
  #
1706
- # Your AWS account must be registered as a delegated administrator in
1707
- # the management account. For more information, see [Register a
1708
- # delegated administrator][1] in the *AWS CloudFormation User Guide*.
1932
+ # Your account must be registered as a delegated administrator in the
1933
+ # management account. For more information, see [Register a delegated
1934
+ # administrator][1] in the *CloudFormation User Guide*.
1709
1935
  #
1710
1936
  #
1711
1937
  #
@@ -1773,9 +1999,9 @@ module Aws::CloudFormation
1773
1999
  # * If you are signed in to a delegated administrator account, specify
1774
2000
  # `DELEGATED_ADMIN`.
1775
2001
  #
1776
- # Your AWS account must be registered as a delegated administrator in
1777
- # the management account. For more information, see [Register a
1778
- # delegated administrator][1] in the *AWS CloudFormation User Guide*.
2002
+ # Your account must be registered as a delegated administrator in the
2003
+ # management account. For more information, see [Register a delegated
2004
+ # administrator][1] in the *CloudFormation User Guide*.
1779
2005
  #
1780
2006
  #
1781
2007
  #
@@ -1862,10 +2088,10 @@ module Aws::CloudFormation
1862
2088
  req.send_request(options)
1863
2089
  end
1864
2090
 
1865
- # Retrieves your account's AWS CloudFormation limits, such as the
1866
- # maximum number of stacks that you can create in your account. For more
1867
- # information about account limits, see [AWS CloudFormation Limits][1]
1868
- # in the *AWS CloudFormation User Guide*.
2091
+ # Retrieves your account's CloudFormation limits, such as the maximum
2092
+ # number of stacks that you can create in your account. For more
2093
+ # information about account limits, see [CloudFormation Limits][1] in
2094
+ # the *CloudFormation User Guide*.
1869
2095
  #
1870
2096
  #
1871
2097
  #
@@ -1904,9 +2130,9 @@ module Aws::CloudFormation
1904
2130
  req.send_request(options)
1905
2131
  end
1906
2132
 
1907
- # Returns the inputs for the change set and a list of changes that AWS
2133
+ # Returns the inputs for the change set and a list of changes that
1908
2134
  # CloudFormation will make if you execute the change set. For more
1909
- # information, see [Updating Stacks Using Change Sets][1] in the AWS
2135
+ # information, see [Updating Stacks Using Change Sets][1] in the
1910
2136
  # CloudFormation User Guide.
1911
2137
  #
1912
2138
  #
@@ -2020,6 +2246,60 @@ module Aws::CloudFormation
2020
2246
  req.send_request(options)
2021
2247
  end
2022
2248
 
2249
+ # Returns information about a CloudFormation extension publisher.
2250
+ #
2251
+ # If you do not supply a `PublisherId`, and you have registered as an
2252
+ # extension publisher, `DescribePublisher` returns information about
2253
+ # your own publisher account.
2254
+ #
2255
+ # For more information on registering as a publisher, see:
2256
+ #
2257
+ # * [RegisterPublisher][1]
2258
+ #
2259
+ # * [Publishing extensions to make them available for public use][2] in
2260
+ # the *CloudFormation CLI User Guide*
2261
+ #
2262
+ #
2263
+ #
2264
+ # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_RegisterPublisher.html
2265
+ # [2]: https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/publish-extension.html
2266
+ #
2267
+ # @option params [String] :publisher_id
2268
+ # The ID of the extension publisher.
2269
+ #
2270
+ # If you do not supply a `PublisherId`, and you have registered as an
2271
+ # extension publisher, `DescribePublisher` returns information about
2272
+ # your own publisher account.
2273
+ #
2274
+ # @return [Types::DescribePublisherOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2275
+ #
2276
+ # * {Types::DescribePublisherOutput#publisher_id #publisher_id} => String
2277
+ # * {Types::DescribePublisherOutput#publisher_status #publisher_status} => String
2278
+ # * {Types::DescribePublisherOutput#identity_provider #identity_provider} => String
2279
+ # * {Types::DescribePublisherOutput#publisher_profile #publisher_profile} => String
2280
+ #
2281
+ # @example Request syntax with placeholder values
2282
+ #
2283
+ # resp = client.describe_publisher({
2284
+ # publisher_id: "PublisherId",
2285
+ # })
2286
+ #
2287
+ # @example Response structure
2288
+ #
2289
+ # resp.publisher_id #=> String
2290
+ # resp.publisher_status #=> String, one of "VERIFIED", "UNVERIFIED"
2291
+ # resp.identity_provider #=> String, one of "AWS_Marketplace", "GitHub", "Bitbucket"
2292
+ # resp.publisher_profile #=> String
2293
+ #
2294
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/DescribePublisher AWS API Documentation
2295
+ #
2296
+ # @overload describe_publisher(params = {})
2297
+ # @param [Hash] params ({})
2298
+ def describe_publisher(params = {}, options = {})
2299
+ req = build_request(:describe_publisher, params)
2300
+ req.send_request(options)
2301
+ end
2302
+
2023
2303
  # Returns information about a stack drift detection operation. A stack
2024
2304
  # drift detection operation detects whether a stack's actual
2025
2305
  # configuration differs, or has *drifted*, from it's expected
@@ -2043,10 +2323,10 @@ module Aws::CloudFormation
2043
2323
  # @option params [required, String] :stack_drift_detection_id
2044
2324
  # The ID of the drift detection results of this operation.
2045
2325
  #
2046
- # AWS CloudFormation generates new results, with a new drift detection
2047
- # ID, each time this operation is run. However, the number of drift
2048
- # results AWS CloudFormation retains for any given stack, and for how
2049
- # long, may vary.
2326
+ # CloudFormation generates new results, with a new drift detection ID,
2327
+ # each time this operation is run. However, the number of drift results
2328
+ # CloudFormation retains for any given stack, and for how long, may
2329
+ # vary.
2050
2330
  #
2051
2331
  # @return [Types::DescribeStackDriftDetectionStatusOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2052
2332
  #
@@ -2085,7 +2365,7 @@ module Aws::CloudFormation
2085
2365
 
2086
2366
  # Returns all stack related events for a specified stack in reverse
2087
2367
  # chronological order. For more information about a stack's event
2088
- # history, go to [Stacks][1] in the AWS CloudFormation User Guide.
2368
+ # history, go to [Stacks][1] in the CloudFormation User Guide.
2089
2369
  #
2090
2370
  # <note markdown="1"> You can list events for stacks that have failed to create or have been
2091
2371
  # deleted by specifying the unique stack identifier (stack ID).
@@ -2151,7 +2431,7 @@ module Aws::CloudFormation
2151
2431
  end
2152
2432
 
2153
2433
  # Returns the stack instance that's associated with the specified stack
2154
- # set, AWS account, and Region.
2434
+ # set, account, and Region.
2155
2435
  #
2156
2436
  # For a list of stack instances that are associated with a specific
2157
2437
  # stack set, use ListStackInstances.
@@ -2161,7 +2441,7 @@ module Aws::CloudFormation
2161
2441
  # stack instance information for.
2162
2442
  #
2163
2443
  # @option params [required, String] :stack_instance_account
2164
- # The ID of an AWS account that's associated with this stack instance.
2444
+ # The ID of an account that's associated with this stack instance.
2165
2445
  #
2166
2446
  # @option params [required, String] :stack_instance_region
2167
2447
  # The name of a Region that's associated with this stack instance.
@@ -2179,9 +2459,9 @@ module Aws::CloudFormation
2179
2459
  # * If you are signed in to a delegated administrator account, specify
2180
2460
  # `DELEGATED_ADMIN`.
2181
2461
  #
2182
- # Your AWS account must be registered as a delegated administrator in
2183
- # the management account. For more information, see [Register a
2184
- # delegated administrator][1] in the *AWS CloudFormation User Guide*.
2462
+ # Your account must be registered as a delegated administrator in the
2463
+ # management account. For more information, see [Register a delegated
2464
+ # administrator][1] in the *CloudFormation User Guide*.
2185
2465
  #
2186
2466
  #
2187
2467
  #
@@ -2288,7 +2568,7 @@ module Aws::CloudFormation
2288
2568
 
2289
2569
  # Returns drift information for the resources that have been checked for
2290
2570
  # drift in the specified stack. This includes actual and expected
2291
- # configuration values for resources where AWS CloudFormation detects
2571
+ # configuration values for resources where CloudFormation detects
2292
2572
  # configuration drift.
2293
2573
  #
2294
2574
  # For a given stack, there will be one `StackResourceDrift` for each
@@ -2322,8 +2602,7 @@ module Aws::CloudFormation
2322
2602
  # * `IN_SYNC`\: The resources's actual configuration matches its
2323
2603
  # expected template configuration.
2324
2604
  #
2325
- # * `NOT_CHECKED`\: AWS CloudFormation does not currently return this
2326
- # value.
2605
+ # * `NOT_CHECKED`\: CloudFormation does not currently return this value.
2327
2606
  #
2328
2607
  # @option params [String] :next_token
2329
2608
  # A string that identifies the next page of stack resource drift
@@ -2383,11 +2662,11 @@ module Aws::CloudFormation
2383
2662
  req.send_request(options)
2384
2663
  end
2385
2664
 
2386
- # Returns AWS resource descriptions for running and deleted stacks. If
2387
- # `StackName` is specified, all the associated resources that are part
2388
- # of the stack are returned. If `PhysicalResourceId` is specified, the
2389
- # associated resources of the stack that the resource belongs to are
2390
- # returned.
2665
+ # Returns Amazon Web Services resource descriptions for running and
2666
+ # deleted stacks. If `StackName` is specified, all the associated
2667
+ # resources that are part of the stack are returned. If
2668
+ # `PhysicalResourceId` is specified, the associated resources of the
2669
+ # stack that the resource belongs to are returned.
2391
2670
  #
2392
2671
  # <note markdown="1"> Only the first 100 resources will be returned. If your stack has more
2393
2672
  # resources than this, you should use `ListStackResources` instead.
@@ -2400,8 +2679,8 @@ module Aws::CloudFormation
2400
2679
  # You must specify either `StackName` or `PhysicalResourceId`, but not
2401
2680
  # both. In addition, you can specify `LogicalResourceId` to filter the
2402
2681
  # returned result. For more information about resources, the
2403
- # `LogicalResourceId` and `PhysicalResourceId`, go to the [AWS
2404
- # CloudFormation User Guide][1].
2682
+ # `LogicalResourceId` and `PhysicalResourceId`, go to the
2683
+ # [CloudFormation User Guide][1].
2405
2684
  #
2406
2685
  # <note markdown="1"> A `ValidationError` is returned if you specify both `StackName` and
2407
2686
  # `PhysicalResourceId` in the same request.
@@ -2433,7 +2712,7 @@ module Aws::CloudFormation
2433
2712
  #
2434
2713
  # @option params [String] :physical_resource_id
2435
2714
  # The name or unique identifier that corresponds to a physical instance
2436
- # ID of a resource supported by AWS CloudFormation.
2715
+ # ID of a resource supported by CloudFormation.
2437
2716
  #
2438
2717
  # For example, for an Amazon Elastic Compute Cloud (EC2) instance,
2439
2718
  # `PhysicalResourceId` corresponds to the `InstanceId`. You can pass the
@@ -2501,9 +2780,9 @@ module Aws::CloudFormation
2501
2780
  # * If you are signed in to a delegated administrator account, specify
2502
2781
  # `DELEGATED_ADMIN`.
2503
2782
  #
2504
- # Your AWS account must be registered as a delegated administrator in
2505
- # the management account. For more information, see [Register a
2506
- # delegated administrator][1] in the *AWS CloudFormation User Guide*.
2783
+ # Your account must be registered as a delegated administrator in the
2784
+ # management account. For more information, see [Register a delegated
2785
+ # administrator][1] in the *CloudFormation User Guide*.
2507
2786
  #
2508
2787
  #
2509
2788
  #
@@ -2585,9 +2864,9 @@ module Aws::CloudFormation
2585
2864
  # * If you are signed in to a delegated administrator account, specify
2586
2865
  # `DELEGATED_ADMIN`.
2587
2866
  #
2588
- # Your AWS account must be registered as a delegated administrator in
2589
- # the management account. For more information, see [Register a
2590
- # delegated administrator][1] in the *AWS CloudFormation User Guide*.
2867
+ # Your account must be registered as a delegated administrator in the
2868
+ # management account. For more information, see [Register a delegated
2869
+ # administrator][1] in the *CloudFormation User Guide*.
2591
2870
  #
2592
2871
  #
2593
2872
  #
@@ -2776,6 +3055,14 @@ module Aws::CloudFormation
2776
3055
  # that specific extension version. Otherwise, it returns information
2777
3056
  # about the default extension version.
2778
3057
  #
3058
+ # @option params [String] :publisher_id
3059
+ # The publisher ID of the extension publisher.
3060
+ #
3061
+ # Extensions provided by Amazon are not assigned a publisher ID.
3062
+ #
3063
+ # @option params [String] :public_version_number
3064
+ # The version number of a public third-party extension.
3065
+ #
2779
3066
  # @return [Types::DescribeTypeOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2780
3067
  #
2781
3068
  # * {Types::DescribeTypeOutput#arn #arn} => String
@@ -2783,17 +3070,28 @@ module Aws::CloudFormation
2783
3070
  # * {Types::DescribeTypeOutput#type_name #type_name} => String
2784
3071
  # * {Types::DescribeTypeOutput#default_version_id #default_version_id} => String
2785
3072
  # * {Types::DescribeTypeOutput#is_default_version #is_default_version} => Boolean
3073
+ # * {Types::DescribeTypeOutput#type_tests_status #type_tests_status} => String
3074
+ # * {Types::DescribeTypeOutput#type_tests_status_description #type_tests_status_description} => String
2786
3075
  # * {Types::DescribeTypeOutput#description #description} => String
2787
3076
  # * {Types::DescribeTypeOutput#schema #schema} => String
2788
3077
  # * {Types::DescribeTypeOutput#provisioning_type #provisioning_type} => String
2789
3078
  # * {Types::DescribeTypeOutput#deprecated_status #deprecated_status} => String
2790
3079
  # * {Types::DescribeTypeOutput#logging_config #logging_config} => Types::LoggingConfig
3080
+ # * {Types::DescribeTypeOutput#required_activated_types #required_activated_types} => Array&lt;Types::RequiredActivatedType&gt;
2791
3081
  # * {Types::DescribeTypeOutput#execution_role_arn #execution_role_arn} => String
2792
3082
  # * {Types::DescribeTypeOutput#visibility #visibility} => String
2793
3083
  # * {Types::DescribeTypeOutput#source_url #source_url} => String
2794
3084
  # * {Types::DescribeTypeOutput#documentation_url #documentation_url} => String
2795
3085
  # * {Types::DescribeTypeOutput#last_updated #last_updated} => Time
2796
3086
  # * {Types::DescribeTypeOutput#time_created #time_created} => Time
3087
+ # * {Types::DescribeTypeOutput#configuration_schema #configuration_schema} => String
3088
+ # * {Types::DescribeTypeOutput#publisher_id #publisher_id} => String
3089
+ # * {Types::DescribeTypeOutput#original_type_name #original_type_name} => String
3090
+ # * {Types::DescribeTypeOutput#original_type_arn #original_type_arn} => String
3091
+ # * {Types::DescribeTypeOutput#public_version_number #public_version_number} => String
3092
+ # * {Types::DescribeTypeOutput#latest_public_version #latest_public_version} => String
3093
+ # * {Types::DescribeTypeOutput#is_activated #is_activated} => Boolean
3094
+ # * {Types::DescribeTypeOutput#auto_update #auto_update} => Boolean
2797
3095
  #
2798
3096
  # @example Request syntax with placeholder values
2799
3097
  #
@@ -2802,6 +3100,8 @@ module Aws::CloudFormation
2802
3100
  # type_name: "TypeName",
2803
3101
  # arn: "TypeArn",
2804
3102
  # version_id: "TypeVersionId",
3103
+ # publisher_id: "PublisherId",
3104
+ # public_version_number: "PublicVersionNumber",
2805
3105
  # })
2806
3106
  #
2807
3107
  # @example Response structure
@@ -2811,18 +3111,34 @@ module Aws::CloudFormation
2811
3111
  # resp.type_name #=> String
2812
3112
  # resp.default_version_id #=> String
2813
3113
  # resp.is_default_version #=> Boolean
3114
+ # resp.type_tests_status #=> String, one of "PASSED", "FAILED", "IN_PROGRESS", "NOT_TESTED"
3115
+ # resp.type_tests_status_description #=> String
2814
3116
  # resp.description #=> String
2815
3117
  # resp.schema #=> String
2816
3118
  # resp.provisioning_type #=> String, one of "NON_PROVISIONABLE", "IMMUTABLE", "FULLY_MUTABLE"
2817
3119
  # resp.deprecated_status #=> String, one of "LIVE", "DEPRECATED"
2818
3120
  # resp.logging_config.log_role_arn #=> String
2819
3121
  # resp.logging_config.log_group_name #=> String
3122
+ # resp.required_activated_types #=> Array
3123
+ # resp.required_activated_types[0].type_name_alias #=> String
3124
+ # resp.required_activated_types[0].original_type_name #=> String
3125
+ # resp.required_activated_types[0].publisher_id #=> String
3126
+ # resp.required_activated_types[0].supported_major_versions #=> Array
3127
+ # resp.required_activated_types[0].supported_major_versions[0] #=> Integer
2820
3128
  # resp.execution_role_arn #=> String
2821
3129
  # resp.visibility #=> String, one of "PUBLIC", "PRIVATE"
2822
3130
  # resp.source_url #=> String
2823
3131
  # resp.documentation_url #=> String
2824
3132
  # resp.last_updated #=> Time
2825
3133
  # resp.time_created #=> Time
3134
+ # resp.configuration_schema #=> String
3135
+ # resp.publisher_id #=> String
3136
+ # resp.original_type_name #=> String
3137
+ # resp.original_type_arn #=> String
3138
+ # resp.public_version_number #=> String
3139
+ # resp.latest_public_version #=> String
3140
+ # resp.is_activated #=> Boolean
3141
+ # resp.auto_update #=> Boolean
2826
3142
  #
2827
3143
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/DescribeType AWS API Documentation
2828
3144
  #
@@ -2886,14 +3202,13 @@ module Aws::CloudFormation
2886
3202
  # Detects whether a stack's actual configuration differs, or has
2887
3203
  # *drifted*, from it's expected configuration, as defined in the stack
2888
3204
  # template and any values specified as template parameters. For each
2889
- # resource in the stack that supports drift detection, AWS
2890
- # CloudFormation compares the actual configuration of the resource with
2891
- # its expected template configuration. Only resource properties
2892
- # explicitly defined in the stack template are checked for drift. A
2893
- # stack is considered to have drifted if one or more of its resources
2894
- # differ from their expected template configurations. For more
2895
- # information, see [Detecting Unregulated Configuration Changes to
2896
- # Stacks and Resources][1].
3205
+ # resource in the stack that supports drift detection, CloudFormation
3206
+ # compares the actual configuration of the resource with its expected
3207
+ # template configuration. Only resource properties explicitly defined in
3208
+ # the stack template are checked for drift. A stack is considered to
3209
+ # have drifted if one or more of its resources differ from their
3210
+ # expected template configurations. For more information, see [Detecting
3211
+ # Unregulated Configuration Changes to Stacks and Resources][1].
2897
3212
  #
2898
3213
  # Use `DetectStackDrift` to detect drift on all supported resources for
2899
3214
  # a given stack, or DetectStackResourceDrift to detect drift on
@@ -2909,8 +3224,8 @@ module Aws::CloudFormation
2909
3224
  # completed, use DescribeStackResourceDrifts to return drift information
2910
3225
  # about the stack and its resources.
2911
3226
  #
2912
- # When detecting drift on a stack, AWS CloudFormation does not detect
2913
- # drift on any nested stacks belonging to that stack. Perform
3227
+ # When detecting drift on a stack, CloudFormation does not detect drift
3228
+ # on any nested stacks belonging to that stack. Perform
2914
3229
  # `DetectStackDrift` directly on the nested stack itself.
2915
3230
  #
2916
3231
  #
@@ -2952,7 +3267,7 @@ module Aws::CloudFormation
2952
3267
  # differs, or has *drifted*, from it's expected configuration, as
2953
3268
  # defined in the stack template and any values specified as template
2954
3269
  # parameters. This information includes actual and expected property
2955
- # values for resources in which AWS CloudFormation detects drift. Only
3270
+ # values for resources in which CloudFormation detects drift. Only
2956
3271
  # resource properties explicitly defined in the stack template are
2957
3272
  # checked for drift. For more information about stack and resource
2958
3273
  # drift, see [Detecting Unregulated Configuration Changes to Stacks and
@@ -3066,8 +3381,8 @@ module Aws::CloudFormation
3066
3381
  # operation.
3067
3382
  #
3068
3383
  # @option params [Types::StackSetOperationPreferences] :operation_preferences
3069
- # The user-specified preferences for how AWS CloudFormation performs a
3070
- # stack set operation.
3384
+ # The user-specified preferences for how CloudFormation performs a stack
3385
+ # set operation.
3071
3386
  #
3072
3387
  # For more information on maximum concurrent accounts and failure
3073
3388
  # tolerance, see [Stack set operation options][1].
@@ -3095,9 +3410,9 @@ module Aws::CloudFormation
3095
3410
  # * If you are signed in to a delegated administrator account, specify
3096
3411
  # `DELEGATED_ADMIN`.
3097
3412
  #
3098
- # Your AWS account must be registered as a delegated administrator in
3099
- # the management account. For more information, see [Register a
3100
- # delegated administrator][1] in the *AWS CloudFormation User Guide*.
3413
+ # Your account must be registered as a delegated administrator in the
3414
+ # management account. For more information, see [Register a delegated
3415
+ # administrator][1] in the *CloudFormation User Guide*.
3101
3416
  #
3102
3417
  #
3103
3418
  #
@@ -3137,13 +3452,13 @@ module Aws::CloudFormation
3137
3452
  end
3138
3453
 
3139
3454
  # Returns the estimated monthly cost of a template. The return value is
3140
- # an AWS Simple Monthly Calculator URL with a query string that
3141
- # describes the resources required to run the template.
3455
+ # an Amazon Web Services Simple Monthly Calculator URL with a query
3456
+ # string that describes the resources required to run the template.
3142
3457
  #
3143
3458
  # @option params [String] :template_body
3144
3459
  # Structure containing the template body with a minimum length of 1 byte
3145
3460
  # and a maximum length of 51,200 bytes. (For more information, go to
3146
- # [Template Anatomy][1] in the AWS CloudFormation User Guide.)
3461
+ # [Template Anatomy][1] in the CloudFormation User Guide.)
3147
3462
  #
3148
3463
  # Conditional: You must pass `TemplateBody` or `TemplateURL`. If both
3149
3464
  # are passed, only `TemplateBody` is used.
@@ -3155,7 +3470,7 @@ module Aws::CloudFormation
3155
3470
  # @option params [String] :template_url
3156
3471
  # Location of file containing the template body. The URL must point to a
3157
3472
  # template that is located in an Amazon S3 bucket or a Systems Manager
3158
- # document. For more information, go to [Template Anatomy][1] in the AWS
3473
+ # document. For more information, go to [Template Anatomy][1] in the
3159
3474
  # CloudFormation User Guide.
3160
3475
  #
3161
3476
  # Conditional: You must pass `TemplateURL` or `TemplateBody`. If both
@@ -3202,14 +3517,14 @@ module Aws::CloudFormation
3202
3517
 
3203
3518
  # Updates a stack using the input information that was provided when the
3204
3519
  # specified change set was created. After the call successfully
3205
- # completes, AWS CloudFormation starts updating the stack. Use the
3520
+ # completes, CloudFormation starts updating the stack. Use the
3206
3521
  # DescribeStacks action to view the status of the update.
3207
3522
  #
3208
- # When you execute a change set, AWS CloudFormation deletes all other
3209
- # change sets associated with the stack because they aren't valid for
3210
- # the updated stack.
3523
+ # When you execute a change set, CloudFormation deletes all other change
3524
+ # sets associated with the stack because they aren't valid for the
3525
+ # updated stack.
3211
3526
  #
3212
- # If a stack policy is associated with the stack, AWS CloudFormation
3527
+ # If a stack policy is associated with the stack, CloudFormation
3213
3528
  # enforces the policy during the update. You can't specify a temporary
3214
3529
  # stack policy that overrides the current policy.
3215
3530
  #
@@ -3226,10 +3541,10 @@ module Aws::CloudFormation
3226
3541
  #
3227
3542
  # @option params [String] :client_request_token
3228
3543
  # A unique identifier for this `ExecuteChangeSet` request. Specify this
3229
- # token if you plan to retry requests so that AWS CloudFormation knows
3230
- # that you're not attempting to execute a change set to update a stack
3231
- # with the same name. You might retry `ExecuteChangeSet` requests to
3232
- # ensure that AWS CloudFormation successfully received them.
3544
+ # token if you plan to retry requests so that CloudFormation knows that
3545
+ # you're not attempting to execute a change set to update a stack with
3546
+ # the same name. You might retry `ExecuteChangeSet` requests to ensure
3547
+ # that CloudFormation successfully received them.
3233
3548
  #
3234
3549
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
3235
3550
  #
@@ -3302,19 +3617,19 @@ module Aws::CloudFormation
3302
3617
  # Default: There is no default value.
3303
3618
  #
3304
3619
  # @option params [String] :change_set_name
3305
- # The name or Amazon Resource Name (ARN) of a change set for which AWS
3620
+ # The name or Amazon Resource Name (ARN) of a change set for which
3306
3621
  # CloudFormation returns the associated template. If you specify a name,
3307
3622
  # you must also specify the `StackName`.
3308
3623
  #
3309
3624
  # @option params [String] :template_stage
3310
3625
  # For templates that include transforms, the stage of the template that
3311
- # AWS CloudFormation returns. To get the user-submitted template,
3312
- # specify `Original`. To get the template after AWS CloudFormation has
3313
- # processed all transforms, specify `Processed`.
3626
+ # CloudFormation returns. To get the user-submitted template, specify
3627
+ # `Original`. To get the template after CloudFormation has processed all
3628
+ # transforms, specify `Processed`.
3314
3629
  #
3315
3630
  # If the template doesn't include transforms, `Original` and
3316
- # `Processed` return the same template. By default, AWS CloudFormation
3317
- # specifies `Original`.
3631
+ # `Processed` return the same template. By default, CloudFormation
3632
+ # specifies `Processed`.
3318
3633
  #
3319
3634
  # @return [Types::GetTemplateOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
3320
3635
  #
@@ -3360,8 +3675,7 @@ module Aws::CloudFormation
3360
3675
  # @option params [String] :template_body
3361
3676
  # Structure containing the template body with a minimum length of 1 byte
3362
3677
  # and a maximum length of 51,200 bytes. For more information about
3363
- # templates, see [Template Anatomy][1] in the AWS CloudFormation User
3364
- # Guide.
3678
+ # templates, see [Template Anatomy][1] in the CloudFormation User Guide.
3365
3679
  #
3366
3680
  # Conditional: You must specify only one of the following parameters:
3367
3681
  # `StackName`, `StackSetName`, `TemplateBody`, or `TemplateURL`.
@@ -3374,8 +3688,7 @@ module Aws::CloudFormation
3374
3688
  # Location of file containing the template body. The URL must point to a
3375
3689
  # template (max size: 460,800 bytes) that is located in an Amazon S3
3376
3690
  # bucket or a Systems Manager document. For more information about
3377
- # templates, see [Template Anatomy][1] in the AWS CloudFormation User
3378
- # Guide.
3691
+ # templates, see [Template Anatomy][1] in the CloudFormation User Guide.
3379
3692
  #
3380
3693
  # Conditional: You must specify only one of the following parameters:
3381
3694
  # `StackName`, `StackSetName`, `TemplateBody`, or `TemplateURL`.
@@ -3400,6 +3713,27 @@ module Aws::CloudFormation
3400
3713
  # Conditional: You must specify only one of the following parameters:
3401
3714
  # `StackName`, `StackSetName`, `TemplateBody`, or `TemplateURL`.
3402
3715
  #
3716
+ # @option params [String] :call_as
3717
+ # \[Service-managed permissions\] Specifies whether you are acting as an
3718
+ # account administrator in the organization's management account or as
3719
+ # a delegated administrator in a member account.
3720
+ #
3721
+ # By default, `SELF` is specified. Use `SELF` for stack sets with
3722
+ # self-managed permissions.
3723
+ #
3724
+ # * If you are signed in to the management account, specify `SELF`.
3725
+ #
3726
+ # * If you are signed in to a delegated administrator account, specify
3727
+ # `DELEGATED_ADMIN`.
3728
+ #
3729
+ # Your account must be registered as a delegated administrator in the
3730
+ # management account. For more information, see [Register a delegated
3731
+ # administrator][1] in the *CloudFormation User Guide*.
3732
+ #
3733
+ #
3734
+ #
3735
+ # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-orgs-delegated-admin.html
3736
+ #
3403
3737
  # @return [Types::GetTemplateSummaryOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
3404
3738
  #
3405
3739
  # * {Types::GetTemplateSummaryOutput#parameters #parameters} => Array&lt;Types::ParameterDeclaration&gt;
@@ -3419,6 +3753,7 @@ module Aws::CloudFormation
3419
3753
  # template_url: "TemplateURL",
3420
3754
  # stack_name: "StackNameOrId",
3421
3755
  # stack_set_name: "StackSetNameOrId",
3756
+ # call_as: "SELF", # accepts SELF, DELEGATED_ADMIN
3422
3757
  # })
3423
3758
  #
3424
3759
  # @example Response structure
@@ -3457,8 +3792,86 @@ module Aws::CloudFormation
3457
3792
  req.send_request(options)
3458
3793
  end
3459
3794
 
3795
+ # Import existing stacks into a new stack sets. Use the stack import
3796
+ # operation to import up to 10 stacks into a new stack set in the same
3797
+ # account as the source stack or in a different administrator account
3798
+ # and Region, by specifying the stack ID of the stack you intend to
3799
+ # import.
3800
+ #
3801
+ # <note markdown="1"> `ImportStacksToStackSet` is only supported by self-managed
3802
+ # permissions.
3803
+ #
3804
+ # </note>
3805
+ #
3806
+ # @option params [required, String] :stack_set_name
3807
+ # The name of the stack set. The name must be unique in the Region where
3808
+ # you create your stack set.
3809
+ #
3810
+ # @option params [required, Array<String>] :stack_ids
3811
+ # The IDs of the stacks you are importing into a stack set. You import
3812
+ # up to 10 stacks per stack set at a time.
3813
+ #
3814
+ # @option params [Types::StackSetOperationPreferences] :operation_preferences
3815
+ # The user-specified preferences for how CloudFormation performs a stack
3816
+ # set operation.
3817
+ #
3818
+ # For more information on maximum concurrent accounts and failure
3819
+ # tolerance, see [Stack set operation options][1].
3820
+ #
3821
+ #
3822
+ #
3823
+ # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-concepts.html#stackset-ops-options
3824
+ #
3825
+ # @option params [String] :operation_id
3826
+ # A unique, user defined, identifier for the stack set operation.
3827
+ #
3828
+ # **A suitable default value is auto-generated.** You should normally
3829
+ # not need to pass this option.**
3830
+ #
3831
+ # @option params [String] :call_as
3832
+ # By default, `SELF` is specified. Use `SELF` for stack sets with
3833
+ # self-managed permissions.
3834
+ #
3835
+ # * If you are signed in to the management account, specify `SELF`.
3836
+ #
3837
+ # * For service managed stack sets, specify `DELEGATED_ADMIN`.
3838
+ #
3839
+ # @return [Types::ImportStacksToStackSetOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
3840
+ #
3841
+ # * {Types::ImportStacksToStackSetOutput#operation_id #operation_id} => String
3842
+ #
3843
+ # @example Request syntax with placeholder values
3844
+ #
3845
+ # resp = client.import_stacks_to_stack_set({
3846
+ # stack_set_name: "StackSetNameOrId", # required
3847
+ # stack_ids: ["StackId"], # required
3848
+ # operation_preferences: {
3849
+ # region_concurrency_type: "SEQUENTIAL", # accepts SEQUENTIAL, PARALLEL
3850
+ # region_order: ["Region"],
3851
+ # failure_tolerance_count: 1,
3852
+ # failure_tolerance_percentage: 1,
3853
+ # max_concurrent_count: 1,
3854
+ # max_concurrent_percentage: 1,
3855
+ # },
3856
+ # operation_id: "ClientRequestToken",
3857
+ # call_as: "SELF", # accepts SELF, DELEGATED_ADMIN
3858
+ # })
3859
+ #
3860
+ # @example Response structure
3861
+ #
3862
+ # resp.operation_id #=> String
3863
+ #
3864
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/ImportStacksToStackSet AWS API Documentation
3865
+ #
3866
+ # @overload import_stacks_to_stack_set(params = {})
3867
+ # @param [Hash] params ({})
3868
+ def import_stacks_to_stack_set(params = {}, options = {})
3869
+ req = build_request(:import_stacks_to_stack_set, params)
3870
+ req.send_request(options)
3871
+ end
3872
+
3460
3873
  # Returns the ID and status of each active change set for a stack. For
3461
- # example, AWS CloudFormation lists change sets that are in the
3874
+ # example, CloudFormation lists change sets that are in the
3462
3875
  # `CREATE_IN_PROGRESS` or `CREATE_PENDING` state.
3463
3876
  #
3464
3877
  # @option params [required, String] :stack_name
@@ -3514,7 +3927,7 @@ module Aws::CloudFormation
3514
3927
  # values that you can import into other stacks. To import values, use
3515
3928
  # the [ `Fn::ImportValue` ][1] function.
3516
3929
  #
3517
- # For more information, see [ AWS CloudFormation Export Stack Output
3930
+ # For more information, see [ CloudFormation Export Stack Output
3518
3931
  # Values][2].
3519
3932
  #
3520
3933
  #
@@ -3569,7 +3982,7 @@ module Aws::CloudFormation
3569
3982
  # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-importvalue.html
3570
3983
  #
3571
3984
  # @option params [required, String] :export_name
3572
- # The name of the exported output value. AWS CloudFormation returns the
3985
+ # The name of the exported output value. CloudFormation returns the
3573
3986
  # stack names that are importing this value.
3574
3987
  #
3575
3988
  # @option params [String] :next_token
@@ -3608,8 +4021,8 @@ module Aws::CloudFormation
3608
4021
 
3609
4022
  # Returns summary information about stack instances that are associated
3610
4023
  # with the specified stack set. You can filter for stack instances that
3611
- # are associated with a specific AWS account name or Region, or that
3612
- # have a specific status.
4024
+ # are associated with a specific account name or Region, or that have a
4025
+ # specific status.
3613
4026
  #
3614
4027
  # @option params [required, String] :stack_set_name
3615
4028
  # The name or unique ID of the stack set that you want to list stack
@@ -3633,7 +4046,7 @@ module Aws::CloudFormation
3633
4046
  # The status that stack instances are filtered by.
3634
4047
  #
3635
4048
  # @option params [String] :stack_instance_account
3636
- # The name of the AWS account that you want to list stack instances for.
4049
+ # The name of the account that you want to list stack instances for.
3637
4050
  #
3638
4051
  # @option params [String] :stack_instance_region
3639
4052
  # The name of the Region where you want to list stack instances.
@@ -3651,9 +4064,9 @@ module Aws::CloudFormation
3651
4064
  # * If you are signed in to a delegated administrator account, specify
3652
4065
  # `DELEGATED_ADMIN`.
3653
4066
  #
3654
- # Your AWS account must be registered as a delegated administrator in
3655
- # the management account. For more information, see [Register a
3656
- # delegated administrator][1] in the *AWS CloudFormation User Guide*.
4067
+ # Your account must be registered as a delegated administrator in the
4068
+ # management account. For more information, see [Register a delegated
4069
+ # administrator][1] in the *CloudFormation User Guide*.
3657
4070
  #
3658
4071
  #
3659
4072
  #
@@ -3803,9 +4216,9 @@ module Aws::CloudFormation
3803
4216
  # * If you are signed in to a delegated administrator account, specify
3804
4217
  # `DELEGATED_ADMIN`.
3805
4218
  #
3806
- # Your AWS account must be registered as a delegated administrator in
3807
- # the management account. For more information, see [Register a
3808
- # delegated administrator][1] in the *AWS CloudFormation User Guide*.
4219
+ # Your account must be registered as a delegated administrator in the
4220
+ # management account. For more information, see [Register a delegated
4221
+ # administrator][1] in the *CloudFormation User Guide*.
3809
4222
  #
3810
4223
  #
3811
4224
  #
@@ -3883,9 +4296,9 @@ module Aws::CloudFormation
3883
4296
  # * If you are signed in to a delegated administrator account, specify
3884
4297
  # `DELEGATED_ADMIN`.
3885
4298
  #
3886
- # Your AWS account must be registered as a delegated administrator in
3887
- # the management account. For more information, see [Register a
3888
- # delegated administrator][1] in the *AWS CloudFormation User Guide*.
4299
+ # Your account must be registered as a delegated administrator in the
4300
+ # management account. For more information, see [Register a delegated
4301
+ # administrator][1] in the *CloudFormation User Guide*.
3889
4302
  #
3890
4303
  #
3891
4304
  #
@@ -3930,8 +4343,8 @@ module Aws::CloudFormation
3930
4343
  # the user.
3931
4344
  #
3932
4345
  # * \[Self-managed permissions\] If you set the `CallAs` parameter to
3933
- # `SELF` while signed in to your AWS account, `ListStackSets` returns
3934
- # all self-managed stack sets in your AWS account.
4346
+ # `SELF` while signed in to your account, `ListStackSets` returns all
4347
+ # self-managed stack sets in your account.
3935
4348
  #
3936
4349
  # * \[Service-managed permissions\] If you set the `CallAs` parameter to
3937
4350
  # `SELF` while signed in to the organization's management account,
@@ -3973,9 +4386,9 @@ module Aws::CloudFormation
3973
4386
  # * If you are signed in to a delegated administrator account, specify
3974
4387
  # `DELEGATED_ADMIN`.
3975
4388
  #
3976
- # Your AWS account must be registered as a delegated administrator in
3977
- # the management account. For more information, see [Register a
3978
- # delegated administrator][1] in the *AWS CloudFormation User Guide*.
4389
+ # Your account must be registered as a delegated administrator in the
4390
+ # management account. For more information, see [Register a delegated
4391
+ # administrator][1] in the *CloudFormation User Guide*.
3979
4392
  #
3980
4393
  #
3981
4394
  #
@@ -4194,6 +4607,11 @@ module Aws::CloudFormation
4194
4607
  #
4195
4608
  # The default is `LIVE`.
4196
4609
  #
4610
+ # @option params [String] :publisher_id
4611
+ # The publisher ID of the extension publisher.
4612
+ #
4613
+ # Extensions published by Amazon are not assigned a publisher ID.
4614
+ #
4197
4615
  # @return [Types::ListTypeVersionsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
4198
4616
  #
4199
4617
  # * {Types::ListTypeVersionsOutput#type_version_summaries #type_version_summaries} => Array&lt;Types::TypeVersionSummary&gt;
@@ -4206,10 +4624,11 @@ module Aws::CloudFormation
4206
4624
  # resp = client.list_type_versions({
4207
4625
  # type: "RESOURCE", # accepts RESOURCE, MODULE
4208
4626
  # type_name: "TypeName",
4209
- # arn: "PrivateTypeArn",
4627
+ # arn: "TypeArn",
4210
4628
  # max_results: 1,
4211
4629
  # next_token: "NextToken",
4212
4630
  # deprecated_status: "LIVE", # accepts LIVE, DEPRECATED
4631
+ # publisher_id: "PublisherId",
4213
4632
  # })
4214
4633
  #
4215
4634
  # @example Response structure
@@ -4222,6 +4641,7 @@ module Aws::CloudFormation
4222
4641
  # resp.type_version_summaries[0].arn #=> String
4223
4642
  # resp.type_version_summaries[0].time_created #=> Time
4224
4643
  # resp.type_version_summaries[0].description #=> String
4644
+ # resp.type_version_summaries[0].public_version_number #=> String
4225
4645
  # resp.next_token #=> String
4226
4646
  #
4227
4647
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/ListTypeVersions AWS API Documentation
@@ -4237,36 +4657,45 @@ module Aws::CloudFormation
4237
4657
  # with CloudFormation.
4238
4658
  #
4239
4659
  # @option params [String] :visibility
4240
- # The scope at which the extension is visible and usable in
4660
+ # The scope at which the extensions are visible and usable in
4241
4661
  # CloudFormation operations.
4242
4662
  #
4243
4663
  # Valid values include:
4244
4664
  #
4245
- # * `PRIVATE`\: The extension is only visible and usable within the
4246
- # account in which it is registered. Currently, AWS CloudFormation
4247
- # marks any extension you create as `PRIVATE`.
4665
+ # * `PRIVATE`\: Extensions that are visible and usable within this
4666
+ # account and region. This includes:
4667
+ #
4668
+ # * Private extensions you have registered in this account and region.
4248
4669
  #
4249
- # * `PUBLIC`\: The extension is publically visible and usable within any
4250
- # Amazon account.
4670
+ # * Public extensions that you have activated in this account and
4671
+ # region.
4672
+ #
4673
+ # * `PUBLIC`\: Extensions that are publicly visible and available to be
4674
+ # activated within any Amazon account. This includes extensions from
4675
+ # Amazon, as well as third-party publishers.
4251
4676
  #
4252
4677
  # The default is `PRIVATE`.
4253
4678
  #
4254
4679
  # @option params [String] :provisioning_type
4255
- # The provisioning behavior of the type. AWS CloudFormation determines
4256
- # the provisioning type during registration, based on the types of
4257
- # handlers in the schema handler package submitted.
4680
+ # For resource types, the provisioning behavior of the resource type.
4681
+ # CloudFormation determines the provisioning type during registration,
4682
+ # based on the types of handlers in the schema handler package
4683
+ # submitted.
4258
4684
  #
4259
4685
  # Valid values include:
4260
4686
  #
4261
- # * `FULLY_MUTABLE`\: The extension includes an update handler to
4262
- # process updates to the extension during stack update operations.
4687
+ # * `FULLY_MUTABLE`\: The resource type includes an update handler to
4688
+ # process updates to the type during stack update operations.
4263
4689
  #
4264
- # * `IMMUTABLE`\: The extension does not include an update handler, so
4265
- # the extension cannot be updated and must instead be replaced during
4690
+ # * `IMMUTABLE`\: The resource type does not include an update handler,
4691
+ # so the type cannot be updated and must instead be replaced during
4266
4692
  # stack update operations.
4267
4693
  #
4268
- # * `NON_PROVISIONABLE`\: The extension does not include create, read,
4269
- # and delete handlers, and therefore cannot actually be provisioned.
4694
+ # * `NON_PROVISIONABLE`\: The resource type does not include create,
4695
+ # read, and delete handlers, and therefore cannot actually be
4696
+ # provisioned.
4697
+ #
4698
+ # The default is `FULLY_MUTABLE`.
4270
4699
  #
4271
4700
  # @option params [String] :deprecated_status
4272
4701
  # The deprecation status of the extension that you want to get summary
@@ -4283,6 +4712,12 @@ module Aws::CloudFormation
4283
4712
  # @option params [String] :type
4284
4713
  # The type of extension.
4285
4714
  #
4715
+ # @option params [Types::TypeFilters] :filters
4716
+ # Filter criteria to use in determining which extensions to return.
4717
+ #
4718
+ # If you specify a filter, CloudFormation ignores any specified
4719
+ # `Visibility` value when returning the list of types.
4720
+ #
4286
4721
  # @option params [Integer] :max_results
4287
4722
  # The maximum number of results to be returned with a single call. If
4288
4723
  # the number of available results exceeds this maximum, the response
@@ -4311,6 +4746,11 @@ module Aws::CloudFormation
4311
4746
  # provisioning_type: "NON_PROVISIONABLE", # accepts NON_PROVISIONABLE, IMMUTABLE, FULLY_MUTABLE
4312
4747
  # deprecated_status: "LIVE", # accepts LIVE, DEPRECATED
4313
4748
  # type: "RESOURCE", # accepts RESOURCE, MODULE
4749
+ # filters: {
4750
+ # category: "REGISTERED", # accepts REGISTERED, ACTIVATED, THIRD_PARTY, AWS_TYPES
4751
+ # publisher_id: "PublisherId",
4752
+ # type_name_prefix: "TypeNamePrefix",
4753
+ # },
4314
4754
  # max_results: 1,
4315
4755
  # next_token: "NextToken",
4316
4756
  # })
@@ -4324,6 +4764,13 @@ module Aws::CloudFormation
4324
4764
  # resp.type_summaries[0].type_arn #=> String
4325
4765
  # resp.type_summaries[0].last_updated #=> Time
4326
4766
  # resp.type_summaries[0].description #=> String
4767
+ # resp.type_summaries[0].publisher_id #=> String
4768
+ # resp.type_summaries[0].original_type_name #=> String
4769
+ # resp.type_summaries[0].public_version_number #=> String
4770
+ # resp.type_summaries[0].latest_public_version #=> String
4771
+ # resp.type_summaries[0].publisher_identity #=> String, one of "AWS_Marketplace", "GitHub", "Bitbucket"
4772
+ # resp.type_summaries[0].publisher_name #=> String
4773
+ # resp.type_summaries[0].is_activated #=> Boolean
4327
4774
  # resp.next_token #=> String
4328
4775
  #
4329
4776
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/ListTypes AWS API Documentation
@@ -4335,6 +4782,81 @@ module Aws::CloudFormation
4335
4782
  req.send_request(options)
4336
4783
  end
4337
4784
 
4785
+ # Publishes the specified extension to the CloudFormation registry as a
4786
+ # public extension in this region. Public extensions are available for
4787
+ # use by all CloudFormation users. For more information on publishing
4788
+ # extensions, see [Publishing extensions to make them available for
4789
+ # public use][1] in the *CloudFormation CLI User Guide*.
4790
+ #
4791
+ # To publish an extension, you must be registered as a publisher with
4792
+ # CloudFormation. For more information, see [RegisterPublisher][2].
4793
+ #
4794
+ #
4795
+ #
4796
+ # [1]: https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/publish-extension.html
4797
+ # [2]: https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_RegisterPublisher.html
4798
+ #
4799
+ # @option params [String] :type
4800
+ # The type of the extension.
4801
+ #
4802
+ # Conditional: You must specify `Arn`, or `TypeName` and `Type`.
4803
+ #
4804
+ # @option params [String] :arn
4805
+ # The Amazon Resource Number (ARN) of the extension.
4806
+ #
4807
+ # Conditional: You must specify `Arn`, or `TypeName` and `Type`.
4808
+ #
4809
+ # @option params [String] :type_name
4810
+ # The name of the extension.
4811
+ #
4812
+ # Conditional: You must specify `Arn`, or `TypeName` and `Type`.
4813
+ #
4814
+ # @option params [String] :public_version_number
4815
+ # The version number to assign to this version of the extension.
4816
+ #
4817
+ # Use the following format, and adhere to semantic versioning when
4818
+ # assigning a version number to your extension:
4819
+ #
4820
+ # `MAJOR.MINOR.PATCH`
4821
+ #
4822
+ # For more information, see [Semantic Versioning 2.0.0][1].
4823
+ #
4824
+ # If you do not specify a version number, CloudFormation increments the
4825
+ # version number by one minor version release.
4826
+ #
4827
+ # The first time you publish a type, CloudFormation sets the version
4828
+ # number to `1.0.0`, regardless of the value you specify.
4829
+ #
4830
+ #
4831
+ #
4832
+ # [1]: https://semver.org/
4833
+ #
4834
+ # @return [Types::PublishTypeOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
4835
+ #
4836
+ # * {Types::PublishTypeOutput#public_type_arn #public_type_arn} => String
4837
+ #
4838
+ # @example Request syntax with placeholder values
4839
+ #
4840
+ # resp = client.publish_type({
4841
+ # type: "RESOURCE", # accepts RESOURCE, MODULE
4842
+ # arn: "PrivateTypeArn",
4843
+ # type_name: "TypeName",
4844
+ # public_version_number: "PublicVersionNumber",
4845
+ # })
4846
+ #
4847
+ # @example Response structure
4848
+ #
4849
+ # resp.public_type_arn #=> String
4850
+ #
4851
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/PublishType AWS API Documentation
4852
+ #
4853
+ # @overload publish_type(params = {})
4854
+ # @param [Hash] params ({})
4855
+ def publish_type(params = {}, options = {})
4856
+ req = build_request(:publish_type, params)
4857
+ req.send_request(options)
4858
+ end
4859
+
4338
4860
  # Reports progress of a resource handler to CloudFormation.
4339
4861
  #
4340
4862
  # Reserved for use by the [CloudFormation CLI][1]. Do not use this API
@@ -4402,7 +4924,7 @@ module Aws::CloudFormation
4402
4924
  # operation_status: "PENDING", # required, accepts PENDING, IN_PROGRESS, SUCCESS, FAILED
4403
4925
  # current_operation_status: "PENDING", # accepts PENDING, IN_PROGRESS, SUCCESS, FAILED
4404
4926
  # status_message: "StatusMessage",
4405
- # error_code: "NotUpdatable", # accepts NotUpdatable, InvalidRequest, AccessDenied, InvalidCredentials, AlreadyExists, NotFound, ResourceConflict, Throttling, ServiceLimitExceeded, NotStabilized, GeneralServiceException, ServiceInternalError, NetworkFailure, InternalFailure
4927
+ # error_code: "NotUpdatable", # accepts NotUpdatable, InvalidRequest, AccessDenied, InvalidCredentials, AlreadyExists, NotFound, ResourceConflict, Throttling, ServiceLimitExceeded, NotStabilized, GeneralServiceException, ServiceInternalError, NetworkFailure, InternalFailure, InvalidTypeConfiguration
4406
4928
  # resource_model: "ResourceModel",
4407
4929
  # client_request_token: "ClientRequestToken",
4408
4930
  # })
@@ -4416,9 +4938,72 @@ module Aws::CloudFormation
4416
4938
  req.send_request(options)
4417
4939
  end
4418
4940
 
4941
+ # Registers your account as a publisher of public extensions in the
4942
+ # CloudFormation registry. Public extensions are available for use by
4943
+ # all CloudFormation users. This publisher ID applies to your account in
4944
+ # all Regions.
4945
+ #
4946
+ # For information on requirements for registering as a public extension
4947
+ # publisher, see [Registering your account to publish CloudFormation
4948
+ # extensions][1] in the *CloudFormation CLI User Guide*.
4949
+ #
4950
+ #
4951
+ #
4952
+ #
4953
+ #
4954
+ # [1]: https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/publish-extension.html#publish-extension-prereqs
4955
+ #
4956
+ # @option params [Boolean] :accept_terms_and_conditions
4957
+ # Whether you accept the [Terms and Conditions][1] for publishing
4958
+ # extensions in the CloudFormation registry. You must accept the terms
4959
+ # and conditions in order to register to publish public extensions to
4960
+ # the CloudFormation registry.
4961
+ #
4962
+ # The default is `false`.
4963
+ #
4964
+ #
4965
+ #
4966
+ # [1]: https://cloudformation-registry-documents.s3.amazonaws.com/Terms_and_Conditions_for_AWS_CloudFormation_Registry_Publishers.pdf
4967
+ #
4968
+ # @option params [String] :connection_arn
4969
+ # If you are using a Bitbucket or GitHub account for identity
4970
+ # verification, the Amazon Resource Name (ARN) for your connection to
4971
+ # that account.
4972
+ #
4973
+ # For more information, see [Registering your account to publish
4974
+ # CloudFormation extensions][1] in the *CloudFormation CLI User Guide*.
4975
+ #
4976
+ #
4977
+ #
4978
+ # [1]: https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/publish-extension.html#publish-extension-prereqs
4979
+ #
4980
+ # @return [Types::RegisterPublisherOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
4981
+ #
4982
+ # * {Types::RegisterPublisherOutput#publisher_id #publisher_id} => String
4983
+ #
4984
+ # @example Request syntax with placeholder values
4985
+ #
4986
+ # resp = client.register_publisher({
4987
+ # accept_terms_and_conditions: false,
4988
+ # connection_arn: "ConnectionArn",
4989
+ # })
4990
+ #
4991
+ # @example Response structure
4992
+ #
4993
+ # resp.publisher_id #=> String
4994
+ #
4995
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/RegisterPublisher AWS API Documentation
4996
+ #
4997
+ # @overload register_publisher(params = {})
4998
+ # @param [Hash] params ({})
4999
+ def register_publisher(params = {}, options = {})
5000
+ req = build_request(:register_publisher, params)
5001
+ req.send_request(options)
5002
+ end
5003
+
4419
5004
  # Registers an extension with the CloudFormation service. Registering an
4420
5005
  # extension makes it available for use in CloudFormation templates in
4421
- # your AWS account, and includes:
5006
+ # your account, and includes:
4422
5007
  #
4423
5008
  # * Validating the extension schema
4424
5009
  #
@@ -4440,9 +5025,17 @@ module Aws::CloudFormation
4440
5025
  # you can use ` DescribeTypeRegistration ` to monitor the progress of
4441
5026
  # the registration request.
4442
5027
  #
5028
+ # Once you have registered a private extension in your account and
5029
+ # region, use
5030
+ # [SetTypeConfiguration](AWSCloudFormation/latest/APIReference/API_SetTypeConfiguration.html)
5031
+ # to specify configuration properties for the extension. For more
5032
+ # information, see [Configuring extensions at the account level][2] in
5033
+ # the *CloudFormation User Guide*.
5034
+ #
4443
5035
  #
4444
5036
  #
4445
5037
  # [1]: https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/resource-types.html
5038
+ # [2]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/registry-register.html#registry-set-configuration
4446
5039
  #
4447
5040
  # @option params [String] :type
4448
5041
  # The kind of extension.
@@ -4450,8 +5043,13 @@ module Aws::CloudFormation
4450
5043
  # @option params [required, String] :type_name
4451
5044
  # The name of the extension being registered.
4452
5045
  #
4453
- # We recommend that extension names adhere to the following pattern:
4454
- # *company\_or\_organization*\::*service*\::*type*.
5046
+ # We recommend that extension names adhere to the following patterns:
5047
+ #
5048
+ # * For resource types,
5049
+ # *company\_or\_organization*\::*service*\::*type*.
5050
+ #
5051
+ # * For modules,
5052
+ # *company\_or\_organization*\::*service*\::*type*\::MODULE.
4455
5053
  #
4456
5054
  # <note markdown="1"> The following organization namespaces are reserved and cannot be used
4457
5055
  # in your extension names:
@@ -4481,8 +5079,8 @@ module Aws::CloudFormation
4481
5079
  # <note markdown="1"> The user registering the extension must be able to access the package
4482
5080
  # in the S3 bucket. That is, the user needs to have [GetObject][2]
4483
5081
  # permissions for the schema handler package. For more information, see
4484
- # [Actions, Resources, and Condition Keys for Amazon S3][3] in the *AWS
4485
- # Identity and Access Management User Guide*.
5082
+ # [Actions, Resources, and Condition Keys for Amazon S3][3] in the
5083
+ # *Identity and Access Management User Guide*.
4486
5084
  #
4487
5085
  # </note>
4488
5086
  #
@@ -4497,15 +5095,25 @@ module Aws::CloudFormation
4497
5095
  #
4498
5096
  # @option params [String] :execution_role_arn
4499
5097
  # The Amazon Resource Name (ARN) of the IAM role for CloudFormation to
4500
- # assume when invoking the extension. If your extension calls AWS APIs
4501
- # in any of its handlers, you must create an <i> <a
5098
+ # assume when invoking the extension.
5099
+ #
5100
+ # For CloudFormation to assume the specified execution role, the role
5101
+ # must contain a trust relationship with the CloudFormation service
5102
+ # principle (`resources.cloudformation.amazonaws.com`). For more
5103
+ # information on adding trust relationships, see [Modifying a role trust
5104
+ # policy](IAM/latest/UserGuide/roles-managingrole-editing-console.html#roles-managingrole_edit-trust-policy)
5105
+ # in the *Identity and Access Management User Guide*.
5106
+ #
5107
+ # If your extension calls Amazon Web Services APIs in any of its
5108
+ # handlers, you must create an <i> <a
4502
5109
  # href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html">IAM
4503
5110
  # execution role</a> </i> that includes the necessary permissions to
4504
- # call those AWS APIs, and provision that execution role in your
4505
- # account. When CloudFormation needs to invoke the extension handler,
4506
- # CloudFormation assumes this execution role to create a temporary
4507
- # session token, which it then passes to the extension handler, thereby
4508
- # supplying your extension with the appropriate credentials.
5111
+ # call those Amazon Web Services APIs, and provision that execution role
5112
+ # in your account. When CloudFormation needs to invoke the resource type
5113
+ # handler, CloudFormation assumes this execution role to create a
5114
+ # temporary session token, which it then passes to the resource type
5115
+ # handler, thereby supplying your resource type with the appropriate
5116
+ # credentials.
4509
5117
  #
4510
5118
  # @option params [String] :client_request_token
4511
5119
  # A unique identifier that acts as an idempotency key for this
@@ -4552,8 +5160,8 @@ module Aws::CloudFormation
4552
5160
  #
4553
5161
  # @option params [String] :stack_policy_body
4554
5162
  # Structure containing the stack policy body. For more information, go
4555
- # to [ Prevent Updates to Stack Resources][1] in the AWS CloudFormation
4556
- # User Guide. You can specify either the `StackPolicyBody` or the
5163
+ # to [ Prevent Updates to Stack Resources][1] in the CloudFormation User
5164
+ # Guide. You can specify either the `StackPolicyBody` or the
4557
5165
  # `StackPolicyURL` parameter, but not both.
4558
5166
  #
4559
5167
  #
@@ -4585,6 +5193,101 @@ module Aws::CloudFormation
4585
5193
  req.send_request(options)
4586
5194
  end
4587
5195
 
5196
+ # Specifies the configuration data for a registered CloudFormation
5197
+ # extension, in the given account and region.
5198
+ #
5199
+ # To view the current configuration data for an extension, refer to the
5200
+ # `ConfigurationSchema` element of
5201
+ # [DescribeType](AWSCloudFormation/latest/APIReference/API_DescribeType.html).
5202
+ # For more information, see [Configuring extensions at the account
5203
+ # level][1] in the *CloudFormation User Guide*.
5204
+ #
5205
+ # It is strongly recommended that you use dynamic references to restrict
5206
+ # sensitive configuration definitions, such as third-party credentials.
5207
+ # For more details on dynamic references, see [Using dynamic references
5208
+ # to specify template values][2] in the *CloudFormation User Guide*.
5209
+ #
5210
+ #
5211
+ #
5212
+ # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/registry-register.html#registry-set-configuration
5213
+ # [2]: https://docs.aws.amazon.com/
5214
+ #
5215
+ # @option params [String] :type_arn
5216
+ # The Amazon Resource Name (ARN) for the extension, in this account and
5217
+ # region.
5218
+ #
5219
+ # For public extensions, this will be the ARN assigned when you
5220
+ # [activate the type][1] in this account and region. For private
5221
+ # extensions, this will be the ARN assigned when you [register the
5222
+ # type][2] in this account and region.
5223
+ #
5224
+ # Do not include the extension versions suffix at the end of the ARN.
5225
+ # You can set the configuration for an extension, but not for a specific
5226
+ # extension version.
5227
+ #
5228
+ #
5229
+ #
5230
+ # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_ActivateType.html
5231
+ # [2]: https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_RegisterType.html
5232
+ #
5233
+ # @option params [required, String] :configuration
5234
+ # The configuration data for the extension, in this account and region.
5235
+ #
5236
+ # The configuration data must be formatted as JSON, and validate against
5237
+ # the schema returned in the `ConfigurationSchema` response element of
5238
+ # [API\_DescribeType](AWSCloudFormation/latest/APIReference/API_DescribeType.html).
5239
+ # For more information, see [Defining account-level configuration data
5240
+ # for an extension][1] in the *CloudFormation CLI User Guide*.
5241
+ #
5242
+ #
5243
+ #
5244
+ # [1]: https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/resource-type-model.html#resource-type-howto-configuration
5245
+ #
5246
+ # @option params [String] :configuration_alias
5247
+ # An alias by which to refer to this extension configuration data.
5248
+ #
5249
+ # Conditional: Specifying a configuration alias is required when setting
5250
+ # a configuration for a resource type extension.
5251
+ #
5252
+ # @option params [String] :type_name
5253
+ # The name of the extension.
5254
+ #
5255
+ # Conditional: You must specify `ConfigurationArn`, or `Type` and
5256
+ # `TypeName`.
5257
+ #
5258
+ # @option params [String] :type
5259
+ # The type of extension.
5260
+ #
5261
+ # Conditional: You must specify `ConfigurationArn`, or `Type` and
5262
+ # `TypeName`.
5263
+ #
5264
+ # @return [Types::SetTypeConfigurationOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
5265
+ #
5266
+ # * {Types::SetTypeConfigurationOutput#configuration_arn #configuration_arn} => String
5267
+ #
5268
+ # @example Request syntax with placeholder values
5269
+ #
5270
+ # resp = client.set_type_configuration({
5271
+ # type_arn: "TypeArn",
5272
+ # configuration: "TypeConfiguration", # required
5273
+ # configuration_alias: "TypeConfigurationAlias",
5274
+ # type_name: "TypeName",
5275
+ # type: "RESOURCE", # accepts RESOURCE, MODULE
5276
+ # })
5277
+ #
5278
+ # @example Response structure
5279
+ #
5280
+ # resp.configuration_arn #=> String
5281
+ #
5282
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/SetTypeConfiguration AWS API Documentation
5283
+ #
5284
+ # @overload set_type_configuration(params = {})
5285
+ # @param [Hash] params ({})
5286
+ def set_type_configuration(params = {}, options = {})
5287
+ req = build_request(:set_type_configuration, params)
5288
+ req.send_request(options)
5289
+ end
5290
+
4588
5291
  # Specify the default version of an extension. The default version of an
4589
5292
  # extension will be used in CloudFormation operations.
4590
5293
  #
@@ -4631,11 +5334,11 @@ module Aws::CloudFormation
4631
5334
 
4632
5335
  # Sends a signal to the specified resource with a success or failure
4633
5336
  # status. You can use the SignalResource API in conjunction with a
4634
- # creation policy or update policy. AWS CloudFormation doesn't proceed
4635
- # with a stack creation or update until resources receive the required
4636
- # number of signals or the timeout period is exceeded. The
4637
- # SignalResource API is useful in cases where you want to send signals
4638
- # from anywhere other than an Amazon EC2 instance.
5337
+ # creation policy or update policy. CloudFormation doesn't proceed with
5338
+ # a stack creation or update until resources receive the required number
5339
+ # of signals or the timeout period is exceeded. The SignalResource API
5340
+ # is useful in cases where you want to send signals from anywhere other
5341
+ # than an Amazon EC2 instance.
4639
5342
  #
4640
5343
  # @option params [required, String] :stack_name
4641
5344
  # The stack name or unique stack ID that includes the resource that you
@@ -4654,7 +5357,7 @@ module Aws::CloudFormation
4654
5357
  #
4655
5358
  # @option params [required, String] :status
4656
5359
  # The status of the signal, which is either success or failure. A
4657
- # failure signal causes AWS CloudFormation to immediately fail the stack
5360
+ # failure signal causes CloudFormation to immediately fail the stack
4658
5361
  # creation or update.
4659
5362
  #
4660
5363
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
@@ -4700,9 +5403,9 @@ module Aws::CloudFormation
4700
5403
  # * If you are signed in to a delegated administrator account, specify
4701
5404
  # `DELEGATED_ADMIN`.
4702
5405
  #
4703
- # Your AWS account must be registered as a delegated administrator in
4704
- # the management account. For more information, see [Register a
4705
- # delegated administrator][1] in the *AWS CloudFormation User Guide*.
5406
+ # Your account must be registered as a delegated administrator in the
5407
+ # management account. For more information, see [Register a delegated
5408
+ # administrator][1] in the *CloudFormation User Guide*.
4706
5409
  #
4707
5410
  #
4708
5411
  #
@@ -4727,6 +5430,115 @@ module Aws::CloudFormation
4727
5430
  req.send_request(options)
4728
5431
  end
4729
5432
 
5433
+ # Tests a registered extension to make sure it meets all necessary
5434
+ # requirements for being published in the CloudFormation registry.
5435
+ #
5436
+ # * For resource types, this includes passing all contracts tests
5437
+ # defined for the type.
5438
+ #
5439
+ # * For modules, this includes determining if the module's model meets
5440
+ # all necessary requirements.
5441
+ #
5442
+ # For more information, see [Testing your public extension prior to
5443
+ # publishing][1] in the *CloudFormation CLI User Guide*.
5444
+ #
5445
+ # If you do not specify a version, CloudFormation uses the default
5446
+ # version of the extension in your account and region for testing.
5447
+ #
5448
+ # To perform testing, CloudFormation assumes the execution role
5449
+ # specified when the type was registered. For more information, see
5450
+ # [RegisterType](AWSCloudFormation/latest/APIReference/API_RegisterType.html).
5451
+ #
5452
+ # Once you've initiated testing on an extension using `TestType`, you
5453
+ # can use [DescribeType][2] to monitor the current test status and test
5454
+ # status description for the extension.
5455
+ #
5456
+ # An extension must have a test status of `PASSED` before it can be
5457
+ # published. For more information, see [Publishing extensions to make
5458
+ # them available for public use][3] in the *CloudFormation CLI User
5459
+ # Guide*.
5460
+ #
5461
+ #
5462
+ #
5463
+ # [1]: https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/publish-extension.html#publish-extension-testing
5464
+ # [2]: https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_DescribeType.html
5465
+ # [3]: https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/resource-type-publish.html
5466
+ #
5467
+ # @option params [String] :arn
5468
+ # The Amazon Resource Number (ARN) of the extension.
5469
+ #
5470
+ # Conditional: You must specify `Arn`, or `TypeName` and `Type`.
5471
+ #
5472
+ # @option params [String] :type
5473
+ # The type of the extension to test.
5474
+ #
5475
+ # Conditional: You must specify `Arn`, or `TypeName` and `Type`.
5476
+ #
5477
+ # @option params [String] :type_name
5478
+ # The name of the extension to test.
5479
+ #
5480
+ # Conditional: You must specify `Arn`, or `TypeName` and `Type`.
5481
+ #
5482
+ # @option params [String] :version_id
5483
+ # The version of the extension to test.
5484
+ #
5485
+ # You can specify the version id with either `Arn`, or with `TypeName`
5486
+ # and `Type`.
5487
+ #
5488
+ # If you do not specify a version, CloudFormation uses the default
5489
+ # version of the extension in this account and region for testing.
5490
+ #
5491
+ # @option params [String] :log_delivery_bucket
5492
+ # The S3 bucket to which CloudFormation delivers the contract test
5493
+ # execution logs.
5494
+ #
5495
+ # CloudFormation delivers the logs by the time contract testing has
5496
+ # completed and the extension has been assigned a test type status of
5497
+ # `PASSED` or `FAILED`.
5498
+ #
5499
+ # The user calling `TestType` must be able to access items in the
5500
+ # specified S3 bucket. Specifically, the user needs the following
5501
+ # permissions:
5502
+ #
5503
+ # * GetObject
5504
+ #
5505
+ # * PutObject
5506
+ #
5507
+ # For more information, see [Actions, Resources, and Condition Keys for
5508
+ # Amazon S3][1] in the *Amazon Web Services Identity and Access
5509
+ # Management User Guide*.
5510
+ #
5511
+ #
5512
+ #
5513
+ # [1]: https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazons3.html
5514
+ #
5515
+ # @return [Types::TestTypeOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
5516
+ #
5517
+ # * {Types::TestTypeOutput#type_version_arn #type_version_arn} => String
5518
+ #
5519
+ # @example Request syntax with placeholder values
5520
+ #
5521
+ # resp = client.test_type({
5522
+ # arn: "TypeArn",
5523
+ # type: "RESOURCE", # accepts RESOURCE, MODULE
5524
+ # type_name: "TypeName",
5525
+ # version_id: "TypeVersionId",
5526
+ # log_delivery_bucket: "S3Bucket",
5527
+ # })
5528
+ #
5529
+ # @example Response structure
5530
+ #
5531
+ # resp.type_version_arn #=> String
5532
+ #
5533
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/TestType AWS API Documentation
5534
+ #
5535
+ # @overload test_type(params = {})
5536
+ # @param [Hash] params ({})
5537
+ def test_type(params = {}, options = {})
5538
+ req = build_request(:test_type, params)
5539
+ req.send_request(options)
5540
+ end
5541
+
4730
5542
  # Updates a stack as specified in the template. After the call completes
4731
5543
  # successfully, the stack update starts. You can check the status of the
4732
5544
  # stack via the DescribeStacks action.
@@ -4748,7 +5560,7 @@ module Aws::CloudFormation
4748
5560
  # @option params [String] :template_body
4749
5561
  # Structure containing the template body with a minimum length of 1 byte
4750
5562
  # and a maximum length of 51,200 bytes. (For more information, go to
4751
- # [Template Anatomy][1] in the AWS CloudFormation User Guide.)
5563
+ # [Template Anatomy][1] in the CloudFormation User Guide.)
4752
5564
  #
4753
5565
  # Conditional: You must specify only one of the following parameters:
4754
5566
  # `TemplateBody`, `TemplateURL`, or set the `UsePreviousTemplate` to
@@ -4761,7 +5573,7 @@ module Aws::CloudFormation
4761
5573
  # @option params [String] :template_url
4762
5574
  # Location of file containing the template body. The URL must point to a
4763
5575
  # template that is located in an Amazon S3 bucket or a Systems Manager
4764
- # document. For more information, go to [Template Anatomy][1] in the AWS
5576
+ # document. For more information, go to [Template Anatomy][1] in the
4765
5577
  # CloudFormation User Guide.
4766
5578
  #
4767
5579
  # Conditional: You must specify only one of the following parameters:
@@ -4812,16 +5624,15 @@ module Aws::CloudFormation
4812
5624
  #
4813
5625
  # @option params [Array<String>] :capabilities
4814
5626
  # In some cases, you must explicitly acknowledge that your stack
4815
- # template contains certain capabilities in order for AWS CloudFormation
4816
- # to update the stack.
5627
+ # template contains certain capabilities in order for CloudFormation to
5628
+ # update the stack.
4817
5629
  #
4818
5630
  # * `CAPABILITY_IAM` and `CAPABILITY_NAMED_IAM`
4819
5631
  #
4820
5632
  # Some stack templates might include resources that can affect
4821
- # permissions in your AWS account; for example, by creating new AWS
4822
- # Identity and Access Management (IAM) users. For those stacks, you
4823
- # must explicitly acknowledge this by specifying one of these
4824
- # capabilities.
5633
+ # permissions in your account; for example, by creating new Identity
5634
+ # and Access Management (IAM) users. For those stacks, you must
5635
+ # explicitly acknowledge this by specifying one of these capabilities.
4825
5636
  #
4826
5637
  # The following IAM resources require you to specify either the
4827
5638
  # `CAPABILITY_IAM` or `CAPABILITY_NAMED_IAM` capability.
@@ -4831,8 +5642,8 @@ module Aws::CloudFormation
4831
5642
  # * If you have IAM resources with custom names, you *must* specify
4832
5643
  # `CAPABILITY_NAMED_IAM`.
4833
5644
  #
4834
- # * If you don't specify either of these capabilities, AWS
4835
- # CloudFormation returns an `InsufficientCapabilities` error.
5645
+ # * If you don't specify either of these capabilities, CloudFormation
5646
+ # returns an `InsufficientCapabilities` error.
4836
5647
  #
4837
5648
  # If your stack template contains these resources, we recommend that
4838
5649
  # you review all permissions associated with them and edit their
@@ -4852,7 +5663,7 @@ module Aws::CloudFormation
4852
5663
  #
4853
5664
  # * [ AWS::IAM::UserToGroupAddition][7]
4854
5665
  #
4855
- # For more information, see [Acknowledging IAM Resources in AWS
5666
+ # For more information, see [Acknowledging IAM Resources in
4856
5667
  # CloudFormation Templates][8].
4857
5668
  #
4858
5669
  # * `CAPABILITY_AUTO_EXPAND`
@@ -4867,7 +5678,7 @@ module Aws::CloudFormation
4867
5678
  # update a stack directly from the processed template, without first
4868
5679
  # reviewing the resulting changes in a change set, you must
4869
5680
  # acknowledge this capability. This includes the [AWS::Include][9] and
4870
- # [AWS::Serverless][10] transforms, which are macros hosted by AWS
5681
+ # [AWS::Serverless][10] transforms, which are macros hosted by
4871
5682
  # CloudFormation.
4872
5683
  #
4873
5684
  # If you want to update a stack from a stack template that contains
@@ -4879,11 +5690,11 @@ module Aws::CloudFormation
4879
5690
  #
4880
5691
  # Each macro relies on an underlying Lambda service function for
4881
5692
  # processing stack templates. Be aware that the Lambda function owner
4882
- # can update the function operation without AWS CloudFormation being
5693
+ # can update the function operation without CloudFormation being
4883
5694
  # notified.
4884
5695
  #
4885
- # For more information, see [Using AWS CloudFormation Macros to
4886
- # Perform Custom Processing on Templates][11].
5696
+ # For more information, see [Using CloudFormation Macros to Perform
5697
+ # Custom Processing on Templates][11].
4887
5698
  #
4888
5699
  #
4889
5700
  #
@@ -4905,33 +5716,32 @@ module Aws::CloudFormation
4905
5716
  # or `Custom::MyCustomInstance`.
4906
5717
  #
4907
5718
  # If the list of resource types doesn't include a resource that you're
4908
- # updating, the stack update fails. By default, AWS CloudFormation
4909
- # grants permissions to all resource types. AWS Identity and Access
4910
- # Management (IAM) uses this parameter for AWS CloudFormation-specific
4911
- # condition keys in IAM policies. For more information, see [Controlling
4912
- # Access with AWS Identity and Access Management][1].
5719
+ # updating, the stack update fails. By default, CloudFormation grants
5720
+ # permissions to all resource types. Identity and Access Management
5721
+ # (IAM) uses this parameter for CloudFormation-specific condition keys
5722
+ # in IAM policies. For more information, see [Controlling Access with
5723
+ # Identity and Access Management][1].
4913
5724
  #
4914
5725
  #
4915
5726
  #
4916
5727
  # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html
4917
5728
  #
4918
5729
  # @option params [String] :role_arn
4919
- # The Amazon Resource Name (ARN) of an AWS Identity and Access
4920
- # Management (IAM) role that AWS CloudFormation assumes to update the
4921
- # stack. AWS CloudFormation uses the role's credentials to make calls
4922
- # on your behalf. AWS CloudFormation always uses this role for all
4923
- # future operations on the stack. As long as users have permission to
4924
- # operate on the stack, AWS CloudFormation uses this role even if the
4925
- # users don't have permission to pass it. Ensure that the role grants
4926
- # least privilege.
4927
- #
4928
- # If you don't specify a value, AWS CloudFormation uses the role that
4929
- # was previously associated with the stack. If no role is available, AWS
5730
+ # The Amazon Resource Name (ARN) of an Identity and Access Management
5731
+ # (IAM) role that CloudFormation assumes to update the stack.
5732
+ # CloudFormation uses the role's credentials to make calls on your
5733
+ # behalf. CloudFormation always uses this role for all future operations
5734
+ # on the stack. As long as users have permission to operate on the
5735
+ # stack, CloudFormation uses this role even if the users don't have
5736
+ # permission to pass it. Ensure that the role grants least privilege.
5737
+ #
5738
+ # If you don't specify a value, CloudFormation uses the role that was
5739
+ # previously associated with the stack. If no role is available,
4930
5740
  # CloudFormation uses a temporary session that is generated from your
4931
5741
  # user credentials.
4932
5742
  #
4933
5743
  # @option params [Types::RollbackConfiguration] :rollback_configuration
4934
- # The rollback triggers for AWS CloudFormation to monitor during stack
5744
+ # The rollback triggers for CloudFormation to monitor during stack
4935
5745
  # creation and updating operations, and for the specified monitoring
4936
5746
  # period afterwards.
4937
5747
  #
@@ -4957,23 +5767,23 @@ module Aws::CloudFormation
4957
5767
  #
4958
5768
  # @option params [Array<String>] :notification_arns
4959
5769
  # Amazon Simple Notification Service topic Amazon Resource Names (ARNs)
4960
- # that AWS CloudFormation associates with the stack. Specify an empty
4961
- # list to remove all notification topics.
5770
+ # that CloudFormation associates with the stack. Specify an empty list
5771
+ # to remove all notification topics.
4962
5772
  #
4963
5773
  # @option params [Array<Types::Tag>] :tags
4964
- # Key-value pairs to associate with this stack. AWS CloudFormation also
5774
+ # Key-value pairs to associate with this stack. CloudFormation also
4965
5775
  # propagates these tags to supported resources in the stack. You can
4966
5776
  # specify a maximum number of 50 tags.
4967
5777
  #
4968
- # If you don't specify this parameter, AWS CloudFormation doesn't
4969
- # modify the stack's tags. If you specify an empty value, AWS
4970
- # CloudFormation removes all associated tags.
5778
+ # If you don't specify this parameter, CloudFormation doesn't modify
5779
+ # the stack's tags. If you specify an empty value, CloudFormation
5780
+ # removes all associated tags.
4971
5781
  #
4972
5782
  # @option params [String] :client_request_token
4973
5783
  # A unique identifier for this `UpdateStack` request. Specify this token
4974
- # if you plan to retry requests so that AWS CloudFormation knows that
5784
+ # if you plan to retry requests so that CloudFormation knows that
4975
5785
  # you're not attempting to update a stack with the same name. You might
4976
- # retry `UpdateStack` requests to ensure that AWS CloudFormation
5786
+ # retry `UpdateStack` requests to ensure that CloudFormation
4977
5787
  # successfully received them.
4978
5788
  #
4979
5789
  # All events triggered by a given stack operation are assigned the same
@@ -5079,7 +5889,7 @@ module Aws::CloudFormation
5079
5889
  # instances.
5080
5890
  #
5081
5891
  # @option params [Array<String>] :accounts
5082
- # \[Self-managed permissions\] The names of one or more AWS accounts for
5892
+ # \[Self-managed permissions\] The names of one or more accounts for
5083
5893
  # which you want to update parameter values for stack instances. The
5084
5894
  # overridden parameter values will be applied to all stack instances in
5085
5895
  # the specified accounts and Regions.
@@ -5087,8 +5897,8 @@ module Aws::CloudFormation
5087
5897
  # You can specify `Accounts` or `DeploymentTargets`, but not both.
5088
5898
  #
5089
5899
  # @option params [Types::DeploymentTargets] :deployment_targets
5090
- # \[Service-managed permissions\] The AWS Organizations accounts for
5091
- # which you want to update parameter values for stack instances. If your
5900
+ # \[Service-managed permissions\] The Organizations accounts for which
5901
+ # you want to update parameter values for stack instances. If your
5092
5902
  # update targets OUs, the overridden parameter values only apply to the
5093
5903
  # accounts that are currently in the target OUs and their child OUs.
5094
5904
  # Accounts added to the target OUs and their child OUs in the future
@@ -5107,24 +5917,19 @@ module Aws::CloudFormation
5107
5917
  #
5108
5918
  # Any overridden parameter values will be applied to all stack instances
5109
5919
  # in the specified accounts and Regions. When specifying parameters and
5110
- # their values, be aware of how AWS CloudFormation sets parameter values
5920
+ # their values, be aware of how CloudFormation sets parameter values
5111
5921
  # during stack instance update operations:
5112
5922
  #
5113
5923
  # * To override the current value for a parameter, include the parameter
5114
5924
  # and specify its value.
5115
5925
  #
5116
- # * To leave a parameter set to its present value, you can do one of the
5117
- # following:
5118
- #
5119
- # * Do not include the parameter in the list.
5926
+ # * To leave an overridden parameter set to its present value, include
5927
+ # the parameter and specify `UsePreviousValue` as `true`. (You cannot
5928
+ # specify both a value and set `UsePreviousValue` to `true`.)
5120
5929
  #
5121
- # * Include the parameter and specify `UsePreviousValue` as `true`.
5122
- # (You cannot specify both a value and set `UsePreviousValue` to
5123
- # `true`.)
5124
- #
5125
- # * To set all overridden parameter back to the values specified in the
5126
- # stack set, specify a parameter list but do not include any
5127
- # parameters.
5930
+ # * To set an overridden parameter back to the value specified in the
5931
+ # stack set, specify a parameter list but do not include the parameter
5932
+ # in the list.
5128
5933
  #
5129
5934
  # * To leave all parameters set to their present values, do not specify
5130
5935
  # this property at all.
@@ -5147,17 +5952,16 @@ module Aws::CloudFormation
5147
5952
  # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_UpdateStackSet.html
5148
5953
  #
5149
5954
  # @option params [Types::StackSetOperationPreferences] :operation_preferences
5150
- # Preferences for how AWS CloudFormation performs this stack set
5151
- # operation.
5955
+ # Preferences for how CloudFormation performs this stack set operation.
5152
5956
  #
5153
5957
  # @option params [String] :operation_id
5154
5958
  # The unique identifier for this stack set operation.
5155
5959
  #
5156
5960
  # The operation ID also functions as an idempotency token, to ensure
5157
- # that AWS CloudFormation performs the stack set operation only once,
5158
- # even if you retry the request multiple times. You might retry stack
5159
- # set operation requests to ensure that AWS CloudFormation successfully
5160
- # received them.
5961
+ # that CloudFormation performs the stack set operation only once, even
5962
+ # if you retry the request multiple times. You might retry stack set
5963
+ # operation requests to ensure that CloudFormation successfully received
5964
+ # them.
5161
5965
  #
5162
5966
  # If you don't specify an operation ID, the SDK generates one
5163
5967
  # automatically.
@@ -5178,9 +5982,9 @@ module Aws::CloudFormation
5178
5982
  # * If you are signed in to a delegated administrator account, specify
5179
5983
  # `DELEGATED_ADMIN`.
5180
5984
  #
5181
- # Your AWS account must be registered as a delegated administrator in
5182
- # the management account. For more information, see [Register a
5183
- # delegated administrator][1] in the *AWS CloudFormation User Guide*.
5985
+ # Your account must be registered as a delegated administrator in the
5986
+ # management account. For more information, see [Register a delegated
5987
+ # administrator][1] in the *CloudFormation User Guide*.
5184
5988
  #
5185
5989
  #
5186
5990
  #
@@ -5252,7 +6056,7 @@ module Aws::CloudFormation
5252
6056
  # @option params [String] :template_body
5253
6057
  # The structure that contains the template body, with a minimum length
5254
6058
  # of 1 byte and a maximum length of 51,200 bytes. For more information,
5255
- # see [Template Anatomy][1] in the AWS CloudFormation User Guide.
6059
+ # see [Template Anatomy][1] in the CloudFormation User Guide.
5256
6060
  #
5257
6061
  # Conditional: You must specify only one of the following parameters:
5258
6062
  # `TemplateBody` or `TemplateURL`—or set `UsePreviousTemplate` to true.
@@ -5265,7 +6069,7 @@ module Aws::CloudFormation
5265
6069
  # The location of the file that contains the template body. The URL must
5266
6070
  # point to a template (maximum size: 460,800 bytes) that is located in
5267
6071
  # an Amazon S3 bucket or a Systems Manager document. For more
5268
- # information, see [Template Anatomy][1] in the AWS CloudFormation User
6072
+ # information, see [Template Anatomy][1] in the CloudFormation User
5269
6073
  # Guide.
5270
6074
  #
5271
6075
  # Conditional: You must specify only one of the following parameters:
@@ -5287,16 +6091,15 @@ module Aws::CloudFormation
5287
6091
  #
5288
6092
  # @option params [Array<String>] :capabilities
5289
6093
  # In some cases, you must explicitly acknowledge that your stack
5290
- # template contains certain capabilities in order for AWS CloudFormation
5291
- # to update the stack set and its associated stack instances.
6094
+ # template contains certain capabilities in order for CloudFormation to
6095
+ # update the stack set and its associated stack instances.
5292
6096
  #
5293
6097
  # * `CAPABILITY_IAM` and `CAPABILITY_NAMED_IAM`
5294
6098
  #
5295
6099
  # Some stack templates might include resources that can affect
5296
- # permissions in your AWS account; for example, by creating new AWS
5297
- # Identity and Access Management (IAM) users. For those stacks sets,
5298
- # you must explicitly acknowledge this by specifying one of these
5299
- # capabilities.
6100
+ # permissions in your account; for example, by creating new Identity
6101
+ # and Access Management (IAM) users. For those stacks sets, you must
6102
+ # explicitly acknowledge this by specifying one of these capabilities.
5300
6103
  #
5301
6104
  # The following IAM resources require you to specify either the
5302
6105
  # `CAPABILITY_IAM` or `CAPABILITY_NAMED_IAM` capability.
@@ -5306,8 +6109,8 @@ module Aws::CloudFormation
5306
6109
  # * If you have IAM resources with custom names, you *must* specify
5307
6110
  # `CAPABILITY_NAMED_IAM`.
5308
6111
  #
5309
- # * If you don't specify either of these capabilities, AWS
5310
- # CloudFormation returns an `InsufficientCapabilities` error.
6112
+ # * If you don't specify either of these capabilities, CloudFormation
6113
+ # returns an `InsufficientCapabilities` error.
5311
6114
  #
5312
6115
  # If your stack template contains these resources, we recommend that
5313
6116
  # you review all permissions associated with them and edit their
@@ -5327,23 +6130,26 @@ module Aws::CloudFormation
5327
6130
  #
5328
6131
  # * [ AWS::IAM::UserToGroupAddition][7]
5329
6132
  #
5330
- # For more information, see [Acknowledging IAM Resources in AWS
6133
+ # For more information, see [Acknowledging IAM Resources in
5331
6134
  # CloudFormation Templates][8].
5332
6135
  #
5333
6136
  # * `CAPABILITY_AUTO_EXPAND`
5334
6137
  #
5335
- # Some templates contain macros. If your stack template contains one
5336
- # or more macros, and you choose to update a stack directly from the
5337
- # processed template, without first reviewing the resulting changes in
5338
- # a change set, you must acknowledge this capability. For more
5339
- # information, see [Using AWS CloudFormation Macros to Perform Custom
5340
- # Processing on Templates][9].
6138
+ # Some templates reference macros. If your stack set template
6139
+ # references one or more macros, you must update the stack set
6140
+ # directly from the processed template, without first reviewing the
6141
+ # resulting changes in a change set. To update the stack set directly,
6142
+ # you must acknowledge this capability. For more information, see
6143
+ # [Using CloudFormation Macros to Perform Custom Processing on
6144
+ # Templates][9].
5341
6145
  #
5342
- # Stack sets do not currently support macros in stack templates. (This
5343
- # includes the [AWS::Include][10] and [AWS::Serverless][11]
5344
- # transforms, which are macros hosted by AWS CloudFormation.) Even if
5345
- # you specify this capability, if you include a macro in your template
5346
- # the stack set operation will fail.
6146
+ # Stack sets with service-managed permissions do not currently support
6147
+ # the use of macros in templates. (This includes the
6148
+ # [AWS::Include][10] and [AWS::Serverless][11] transforms, which are
6149
+ # macros hosted by CloudFormation.) Even if you specify this
6150
+ # capability for a stack set with service-managed permissions, if you
6151
+ # reference a macro in your template the stack set operation will
6152
+ # fail.
5347
6153
  #
5348
6154
  #
5349
6155
  #
@@ -5361,15 +6167,15 @@ module Aws::CloudFormation
5361
6167
  #
5362
6168
  # @option params [Array<Types::Tag>] :tags
5363
6169
  # The key-value pairs to associate with this stack set and the stacks
5364
- # created from it. AWS CloudFormation also propagates these tags to
6170
+ # created from it. CloudFormation also propagates these tags to
5365
6171
  # supported resources that are created in the stacks. You can specify a
5366
6172
  # maximum number of 50 tags.
5367
6173
  #
5368
6174
  # If you specify tags for this parameter, those tags replace any list of
5369
6175
  # tags that are currently associated with this stack set. This means:
5370
6176
  #
5371
- # * If you don't specify this parameter, AWS CloudFormation doesn't
5372
- # modify the stack's tags.
6177
+ # * If you don't specify this parameter, CloudFormation doesn't modify
6178
+ # the stack's tags.
5373
6179
  #
5374
6180
  # * If you specify *any* tags using this parameter, you must specify
5375
6181
  # *all* the tags that you want associated with this stack set, even
@@ -5378,21 +6184,20 @@ module Aws::CloudFormation
5378
6184
  # you don't include in the updated list of tags are removed from the
5379
6185
  # stack set, and therefore from the stacks and resources as well.
5380
6186
  #
5381
- # * If you specify an empty value, AWS CloudFormation removes all
5382
- # currently associated tags.
6187
+ # * If you specify an empty value, CloudFormation removes all currently
6188
+ # associated tags.
5383
6189
  #
5384
- # If you specify new tags as part of an `UpdateStackSet` action, AWS
6190
+ # If you specify new tags as part of an `UpdateStackSet` action,
5385
6191
  # CloudFormation checks to see if you have the required IAM permission
5386
6192
  # to tag resources. If you omit tags that are currently associated with
5387
- # the stack set from the list of tags you specify, AWS CloudFormation
6193
+ # the stack set from the list of tags you specify, CloudFormation
5388
6194
  # assumes that you want to remove those tags from the stack set, and
5389
6195
  # checks to see if you have permission to untag resources. If you don't
5390
6196
  # have the necessary permission(s), the entire `UpdateStackSet` action
5391
6197
  # fails with an `access denied` error, and the stack set is not updated.
5392
6198
  #
5393
6199
  # @option params [Types::StackSetOperationPreferences] :operation_preferences
5394
- # Preferences for how AWS CloudFormation performs this stack set
5395
- # operation.
6200
+ # Preferences for how CloudFormation performs this stack set operation.
5396
6201
  #
5397
6202
  # @option params [String] :administration_role_arn
5398
6203
  # The Amazon Resource Number (ARN) of the IAM role to use to update this
@@ -5401,8 +6206,8 @@ module Aws::CloudFormation
5401
6206
  # Specify an IAM role only if you are using customized administrator
5402
6207
  # roles to control which users or groups can manage specific stack sets
5403
6208
  # within the same administrator account. For more information, see
5404
- # [Granting Permissions for Stack Set Operations][1] in the *AWS
5405
- # CloudFormation User Guide*.
6209
+ # [Granting Permissions for Stack Set Operations][1] in the
6210
+ # *CloudFormation User Guide*.
5406
6211
  #
5407
6212
  # If you specified a customized administrator role when you created the
5408
6213
  # stack set, you must specify a customized administrator role, even if
@@ -5415,7 +6220,7 @@ module Aws::CloudFormation
5415
6220
  #
5416
6221
  # @option params [String] :execution_role_name
5417
6222
  # The name of the IAM execution role to use to update the stack set. If
5418
- # you do not specify an execution role, AWS CloudFormation uses the
6223
+ # you do not specify an execution role, CloudFormation uses the
5419
6224
  # `AWSCloudFormationStackSetExecutionRole` role for the stack set
5420
6225
  # operation.
5421
6226
  #
@@ -5423,27 +6228,27 @@ module Aws::CloudFormation
5423
6228
  # to control which stack resources users and groups can include in their
5424
6229
  # stack sets.
5425
6230
  #
5426
- # If you specify a customized execution role, AWS CloudFormation uses
5427
- # that role to update the stack. If you do not specify a customized
5428
- # execution role, AWS CloudFormation performs the update using the role
5429
- # previously associated with the stack set, so long as you have
5430
- # permissions to perform operations on the stack set.
6231
+ # If you specify a customized execution role, CloudFormation uses that
6232
+ # role to update the stack. If you do not specify a customized execution
6233
+ # role, CloudFormation performs the update using the role previously
6234
+ # associated with the stack set, so long as you have permissions to
6235
+ # perform operations on the stack set.
5431
6236
  #
5432
6237
  # @option params [Types::DeploymentTargets] :deployment_targets
5433
- # \[Service-managed permissions\] The AWS Organizations accounts in
5434
- # which to update associated stack instances.
6238
+ # \[Service-managed permissions\] The Organizations accounts in which to
6239
+ # update associated stack instances.
5435
6240
  #
5436
6241
  # To update all the stack instances associated with this stack set, do
5437
6242
  # not specify `DeploymentTargets` or `Regions`.
5438
6243
  #
5439
6244
  # If the stack set update includes changes to the template (that is, if
5440
6245
  # `TemplateBody` or `TemplateURL` is specified), or the `Parameters`,
5441
- # AWS CloudFormation marks all stack instances with a status of
5442
- # `OUTDATED` prior to updating the stack instances in the specified
5443
- # accounts and Regions. If the stack set update does not include changes
5444
- # to the template or parameters, AWS CloudFormation updates the stack
5445
- # instances in the specified accounts and Regions, while leaving all
5446
- # other stack instances with their existing stack instance status.
6246
+ # CloudFormation marks all stack instances with a status of `OUTDATED`
6247
+ # prior to updating the stack instances in the specified accounts and
6248
+ # Regions. If the stack set update does not include changes to the
6249
+ # template or parameters, CloudFormation updates the stack instances in
6250
+ # the specified accounts and Regions, while leaving all other stack
6251
+ # instances with their existing stack instance status.
5447
6252
  #
5448
6253
  # @option params [String] :permission_model
5449
6254
  # Describes how the IAM roles required for stack set operations are
@@ -5455,7 +6260,7 @@ module Aws::CloudFormation
5455
6260
  # information, see [Grant Self-Managed Stack Set Permissions][1].
5456
6261
  #
5457
6262
  # * With `service-managed` permissions, StackSets automatically creates
5458
- # the IAM roles required to deploy to accounts managed by AWS
6263
+ # the IAM roles required to deploy to accounts managed by
5459
6264
  # Organizations. For more information, see [Grant Service-Managed
5460
6265
  # Stack Set Permissions][2].
5461
6266
  #
@@ -5466,8 +6271,8 @@ module Aws::CloudFormation
5466
6271
  #
5467
6272
  # @option params [Types::AutoDeployment] :auto_deployment
5468
6273
  # \[Service-managed permissions\] Describes whether StackSets
5469
- # automatically deploys to AWS Organizations accounts that are added to
5470
- # a target organization or organizational unit (OU).
6274
+ # automatically deploys to Organizations accounts that are added to a
6275
+ # target organization or organizational unit (OU).
5471
6276
  #
5472
6277
  # If you specify `AutoDeployment`, do not specify `DeploymentTargets` or
5473
6278
  # `Regions`.
@@ -5476,13 +6281,13 @@ module Aws::CloudFormation
5476
6281
  # The unique ID for this stack set operation.
5477
6282
  #
5478
6283
  # The operation ID also functions as an idempotency token, to ensure
5479
- # that AWS CloudFormation performs the stack set operation only once,
5480
- # even if you retry the request multiple times. You might retry stack
5481
- # set operation requests to ensure that AWS CloudFormation successfully
5482
- # received them.
6284
+ # that CloudFormation performs the stack set operation only once, even
6285
+ # if you retry the request multiple times. You might retry stack set
6286
+ # operation requests to ensure that CloudFormation successfully received
6287
+ # them.
5483
6288
  #
5484
- # If you don't specify an operation ID, AWS CloudFormation generates
5485
- # one automatically.
6289
+ # If you don't specify an operation ID, CloudFormation generates one
6290
+ # automatically.
5486
6291
  #
5487
6292
  # Repeating this stack set operation with a new operation ID retries all
5488
6293
  # stack instances whose status is `OUTDATED`.
@@ -5500,13 +6305,13 @@ module Aws::CloudFormation
5500
6305
  #
5501
6306
  # If the stack set update includes changes to the template (that is, if
5502
6307
  # the `TemplateBody` or `TemplateURL` properties are specified), or the
5503
- # `Parameters` property, AWS CloudFormation marks all stack instances
5504
- # with a status of `OUTDATED` prior to updating the stack instances in
5505
- # the specified accounts and Regions. If the stack set update does not
5506
- # include changes to the template or parameters, AWS CloudFormation
5507
- # updates the stack instances in the specified accounts and Regions,
5508
- # while leaving all other stack instances with their existing stack
5509
- # instance status.
6308
+ # `Parameters` property, CloudFormation marks all stack instances with a
6309
+ # status of `OUTDATED` prior to updating the stack instances in the
6310
+ # specified accounts and Regions. If the stack set update does not
6311
+ # include changes to the template or parameters, CloudFormation updates
6312
+ # the stack instances in the specified accounts and Regions, while
6313
+ # leaving all other stack instances with their existing stack instance
6314
+ # status.
5510
6315
  #
5511
6316
  # @option params [Array<String>] :regions
5512
6317
  # The Regions in which to update associated stack instances. If you
@@ -5518,13 +6323,13 @@ module Aws::CloudFormation
5518
6323
  #
5519
6324
  # If the stack set update includes changes to the template (that is, if
5520
6325
  # the `TemplateBody` or `TemplateURL` properties are specified), or the
5521
- # `Parameters` property, AWS CloudFormation marks all stack instances
5522
- # with a status of `OUTDATED` prior to updating the stack instances in
5523
- # the specified accounts and Regions. If the stack set update does not
5524
- # include changes to the template or parameters, AWS CloudFormation
5525
- # updates the stack instances in the specified accounts and Regions,
5526
- # while leaving all other stack instances with their existing stack
5527
- # instance status.
6326
+ # `Parameters` property, CloudFormation marks all stack instances with a
6327
+ # status of `OUTDATED` prior to updating the stack instances in the
6328
+ # specified accounts and Regions. If the stack set update does not
6329
+ # include changes to the template or parameters, CloudFormation updates
6330
+ # the stack instances in the specified accounts and Regions, while
6331
+ # leaving all other stack instances with their existing stack instance
6332
+ # status.
5528
6333
  #
5529
6334
  # @option params [String] :call_as
5530
6335
  # \[Service-managed permissions\] Specifies whether you are acting as an
@@ -5539,9 +6344,9 @@ module Aws::CloudFormation
5539
6344
  # * If you are signed in to a delegated administrator account, specify
5540
6345
  # `DELEGATED_ADMIN`.
5541
6346
  #
5542
- # Your AWS account must be registered as a delegated administrator in
5543
- # the management account. For more information, see [Register a
5544
- # delegated administrator][1] in the *AWS CloudFormation User Guide*.
6347
+ # Your account must be registered as a delegated administrator in the
6348
+ # management account. For more information, see [Register a delegated
6349
+ # administrator][1] in the *CloudFormation User Guide*.
5545
6350
  #
5546
6351
  #
5547
6352
  #
@@ -5616,8 +6421,8 @@ module Aws::CloudFormation
5616
6421
  # Updates termination protection for the specified stack. If a user
5617
6422
  # attempts to delete a stack with termination protection enabled, the
5618
6423
  # operation fails and the stack remains unchanged. For more information,
5619
- # see [Protecting a Stack From Being Deleted][1] in the *AWS
5620
- # CloudFormation User Guide*.
6424
+ # see [Protecting a Stack From Being Deleted][1] in the *CloudFormation
6425
+ # User Guide*.
5621
6426
  #
5622
6427
  # For [nested stacks][2], termination protection is set on the root
5623
6428
  # stack and cannot be changed directly on the nested stack.
@@ -5658,15 +6463,15 @@ module Aws::CloudFormation
5658
6463
  req.send_request(options)
5659
6464
  end
5660
6465
 
5661
- # Validates a specified template. AWS CloudFormation first checks if the
5662
- # template is valid JSON. If it isn't, AWS CloudFormation checks if the
5663
- # template is valid YAML. If both these checks fail, AWS CloudFormation
6466
+ # Validates a specified template. CloudFormation first checks if the
6467
+ # template is valid JSON. If it isn't, CloudFormation checks if the
6468
+ # template is valid YAML. If both these checks fail, CloudFormation
5664
6469
  # returns a template validation error.
5665
6470
  #
5666
6471
  # @option params [String] :template_body
5667
6472
  # Structure containing the template body with a minimum length of 1 byte
5668
6473
  # and a maximum length of 51,200 bytes. For more information, go to
5669
- # [Template Anatomy][1] in the AWS CloudFormation User Guide.
6474
+ # [Template Anatomy][1] in the CloudFormation User Guide.
5670
6475
  #
5671
6476
  # Conditional: You must pass `TemplateURL` or `TemplateBody`. If both
5672
6477
  # are passed, only `TemplateBody` is used.
@@ -5679,7 +6484,7 @@ module Aws::CloudFormation
5679
6484
  # Location of file containing the template body. The URL must point to a
5680
6485
  # template (max size: 460,800 bytes) that is located in an Amazon S3
5681
6486
  # bucket or a Systems Manager document. For more information, go to
5682
- # [Template Anatomy][1] in the AWS CloudFormation User Guide.
6487
+ # [Template Anatomy][1] in the CloudFormation User Guide.
5683
6488
  #
5684
6489
  # Conditional: You must pass `TemplateURL` or `TemplateBody`. If both
5685
6490
  # are passed, only `TemplateBody` is used.
@@ -5739,7 +6544,7 @@ module Aws::CloudFormation
5739
6544
  params: params,
5740
6545
  config: config)
5741
6546
  context[:gem_name] = 'aws-sdk-cloudformation'
5742
- context[:gem_version] = '1.50.0'
6547
+ context[:gem_version] = '1.54.0'
5743
6548
  Seahorse::Client::Request.new(handlers, context)
5744
6549
  end
5745
6550