aws-sdk-cloudformation 1.53.0 → 1.54.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 4c783a8c161abb59320721664af11592a924a8ad947e4f37d40808d4fea53f49
4
- data.tar.gz: cb4aeb16b7ad4e99d1a80ec11f1b72eb53e8300076ded8f990d3edd5210e8c2e
3
+ metadata.gz: 642a8c36978ebf152ba0b7df35f3c1e627e0101432269f02eee095dcc3f18f3e
4
+ data.tar.gz: 4573401978788bdecf9a7d29a0e4117bc194e86017bbc24ff29d3bb9ad7103a3
5
5
  SHA512:
6
- metadata.gz: c07bb4a2f0cc0be46eb9b6f2204af5a5b39cedbc94743cb7d84ab22a17fabbfa0dfae4d839aa7a2c406d67819438bf253723963842eaf2971e997adbf2c2b425
7
- data.tar.gz: 62074ede85d71cdc0f03e269c72e46475e786164847d613c177222015d7b351c5668062a95ba3129015443659c04c29290d000aea230a8e022e4cfe7c97eae5a
6
+ metadata.gz: c7025f03f4433653da5cfea4f11d2ac755edee61fa291f5b4036b0c4d1af311d59f95ed0e94aa49f99c97f1bf5905c597f805731e6879329c9835886d944a96c
7
+ data.tar.gz: 3df65c06788d3e4384895b3447c29f37b34030c3ff31dc66ec626aa978bbc43ab150e249053d9f772eb18b0c91370cc3e58b70db39842a9b8faaff621aa1262b
data/CHANGELOG.md CHANGED
@@ -1,6 +1,11 @@
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
+
4
9
  1.53.0 (2021-06-21)
5
10
  ------------------
6
11
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.53.0
1
+ 1.54.0
@@ -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.53.0'
56
+ GEM_VERSION = '1.54.0'
57
57
 
58
58
  end
@@ -527,10 +527,10 @@ module Aws::CloudFormation
527
527
  #
528
528
  # @option params [String] :client_request_token
529
529
  # A unique identifier for this `CancelUpdateStack` request. Specify this
530
- # token if you plan to retry requests so that AWS CloudFormation knows
531
- # that you're not attempting to cancel an update on a stack with the
532
- # same name. You might retry `CancelUpdateStack` requests to ensure that
533
- # 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.
534
534
  #
535
535
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
536
536
  #
@@ -558,11 +558,11 @@ module Aws::CloudFormation
558
558
  # `UPDATE_ROLLBACK_COMPLETE` state), and then try to update the stack
559
559
  # again.
560
560
  #
561
- # A stack goes into the `UPDATE_ROLLBACK_FAILED` state when AWS
561
+ # A stack goes into the `UPDATE_ROLLBACK_FAILED` state when
562
562
  # CloudFormation cannot roll back all changes after a failed stack
563
563
  # update. For example, you might have a stack that is rolling back to an
564
- # old database instance that was deleted outside of AWS CloudFormation.
565
- # 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
566
566
  # assumes that the database instance still exists and attempts to roll
567
567
  # back to it, causing the update rollback to fail.
568
568
  #
@@ -582,33 +582,32 @@ module Aws::CloudFormation
582
582
  # </note>
583
583
  #
584
584
  # @option params [String] :role_arn
585
- # The Amazon Resource Name (ARN) of an AWS Identity and Access
586
- # Management (IAM) role that AWS CloudFormation assumes to roll back the
587
- # stack. AWS CloudFormation uses the role's credentials to make calls
588
- # on your behalf. AWS CloudFormation always uses this role for all
589
- # future operations on the stack. As long as users have permission to
590
- # operate on the stack, AWS CloudFormation uses this role even if the
591
- # users don't have permission to pass it. Ensure that the role grants
592
- # least privilege.
593
- #
594
- # If you don't specify a value, AWS CloudFormation uses the role that
595
- # 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,
596
595
  # CloudFormation uses a temporary session that is generated from your
597
596
  # user credentials.
598
597
  #
599
598
  # @option params [Array<String>] :resources_to_skip
600
- # A list of the logical IDs of the resources that AWS CloudFormation
601
- # skips during the continue update rollback operation. You can specify
602
- # only resources that are in the `UPDATE_FAILED` state because a
603
- # rollback failed. You can't specify resources that are in the
604
- # `UPDATE_FAILED` state for other reasons, for example, because an
605
- # update was cancelled. To check why a resource update failed, use the
606
- # DescribeStackResources action, and view the resource status reason.
607
- #
608
- # 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
609
608
  # CloudFormation can't successfully roll back. We recommend that you [
610
- # troubleshoot][1] resources before skipping them. AWS CloudFormation
611
- # 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
612
611
  # continues to roll back the stack. After the rollback is complete, the
613
612
  # state of the skipped resources will be inconsistent with the state of
614
613
  # the resources in the stack template. Before performing another stack
@@ -642,10 +641,10 @@ module Aws::CloudFormation
642
641
  #
643
642
  # @option params [String] :client_request_token
644
643
  # A unique identifier for this `ContinueUpdateRollback` request. Specify
645
- # this token if you plan to retry requests so that AWS CloudFormation
646
- # knows that you're not attempting to continue the rollback to a stack
647
- # with the same name. You might retry `ContinueUpdateRollback` requests
648
- # 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.
649
648
  #
650
649
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
651
650
  #
@@ -671,25 +670,25 @@ module Aws::CloudFormation
671
670
  # can review the changes before executing them. You can create a change
672
671
  # set for a stack that doesn't exist or an existing stack. If you
673
672
  # create a change set for a stack that doesn't exist, the change set
674
- # shows all of the resources that AWS CloudFormation will create. If you
675
- # create a change set for an existing stack, AWS CloudFormation compares
676
- # 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
677
676
  # change set and lists the differences. Use change sets to understand
678
- # which resources AWS CloudFormation will create or change, and how it
679
- # will change resources in an existing stack, before you create or
680
- # 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.
681
680
  #
682
681
  # To create a change set for a stack that doesn't exist, for the
683
682
  # `ChangeSetType` parameter, specify `CREATE`. To create a change set
684
683
  # for an existing stack, specify `UPDATE` for the `ChangeSetType`
685
684
  # parameter. To create a change set for an import operation, specify
686
685
  # `IMPORT` for the `ChangeSetType` parameter. After the
687
- # `CreateChangeSet` call successfully completes, AWS CloudFormation
688
- # starts creating the change set. To check the status of the change set
689
- # 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.
690
689
  #
691
690
  # When you are satisfied with the changes the change set will make,
692
- # execute the change set by using the ExecuteChangeSet action. AWS
691
+ # execute the change set by using the ExecuteChangeSet action.
693
692
  # CloudFormation doesn't make changes until you execute the change set.
694
693
  #
695
694
  # To create a change set for the entire stack hierachy, set
@@ -697,13 +696,13 @@ module Aws::CloudFormation
697
696
  #
698
697
  # @option params [required, String] :stack_name
699
698
  # The name or the unique ID of the stack for which you are creating a
700
- # change set. AWS CloudFormation generates the change set by comparing
701
- # this stack's information with the information that you submit, such
702
- # 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.
703
702
  #
704
703
  # @option params [String] :template_body
705
704
  # A structure that contains the body of the revised template, with a
706
- # 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.
707
706
  # CloudFormation generates the change set by comparing this template
708
707
  # with the template of the stack that you specified.
709
708
  #
@@ -712,9 +711,9 @@ module Aws::CloudFormation
712
711
  # @option params [String] :template_url
713
712
  # The location of the file that contains the revised template. The URL
714
713
  # must point to a template (max size: 460,800 bytes) that is located in
715
- # an S3 bucket or a Systems Manager document. AWS CloudFormation
716
- # generates the change set by comparing this template with the stack
717
- # 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.
718
717
  #
719
718
  # Conditional: You must specify only `TemplateBody` or `TemplateURL`.
720
719
  #
@@ -728,16 +727,15 @@ module Aws::CloudFormation
728
727
  #
729
728
  # @option params [Array<String>] :capabilities
730
729
  # In some cases, you must explicitly acknowledge that your stack
731
- # template contains certain capabilities in order for AWS CloudFormation
732
- # to create the stack.
730
+ # template contains certain capabilities in order for CloudFormation to
731
+ # create the stack.
733
732
  #
734
733
  # * `CAPABILITY_IAM` and `CAPABILITY_NAMED_IAM`
735
734
  #
736
735
  # Some stack templates might include resources that can affect
737
- # permissions in your AWS account; for example, by creating new AWS
738
- # Identity and Access Management (IAM) users. For those stacks, you
739
- # must explicitly acknowledge this by specifying one of these
740
- # 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.
741
739
  #
742
740
  # The following IAM resources require you to specify either the
743
741
  # `CAPABILITY_IAM` or `CAPABILITY_NAMED_IAM` capability.
@@ -747,8 +745,8 @@ module Aws::CloudFormation
747
745
  # * If you have IAM resources with custom names, you *must* specify
748
746
  # `CAPABILITY_NAMED_IAM`.
749
747
  #
750
- # * If you don't specify either of these capabilities, AWS
751
- # CloudFormation returns an `InsufficientCapabilities` error.
748
+ # * If you don't specify either of these capabilities, CloudFormation
749
+ # returns an `InsufficientCapabilities` error.
752
750
  #
753
751
  # If your stack template contains these resources, we recommend that
754
752
  # you review all permissions associated with them and edit their
@@ -768,7 +766,7 @@ module Aws::CloudFormation
768
766
  #
769
767
  # * [ AWS::IAM::UserToGroupAddition][7]
770
768
  #
771
- # For more information, see [Acknowledging IAM Resources in AWS
769
+ # For more information, see [Acknowledging IAM Resources in
772
770
  # CloudFormation Templates][8].
773
771
  #
774
772
  # * `CAPABILITY_AUTO_EXPAND`
@@ -783,7 +781,7 @@ module Aws::CloudFormation
783
781
  # create a stack directly from the processed template, without first
784
782
  # reviewing the resulting changes in a change set, you must
785
783
  # acknowledge this capability. This includes the [AWS::Include][9] and
786
- # [AWS::Serverless][10] transforms, which are macros hosted by AWS
784
+ # [AWS::Serverless][10] transforms, which are macros hosted by
787
785
  # CloudFormation.
788
786
  #
789
787
  # <note markdown="1"> This capacity does not apply to creating change sets, and specifying
@@ -796,8 +794,8 @@ module Aws::CloudFormation
796
794
  #
797
795
  # </note>
798
796
  #
799
- # For more information on macros, see [Using AWS CloudFormation Macros
800
- # 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].
801
799
  #
802
800
  #
803
801
  #
@@ -819,44 +817,43 @@ module Aws::CloudFormation
819
817
  # `AWS::EC2::*`, or `Custom::MyCustomInstance`.
820
818
  #
821
819
  # If the list of resource types doesn't include a resource type that
822
- # you're updating, the stack update fails. By default, AWS
823
- # CloudFormation grants permissions to all resource types. AWS Identity
824
- # and Access Management (IAM) uses this parameter for condition keys in
825
- # IAM policies for AWS CloudFormation. For more information, see
826
- # [Controlling Access with AWS Identity and Access Management][1] in the
827
- # 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.
828
826
  #
829
827
  #
830
828
  #
831
829
  # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html
832
830
  #
833
831
  # @option params [String] :role_arn
834
- # The Amazon Resource Name (ARN) of an AWS Identity and Access
835
- # Management (IAM) role that AWS CloudFormation assumes when executing
836
- # the change set. AWS CloudFormation uses the role's credentials to
837
- # make calls on your behalf. AWS CloudFormation uses this role for all
838
- # future operations on the stack. As long as users have permission to
839
- # operate on the stack, AWS CloudFormation uses this role even if the
840
- # users don't have permission to pass it. Ensure that the role grants
841
- # least privilege.
842
- #
843
- # If you don't specify a value, AWS CloudFormation uses the role that
844
- # 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,
845
842
  # CloudFormation uses a temporary session that is generated from your
846
843
  # user credentials.
847
844
  #
848
845
  # @option params [Types::RollbackConfiguration] :rollback_configuration
