File Coverage

blib/lib/Paws/CloudFormation/CreateStackSet.pm
Criterion Covered Total %
statement 6 6 100.0
branch n/a
condition n/a
subroutine 2 2 100.0
pod n/a
total 8 8 100.0


line stmt bran cond sub pod time code
1              
2             package Paws::CloudFormation::CreateStackSet;
3 1     1   326 use Moose;
  1         2  
  1         6  
4             has Capabilities => (is => 'ro', isa => 'ArrayRef[Str|Undef]');
5             has ClientRequestToken => (is => 'ro', isa => 'Str');
6             has Description => (is => 'ro', isa => 'Str');
7             has Parameters => (is => 'ro', isa => 'ArrayRef[Paws::CloudFormation::Parameter]');
8             has StackSetName => (is => 'ro', isa => 'Str', required => 1);
9             has Tags => (is => 'ro', isa => 'ArrayRef[Paws::CloudFormation::Tag]');
10             has TemplateBody => (is => 'ro', isa => 'Str');
11             has TemplateURL => (is => 'ro', isa => 'Str');
12              
13 1     1   5498 use MooseX::ClassAttribute;
  1         3  
  1         6  
14              
15             class_has _api_call => (isa => 'Str', is => 'ro', default => 'CreateStackSet');
16             class_has _returns => (isa => 'Str', is => 'ro', default => 'Paws::CloudFormation::CreateStackSetOutput');
17             class_has _result_key => (isa => 'Str', is => 'ro', default => 'CreateStackSetResult');
18             1;
19              
20             ### main pod documentation begin ###
21              
22             =head1 NAME
23              
24             Paws::CloudFormation::CreateStackSet - Arguments for method CreateStackSet on Paws::CloudFormation
25              
26             =head1 DESCRIPTION
27              
28             This class represents the parameters used for calling the method CreateStackSet on the
29             AWS CloudFormation service. Use the attributes of this class
30             as arguments to method CreateStackSet.
31              
32             You shouldn't make instances of this class. Each attribute should be used as a named argument in the call to CreateStackSet.
33              
34             As an example:
35              
36             $service_obj->CreateStackSet(Att1 => $value1, Att2 => $value2, ...);
37              
38             Values for attributes that are native types (Int, String, Float, etc) can passed as-is (scalar values). Values for complex Types (objects) can be passed as a HashRef. The keys and values of the hashref will be used to instance the underlying object.
39              
40             =head1 ATTRIBUTES
41              
42              
43             =head2 Capabilities => ArrayRef[Str|Undef]
44              
45             A list of values that you must specify before AWS CloudFormation can
46             create certain stack sets. Some stack set templates might include
47             resources that can affect permissions in your AWS accountE<mdash>for
48             example, by creating new AWS Identity and Access Management (IAM)
49             users. For those stack sets, you must explicitly acknowledge their
50             capabilities by specifying this parameter.
51              
52             The only valid values are CAPABILITY_IAM and CAPABILITY_NAMED_IAM. The
53             following resources require you to specify this parameter:
54              
55             =over
56              
57             =item *
58              
59             AWS::IAM::AccessKey
60              
61             =item *
62              
63             AWS::IAM::Group
64              
65             =item *
66              
67             AWS::IAM::InstanceProfile
68              
69             =item *
70              
71             AWS::IAM::Policy
72              
73             =item *
74              
75             AWS::IAM::Role
76              
77             =item *
78              
79             AWS::IAM::User
80              
81             =item *
82              
83             AWS::IAM::UserToGroupAddition
84              
85             =back
86              
87             If your stack template contains these resources, we recommend that you
88             review all permissions that are associated with them and edit their
89             permissions if necessary.
90              
91             If you have IAM resources, you can specify either capability. If you
92             have IAM resources with custom names, you must specify
93             CAPABILITY_NAMED_IAM. If you don't specify this parameter, this action
94             returns an C<InsufficientCapabilities> error.
95              
96             For more information, see Acknowledging IAM Resources in AWS
97             CloudFormation Templates.
98              
99              
100              
101             =head2 ClientRequestToken => Str
102              
103             A unique identifier for this C<CreateStackSet> request. Specify this
104             token if you plan to retry requests so that AWS CloudFormation knows
105             that you're not attempting to create another stack set with the same
106             name. You might retry C<CreateStackSet> requests to ensure that AWS
107             CloudFormation successfully received them.
108              
109             If you don't specify an operation ID, the SDK generates one
110             automatically.
111              
112              
113              
114             =head2 Description => Str
115              
116             A description of the stack set. You can use the description to identify
117             the stack set's purpose or other important information.
118              
119              
120              
121             =head2 Parameters => ArrayRef[L<Paws::CloudFormation::Parameter>]
122              
123             The input parameters for the stack set template.
124              
125              
126              
127             =head2 B<REQUIRED> StackSetName => Str
128              
129             The name to associate with the stack set. The name must be unique in
130             the region where you create your stack set.
131              
132             A stack name can contain only alphanumeric characters (case-sensitive)
133             and hyphens. It must start with an alphabetic character and can't be
134             longer than 128 characters.
135              
136              
137              
138             =head2 Tags => ArrayRef[L<Paws::CloudFormation::Tag>]
139              
140             The key-value pairs to associate with this stack set and the stacks
141             created from it. AWS CloudFormation also propagates these tags to
142             supported resources that are created in the stacks. A maximum number of
143             50 tags can be specified.
144              
145             If you specify tags as part of a C<CreateStackSet> action, AWS
146             CloudFormation checks to see if you have the required IAM permission to
147             tag resources. If you don't, the entire C<CreateStackSet> action fails
148             with an C<access denied> error, and the stack set is not created.
149              
150              
151              
152             =head2 TemplateBody => Str
153              
154             The structure that contains the template body, with a minimum length of
155             1 byte and a maximum length of 51,200 bytes. For more information, see
156             Template Anatomy in the AWS CloudFormation User Guide.
157              
158             Conditional: You must specify either the TemplateBody or the
159             TemplateURL parameter, but not both.
160              
161              
162              
163             =head2 TemplateURL => Str
164              
165             The location of the file that contains the template body. The URL must
166             point to a template (maximum size: 460,800 bytes) that's located in an
167             Amazon S3 bucket. For more information, see Template Anatomy in the AWS
168             CloudFormation User Guide.
169              
170             Conditional: You must specify either the TemplateBody or the
171             TemplateURL parameter, but not both.
172              
173              
174              
175              
176             =head1 SEE ALSO
177              
178             This class forms part of L<Paws>, documenting arguments for method CreateStackSet in L<Paws::CloudFormation>
179              
180             =head1 BUGS and CONTRIBUTIONS
181              
182             The source code is located here: https://github.com/pplu/aws-sdk-perl
183              
184             Please report bugs to: https://github.com/pplu/aws-sdk-perl/issues
185              
186             =cut
187