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 +4 -4
- data/CHANGELOG.md +5 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-cloudformation.rb +1 -1
- data/lib/aws-sdk-cloudformation/client.rb +534 -470
- data/lib/aws-sdk-cloudformation/client_api.rb +34 -0
- data/lib/aws-sdk-cloudformation/errors.rb +11 -0
- data/lib/aws-sdk-cloudformation/event.rb +2 -2
- data/lib/aws-sdk-cloudformation/resource.rb +41 -42
- data/lib/aws-sdk-cloudformation/stack.rb +102 -105
- data/lib/aws-sdk-cloudformation/stack_resource.rb +5 -5
- data/lib/aws-sdk-cloudformation/stack_resource_summary.rb +2 -2
- data/lib/aws-sdk-cloudformation/types.rb +722 -668
- metadata +4 -4
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 642a8c36978ebf152ba0b7df35f3c1e627e0101432269f02eee095dcc3f18f3e
|
4
|
+
data.tar.gz: 4573401978788bdecf9a7d29a0e4117bc194e86017bbc24ff29d3bb9ad7103a3
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
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.
|
1
|
+
1.54.0
|
@@ -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
|
531
|
-
#
|
532
|
-
#
|
533
|
-
#
|
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
|
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
|
565
|
-
# Because
|
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
|
586
|
-
#
|
587
|
-
#
|
588
|
-
#
|
589
|
-
#
|
590
|
-
#
|
591
|
-
#
|
592
|
-
#
|
593
|
-
#
|
594
|
-
#
|
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
|
601
|
-
#
|
602
|
-
#
|
603
|
-
#
|
604
|
-
#
|
605
|
-
#
|
606
|
-
#
|
607
|
-
#
|
608
|
-
# Specify this property to skip rolling back resources that
|
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.
|
611
|
-
#
|
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
|
646
|
-
#
|
647
|
-
#
|
648
|
-
#
|
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
|
675
|
-
# create a change set for an existing stack,
|
676
|
-
#
|
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
|
679
|
-
#
|
680
|
-
#
|
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,
|
688
|
-
#
|
689
|
-
#
|
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.
|
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.
|
701
|
-
#
|
702
|
-
#
|
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.
|
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.
|
716
|
-
#
|
717
|
-
#
|
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
|
732
|
-
#
|
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
|
738
|
-
#
|
739
|
-
#
|
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,
|
751
|
-
#
|
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
|
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
|
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
|
800
|
-
#
|
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,
|
823
|
-
#
|
824
|
-
#
|
825
|
-
#
|
826
|
-
#
|
827
|
-
#
|
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
|
835
|
-
#
|
836
|
-
#
|
837
|
-
#
|
838
|
-
#
|
839
|
-
#
|
840
|
-
#
|
841
|
-
#
|
842
|
-
#
|
843
|
-
#
|
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
|
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
|
856
|
-
#
|
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.
|
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
|
874
|
-
#
|
875
|
-
# name. You might retry `CreateChangeSet` requests to ensure that
|
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,
|
888
|
-
#
|
889
|
-
#
|
890
|
-
#
|
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,
|
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
|
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
|
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
|
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
|
1049
|
-
#
|
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
|
1055
|
-
#
|
1056
|
-
#
|
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,
|
1068
|
-
#
|
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
|
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
|
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
|
1111
|
+
# can update the function operation without CloudFormation being
|
1116
1112
|
# notified.
|
1117
1113
|
#
|
1118
|
-
# For more information, see [Using
|
1119
|
-
#
|
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
|
1140
|
-
#
|
1141
|
-
#
|
1142
|
-
#
|
1143
|
-
#
|
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,
|
1147
|
-
#
|
1148
|
-
#
|
1149
|
-
#
|
1150
|
-
#
|
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
|
1158
|
-
#
|
1159
|
-
#
|
1160
|
-
#
|
1161
|
-
#
|
1162
|
-
#
|
1163
|
-
#
|
1164
|
-
#
|
1165
|
-
#
|
1166
|
-
#
|
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 *
|
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.
|
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
|
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
|
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
|
-
# *
|
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
|
1307
|
-
#
|
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
|
1314
|
-
#
|
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
|
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
|
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
|
1335
|
-
#
|
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
|
1344
|
-
# stack set, specify a parameter list but do not include
|
1345
|
-
#
|
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
|
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
|
1370
|
-
#
|
1371
|
-
#
|
1372
|
-
#
|
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
|
1397
|
-
#
|
1398
|
-
#
|
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
|
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
|
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
|
1500
|
-
#
|
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
|
1506
|
-
#
|
1507
|
-
#
|
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,
|
1519
|
-
#
|
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
|
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
|
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
|
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.
|
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,
|
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 *
|
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,
|
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
|
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
|
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
|
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 *
|
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
|
1661
|
-
#
|
1662
|
-
#
|
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,
|
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,
|
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
|
1822
|
-
#
|
1823
|
-
#
|
1824
|
-
#
|
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,
|
1827
|
-
#
|
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
|
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
|
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
|
1881
|
-
#
|
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
|
1887
|
-
#
|
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
|
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
|
1917
|
-
#
|
1918
|
-
# operation requests to ensure that
|
1919
|
-
#
|
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
|
1941
|
-
#
|
1942
|
-
#
|
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
|
2011
|
-
#
|
2012
|
-
#
|
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
|
2100
|
-
#
|
2101
|
-
# information about account limits, see [
|
2102
|
-
#
|
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
|
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
|
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
|
-
#
|
2335
|
-
#
|
2336
|
-
#
|
2337
|
-
#
|
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
|
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,
|
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
|
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
|
2471
|
-
#
|
2472
|
-
#
|
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
|
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`\:
|
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
|
2675
|
-
# `StackName` is specified, all the associated
|
2676
|
-
# of the stack are returned. If
|
2677
|
-
#
|
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
|
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
|
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
|
2793
|
-
#
|
2794
|
-
#
|
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
|
2877
|
-
#
|
2878
|
-
#
|
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,
|
3215
|
-
#
|
3216
|
-
#
|
3217
|
-
#
|
3218
|
-
#
|
3219
|
-
#
|
3220
|
-
#
|
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,
|
3238
|
-
#
|
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
|
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
|
3395
|
-
#
|
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
|
3424
|
-
#
|
3425
|
-
#
|
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
|
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
|
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
|
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,
|
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,
|
3534
|
-
#
|
3535
|
-
#
|
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,
|
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
|
3555
|
-
#
|
3556
|
-
#
|
3557
|
-
#
|
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
|
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
|
-
#
|
3637
|
-
#
|
3638
|
-
#
|
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,
|
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
|
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
|
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
|
3742
|
-
#
|
3743
|
-
#
|
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,
|
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 [
|
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.
|
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
|
3959
|
-
#
|
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
|
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
|
4002
|
-
#
|
4003
|
-
#
|
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
|
4154
|
-
#
|
4155
|
-
#
|
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
|
4234
|
-
#
|
4235
|
-
#
|
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
|
4281
|
-
#
|
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
|
4324
|
-
#
|
4325
|
-
#
|
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
|
-
#
|
4616
|
-
#
|
4617
|
-
#
|
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
|
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
|
4889
|
-
# in the CloudFormation registry. You must accept the terms
|
4890
|
-
# conditions in order to register to publish public extensions to
|
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
|
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
|
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 *
|
5105
|
+
# in the *Identity and Access Management User Guide*.
|
5033
5106
|
#
|
5034
|
-
# If your extension calls
|
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
|
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
|
5091
|
-
#
|
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 *
|
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.
|
5265
|
-
#
|
5266
|
-
#
|
5267
|
-
#
|
5268
|
-
#
|
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
|
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
|
5334
|
-
#
|
5335
|
-
#
|
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
|
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 *
|
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
|
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
|
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
|
5554
|
-
#
|
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
|
5560
|
-
#
|
5561
|
-
#
|
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,
|
5573
|
-
#
|
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
|
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
|
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
|
5693
|
+
# can update the function operation without CloudFormation being
|
5621
5694
|
# notified.
|
5622
5695
|
#
|
5623
|
-
# For more information, see [Using
|
5624
|
-
#
|
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,
|
5647
|
-
#
|
5648
|
-
#
|
5649
|
-
#
|
5650
|
-
#
|
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
|
5658
|
-
#
|
5659
|
-
#
|
5660
|
-
#
|
5661
|
-
#
|
5662
|
-
#
|
5663
|
-
#
|
5664
|
-
#
|
5665
|
-
#
|
5666
|
-
#
|
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
|
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
|
5699
|
-
#
|
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.
|
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,
|
5707
|
-
#
|
5708
|
-
#
|
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
|
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
|
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
|
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
|
5829
|
-
#
|
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
|
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
|
5855
|
-
#
|
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
|
5864
|
-
# stack set, specify a parameter list but do not include
|
5865
|
-
#
|
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
|
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
|
5896
|
-
#
|
5897
|
-
#
|
5898
|
-
#
|
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
|
5920
|
-
#
|
5921
|
-
#
|
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
|
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
|
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
|
6029
|
-
#
|
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
|
6035
|
-
#
|
6036
|
-
#
|
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,
|
6048
|
-
#
|
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
|
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
|
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
|
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.
|
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,
|
6113
|
-
#
|
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,
|
6123
|
-
#
|
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,
|
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,
|
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
|
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
|
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,
|
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,
|
6168
|
-
#
|
6169
|
-
#
|
6170
|
-
#
|
6171
|
-
#
|
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
|
6175
|
-
#
|
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
|
-
#
|
6183
|
-
#
|
6184
|
-
#
|
6185
|
-
#
|
6186
|
-
#
|
6187
|
-
#
|
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
|
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
|
6211
|
-
#
|
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
|
6221
|
-
#
|
6222
|
-
#
|
6223
|
-
#
|
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,
|
6226
|
-
#
|
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,
|
6245
|
-
#
|
6246
|
-
#
|
6247
|
-
# include changes to the template or parameters,
|
6248
|
-
#
|
6249
|
-
#
|
6250
|
-
#
|
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,
|
6263
|
-
#
|
6264
|
-
#
|
6265
|
-
# include changes to the template or parameters,
|
6266
|
-
#
|
6267
|
-
#
|
6268
|
-
#
|
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
|
6284
|
-
#
|
6285
|
-
#
|
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 *
|
6361
|
-
#
|
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.
|
6403
|
-
# template is valid JSON. If it isn't,
|
6404
|
-
# template is valid YAML. If both these checks fail,
|
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
|
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
|
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.
|
6547
|
+
context[:gem_version] = '1.54.0'
|
6484
6548
|
Seahorse::Client::Request.new(handlers, context)
|
6485
6549
|
end
|
6486
6550
|
|