849
- # The rollback triggers for AWS CloudFormation to monitor during stack
846
+ # The rollback triggers for CloudFormation to monitor during stack
850
847
  # creation and updating operations, and for the specified monitoring
851
848
  # period afterwards.
852
849
  #
853
850
  # @option params [Array<String>] :notification_arns
854
851
  # The Amazon Resource Names (ARNs) of Amazon Simple Notification Service
855
- # (Amazon SNS) topics that AWS CloudFormation associates with the stack.
856
- # 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.
857
854
  #
858
855
  # @option params [Array<Types::Tag>] :tags
859
- # Key-value pairs to associate with this stack. AWS CloudFormation also
856
+ # Key-value pairs to associate with this stack. CloudFormation also
860
857
  # propagates these tags to resources in the stack. You can specify a
861
858
  # maximum of 50 tags.
862
859
  #
@@ -870,9 +867,9 @@ module Aws::CloudFormation
870
867
  #
871
868
  # @option params [String] :client_token
872
869
  # A unique identifier for this `CreateChangeSet` request. Specify this
873
- # token if you plan to retry requests so that AWS CloudFormation knows
874
- # that you're not attempting to create another change set with the same
875
- # 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
876
873
  # CloudFormation successfully received them.
877
874
  #
878
875
  # @option params [String] :description
@@ -884,12 +881,12 @@ module Aws::CloudFormation
884
881
  # specify `UPDATE`. To create a change set for an import operation,
885
882
  # specify `IMPORT`.
886
883
  #
887
- # If you create a change set for a new stack, AWS Cloudformation creates
888
- # a stack with a unique stack ID, but no template or resources. The
889
- # stack will be in the [ `REVIEW_IN_PROGRESS` ][1] state until you
890
- # 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.
891
888
  #
892
- # By default, AWS CloudFormation specifies `UPDATE`. You can't use the
889
+ # By default, CloudFormation specifies `UPDATE`. You can't use the
893
890
  # `UPDATE` type to create a change set for a new stack or the `CREATE`
894
891
  # type to create a change set for an existing stack.
895
892
  #
@@ -991,7 +988,7 @@ module Aws::CloudFormation
991
988
  # @option params [String] :template_body
992
989
  # Structure containing the template body with a minimum length of 1 byte
993
990
  # and a maximum length of 51,200 bytes. For more information, go to
994
- # [Template Anatomy][1] in the AWS CloudFormation User Guide.
991
+ # [Template Anatomy][1] in the CloudFormation User Guide.
995
992
  #
996
993
  # Conditional: You must specify either the `TemplateBody` or the
997
994
  # `TemplateURL` parameter, but not both.
@@ -1004,7 +1001,7 @@ module Aws::CloudFormation
1004
1001
  # Location of file containing the template body. The URL must point to a
1005
1002
  # template (max size: 460,800 bytes) that is located in an Amazon S3
1006
1003
  # bucket or a Systems Manager document. For more information, go to the
1007
- # [Template Anatomy][1] in the AWS CloudFormation User Guide.
1004
+ # [Template Anatomy][1] in the CloudFormation User Guide.
1008
1005
  #
1009
1006
  # Conditional: You must specify either the `TemplateBody` or the
1010
1007
  # `TemplateURL` parameter, but not both.
@@ -1029,7 +1026,7 @@ module Aws::CloudFormation
1029
1026
  # Default: `false`
1030
1027
  #
1031
1028
  # @option params [Types::RollbackConfiguration] :rollback_configuration
1032
- # The rollback triggers for AWS CloudFormation to monitor during stack
1029
+ # The rollback triggers for CloudFormation to monitor during stack
1033
1030
  # creation and updating operations, and for the specified monitoring
1034
1031
  # period afterwards.
1035
1032
  #
@@ -1045,16 +1042,15 @@ module Aws::CloudFormation
1045
1042
  #
1046
1043
  # @option params [Array<String>] :capabilities
1047
1044
  # In some cases, you must explicitly acknowledge that your stack
1048
- # template contains certain capabilities in order for AWS CloudFormation
1049
- # to create the stack.
1045
+ # template contains certain capabilities in order for CloudFormation to
1046
+ # create the stack.
1050
1047
  #
1051
1048
  # * `CAPABILITY_IAM` and `CAPABILITY_NAMED_IAM`
1052
1049
  #
1053
1050
  # Some stack templates might include resources that can affect
1054
- # permissions in your AWS account; for example, by creating new AWS
1055
- # Identity and Access Management (IAM) users. For those stacks, you
1056
- # must explicitly acknowledge this by specifying one of these
1057
- # 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.
1058
1054
  #
1059
1055
  # The following IAM resources require you to specify either the
1060
1056
  # `CAPABILITY_IAM` or `CAPABILITY_NAMED_IAM` capability.
@@ -1064,8 +1060,8 @@ module Aws::CloudFormation
1064
1060
  # * If you have IAM resources with custom names, you *must* specify
1065
1061
  # `CAPABILITY_NAMED_IAM`.
1066
1062
  #
1067
- # * If you don't specify either of these capabilities, AWS
1068
- # CloudFormation returns an `InsufficientCapabilities` error.
1063
+ # * If you don't specify either of these capabilities, CloudFormation
1064
+ # returns an `InsufficientCapabilities` error.
1069
1065
  #
1070
1066
  # If your stack template contains these resources, we recommend that
1071
1067
  # you review all permissions associated with them and edit their
@@ -1085,7 +1081,7 @@ module Aws::CloudFormation
1085
1081
  #
1086
1082
  # * [ AWS::IAM::UserToGroupAddition][7]
1087
1083
  #
1088
- # For more information, see [Acknowledging IAM Resources in AWS
1084
+ # For more information, see [Acknowledging IAM Resources in
1089
1085
  # CloudFormation Templates][8].
1090
1086
  #
1091
1087
  # * `CAPABILITY_AUTO_EXPAND`
@@ -1100,7 +1096,7 @@ module Aws::CloudFormation
1100
1096
  # create a stack directly from the processed template, without first
1101
1097
  # reviewing the resulting changes in a change set, you must
1102
1098
  # acknowledge this capability. This includes the [AWS::Include][9] and
1103
- # [AWS::Serverless][10] transforms, which are macros hosted by AWS
1099
+ # [AWS::Serverless][10] transforms, which are macros hosted by
1104
1100
  # CloudFormation.
1105
1101
  #
1106
1102
  # If you want to create a stack from a stack template that contains
@@ -1112,11 +1108,11 @@ module Aws::CloudFormation
1112
1108
  #
1113
1109
  # Each macro relies on an underlying Lambda service function for
1114
1110
  # processing stack templates. Be aware that the Lambda function owner
1115
- # can update the function operation without AWS CloudFormation being
1111
+ # can update the function operation without CloudFormation being
1116
1112
  # notified.
1117
1113
  #
1118
- # For more information, see [Using AWS CloudFormation Macros to
1119
- # Perform Custom Processing on Templates][11].
1114
+ # For more information, see [Using CloudFormation Macros to Perform
1115
+ # Custom Processing on Templates][11].
1120
1116
  #
1121
1117
  #
1122
1118
  #
@@ -1136,35 +1132,35 @@ module Aws::CloudFormation
1136
1132
  # The template resource types that you have permissions to work with for
1137
1133
  # this create stack action, such as `AWS::EC2::Instance`, `AWS::EC2::*`,
1138
1134
  # or `Custom::MyCustomInstance`. Use the following syntax to describe
1139
- # template resource types: `AWS::*` (for all AWS resource), `Custom::*`
1140
- # (for all custom resources), `Custom::logical_ID ` (for a specific
1141
- # custom resource), `AWS::service_name::*` (for all resources of a
1142
- # particular AWS service), and `AWS::service_name::resource_logical_ID `
1143
- # (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).
1144
1141
  #
1145
1142
  # If the list of resource types doesn't include a resource that you're
1146
- # creating, the stack creation fails. By default, AWS CloudFormation
1147
- # grants permissions to all resource types. AWS Identity and Access
1148
- # Management (IAM) uses this parameter for AWS CloudFormation-specific
1149
- # condition keys in IAM policies. For more information, see [Controlling
1150
- # 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].
1151
1148
  #
1152
1149
  #
1153
1150
  #
1154
1151
  # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html
1155
1152
  #
1156
1153
  # @option params [String] :role_arn
1157
- # The Amazon Resource Name (ARN) of an AWS Identity and Access
1158
- # Management (IAM) role that AWS CloudFormation assumes to create the
1159
- # stack. AWS CloudFormation uses the role's credentials to make calls
1160
- # on your behalf. AWS CloudFormation always uses this role for all
1161
- # future operations on the stack. As long as users have permission to
1162
- # operate on the stack, AWS CloudFormation uses this role even if the
1163
- # users don't have permission to pass it. Ensure that the role grants
1164
- # least privilege.
1165
- #
1166
- # If you don't specify a value, AWS CloudFormation uses the role that
1167
- # 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,
1168
1164
  # CloudFormation uses a temporary session that is generated from your
1169
1165
  # user credentials.
1170
1166
  #
@@ -1177,7 +1173,7 @@ module Aws::CloudFormation
1177
1173
  #
1178
1174
  # @option params [String] :stack_policy_body
1179
1175
  # Structure containing the stack policy body. For more information, go
1180
- # to [ Prevent Updates to Stack Resources][1] in the *AWS CloudFormation
1176
+ # to [ Prevent Updates to Stack Resources][1] in the *CloudFormation
1181
1177
  # User Guide*. You can specify either the `StackPolicyBody` or the
1182
1178
  # `StackPolicyURL` parameter, but not both.
1183
1179
  #
@@ -1192,15 +1188,15 @@ module Aws::CloudFormation
1192
1188
  # the `StackPolicyURL` parameter, but not both.
1193
1189
  #
1194
1190
  # @option params [Array<Types::Tag>] :tags
1195
- # Key-value pairs to associate with this stack. AWS CloudFormation also
1191
+ # Key-value pairs to associate with this stack. CloudFormation also
1196
1192
  # propagates these tags to the resources created in the stack. A maximum
1197
1193
  # number of 50 tags can be specified.
1198
1194
  #
1199
1195
  # @option params [String] :client_request_token
1200
1196
  # A unique identifier for this `CreateStack` request. Specify this token
1201
- # if you plan to retry requests so that AWS CloudFormation knows that
1197
+ # if you plan to retry requests so that CloudFormation knows that
1202
1198
  # you're not attempting to create a stack with the same name. You might
1203
- # retry `CreateStack` requests to ensure that AWS CloudFormation
1199
+ # retry `CreateStack` requests to ensure that CloudFormation
1204
1200
  # successfully received them.
1205
1201
  #
1206
1202
  # All events triggered by a given stack operation are assigned the same
@@ -1222,7 +1218,7 @@ module Aws::CloudFormation
1222
1218
  # user attempts to delete a stack with termination protection enabled,
1223
1219
  # the operation fails and the stack remains unchanged. For more
1224
1220
  # information, see [Protecting a Stack From Being Deleted][1] in the
1225
- # *AWS CloudFormation User Guide*. Termination protection is disabled on
1221
+ # *CloudFormation User Guide*. Termination protection is disabled on
1226
1222
  # stacks by default.
1227
1223
  #
1228
1224
  # For [nested stacks][2], termination protection is set on the root
@@ -1303,21 +1299,20 @@ module Aws::CloudFormation
1303
1299
  # instances from.
1304
1300
  #
1305
1301
  # @option params [Array<String>] :accounts
1306
- # \[Self-managed permissions\] The names of one or more AWS accounts
1307
- # that you want to create stack instances in the specified Region(s)
1308
- # 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.
1309
1304
  #
1310
1305
  # You can specify `Accounts` or `DeploymentTargets`, but not both.
1311
1306
  #
1312
1307
  # @option params [Types::DeploymentTargets] :deployment_targets
1313
- # \[Service-managed permissions\] The AWS Organizations accounts for
1314
- # 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.
1315
1310
  #
1316
1311
  # You can specify `Accounts` or `DeploymentTargets`, but not both.
1317
1312
  #
1318
1313
  # @option params [required, Array<String>] :regions
