Container for the parameters to the CreateStack operation.

Creates a stack as specified in the template. After the call completes successfully, the stack creation starts. You can check the status of the stack via the DescribeStacks API.

NOTE: Currently, the limit for stacks is 20 stacks per account per region.

Namespace: Amazon.CloudFormation.Model
Assembly: AWSSDK (in AWSSDK.dll) Version: 1.4.10.0 (1.4.10.0)

Syntax

         
 C#  Visual Basic  Visual C++ 
public class CreateStackRequest : AmazonWebServiceRequest
Public Class CreateStackRequest _
	Inherits AmazonWebServiceRequest
public ref class CreateStackRequest : public AmazonWebServiceRequest

Members

            
 All Members  Constructors   Properties   Methods  
 Public

 Protected
 Instance

 Static 
 Declared

 Inherited
 XNA Framework Only 

 .NET Compact Framework Only 

 MemberDescription
CreateStackRequest()()()()
Initializes a new instance of the CreateStackRequest class
Capabilities
The list of capabilities that you want to allow in the stack. If your template contains IAM resources, you must specify the CAPABILITY_IAM value for this parameter; otherwise, this action returns an InsufficientCapabilities error. IAM resources are the following: AWS::IAM::AccessKey, AWS::IAM::Group, AWS::IAM::Policy, AWS::IAM::User, and AWS::IAM::UserToGroupAddition.
DisableRollback
Boolean to enable or disable rollback on stack creation failures. Default: false
Equals(Object)
Determines whether the specified Object is equal to the current Object.
(Inherited from Object.)
GetHashCode()()()()
Serves as a hash function for a particular type.
(Inherited from Object.)
GetType()()()()
Gets the Type of the current instance.
(Inherited from Object.)
NotificationARNs
The Simple Notification Service (SNS) topic ARNs to publish stack related events. You can find your SNS topic ARNs using the SNS console or your Command Line Interface (CLI).

Constraints:

Length
0 - 5

OnFailure
Parameters
A list of Parameter structures that specify input parameters for the stack.
StackName
The name associated with the stack. The name must be unique within your AWS account.
Note:
Must contain only alphanumeric characters (case sensitive) and start with an alpha character. Maximum length of the name is 255 characters.
TemplateBody
Structure containing the template body. (For more information, go to the AWS CloudFormation User Guide.) Conditional: You must pass TemplateBody or TemplateURL. If both are passed, only TemplateBody is used.

Constraints:

Length
1 -

TemplateURL
Location of file containing the template body. The URL must point to a template located in an S3 bucket in the same region as the stack. For more information, go to the AWS CloudFormation User Guide. Conditional: You must pass TemplateURL or TemplateBody. If both are passed, only TemplateBody is used.

Constraints:

Length
1 - 1024

TimeoutInMinutes
The amount of time that can pass before the stack status becomes CREATE_FAILED; if DisableRollback is not set or is set to false, the stack will be rolled back.

Constraints:

Range
1 -

ToString()()()()
Returns a String that represents the current Object.
(Inherited from Object.)
WithCapabilities(IEnumerable<(Of <<'(String>)>>))
Adds elements to the Capabilities collection
WithCapabilities(array<String>[]()[][])
Adds elements to the Capabilities collection
WithDisableRollback(Boolean)
Sets the DisableRollback property
WithNotificationARNs(IEnumerable<(Of <<'(String>)>>))
Adds elements to the NotificationARNs collection
WithNotificationARNs(array<String>[]()[][])
Adds elements to the NotificationARNs collection
WithOnFailure(String)
Sets the OnFailure property
WithParameters(array<Parameter>[]()[][])
Adds elements to the Parameters collection
WithParameters(IEnumerable<(Of <<'(Parameter>)>>))
Adds elements to the Parameters collection
WithStackName(String)
Sets the StackName property
WithTemplateBody(String)
Sets the TemplateBody property
WithTemplateURL(String)
Sets the TemplateURL property
WithTimeoutInMinutes(Int32)
Sets the TimeoutInMinutes property

Inheritance Hierarchy

System..::..Object
  Amazon.Runtime..::..AmazonWebServiceRequest
    Amazon.CloudFormation.Model..::..CreateStackRequest

See Also