AWS CloudFormation
User Guide (API Version 2010-05-15)
Did this page help you?  Yes | No |  Tell us about it...
« PreviousNext »
View the PDF for this guide.Go to the AWS Discussion Forum for this product.Go to the Kindle Store to download this guide in Kindle format.

Selecting a Stack Template on the AWS CloudFormation Console

After starting the Create Stack wizard, you specify a stack name and select the template AWS CloudFormation uses to create your stack.

AWS CloudFormation templates are JSON files that specify the AWS resources that make up your stack. For more information about AWS CloudFormation templates, see Template Anatomy.

To choose a stack name and select a stack template:

  1. On the Create A New Stack page of the Create Stack wizard, type a stack name in the Name box.

    A stack name can contain only alphanumeric characters (case sensitive) and hyphens. It must start with an alphabetic character and cannot be longer than 255 characters.

  2. Choose a stack using one of the following options:

    Use a sample template

    Select an AWS CloudFormation template from among those available on the menu. The list of available templates in the menu is generally the same as the list of templates on the AWS CloudFormation Sample Templates web page.

    You can select CloudFormer from the list to create a stack from existing AWS resources, using the CloudFormer tool. For more information, see Using CloudFormer to Create Templates.

    Upload a template file

    Select an AWS CloudFormation template on your local system. Specify the full path or click Browse to select the file that you want to upload.

    An uploaded template can be, at most, 51200 bytes.


    If you upload a local template file, AWS CloudFormation uploads it to an Amazon S3 bucket in your AWS account. AWS CloudFormation creates a unique bucket for each region in which you upload a template file. The buckets are accessible to anyone with Amazon S3 permissions in your AWS account. If an AWS CloudFormation-created bucket already exists, the template is added to that bucket.

    You can use your own bucket and manage its permissions by manually uploading templates to Amazon S3. Then whenever you create or update a stack, specify the Amazon S3 URL of a template file.

    Provide a template URL

    Specify a URL to a template in an Amazon S3 bucket.

    The URL must point to a template (max size: 460,800 bytes) in an Amazon S3 bucket that you have read permissions to, located in the same region as the stack. The URL itself can be, at most, 1024 characters long.

  3. Click Next Step to accept your settings and proceed with specifying stack parameters.