1319
1314
  # The names of one or more Regions where you want to create stack
1320
- # instances using the specified AWS account(s).
1315
+ # instances using the specified accounts.
1321
1316
  #
1322
1317
  # @option params [Array<Types::Parameter>] :parameter_overrides
1323
1318
  # A list of stack set parameters whose values you want to override in
@@ -1325,24 +1320,19 @@ module Aws::CloudFormation
1325
1320
  #
1326
1321
  # Any overridden parameter values will be applied to all stack instances
1327
1322
  # in the specified accounts and Regions. When specifying parameters and
1328
- # their values, be aware of how AWS CloudFormation sets parameter values
1323
+ # their values, be aware of how CloudFormation sets parameter values
1329
1324
  # during stack instance operations:
1330
1325
  #
1331
1326
  # * To override the current value for a parameter, include the parameter
1332
1327
  # and specify its value.
1333
1328
  #
1334
- # * To leave a parameter set to its present value, you can do one of the
1335
- # following:
1336
- #
1337
- # * Do not include the parameter in the list.
1338
- #
1339
- # * Include the parameter and specify `UsePreviousValue` as `true`.
1340
- # (You cannot specify both a value and set `UsePreviousValue` to
1341
- # `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`.)
1342
1332
  #
1343
- # * To set all overridden parameter back to the values specified in the
1344
- # stack set, specify a parameter list but do not include any
1345
- # 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.
1346
1336
  #
1347
1337
  # * To leave all parameters set to their present values, do not specify
1348
1338
  # this property at all.
@@ -1359,17 +1349,16 @@ module Aws::CloudFormation
1359
1349
  # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_UpdateStackSet.html
1360
1350
  #
1361
1351
  # @option params [Types::StackSetOperationPreferences] :operation_preferences
1362
- # Preferences for how AWS CloudFormation performs this stack set
1363
- # operation.
1352
+ # Preferences for how CloudFormation performs this stack set operation.
1364
1353
  #
1365
1354
  # @option params [String] :operation_id
1366
1355
  # The unique identifier for this stack set operation.
1367
1356
  #
1368
1357
  # The operation ID also functions as an idempotency token, to ensure
1369
- # that AWS CloudFormation performs the stack set operation only once,
1370
- # even if you retry the request multiple times. You might retry stack
1371
- # set operation requests to ensure that AWS CloudFormation successfully
1372
- # 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.
1373
1362
  #
1374
1363
  # If you don't specify an operation ID, the SDK generates one
1375
1364
  # automatically.
@@ -1393,9 +1382,9 @@ module Aws::CloudFormation
1393
1382
  # * If you are signed in to a delegated administrator account, specify
1394
1383
  # `DELEGATED_ADMIN`.
1395
1384
  #
1396
- # Your AWS account must be registered as a delegated administrator in
1397
- # the management account. For more information, see [Register a
1398
- # 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*.
1399
1388
  #
1400
1389
  #
1401
1390
  #
@@ -1468,7 +1457,7 @@ module Aws::CloudFormation
1468
1457
  # @option params [String] :template_body
1469
1458
  # The structure that contains the template body, with a minimum length
1470
1459
  # of 1 byte and a maximum length of 51,200 bytes. For more information,
1471
- # see [Template Anatomy][1] in the AWS CloudFormation User Guide.
1460
+ # see [Template Anatomy][1] in the CloudFormation User Guide.
1472
1461
  #
1473
1462
  # Conditional: You must specify either the TemplateBody or the
1474
1463
  # TemplateURL parameter, but not both.
@@ -1481,7 +1470,7 @@ module Aws::CloudFormation
1481
1470
  # The location of the file that contains the template body. The URL must
1482
1471
  # point to a template (maximum size: 460,800 bytes) that's located in
1483
1472
  # an Amazon S3 bucket or a Systems Manager document. For more
1484
- # information, see [Template Anatomy][1] in the AWS CloudFormation User
1473
+ # information, see [Template Anatomy][1] in the CloudFormation User
1485
1474
  # Guide.
1486
1475
  #
1487
1476
  # Conditional: You must specify either the TemplateBody or the
@@ -1491,21 +1480,24 @@ module Aws::CloudFormation
1491
1480
  #
1492
1481
  # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html
1493
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
+ #
1494
1487
  # @option params [Array<Types::Parameter>] :parameters
1495
1488
  # The input parameters for the stack set template.
1496
1489
  #
1497
1490
  # @option params [Array<String>] :capabilities
1498
1491
  # In some cases, you must explicitly acknowledge that your stack set
1499
- # template contains certain capabilities in order for AWS CloudFormation
1500
- # 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.
1501
1494
  #
1502
1495
  # * `CAPABILITY_IAM` and `CAPABILITY_NAMED_IAM`
1503
1496
  #
1504
1497
  # Some stack templates might include resources that can affect
1505
- # permissions in your AWS account; for example, by creating new AWS
1506
- # Identity and Access Management (IAM) users. For those stack sets,
1507
- # you must explicitly acknowledge this by specifying one of these
1508
- # 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.
1509
1501
  #
1510
1502
  # The following IAM resources require you to specify either the
1511
1503
  # `CAPABILITY_IAM` or `CAPABILITY_NAMED_IAM` capability.
@@ -1515,8 +1507,8 @@ module Aws::CloudFormation
1515
1507
  # * If you have IAM resources with custom names, you *must* specify
1516
1508
  # `CAPABILITY_NAMED_IAM`.
1517
1509
  #
1518
- # * If you don't specify either of these capabilities, AWS
1519
- # CloudFormation returns an `InsufficientCapabilities` error.
1510
+ # * If you don't specify either of these capabilities, CloudFormation
1511
+ # returns an `InsufficientCapabilities` error.
1520
1512
  #
1521
1513
  # If your stack template contains these resources, we recommend that
1522
1514
  # you review all permissions associated with them and edit their
@@ -1536,7 +1528,7 @@ module Aws::CloudFormation
1536
1528
  #
1537
1529
  # * [ AWS::IAM::UserToGroupAddition][7]
1538
1530
  #
1539
- # For more information, see [Acknowledging IAM Resources in AWS
1531
+ # For more information, see [Acknowledging IAM Resources in
1540
1532
  # CloudFormation Templates][8].
1541
1533
  #
1542
1534
  # * `CAPABILITY_AUTO_EXPAND`
@@ -1546,13 +1538,13 @@ module Aws::CloudFormation
1546
1538
  # directly from the processed template, without first reviewing the
1547
1539
  # resulting changes in a change set. To create the stack set directly,
1548
1540
  # you must acknowledge this capability. For more information, see
1549
- # [Using AWS CloudFormation Macros to Perform Custom Processing on
1541
+ # [Using CloudFormation Macros to Perform Custom Processing on
1550
1542
  # Templates][9].
1551
1543
  #
1552
1544
  # Stack sets with service-managed permissions do not currently support
1553
1545
  # the use of macros in templates. (This includes the
1554
1546
  # [AWS::Include][10] and [AWS::Serverless][11] transforms, which are
1555
- # macros hosted by AWS CloudFormation.) Even if you specify this
1547
+ # macros hosted by CloudFormation.) Even if you specify this
1556
1548
  # capability for a stack set with service-managed permissions, if you
1557
1549
  # reference a macro in your template the stack set operation will
1558
1550
  # fail.
@@ -1573,11 +1565,11 @@ module Aws::CloudFormation
1573
1565
  #
1574
1566
  # @option params [Array<Types::Tag>] :tags
1575
1567
  # The key-value pairs to associate with this stack set and the stacks
1576
- # created from it. AWS CloudFormation also propagates these tags to
1568
+ # created from it. CloudFormation also propagates these tags to
1577
1569
  # supported resources that are created in the stacks. A maximum number
1578
1570
  # of 50 tags can be specified.
1579
1571
  #
1580
- # If you specify tags as part of a `CreateStackSet` action, AWS
1572
+ # If you specify tags as part of a `CreateStackSet` action,
1581
1573
  # CloudFormation checks to see if you have the required IAM permission
1582
1574
  # to tag resources. If you don't, the entire `CreateStackSet` action
1583
1575
  # fails with an `access denied` error, and the stack set is not created.
@@ -1590,7 +1582,7 @@ module Aws::CloudFormation
1590
1582
  # roles to control which users or groups can manage specific stack sets
1591
1583
  # within the same administrator account. For more information, see
1592
1584
  # [Prerequisites: Granting Permissions for Stack Set Operations][1] in
1593
- # the *AWS CloudFormation User Guide*.
1585
+ # the *CloudFormation User Guide*.
1594
1586
  #
1595
1587
  #
1596
1588
  #
@@ -1598,7 +1590,7 @@ module Aws::CloudFormation
1598
1590
  #
1599
1591
  # @option params [String] :execution_role_name
1600
1592
  # The name of the IAM execution role to use to create the stack set. If
1601
- # you do not specify an execution role, AWS CloudFormation uses the
1593
+ # you do not specify an execution role, CloudFormation uses the
1602
1594
  # `AWSCloudFormationStackSetExecutionRole` role for the stack set
1603
1595
  # operation.
1604
1596
  #
@@ -1615,7 +1607,7 @@ module Aws::CloudFormation
1615
1607
  # information, see [Grant Self-Managed Stack Set Permissions][1].
1616
1608
  #
1617
1609
  # * With `service-managed` permissions, StackSets automatically creates
1618
- # the IAM roles required to deploy to accounts managed by AWS
1610
+ # the IAM roles required to deploy to accounts managed by
1619
1611
  # Organizations. For more information, see [Grant Service-Managed
1620
1612
  # Stack Set Permissions][2].
1621
1613
  #
@@ -1625,7 +1617,7 @@ module Aws::CloudFormation
1625
1617
  # [2]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-prereqs-service-managed.html
1626
1618
  #
1627
1619
  # @option params [Types::AutoDeployment] :auto_deployment
1628
- # Describes whether StackSets automatically deploys to AWS Organizations
1620
+ # Describes whether StackSets automatically deploys to Organizations
1629
1621
  # accounts that are added to the target organization or organizational
1630
1622
  # unit (OU). Specify only if `PermissionModel` is `SERVICE_MANAGED`.
1631
1623
  #
@@ -1643,9 +1635,9 @@ module Aws::CloudFormation
1643
1635
  # * To create a stack set with service-managed permissions while signed
1644
1636
  # in to a delegated administrator account, specify `DELEGATED_ADMIN`.
1645
1637
  #
1646
- # Your AWS account must be registered as a delegated admin in the
1638
+ # Your account must be registered as a delegated admin in the
1647
1639
  # management account. For more information, see [Register a delegated
1648
- # administrator][1] in the *AWS CloudFormation User Guide*.
1640
+ # administrator][1] in the *CloudFormation User Guide*.
1649
1641
  #
1650
1642
  # Stack sets with service-managed permissions are created in the
1651
1643
  # management account, including stack sets that are created by delegated
@@ -1657,9 +1649,9 @@ module Aws::CloudFormation
1657
1649
  #
1658
1650
  # @option params [String] :client_request_token
1659
1651
  # A unique identifier for this `CreateStackSet` request. Specify this
1660
- # token if you plan to retry requests so that AWS CloudFormation knows
1661
- # that you're not attempting to create another stack set with the same
1662
- # 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
1663
1655
  # CloudFormation successfully received them.
1664
1656
  #
1665
1657
  # If you don't specify an operation ID, the SDK generates one
@@ -1679,6 +1671,7 @@ module Aws::CloudFormation
1679
1671
  # description: "Description",
1680
1672
  # template_body: "TemplateBody",
1681
1673
  # template_url: "TemplateURL",
1674
+ # stack_id: "StackId",
1682
1675
  # parameters: [
1683
1676
  # {
1684
1677
  # parameter_key: "ParameterKey",
@@ -1767,7 +1760,7 @@ module Aws::CloudFormation
1767
1760
  # Deletes the specified change set. Deleting change sets ensures that no
1768
1761
  # one executes the wrong change set.
1769
1762
  #
1770
- # If the call successfully completes, AWS CloudFormation successfully
1763
+ # If the call successfully completes, CloudFormation successfully
1771
1764
  # deleted the change set.
