1 2package Paws::CloudFormation::CreateStack { 3 use Moose; 4 has Capabilities => (is => 'ro', isa => 'ArrayRef[Str]'); 5 has DisableRollback => (is => 'ro', isa => 'Bool'); 6 has NotificationARNs => (is => 'ro', isa => 'ArrayRef[Str]'); 7 has OnFailure => (is => 'ro', isa => 'Str'); 8 has Parameters => (is => 'ro', isa => 'ArrayRef[Paws::CloudFormation::Parameter]'); 9 has StackName => (is => 'ro', isa => 'Str', required => 1); 10 has StackPolicyBody => (is => 'ro', isa => 'Str'); 11 has StackPolicyURL => (is => 'ro', isa => 'Str'); 12 has Tags => (is => 'ro', isa => 'ArrayRef[Paws::CloudFormation::Tag]'); 13 has TemplateBody => (is => 'ro', isa => 'Str'); 14 has TemplateURL => (is => 'ro', isa => 'Str'); 15 has TimeoutInMinutes => (is => 'ro', isa => 'Int'); 16 17 use MooseX::ClassAttribute; 18 19 class_has _api_call => (isa => 'Str', is => 'ro', default => 'CreateStack'); 20 class_has _returns => (isa => 'Str', is => 'ro', default => 'Paws::CloudFormation::CreateStackOutput'); 21 class_has _result_key => (isa => 'Str', is => 'ro', default => 'CreateStackResult'); 22} 231; 24 25### main pod documentation begin ### 26 27=head1 NAME 28 29Paws::CloudFormation::CreateStack - Arguments for method CreateStack on Paws::CloudFormation 30 31=head1 DESCRIPTION 32 33This class represents the parameters used for calling the method CreateStack on the 34AWS CloudFormation service. Use the attributes of this class 35as arguments to method CreateStack. 36 37You shouln't make instances of this class. Each attribute should be used as a named argument in the call to CreateStack. 38 39As an example: 40 41 $service_obj->CreateStack(Att1 => $value1, Att2 => $value2, ...); 42 43Values 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. 44 45=head1 ATTRIBUTES 46 47=head2 Capabilities => ArrayRef[Str] 48 49 50 51A list of capabilities that you must specify before AWS CloudFormation 52can create or update certain stacks. Some stack templates might include 53resources that can affect permissions in your AWS account. For those 54stacks, you must explicitly acknowledge their capabilities by 55specifying this parameter. 56 57Currently, the only valid value is C<CAPABILITY_IAM>, which is required 58for the following resources: AWS::IAM::AccessKey, AWS::IAM::Group, 59AWS::IAM::InstanceProfile, AWS::IAM::Policy, AWS::IAM::Role, 60AWS::IAM::User, and AWS::IAM::UserToGroupAddition. If your stack 61template contains these resources, we recommend that you review any 62permissions associated with them. If you don't specify this parameter, 63this action returns an C<InsufficientCapabilities> error. 64 65 66 67 68 69 70 71 72 73 74=head2 DisableRollback => Bool 75 76 77 78Set to C<true> to disable rollback of the stack if stack creation 79failed. You can specify either C<DisableRollback> or C<OnFailure>, but 80not both. 81 82Default: C<false> 83 84 85 86 87 88 89 90 91 92 93=head2 NotificationARNs => ArrayRef[Str] 94 95 96 97The Simple Notification Service (SNS) topic ARNs to publish stack 98related events. You can find your SNS topic ARNs using the SNS console 99or your Command Line Interface (CLI). 100 101 102 103 104 105 106 107 108 109 110=head2 OnFailure => Str 111 112 113 114Determines what action will be taken if stack creation fails. This must 115be one of: DO_NOTHING, ROLLBACK, or DELETE. You can specify either 116C<OnFailure> or C<DisableRollback>, but not both. 117 118Default: C<ROLLBACK> 119 120 121 122 123 124 125 126 127 128 129=head2 Parameters => ArrayRef[Paws::CloudFormation::Parameter] 130 131 132 133A list of C<Parameter> structures that specify input parameters for the 134stack. 135 136 137 138 139 140 141 142 143 144 145=head2 B<REQUIRED> StackName => Str 146 147 148 149The name that is associated with the stack. The name must be unique in 150the region in which you are creating the stack. 151 152A stack name can contain only alphanumeric characters (case sensitive) 153and hyphens. It must start with an alphabetic character and cannot be 154longer than 255 characters. 155 156 157 158 159 160 161 162 163 164 165=head2 StackPolicyBody => Str 166 167 168 169Structure containing the stack policy body. For more information, go to 170Prevent Updates to Stack Resources in the AWS CloudFormation User 171Guide. You can specify either the C<StackPolicyBody> or the 172C<StackPolicyURL> parameter, but not both. 173 174 175 176 177 178 179 180 181 182 183=head2 StackPolicyURL => Str 184 185 186 187Location of a file containing the stack policy. The URL must point to a 188policy (max size: 16KB) located in an S3 bucket in the same region as 189the stack. You can specify either the C<StackPolicyBody> or the 190C<StackPolicyURL> parameter, but not both. 191 192 193 194 195 196 197 198 199 200 201=head2 Tags => ArrayRef[Paws::CloudFormation::Tag] 202 203 204 205A set of user-defined C<Tags> to associate with this stack, represented 206by key/value pairs. Tags defined for the stack are propagated to EC2 207resources that are created as part of the stack. A maximum number of 10 208tags can be specified. 209 210 211 212 213 214 215 216 217 218 219=head2 TemplateBody => Str 220 221 222 223Structure containing the template body with a minimum length of 1 byte 224and a maximum length of 51,200 bytes. For more information, go to 225Template Anatomy in the AWS CloudFormation User Guide. 226 227Conditional: You must specify either the C<TemplateBody> or the 228C<TemplateURL> parameter, but not both. 229 230 231 232 233 234 235 236 237 238 239=head2 TemplateURL => Str 240 241 242 243Location of file containing the template body. The URL must point to a 244template (max size: 460,800 bytes) located in an S3 bucket in the same 245region as the stack. For more information, go to the Template Anatomy 246in the AWS CloudFormation User Guide. 247 248Conditional: You must specify either the C<TemplateBody> or the 249C<TemplateURL> parameter, but not both. 250 251 252 253 254 255 256 257 258 259 260=head2 TimeoutInMinutes => Int 261 262 263 264The amount of time that can pass before the stack status becomes 265CREATE_FAILED; if C<DisableRollback> is not set or is set to C<false>, 266the stack will be rolled back. 267 268 269 270 271 272 273 274 275 276 277 278 279=head1 SEE ALSO 280 281This class forms part of L<Paws>, documenting arguments for method CreateStack in L<Paws::CloudFormation> 282 283=head1 BUGS and CONTRIBUTIONS 284 285The source code is located here: https://github.com/pplu/aws-sdk-perl 286 287Please report bugs to: https://github.com/pplu/aws-sdk-perl/issues 288 289=cut 290 291