1772
1765
  #
1773
1766
  # If `IncludeNestedStacks` specifies `True` during the creation of the
@@ -1811,28 +1804,28 @@ module Aws::CloudFormation
1811
1804
  # @option params [Array<String>] :retain_resources
1812
1805
  # For stacks in the `DELETE_FAILED` state, a list of resource logical
1813
1806
  # IDs that are associated with the resources you want to retain. During
1814
- # deletion, AWS CloudFormation deletes the stack but does not delete the
1807
+ # deletion, CloudFormation deletes the stack but does not delete the
1815
1808
  # retained resources.
1816
1809
  #
1817
1810
  # Retaining resources is useful when you cannot delete a resource, such
1818
1811
  # as a non-empty S3 bucket, but you want to delete the stack.
1819
1812
  #
1820
1813
  # @option params [String] :role_arn
1821
- # The Amazon Resource Name (ARN) of an AWS Identity and Access
1822
- # Management (IAM) role that AWS CloudFormation assumes to delete the
1823
- # stack. AWS CloudFormation uses the role's credentials to make calls
1824
- # 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.
1825
1818
  #
1826
- # If you don't specify a value, AWS CloudFormation uses the role that
1827
- # 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,
1828
1821
  # CloudFormation uses a temporary session that is generated from your
1829
1822
  # user credentials.
1830
1823
  #
1831
1824
  # @option params [String] :client_request_token
1832
1825
  # A unique identifier for this `DeleteStack` request. Specify this token
1833
- # if you plan to retry requests so that AWS CloudFormation knows that
1826
+ # if you plan to retry requests so that CloudFormation knows that
1834
1827
  # you're not attempting to delete a stack with the same name. You might
1835
- # retry `DeleteStack` requests to ensure that AWS CloudFormation
1828
+ # retry `DeleteStack` requests to ensure that CloudFormation
1836
1829
  # successfully received them.
1837
1830
  #
1838
1831
  # All events triggered by a given stack operation are assigned the same
@@ -1877,14 +1870,14 @@ module Aws::CloudFormation
1877
1870
  # instances for.
1878
1871
  #
1879
1872
  # @option params [Array<String>] :accounts
1880
- # \[Self-managed permissions\] The names of the AWS accounts that you
1881
- # want to delete stack instances for.
1873
+ # \[Self-managed permissions\] The names of the accounts that you want
1874
+ # to delete stack instances for.
1882
1875
  #
1883
1876
  # You can specify `Accounts` or `DeploymentTargets`, but not both.
1884
1877
  #
1885
1878
  # @option params [Types::DeploymentTargets] :deployment_targets
1886
- # \[Service-managed permissions\] The AWS Organizations accounts from
1887
- # which to delete stack instances.
1879
+ # \[Service-managed permissions\] The Organizations accounts from which
1880
+ # to delete stack instances.
1888
1881
  #
1889
1882
  # You can specify `Accounts` or `DeploymentTargets`, but not both.
1890
1883
  #
@@ -1892,8 +1885,7 @@ module Aws::CloudFormation
1892
1885
  # The Regions where you want to delete stack set instances.
1893
1886
  #
1894
1887
  # @option params [Types::StackSetOperationPreferences] :operation_preferences
1895
- # Preferences for how AWS CloudFormation performs this stack set
1896
- # operation.
1888
+ # Preferences for how CloudFormation performs this stack set operation.
1897
1889
  #
1898
1890
  # @option params [required, Boolean] :retain_stacks
1899
1891
  # Removes the stack instances from the specified stack set, but doesn't
@@ -1913,10 +1905,10 @@ module Aws::CloudFormation
1913
1905
  # automatically.
1914
1906
  #
1915
1907
  # The operation ID also functions as an idempotency token, to ensure
1916
- # that AWS CloudFormation performs the stack set operation only once,
1917
- # even if you retry the request multiple times. You can retry stack set
1918
- # operation requests to ensure that AWS CloudFormation successfully
1919
- # 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.
1920
1912
  #
1921
1913
  # Repeating this stack set operation with a new operation ID retries all
1922
1914
  # stack instances whose status is `OUTDATED`.
@@ -1937,9 +1929,9 @@ module Aws::CloudFormation
1937
1929
  # * If you are signed in to a delegated administrator account, specify
1938
1930
  # `DELEGATED_ADMIN`.
1939
1931
  #
1940
- # Your AWS account must be registered as a delegated administrator in
1941
- # the management account. For more information, see [Register a
1942
- # 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*.
1943
1935
  #
1944
1936
  #
1945
1937
  #
@@ -2007,9 +1999,9 @@ module Aws::CloudFormation
2007
1999
  # * If you are signed in to a delegated administrator account, specify
2008
2000
  # `DELEGATED_ADMIN`.
2009
2001
  #
2010
- # Your AWS account must be registered as a delegated administrator in
2011
- # the management account. For more information, see [Register a
2012
- # 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*.
2013
2005
  #
2014
2006
  #
2015
2007
  #
@@ -2096,10 +2088,10 @@ module Aws::CloudFormation
2096
2088
  req.send_request(options)
2097
2089
  end
2098
2090
 
2099
- # Retrieves your account's AWS CloudFormation limits, such as the
2100
- # maximum number of stacks that you can create in your account. For more
2101
- # information about account limits, see [AWS CloudFormation Limits][1]
2102
- # 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*.
2103
2095
  #
2104
2096
  #
2105
2097
  #
@@ -2138,9 +2130,9 @@ module Aws::CloudFormation
2138
2130
  req.send_request(options)
2139
2131
  end
2140
2132
 
2141
- # 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
2142
2134
  # CloudFormation will make if you execute the change set. For more
2143
- # information, see [Updating Stacks Using Change Sets][1] in the AWS
2135
+ # information, see [Updating Stacks Using Change Sets][1] in the
2144
2136
  # CloudFormation User Guide.
2145
2137
  #
2146
2138
  #
@@ -2331,10 +2323,10 @@ module Aws::CloudFormation
2331
2323
  # @option params [required, String] :stack_drift_detection_id
2332
2324
  # The ID of the drift detection results of this operation.
2333
2325
  #
2334
- # AWS CloudFormation generates new results, with a new drift detection
2335
- # ID, each time this operation is run. However, the number of drift
2336
- # results AWS CloudFormation retains for any given stack, and for how
2337
- # 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.
2338
2330
  #
2339
2331
  # @return [Types::DescribeStackDriftDetectionStatusOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2340
2332
  #
@@ -2373,7 +2365,7 @@ module Aws::CloudFormation
2373
2365
 
2374
2366
  # Returns all stack related events for a specified stack in reverse
2375
2367
  # chronological order. For more information about a stack's event
2376
- # history, go to [Stacks][1] in the AWS CloudFormation User Guide.
2368
+ # history, go to [Stacks][1] in the CloudFormation User Guide.
2377
2369
  #
2378
2370
  # <note markdown="1"> You can list events for stacks that have failed to create or have been
2379
2371
  # deleted by specifying the unique stack identifier (stack ID).
@@ -2439,7 +2431,7 @@ module Aws::CloudFormation
2439
2431
  end
2440
2432
 
2441
2433
  # Returns the stack instance that's associated with the specified stack
2442
- # set, AWS account, and Region.
2434
+ # set, account, and Region.
2443
2435
  #
2444
2436
  # For a list of stack instances that are associated with a specific
2445
2437
  # stack set, use ListStackInstances.
@@ -2449,7 +2441,7 @@ module Aws::CloudFormation
2449
2441
  # stack instance information for.
2450
2442
  #
2451
2443
  # @option params [required, String] :stack_instance_account
2452
- # 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.
2453
2445
  #
2454
2446
  # @option params [required, String] :stack_instance_region
2455
2447
  # The name of a Region that's associated with this stack instance.
@@ -2467,9 +2459,9 @@ module Aws::CloudFormation
2467
2459
  # * If you are signed in to a delegated administrator account, specify
2468
2460
  # `DELEGATED_ADMIN`.
2469
2461
  #
2470
- # Your AWS account must be registered as a delegated administrator in
2471
- # the management account. For more information, see [Register a
2472
- # 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*.
2473
2465
  #
2474
2466
  #
2475
2467
  #
@@ -2576,7 +2568,7 @@ module Aws::CloudFormation
2576
2568
 
2577
2569
  # Returns drift information for the resources that have been checked for
2578
2570
  # drift in the specified stack. This includes actual and expected
2579
- # configuration values for resources where AWS CloudFormation detects
2571
+ # configuration values for resources where CloudFormation detects
2580
2572
  # configuration drift.
2581
2573
  #
2582
2574
  # For a given stack, there will be one `StackResourceDrift` for each
@@ -2610,8 +2602,7 @@ module Aws::CloudFormation
2610
2602
  # * `IN_SYNC`\: The resources's actual configuration matches its
2611
2603
  # expected template configuration.
2612
2604
  #
2613
- # * `NOT_CHECKED`\: AWS CloudFormation does not currently return this
2614
- # value.
2605
+ # * `NOT_CHECKED`\: CloudFormation does not currently return this value.
2615
2606
  #
2616
2607
  # @option params [String] :next_token
2617
2608
  # A string that identifies the next page of stack resource drift
@@ -2671,11 +2662,11 @@ module Aws::CloudFormation
2671
2662
  req.send_request(options)
2672
2663
  end
2673
2664
 
2674
- # Returns AWS resource descriptions for running and deleted stacks. If
2675
- # `StackName` is specified, all the associated resources that are part
2676
- # of the stack are returned. If `PhysicalResourceId` is specified, the
2677
- # associated resources of the stack that the resource belongs to are
2678
- # 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.
2679
2670
  #
2680
2671
  # <note markdown="1"> Only the first 100 resources will be returned. If your stack has more
2681
2672
  # resources than this, you should use `ListStackResources` instead.
@@ -2688,8 +2679,8 @@ module Aws::CloudFormation
2688
2679
  # You must specify either `StackName` or `PhysicalResourceId`, but not
2689
2680
  # both. In addition, you can specify `LogicalResourceId` to filter the
2690
2681
  # returned result. For more information about resources, the
2691
- # `LogicalResourceId` and `PhysicalResourceId`, go to the [AWS
2692
- # CloudFormation User Guide][1].
2682
+ # `LogicalResourceId` and `PhysicalResourceId`, go to the
2683
+ # [CloudFormation User Guide][1].
2693
2684
  #
2694
2685
  # <note markdown="1"> A `ValidationError` is returned if you specify both `StackName` and
2695
2686
  # `PhysicalResourceId` in the same request.
@@ -2721,7 +2712,7 @@ module Aws::CloudFormation
2721
2712
  #
2722
2713
  # @option params [String] :physical_resource_id
2723
2714
  # The name or unique identifier that corresponds to a physical instance
2724
- # ID of a resource supported by AWS CloudFormation.
2715
+ # ID of a resource supported by CloudFormation.
2725
2716
  #
2726
2717
  # For example, for an Amazon Elastic Compute Cloud (EC2) instance,
2727
2718
  # `PhysicalResourceId` corresponds to the `InstanceId`. You can pass the
@@ -2789,9 +2780,9 @@ module Aws::CloudFormation
2789
2780
  # * If you are signed in to a delegated administrator account, specify
2790
2781
  # `DELEGATED_ADMIN`.
2791
2782
  #
2792
- # Your AWS account must be registered as a delegated administrator in
2793
- # the management account. For more information, see [Register a
2794
- # 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*.
2795
2786
  #
2796
2787
  #
2797
2788
  #
@@ -2873,9 +2864,9 @@ module Aws::CloudFormation
2873
2864
  # * If you are signed in to a delegated administrator account, specify
2874
2865
  # `DELEGATED_ADMIN`.
2875
2866
  #
2876
- # Your AWS account must be registered as a delegated administrator in
2877
- # the management account. For more information, see [Register a
2878
- # 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*.
2879
2870
  #
2880
2871
  #
2881
2872
  #
@@ -3211,14 +3202,13 @@ module Aws::CloudFormation
3211
3202
  # Detects whether a stack's actual configuration differs, or has
3212
3203
  # *drifted*, from it's expected configuration, as defined in the stack
3213
3204
  # template and any values specified as template parameters. For each
3214
- # resource in the stack that supports drift detection, AWS
3215
- # CloudFormation compares the actual configuration of the resource with
3216
- # its expected template configuration. Only resource properties
3217
- # explicitly defined in the stack template are checked for drift. A
3218
- # stack is considered to have drifted if one or more of its resources
3219
- # differ from their expected template configurations. For more
3220
- # information, see [Detecting Unregulated Configuration Changes to
3221
- # 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].
3222
3212
  #
3223
3213
  # Use `DetectStackDrift` to detect drift on all supported resources for
3224
3214
  # a given stack, or DetectStackResourceDrift to detect drift on
@@ -3234,8 +3224,8 @@ module Aws::CloudFormation
3234
3224
  # completed, use DescribeStackResourceDrifts to return drift information
3235
3225
  # about the stack and its resources.
3236
3226
  #
3237
- # When detecting drift on a stack, AWS CloudFormation does not detect
3238
- # 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
3239
3229
  # `DetectStackDrift` directly on the nested stack itself.
3240
3230
  #
3241
3231
  #
@@ -3277,7 +3267,7 @@ module Aws::CloudFormation
3277
3267
  # differs, or has *drifted*, from it's expected configuration, as
3278
3268
  # defined in the stack template and any values specified as template
3279
3269
  # parameters. This information includes actual and expected property
3280
- # values for resources in which AWS CloudFormation detects drift. Only
3270
+ # values for resources in which CloudFormation detects drift. Only
3281
3271
  # resource properties explicitly defined in the stack template are
3282
3272
  # checked for drift. For more information about stack and resource
3283
3273
  # drift, see [Detecting Unregulated Configuration Changes to Stacks and
@@ -3391,8 +3381,8 @@ module Aws::CloudFormation
3391
3381
  # operation.
3392
3382
  #
3393
3383
  # @option params [Types::StackSetOperationPreferences] :operation_preferences
3394
- # The user-specified preferences for how AWS CloudFormation performs a
3395
- # stack set operation.
3384
+ # The user-specified preferences for how CloudFormation performs a stack
3385
+ # set operation.
3396
3386
  #
3397
3387
  # For more information on maximum concurrent accounts and failure
3398
3388
  # tolerance, see [Stack set operation options][1].
@@ -3420,9 +3410,9 @@ module Aws::CloudFormation
3420
3410
  # * If you are signed in to a delegated administrator account, specify
3421
3411
  # `DELEGATED_ADMIN`.
3422
3412
  #
3423
- # Your AWS account must be registered as a delegated administrator in
3424
- # the management account. For more information, see [Register a
3425
- # 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*.
3426
3416
  #
3427
3417
  #
3428
3418
  #
@@ -3462,13 +3452,13 @@ module Aws::CloudFormation
3462
3452
  end
3463
3453
 
3464
3454
  # Returns the estimated monthly cost of a template. The return value is
3465
- # an AWS Simple Monthly Calculator URL with a query string that
3466
- # 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.
3467
3457
  #
3468
3458
  # @option params [String] :template_body
3469
3459
  # Structure containing the template body with a minimum length of 1 byte
3470
3460
  # and a maximum length of 51,200 bytes. (For more information, go to
3471
- # [Template Anatomy][1] in the AWS CloudFormation User Guide.)
3461
+ # [Template Anatomy][1] in the CloudFormation User Guide.)
3472
3462
  #
3473
3463
  # Conditional: You must pass `TemplateBody` or `TemplateURL`. If both
3474
3464
  # are passed, only `TemplateBody` is used.
@@ -3480,7 +3470,7 @@ module Aws::CloudFormation
3480
3470
  # @option params [String] :template_url
3481
3471
  # Location of file containing the template body. The URL must point to a
3482
3472
  # template that is located in an Amazon S3 bucket or a Systems Manager
3483
- # document. For more information, go to [Template Anatomy][1] in the AWS
3473
+ # document. For more information, go to [Template Anatomy][1] in the
3484
3474
  # CloudFormation User Guide.
3485
3475
  #
3486
3476
  # Conditional: You must pass `TemplateURL` or `TemplateBody`. If both
@@ -3527,14 +3517,14 @@ module Aws::CloudFormation
3527
3517
 
3528
3518
  # Updates a stack using the input information that was provided when the
3529
3519
  # specified change set was created. After the call successfully
3530
- # completes, AWS CloudFormation starts updating the stack. Use the
3520
+ # completes, CloudFormation starts updating the stack. Use the
3531
3521
  # DescribeStacks action to view the status of the update.
3532
3522
  #
3533
- # When you execute a change set, AWS CloudFormation deletes all other
3534
- # change sets associated with the stack because they aren't valid for
3535
- # 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.
3536
3526
  #
3537
- # If a stack policy is associated with the stack, AWS CloudFormation
3527
+ # If a stack policy is associated with the stack, CloudFormation
3538
3528
  # enforces the policy during the update. You can't specify a temporary
3539
3529
  # stack policy that overrides the current policy.
3540
3530
  #
@@ -3551,10 +3541,10 @@ module Aws::CloudFormation
3551
3541
  #
3552
3542
  # @option params [String] :client_request_token
3553
3543
  # A unique identifier for this `ExecuteChangeSet` request. Specify this
3554
- # token if you plan to retry requests so that AWS CloudFormation knows
3555
- # that you're not attempting to execute a change set to update a stack
3556
- # with the same name. You might retry `ExecuteChangeSet` requests to
3557
- # 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.
3558
3548
  #
3559
3549
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
3560
3550
  #
@@ -3627,18 +3617,18 @@ module Aws::CloudFormation
3627
3617
  # Default: There is no default value.
3628
3618
  #
3629
3619
  # @option params [String] :change_set_name
3630
- # 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
3631
3621
  # CloudFormation returns the associated template. If you specify a name,
3632
3622
  # you must also specify the `StackName`.
3633
3623
  #
3634
3624
  # @option params [String] :template_stage
3635
3625
  # For templates that include transforms, the stage of the template that
3636
- # AWS CloudFormation returns. To get the user-submitted template,
3637
- # specify `Original`. To get the template after AWS CloudFormation has
3638
- # 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`.
3639
3629
  #
3640
3630
  # If the template doesn't include transforms, `Original` and
3641
- # `Processed` return the same template. By default, AWS CloudFormation
3631
+ # `Processed` return the same template. By default, CloudFormation
3642
3632
  # specifies `Processed`.
3643
3633
  #
3644
3634
  # @return [Types::GetTemplateOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
@@ -3685,8 +3675,7 @@ module Aws::CloudFormation
3685
3675
  # @option params [String] :template_body
3686
3676
  # Structure containing the template body with a minimum length of 1 byte
3687
3677
  # and a maximum length of 51,200 bytes. For more information about
3688
- # templates, see [Template Anatomy][1] in the AWS CloudFormation User
3689
- # Guide.
3678
+ # templates, see [Template Anatomy][1] in the CloudFormation User Guide.
3690
3679
  #
3691
3680
  # Conditional: You must specify only one of the following parameters:
3692
3681
  # `StackName`, `StackSetName`, `TemplateBody`, or `TemplateURL`.
@@ -3699,8 +3688,7 @@ module Aws::CloudFormation
3699
3688
  # Location of file containing the template body. The URL must point to a
3700
3689
  # template (max size: 460,800 bytes) that is located in an Amazon S3
3701
3690
  # bucket or a Systems Manager document. For more information about
3702
- # templates, see [Template Anatomy][1] in the AWS CloudFormation User
3703
- # Guide.
3691
+ # templates, see [Template Anatomy][1] in the CloudFormation User Guide.
3704
3692
  #
3705
3693
  # Conditional: You must specify only one of the following parameters:
3706
3694
  # `StackName`, `StackSetName`, `TemplateBody`, or `TemplateURL`.
@@ -3738,9 +3726,9 @@ module Aws::CloudFormation
3738
3726
  # * If you are signed in to a delegated administrator account, specify
3739
3727
  # `DELEGATED_ADMIN`.
3740
3728
  #
3741
- # Your AWS account must be registered as a delegated administrator in
3742
- # the management account. For more information, see [Register a
3743
- # delegated administrator][1] in the *AWS CloudFormation User Guide*.
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*.
3744
3732
  #
3745
3733
  #
3746
3734
  #
@@ -3804,8 +3792,86 @@ module Aws::CloudFormation
3804
3792
  req.send_request(options)
3805
3793
  end
3806
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
+
3807
3873
  # Returns the ID and status of each active change set for a stack. For
3808
- # example, AWS CloudFormation lists change sets that are in the
3874
+ # example, CloudFormation lists change sets that are in the
3809
3875
  # `CREATE_IN_PROGRESS` or `CREATE_PENDING` state.
3810
3876
  #
3811
3877
  # @option params [required, String] :stack_name
@@ -3861,7 +3927,7 @@ module Aws::CloudFormation
3861
3927
  # values that you can import into other stacks. To import values, use
3862
3928
  # the [ `Fn::ImportValue` ][1] function.
3863
3929
  #
3864
- # For more information, see [ AWS CloudFormation Export Stack Output
3930
+ # For more information, see [ CloudFormation Export Stack Output
3865
3931
  # Values][2].
3866
3932
  #
3867
3933
  #
@@ -3916,7 +3982,7 @@ module Aws::CloudFormation
3916
3982
  # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-importvalue.html
3917
3983
  #
3918
3984
  # @option params [required, String] :export_name
3919
- # The name of the exported output value. AWS CloudFormation returns the
3985
+ # The name of the exported output value. CloudFormation returns the
3920
3986
  # stack names that are importing this value.
3921
3987
  #
3922
3988
  # @option params [String] :next_token
@@ -3955,8 +4021,8 @@ module Aws::CloudFormation
3955
4021
 
3956
4022
  # Returns summary information about stack instances that are associated
3957
4023
  # with the specified stack set. You can filter for stack instances that
3958
- # are associated with a specific AWS account name or Region, or that
3959
- # have a specific status.
4024
+ # are associated with a specific account name or Region, or that have a
4025
+ # specific status.
3960
4026
  #
3961
4027
  # @option params [required, String] :stack_set_name
3962
4028
  # The name or unique ID of the stack set that you want to list stack
@@ -3980,7 +4046,7 @@ module Aws::CloudFormation
3980
4046
  # The status that stack instances are filtered by.
3981
4047
  #
3982
4048
  # @option params [String] :stack_instance_account
3983
- # 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.
3984
4050
  #
3985
4051
  # @option params [String] :stack_instance_region
3986
4052
  # The name of the Region where you want to list stack instances.
@@ -3998,9 +4064,9 @@ module Aws::CloudFormation
3998
4064
  # * If you are signed in to a delegated administrator account, specify
3999
4065
  # `DELEGATED_ADMIN`.
4000
4066
  #
4001
- # Your AWS account must be registered as a delegated administrator in
4002
- # the management account. For more information, see [Register a
4003
- # 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*.
4004
4070
  #
4005
4071
  #
4006
4072
  #
@@ -4150,9 +4216,9 @@ module Aws::CloudFormation
4150
4216
  # * If you are signed in to a delegated administrator account, specify
4151
4217
  # `DELEGATED_ADMIN`.
4152
4218
  #
4153
- # Your AWS account must be registered as a delegated administrator in
4154
- # the management account. For more information, see [Register a
4155
- # 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*.
4156
4222
  #
4157
4223
  #
4158
4224
  #
@@ -4230,9 +4296,9 @@ module Aws::CloudFormation
4230
4296
  # * If you are signed in to a delegated administrator account, specify
4231
4297
  # `DELEGATED_ADMIN`.
4232
4298
  #
4233
- # Your AWS account must be registered as a delegated administrator in
4234
- # the management account. For more information, see [Register a
4235
- # 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*.
4236
4302
  #
4237
4303
  #
4238
4304
  #
@@ -4277,8 +4343,8 @@ module Aws::CloudFormation
4277
4343
  # the user.
4278
4344
  #
4279
4345
  # * \[Self-managed permissions\] If you set the `CallAs` parameter to
4280
- # `SELF` while signed in to your AWS account, `ListStackSets` returns
4281
- # 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.
4282
4348
  #
4283
4349
  # * \[Service-managed permissions\] If you set the `CallAs` parameter to
4284
4350
  # `SELF` while signed in to the organization's management account,
@@ -4320,9 +4386,9 @@ module Aws::CloudFormation
4320
4386
  # * If you are signed in to a delegated administrator account, specify
4321
4387
  # `DELEGATED_ADMIN`.
4322
4388
  #
4323
- # Your AWS account must be registered as a delegated administrator in
4324
- # the management account. For more information, see [Register a
4325
- # 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*.
4326
4392
  #
4327
4393
  #
4328
4394
  #
@@ -4612,9 +4678,9 @@ module Aws::CloudFormation
4612
4678
  #
4613
4679
  # @option params [String] :provisioning_type
4614
4680
  # For resource types, the provisioning behavior of the resource type.
4615
- # AWS CloudFormation determines the provisioning type during
4616
- # registration, based on the types of handlers in the schema handler
4617
- # package submitted.
4681
+ # CloudFormation determines the provisioning type during registration,
4682
+ # based on the types of handlers in the schema handler package
4683
+ # submitted.
4618
4684
  #
4619
4685
  # Valid values include:
4620
4686
  #
@@ -4758,6 +4824,9 @@ module Aws::CloudFormation
4758
4824
  # If you do not specify a version number, CloudFormation increments the
4759
4825
  # version number by one minor version release.
4760
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
+ #
4761
4830
  #
4762
4831
  #
4763
4832
  # [1]: https://semver.org/
@@ -4872,7 +4941,7 @@ module Aws::CloudFormation
4872
4941
  # Registers your account as a publisher of public extensions in the
4873
4942
  # CloudFormation registry. Public extensions are available for use by
4874
4943
  # all CloudFormation users. This publisher ID applies to your account in
4875
- # all AWS regions.
4944
+ # all Regions.
4876
4945
  #
4877
4946
  # For information on requirements for registering as a public extension
4878
4947
  # publisher, see [Registering your account to publish CloudFormation
@@ -4885,13 +4954,17 @@ module Aws::CloudFormation
4885
4954
  # [1]: https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/publish-extension.html#publish-extension-prereqs
4886
4955
  #
4887
4956
  # @option params [Boolean] :accept_terms_and_conditions
4888
- # Whether you accept the terms and conditions for publishing extensions
4889
- # in the CloudFormation registry. You must accept the terms and
4890
- # conditions in order to register to publish public extensions to the
4891
- # CloudFormation registry.
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.
4892
4961
  #
4893
4962
  # The default is `false`.
4894
4963
  #
4964
+ #
4965
+ #
4966
+ # [1]: https://cloudformation-registry-documents.s3.amazonaws.com/Terms_and_Conditions_for_AWS_CloudFormation_Registry_Publishers.pdf
4967
+ #
4895
4968
  # @option params [String] :connection_arn
4896
4969
  # If you are using a Bitbucket or GitHub account for identity
4897
4970
  # verification, the Amazon Resource Name (ARN) for your connection to
@@ -4930,7 +5003,7 @@ module Aws::CloudFormation
4930
5003
 
4931
5004
  # Registers an extension with the CloudFormation service. Registering an
4932
5005
  # extension makes it available for use in CloudFormation templates in
4933
- # your AWS account, and includes:
5006
+ # your account, and includes:
4934
5007
  #
4935
5008
  # * Validating the extension schema
4936
5009
  #
@@ -5006,8 +5079,8 @@ module Aws::CloudFormation
5006
5079
  # <note markdown="1"> The user registering the extension must be able to access the package
5007
5080
  # in the S3 bucket. That is, the user needs to have [GetObject][2]
5008
5081
  # permissions for the schema handler package. For more information, see
5009
- # [Actions, Resources, and Condition Keys for Amazon S3][3] in the *AWS
5010
- # 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*.
5011
5084
  #
5012
5085
  # </note>
5013
5086
  #
@@ -5029,14 +5102,14 @@ module Aws::CloudFormation
5029
5102
  # principle (`resources.cloudformation.amazonaws.com`). For more
5030
5103
  # information on adding trust relationships, see [Modifying a role trust
5031
5104
  # policy](IAM/latest/UserGuide/roles-managingrole-editing-console.html#roles-managingrole_edit-trust-policy)
5032
- # in the *AWS Identity and Access Management User Guide*.
5105
+ # in the *Identity and Access Management User Guide*.
5033
5106
  #
5034
- # If your extension calls AWS APIs in any of its handlers, you must
5035
- # create an <i> <a
5107
+ # If your extension calls Amazon Web Services APIs in any of its
5108
+ # handlers, you must create an <i> <a
5036
5109
  # href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html">IAM
5037
5110
  # execution role</a> </i> that includes the necessary permissions to
5038
- # call those AWS APIs, and provision that execution role in your
5039
- # account. When CloudFormation needs to invoke the resource type
5111
+ # call those Amazon Web Services APIs, and provision that execution role
5112
+ # in your account. When CloudFormation needs to invoke the resource type
5040
5113
  # handler, CloudFormation assumes this execution role to create a
5041
5114
  # temporary session token, which it then passes to the resource type
5042
5115
  # handler, thereby supplying your resource type with the appropriate
@@ -5087,8 +5160,8 @@ module Aws::CloudFormation
5087
5160
  #
5088
5161
  # @option params [String] :stack_policy_body
5089
5162
  # Structure containing the stack policy body. For more information, go
5090
- # to [ Prevent Updates to Stack Resources][1] in the AWS CloudFormation
5091
- # 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
5092
5165
  # `StackPolicyURL` parameter, but not both.
5093
5166
  #
5094
5167
  #
@@ -5132,7 +5205,7 @@ module Aws::CloudFormation
5132
5205
  # It is strongly recommended that you use dynamic references to restrict
5133
5206
  # sensitive configuration definitions, such as third-party credentials.
5134
5207
  # For more details on dynamic references, see [Using dynamic references
5135
- # to specify template values][2] in the *AWS CloudFormation User Guide*.
5208
+ # to specify template values][2] in the *CloudFormation User Guide*.
5136
5209
  #
5137
5210
  #
5138
5211
  #
@@ -5261,11 +5334,11 @@ module Aws::CloudFormation
5261
5334
 
5262
5335
  # Sends a signal to the specified resource with a success or failure
5263
5336
  # status. You can use the SignalResource API in conjunction with a
5264
- # creation policy or update policy. AWS CloudFormation doesn't proceed
5265
- # with a stack creation or update until resources receive the required
5266
- # number of signals or the timeout period is exceeded. The
5267
- # SignalResource API is useful in cases where you want to send signals
5268
- # 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.
5269
5342
  #
5270
5343
  # @option params [required, String] :stack_name
5271
5344
  # The stack name or unique stack ID that includes the resource that you
@@ -5284,7 +5357,7 @@ module Aws::CloudFormation
5284
5357
  #
5285
5358
  # @option params [required, String] :status
5286
5359
  # The status of the signal, which is either success or failure. A
5287
- # failure signal causes AWS CloudFormation to immediately fail the stack
5360
+ # failure signal causes CloudFormation to immediately fail the stack
5288
5361
  # creation or update.
5289
5362
  #
5290
5363
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
@@ -5330,9 +5403,9 @@ module Aws::CloudFormation
5330
5403
  # * If you are signed in to a delegated administrator account, specify
5331
5404
  # `DELEGATED_ADMIN`.
5332
5405
  #
5333
- # Your AWS account must be registered as a delegated administrator in
5334
- # the management account. For more information, see [Register a
5335
- # 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*.
5336
5409
  #
5337
5410
  #
5338
5411
  #
@@ -5373,7 +5446,7 @@ module Aws::CloudFormation
5373
5446
  # version of the extension in your account and region for testing.
5374
5447
  #
5375
5448
  # To perform testing, CloudFormation assumes the execution role
5376
- # specified when the test was registered. For more information, see
5449
+ # specified when the type was registered. For more information, see
5377
5450
  # [RegisterType](AWSCloudFormation/latest/APIReference/API_RegisterType.html).
5378
5451
  #
5379
5452
  # Once you've initiated testing on an extension using `TestType`, you
@@ -5432,7 +5505,8 @@ module Aws::CloudFormation
5432
5505
  # * PutObject
5433
5506
  #
5434
5507
  # For more information, see [Actions, Resources, and Condition Keys for
5435
- # Amazon S3][1] in the *AWS Identity and Access Management User Guide*.
5508
+ # Amazon S3][1] in the *Amazon Web Services Identity and Access
5509
+ # Management User Guide*.
5436
5510
  #
5437
5511
  #
5438
5512
  #
@@ -5486,7 +5560,7 @@ module Aws::CloudFormation
5486
5560
  # @option params [String] :template_body
5487
5561
  # Structure containing the template body with a minimum length of 1 byte
5488
5562
  # and a maximum length of 51,200 bytes. (For more information, go to
5489
- # [Template Anatomy][1] in the AWS CloudFormation User Guide.)
5563
+ # [Template Anatomy][1] in the CloudFormation User Guide.)
5490
5564
  #
5491
5565
  # Conditional: You must specify only one of the following parameters:
5492
5566
  # `TemplateBody`, `TemplateURL`, or set the `UsePreviousTemplate` to
@@ -5499,7 +5573,7 @@ module Aws::CloudFormation
5499
5573
  # @option params [String] :template_url
5500
5574
  # Location of file containing the template body. The URL must point to a
5501
5575
  # template that is located in an Amazon S3 bucket or a Systems Manager
5502
- # document. For more information, go to [Template Anatomy][1] in the AWS
5576
+ # document. For more information, go to [Template Anatomy][1] in the
5503
5577
  # CloudFormation User Guide.
5504
5578
  #
5505
5579
  # Conditional: You must specify only one of the following parameters:
@@ -5550,16 +5624,15 @@ module Aws::CloudFormation
5550
5624
  #
5551
5625
  # @option params [Array<String>] :capabilities
5552
5626
  # In some cases, you must explicitly acknowledge that your stack
5553
- # template contains certain capabilities in order for AWS CloudFormation
5554
- # to update the stack.
5627
+ # template contains certain capabilities in order for CloudFormation to
5628
+ # update the stack.
5555
5629
  #
5556
5630
  # * `CAPABILITY_IAM` and `CAPABILITY_NAMED_IAM`
5557
5631
  #
5558
5632
  # Some stack templates might include resources that can affect
5559
- # permissions in your AWS account; for example, by creating new AWS
5560
- # Identity and Access Management (IAM) users. For those stacks, you
5561
- # must explicitly acknowledge this by specifying one of these
5562
- # 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.
5563
5636
  #
5564
5637
  # The following IAM resources require you to specify either the
5565
5638
  # `CAPABILITY_IAM` or `CAPABILITY_NAMED_IAM` capability.
@@ -5569,8 +5642,8 @@ module Aws::CloudFormation
5569
5642
  # * If you have IAM resources with custom names, you *must* specify
5570
5643
  # `CAPABILITY_NAMED_IAM`.
5571
5644
  #
5572
- # * If you don't specify either of these capabilities, AWS
5573
- # CloudFormation returns an `InsufficientCapabilities` error.
5645
+ # * If you don't specify either of these capabilities, CloudFormation
5646
+ # returns an `InsufficientCapabilities` error.
5574
5647
  #
5575
5648
  # If your stack template contains these resources, we recommend that
5576
5649
  # you review all permissions associated with them and edit their
@@ -5590,7 +5663,7 @@ module Aws::CloudFormation
5590
5663
  #
5591
5664
  # * [ AWS::IAM::UserToGroupAddition][7]
5592
5665
  #
5593
- # For more information, see [Acknowledging IAM Resources in AWS
5666
+ # For more information, see [Acknowledging IAM Resources in
5594
5667
  # CloudFormation Templates][8].
5595
5668
  #
5596
5669
  # * `CAPABILITY_AUTO_EXPAND`
@@ -5605,7 +5678,7 @@ module Aws::CloudFormation
5605
5678
  # update a stack directly from the processed template, without first
5606
5679
  # reviewing the resulting changes in a change set, you must
5607
5680
  # acknowledge this capability. This includes the [AWS::Include][9] and
5608
- # [AWS::Serverless][10] transforms, which are macros hosted by AWS
5681
+ # [AWS::Serverless][10] transforms, which are macros hosted by
5609
5682
  # CloudFormation.
5610
5683
  #
5611
5684
  # If you want to update a stack from a stack template that contains
@@ -5617,11 +5690,11 @@ module Aws::CloudFormation
5617
5690
  #
5618
5691
  # Each macro relies on an underlying Lambda service function for
5619
5692
  # processing stack templates. Be aware that the Lambda function owner
5620
- # can update the function operation without AWS CloudFormation being
5693
+ # can update the function operation without CloudFormation being
5621
5694
  # notified.
5622
5695
  #
5623
- # For more information, see [Using AWS CloudFormation Macros to
5624
- # Perform Custom Processing on Templates][11].
5696
+ # For more information, see [Using CloudFormation Macros to Perform
5697
+ # Custom Processing on Templates][11].
5625
5698
  #
5626
5699
  #
5627
5700
  #
@@ -5643,33 +5716,32 @@ module Aws::CloudFormation
5643
5716
  # or `Custom::MyCustomInstance`.
5644
5717
  #
5645
5718
  # If the list of resource types doesn't include a resource that you're
5646
- # updating, the stack update fails. By default, AWS CloudFormation
5647
- # grants permissions to all resource types. AWS Identity and Access
5648
- # Management (IAM) uses this parameter for AWS CloudFormation-specific
5649
- # condition keys in IAM policies. For more information, see [Controlling
5650
- # 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].
5651
5724
  #
5652
5725
  #
5653
5726
  #
5654
5727
  # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html
5655
5728
  #
5656
5729
  # @option params [String] :role_arn
5657
- # The Amazon Resource Name (ARN) of an AWS Identity and Access
5658
- # Management (IAM) role that AWS CloudFormation assumes to update the
5659
- # stack. AWS CloudFormation uses the role's credentials to make calls
5660
- # on your behalf. AWS CloudFormation always uses this role for all
5661
- # future operations on the stack. As long as users have permission to
5662
- # operate on the stack, AWS CloudFormation uses this role even if the
5663
- # users don't have permission to pass it. Ensure that the role grants
5664
- # least privilege.
5665
- #
5666
- # If you don't specify a value, AWS CloudFormation uses the role that
5667
- # 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,
5668
5740
  # CloudFormation uses a temporary session that is generated from your
5669
5741
  # user credentials.
5670
5742
  #
5671
5743
  # @option params [Types::RollbackConfiguration] :rollback_configuration
5672
- # The rollback triggers for AWS CloudFormation to monitor during stack
5744
+ # The rollback triggers for CloudFormation to monitor during stack
5673
5745
  # creation and updating operations, and for the specified monitoring
5674
5746
  # period afterwards.
5675
5747
  #
@@ -5695,23 +5767,23 @@ module Aws::CloudFormation
5695
5767
  #
5696
5768
  # @option params [Array<String>] :notification_arns
5697
5769
  # Amazon Simple Notification Service topic Amazon Resource Names (ARNs)
5698
- # that AWS CloudFormation associates with the stack. Specify an empty
5699
- # list to remove all notification topics.
5770
+ # that CloudFormation associates with the stack. Specify an empty list
5771
+ # to remove all notification topics.
5700
5772
  #
5701
5773
  # @option params [Array<Types::Tag>] :tags
5702
- # Key-value pairs to associate with this stack. AWS CloudFormation also
5774
+ # Key-value pairs to associate with this stack. CloudFormation also
5703
5775
  # propagates these tags to supported resources in the stack. You can
5704
5776
  # specify a maximum number of 50 tags.
5705
5777
  #
5706
- # If you don't specify this parameter, AWS CloudFormation doesn't
5707
- # modify the stack's tags. If you specify an empty value, AWS
5708
- # 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.
5709
5781
  #
5710
5782
  # @option params [String] :client_request_token
5711
5783
  # A unique identifier for this `UpdateStack` request. Specify this token
5712
- # if you plan to retry requests so that AWS CloudFormation knows that
5784
+ # if you plan to retry requests so that CloudFormation knows that
5713
5785
  # you're not attempting to update a stack with the same name. You might
5714
- # retry `UpdateStack` requests to ensure that AWS CloudFormation
5786
+ # retry `UpdateStack` requests to ensure that CloudFormation
5715
5787
  # successfully received them.
5716
5788
  #
5717
5789
  # All events triggered by a given stack operation are assigned the same
@@ -5817,7 +5889,7 @@ module Aws::CloudFormation
5817
5889
  # instances.
5818
5890
  #
5819
5891
  # @option params [Array<String>] :accounts
5820
- # \[Self-managed permissions\] The names of one or more AWS accounts for
5892
+ # \[Self-managed permissions\] The names of one or more accounts for
5821
5893
  # which you want to update parameter values for stack instances. The
5822
5894
  # overridden parameter values will be applied to all stack instances in
5823
5895
  # the specified accounts and Regions.
@@ -5825,8 +5897,8 @@ module Aws::CloudFormation
5825
5897
  # You can specify `Accounts` or `DeploymentTargets`, but not both.
5826
5898
  #
5827
5899
  # @option params [Types::DeploymentTargets] :deployment_targets
5828
- # \[Service-managed permissions\] The AWS Organizations accounts for
5829
- # 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
5830
5902
  # update targets OUs, the overridden parameter values only apply to the
5831
5903
  # accounts that are currently in the target OUs and their child OUs.
5832
5904
  # Accounts added to the target OUs and their child OUs in the future
@@ -5845,24 +5917,19 @@ module Aws::CloudFormation
5845
5917
  #
5846
5918
  # Any overridden parameter values will be applied to all stack instances
5847
5919
  # in the specified accounts and Regions. When specifying parameters and
5848
- # their values, be aware of how AWS CloudFormation sets parameter values
5920
+ # their values, be aware of how CloudFormation sets parameter values
5849
5921
  # during stack instance update operations:
5850
5922
  #
5851
5923
  # * To override the current value for a parameter, include the parameter
5852
5924
  # and specify its value.
5853
5925
  #
5854
- # * To leave a parameter set to its present value, you can do one of the
5855
- # following:
5856
- #
5857
- # * Do not include the parameter in the list.
5858
- #
5859
- # * Include the parameter and specify `UsePreviousValue` as `true`.
5860
- # (You cannot specify both a value and set `UsePreviousValue` to
5861
- # `true`.)
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`.)
5862
5929
  #
5863
- # * To set all overridden parameter back to the values specified in the
5864
- # stack set, specify a parameter list but do not include any
5865
- # 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.
5866
5933
  #
5867
5934
  # * To leave all parameters set to their present values, do not specify
5868
5935
  # this property at all.
@@ -5885,17 +5952,16 @@ module Aws::CloudFormation
5885
5952
  # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_UpdateStackSet.html
5886
5953
  #
5887
5954
  # @option params [Types::StackSetOperationPreferences] :operation_preferences
5888
- # Preferences for how AWS CloudFormation performs this stack set
5889
- # operation.
5955
+ # Preferences for how CloudFormation performs this stack set operation.
5890
5956
  #
5891
5957
  # @option params [String] :operation_id
5892
5958
  # The unique identifier for this stack set operation.
5893
5959
  #
5894
5960
  # The operation ID also functions as an idempotency token, to ensure
5895
- # that AWS CloudFormation performs the stack set operation only once,
5896
- # even if you retry the request multiple times. You might retry stack
5897
- # set operation requests to ensure that AWS CloudFormation successfully
5898
- # 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.
5899
5965
  #
5900
5966
  # If you don't specify an operation ID, the SDK generates one
5901
5967
  # automatically.
@@ -5916,9 +5982,9 @@ module Aws::CloudFormation
5916
5982
  # * If you are signed in to a delegated administrator account, specify
5917
5983
  # `DELEGATED_ADMIN`.
5918
5984
  #
5919
- # Your AWS account must be registered as a delegated administrator in
5920
- # the management account. For more information, see [Register a
5921
- # 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*.
5922
5988
  #
5923
5989
  #
5924
5990
  #
@@ -5990,7 +6056,7 @@ module Aws::CloudFormation
5990
6056
  # @option params [String] :template_body
5991
6057
  # The structure that contains the template body, with a minimum length
5992
6058
  # of 1 byte and a maximum length of 51,200 bytes. For more information,
5993
- # see [Template Anatomy][1] in the AWS CloudFormation User Guide.
6059
+ # see [Template Anatomy][1] in the CloudFormation User Guide.
5994
6060
  #
5995
6061
  # Conditional: You must specify only one of the following parameters:
5996
6062
  # `TemplateBody` or `TemplateURL`—or set `UsePreviousTemplate` to true.
@@ -6003,7 +6069,7 @@ module Aws::CloudFormation
6003
6069
  # The location of the file that contains the template body. The URL must
6004
6070
  # point to a template (maximum size: 460,800 bytes) that is located in
6005
6071
  # an Amazon S3 bucket or a Systems Manager document. For more
6006
- # information, see [Template Anatomy][1] in the AWS CloudFormation User
6072
+ # information, see [Template Anatomy][1] in the CloudFormation User
6007
6073
  # Guide.
6008
6074
  #
6009
6075
  # Conditional: You must specify only one of the following parameters:
@@ -6025,16 +6091,15 @@ module Aws::CloudFormation
6025
6091
  #
6026
6092
  # @option params [Array<String>] :capabilities
6027
6093
  # In some cases, you must explicitly acknowledge that your stack
6028
- # template contains certain capabilities in order for AWS CloudFormation
6029
- # 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.
6030
6096
  #
6031
6097
  # * `CAPABILITY_IAM` and `CAPABILITY_NAMED_IAM`
6032
6098
  #
6033
6099
  # Some stack templates might include resources that can affect
6034
- # permissions in your AWS account; for example, by creating new AWS
6035
- # Identity and Access Management (IAM) users. For those stacks sets,
6036
- # you must explicitly acknowledge this by specifying one of these
6037
- # 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.
6038
6103
  #
6039
6104
  # The following IAM resources require you to specify either the
6040
6105
  # `CAPABILITY_IAM` or `CAPABILITY_NAMED_IAM` capability.
@@ -6044,8 +6109,8 @@ module Aws::CloudFormation
6044
6109
  # * If you have IAM resources with custom names, you *must* specify
6045
6110
  # `CAPABILITY_NAMED_IAM`.
6046
6111
  #
6047
- # * If you don't specify either of these capabilities, AWS
6048
- # CloudFormation returns an `InsufficientCapabilities` error.
6112
+ # * If you don't specify either of these capabilities, CloudFormation
6113
+ # returns an `InsufficientCapabilities` error.
6049
6114
  #
6050
6115
  # If your stack template contains these resources, we recommend that
6051
6116
  # you review all permissions associated with them and edit their
@@ -6065,7 +6130,7 @@ module Aws::CloudFormation
6065
6130
  #
6066
6131
  # * [ AWS::IAM::UserToGroupAddition][7]
6067
6132
  #
6068
- # For more information, see [Acknowledging IAM Resources in AWS
6133
+ # For more information, see [Acknowledging IAM Resources in
6069
6134
  # CloudFormation Templates][8].
6070
6135
  #
6071
6136
  # * `CAPABILITY_AUTO_EXPAND`
@@ -6075,13 +6140,13 @@ module Aws::CloudFormation
6075
6140
  # directly from the processed template, without first reviewing the
6076
6141
  # resulting changes in a change set. To update the stack set directly,
6077
6142
  # you must acknowledge this capability. For more information, see
6078
- # [Using AWS CloudFormation Macros to Perform Custom Processing on
6143
+ # [Using CloudFormation Macros to Perform Custom Processing on
6079
6144
  # Templates][9].
6080
6145
  #
6081
6146
  # Stack sets with service-managed permissions do not currently support
6082
6147
  # the use of macros in templates. (This includes the
6083
6148
  # [AWS::Include][10] and [AWS::Serverless][11] transforms, which are
6084
- # macros hosted by AWS CloudFormation.) Even if you specify this
6149
+ # macros hosted by CloudFormation.) Even if you specify this
6085
6150
  # capability for a stack set with service-managed permissions, if you
6086
6151
  # reference a macro in your template the stack set operation will
6087
6152
  # fail.
@@ -6102,15 +6167,15 @@ module Aws::CloudFormation
6102
6167
  #
6103
6168
  # @option params [Array<Types::Tag>] :tags
6104
6169
  # The key-value pairs to associate with this stack set and the stacks
6105
- # created from it. AWS CloudFormation also propagates these tags to
6170
+ # created from it. CloudFormation also propagates these tags to
6106
6171
  # supported resources that are created in the stacks. You can specify a
6107
6172
  # maximum number of 50 tags.
6108
6173
  #
6109
6174
  # If you specify tags for this parameter, those tags replace any list of
6110
6175
  # tags that are currently associated with this stack set. This means:
6111
6176
  #
6112
- # * If you don't specify this parameter, AWS CloudFormation doesn't
6113
- # modify the stack's tags.
6177
+ # * If you don't specify this parameter, CloudFormation doesn't modify
6178
+ # the stack's tags.
6114
6179
  #
6115
6180
  # * If you specify *any* tags using this parameter, you must specify
6116
6181
  # *all* the tags that you want associated with this stack set, even
@@ -6119,21 +6184,20 @@ module Aws::CloudFormation
6119
6184
  # you don't include in the updated list of tags are removed from the
6120
6185
  # stack set, and therefore from the stacks and resources as well.
6121
6186
  #
6122
- # * If you specify an empty value, AWS CloudFormation removes all
6123
- # currently associated tags.
6187
+ # * If you specify an empty value, CloudFormation removes all currently
6188
+ # associated tags.
6124
6189
  #
6125
- # If you specify new tags as part of an `UpdateStackSet` action, AWS
6190
+ # If you specify new tags as part of an `UpdateStackSet` action,
6126
6191
  # CloudFormation checks to see if you have the required IAM permission
6127
6192
  # to tag resources. If you omit tags that are currently associated with
6128
- # the stack set from the list of tags you specify, AWS CloudFormation
6193
+ # the stack set from the list of tags you specify, CloudFormation
6129
6194
  # assumes that you want to remove those tags from the stack set, and
6130
6195
  # checks to see if you have permission to untag resources. If you don't
6131
6196
  # have the necessary permission(s), the entire `UpdateStackSet` action
6132
6197
  # fails with an `access denied` error, and the stack set is not updated.
6133
6198
  #
6134
6199
  # @option params [Types::StackSetOperationPreferences] :operation_preferences
6135
- # Preferences for how AWS CloudFormation performs this stack set
6136
- # operation.
6200
+ # Preferences for how CloudFormation performs this stack set operation.
6137
6201
  #
6138
6202
  # @option params [String] :administration_role_arn
6139
6203
  # The Amazon Resource Number (ARN) of the IAM role to use to update this
@@ -6142,8 +6206,8 @@ module Aws::CloudFormation
6142
6206
  # Specify an IAM role only if you are using customized administrator
6143
6207
  # roles to control which users or groups can manage specific stack sets
6144
6208
  # within the same administrator account. For more information, see
6145
- # [Granting Permissions for Stack Set Operations][1] in the *AWS
6146
- # CloudFormation User Guide*.
6209
+ # [Granting Permissions for Stack Set Operations][1] in the
6210
+ # *CloudFormation User Guide*.
6147
6211
  #
6148
6212
  # If you specified a customized administrator role when you created the
6149
6213
  # stack set, you must specify a customized administrator role, even if
@@ -6156,7 +6220,7 @@ module Aws::CloudFormation
6156
6220
  #
6157
6221
  # @option params [String] :execution_role_name
6158
6222
  # The name of the IAM execution role to use to update the stack set. If
6159
- # you do not specify an execution role, AWS CloudFormation uses the
6223
+ # you do not specify an execution role, CloudFormation uses the
6160
6224
  # `AWSCloudFormationStackSetExecutionRole` role for the stack set
6161
6225
  # operation.
6162
6226
  #
@@ -6164,27 +6228,27 @@ module Aws::CloudFormation
6164
6228
  # to control which stack resources users and groups can include in their
6165
6229
  # stack sets.
6166
6230
  #
6167
- # If you specify a customized execution role, AWS CloudFormation uses
6168
- # that role to update the stack. If you do not specify a customized
6169
- # execution role, AWS CloudFormation performs the update using the role
6170
- # previously associated with the stack set, so long as you have
6171
- # 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.
6172
6236
  #
6173
6237
  # @option params [Types::DeploymentTargets] :deployment_targets
6174
- # \[Service-managed permissions\] The AWS Organizations accounts in
6175
- # which to update associated stack instances.
6238
+ # \[Service-managed permissions\] The Organizations accounts in which to
6239
+ # update associated stack instances.
6176
6240
  #
6177
6241
  # To update all the stack instances associated with this stack set, do
6178
6242
  # not specify `DeploymentTargets` or `Regions`.
6179
6243
  #
6180
6244
  # If the stack set update includes changes to the template (that is, if
6181
6245
  # `TemplateBody` or `TemplateURL` is specified), or the `Parameters`,
6182
- # AWS CloudFormation marks all stack instances with a status of
6183
- # `OUTDATED` prior to updating the stack instances in the specified
6184
- # accounts and Regions. If the stack set update does not include changes
6185
- # to the template or parameters, AWS CloudFormation updates the stack
6186
- # instances in the specified accounts and Regions, while leaving all
6187
- # 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.
6188
6252
  #
6189
6253
  # @option params [String] :permission_model
6190
6254
  # Describes how the IAM roles required for stack set operations are
@@ -6196,7 +6260,7 @@ module Aws::CloudFormation
6196
6260
  # information, see [Grant Self-Managed Stack Set Permissions][1].
6197
6261
  #
6198
6262
  # * With `service-managed` permissions, StackSets automatically creates
6199
- # the IAM roles required to deploy to accounts managed by AWS
6263
+ # the IAM roles required to deploy to accounts managed by
6200
6264
  # Organizations. For more information, see [Grant Service-Managed
6201
6265
  # Stack Set Permissions][2].
6202
6266
  #
@@ -6207,8 +6271,8 @@ module Aws::CloudFormation
6207
6271
  #
6208
6272
  # @option params [Types::AutoDeployment] :auto_deployment
6209
6273
  # \[Service-managed permissions\] Describes whether StackSets
6210
- # automatically deploys to AWS Organizations accounts that are added to
6211
- # 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).
6212
6276
  #
6213
6277
  # If you specify `AutoDeployment`, do not specify `DeploymentTargets` or
6214
6278
  # `Regions`.
@@ -6217,13 +6281,13 @@ module Aws::CloudFormation
6217
6281
  # The unique ID for this stack set operation.
6218
6282
  #
6219
6283
  # The operation ID also functions as an idempotency token, to ensure
6220
- # that AWS CloudFormation performs the stack set operation only once,
6221
- # even if you retry the request multiple times. You might retry stack
6222
- # set operation requests to ensure that AWS CloudFormation successfully
6223
- # 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.
6224
6288
  #
6225
- # If you don't specify an operation ID, AWS CloudFormation generates
6226
- # one automatically.
6289
+ # If you don't specify an operation ID, CloudFormation generates one
6290
+ # automatically.
6227
6291
  #
6228
6292
  # Repeating this stack set operation with a new operation ID retries all
6229
6293
  # stack instances whose status is `OUTDATED`.
@@ -6241,13 +6305,13 @@ module Aws::CloudFormation
6241
6305
  #
6242
6306
  # If the stack set update includes changes to the template (that is, if
6243
6307
  # the `TemplateBody` or `TemplateURL` properties are specified), or the
6244
- # `Parameters` property, AWS CloudFormation marks all stack instances
6245
- # with a status of `OUTDATED` prior to updating the stack instances in
6246
- # the specified accounts and Regions. If the stack set update does not
6247
- # include changes to the template or parameters, AWS CloudFormation
6248
- # updates the stack instances in the specified accounts and Regions,
6249
- # while leaving all other stack instances with their existing stack
6250
- # 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.
6251
6315
  #
6252
6316
  # @option params [Array<String>] :regions
6253
6317
  # The Regions in which to update associated stack instances. If you
@@ -6259,13 +6323,13 @@ module Aws::CloudFormation
6259
6323
  #
6260
6324
  # If the stack set update includes changes to the template (that is, if
6261
6325
  # the `TemplateBody` or `TemplateURL` properties are specified), or the
6262
- # `Parameters` property, AWS CloudFormation marks all stack instances
6263
- # with a status of `OUTDATED` prior to updating the stack instances in
6264
- # the specified accounts and Regions. If the stack set update does not
6265
- # include changes to the template or parameters, AWS CloudFormation
6266
- # updates the stack instances in the specified accounts and Regions,
6267
- # while leaving all other stack instances with their existing stack
6268
- # 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.
6269
6333
  #
6270
6334
  # @option params [String] :call_as
6271
6335
  # \[Service-managed permissions\] Specifies whether you are acting as an
@@ -6280,9 +6344,9 @@ module Aws::CloudFormation
6280
6344
  # * If you are signed in to a delegated administrator account, specify
6281
6345
  # `DELEGATED_ADMIN`.
6282
6346
  #
6283
- # Your AWS account must be registered as a delegated administrator in
6284
- # the management account. For more information, see [Register a
6285
- # 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*.
6286
6350
  #
6287
6351
  #
6288
6352
  #
@@ -6357,8 +6421,8 @@ module Aws::CloudFormation
6357
6421
  # Updates termination protection for the specified stack. If a user
6358
6422
  # attempts to delete a stack with termination protection enabled, the
6359
6423
  # operation fails and the stack remains unchanged. For more information,
6360
- # see [Protecting a Stack From Being Deleted][1] in the *AWS
6361
- # CloudFormation User Guide*.
6424
+ # see [Protecting a Stack From Being Deleted][1] in the *CloudFormation
6425
+ # User Guide*.
6362
6426
  #
6363
6427
  # For [nested stacks][2], termination protection is set on the root
6364
6428
  # stack and cannot be changed directly on the nested stack.
@@ -6399,15 +6463,15 @@ module Aws::CloudFormation
6399
6463
  req.send_request(options)
6400
6464
  end
6401
6465
 
6402
- # Validates a specified template. AWS CloudFormation first checks if the
6403
- # template is valid JSON. If it isn't, AWS CloudFormation checks if the
6404
- # 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
6405
6469
  # returns a template validation error.
6406
6470
  #
6407
6471
  # @option params [String] :template_body
6408
6472
  # Structure containing the template body with a minimum length of 1 byte
6409
6473
  # and a maximum length of 51,200 bytes. For more information, go to
6410
- # [Template Anatomy][1] in the AWS CloudFormation User Guide.
6474
+ # [Template Anatomy][1] in the CloudFormation User Guide.
6411
6475
  #
6412
6476
  # Conditional: You must pass `TemplateURL` or `TemplateBody`. If both
6413
6477
  # are passed, only `TemplateBody` is used.
@@ -6420,7 +6484,7 @@ module Aws::CloudFormation
6420
6484
  # Location of file containing the template body. The URL must point to a
6421
6485
  # template (max size: 460,800 bytes) that is located in an Amazon S3
6422
6486
  # bucket or a Systems Manager document. For more information, go to
6423
- # [Template Anatomy][1] in the AWS CloudFormation User Guide.
6487
+ # [Template Anatomy][1] in the CloudFormation User Guide.
6424
6488
  #
6425
6489
  # Conditional: You must pass `TemplateURL` or `TemplateBody`. If both
6426
6490
  # are passed, only `TemplateBody` is used.
@@ -6480,7 +6544,7 @@ module Aws::CloudFormation
6480
6544
  params: params,
6481
6545
  config: config)
6482
6546
  context[:gem_name] = 'aws-sdk-cloudformation'
6483
- context[:gem_version] = '1.53.0'
6547
+ context[:gem_version] = '1.54.0'
6484
6548
  Seahorse::Client::Request.new(handlers, context)
6485
6549
  end
6486
6550