AWS CloudFormation
User Guide (API Version 2010-05-15)
« 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.Did this page help you?  Yes | No |  Tell us about it...

Document History

The following table describes the important changes to the AWS CloudFormation documentation. This documentation is associated with the 2010-05-15 release of AWS CloudFormation. This guide was last updated on February 20, 2013.

ChangeDescriptionRelease Date

VPC security groups can now be set in AWS RDS instances

You can now assign VPC security groups to an Amazon RDS instance with AWS CloudFormation. For more information, see the VPCSecurityGroups property in AWS::RDS::DBInstance.

February 28, 2013

Rolling Deployments for Auto Scaling Groups

AWS CloudFormation now supports update policies on autoscaling groups, which describe how instances in the autoscaling group are replaced or modified when the auto scaling group adds or removes instances. You can modify these settings at stack creation or during a stack update.

For more information and an example, see UpdatePolicy.

February 20, 2013

Cancel and Rollback Action for Stack Updates

AWS CloudFormation supports the ability to cancel a stack update. The stack must be in the UPDATE_IN_PROGRESS state when the update request is made. More information is available in the following topics:

February 20, 2013

EBS-Optimized Instances for Auto Scaling Groups

You can now provision EBS-optimized instances in auto scaling groups for dedicated throughput to Amazon EBS in autoscaled instances. The implementation is similar to that of the previously released support for optimized EBS EC2 instances.

For more information, see the new EbsOptimized property in AWS::AutoScaling::LaunchConfiguration.

February 20, 2013

New Documentation

AWS::EC2::Instance now provides a BlockDeviceMappings property to allow you to set block device mappings for your EC2 instance.

With this change, two new types have been added:

For template examples, see EC2 Block Device Mapping Examples.

December 21, 2012

New Documentation

New sections have been added to describe the procedures for creating and viewing stacks using the recently redesigned AWS Management Console. You can find them here:

December 21, 2012

New Documentation

Custom resources are special AWS CloudFormation resources that provide a way for a template developer to include resources in an AWS CloudFormation stack that are provided by a source other than Amazon Web Services. The custom resource provider can be either a template developer or a separate third-party resource provider.

Information about custom resources is provided in the following topics:

November 15, 2012

Updated Documentation

AWS CloudFormation now supports specifying provisioned I/O operations per second (IOPS) for Amazon RDS instances. You can set this value from 1000–10,000 in 1000 IOPS increments by using the new Iops property in AWS::RDS::DBInstance.

For more information about specifying IOPS for RDS instances, see Provisioned IOPS in the Amazon Relational Database Service User Guide.

November 15, 2012

New and Updated Documentation

Reorganization of topics to more clearly provide specific information about using the AWS Management Console and using the AWS CloudFormation command-line interface (CLI).

Information about tagging AWS CloudFormation stacks has been added to the documentation, including new guides and updated reference topics:

New information about working with Windows Stacks:

New topic: Using Regular Expressions in AWS CloudFormation Templates.

New section: Installing the AWS CloudFormation Command Line Interface (CLI), with tailored guides for Linux, Mac OS X and Windows.

August 27, 2012

New Feature

AWS CloudFormation now provides full support for Virtual Private Cloud (VPC) security with Amazon EC2. You can now create and populate an entire VPC with every type of VPC resource (subnets, gateways, network ACLs, route tables, and so forth) using a single AWS CloudFormation template.

Templates can be downloaded that demonstrate new VPC features:

Single instance in a single subnet
Multiple subnets with Elastic Load Balancing (ELB) and an auto scaling group

Documentation for the following resource types has been updated:

AWS::EC2::SecurityGroup
AWS::EC2::SecurityGroupIngress
AWS::EC2::SecurityGroupEgress
AWS::EC2::Instance
AWS::AutoScaling::AutoScalingGroup
AWS::EC2::EIP
AWS::EC2::EIPAssociation
AWS::ElasticLoadBalancing::LoadBalancer

New resource types have been added to the documentation:

AWS::EC2::VPC
AWS::EC2::InternetGateway
AWS::EC2::DHCPOptions
AWS::EC2::DHCPOptions
AWS::EC2::RouteTable
AWS::EC2::NetworkAcl
AWS::EC2::NetworkAclEntry
AWS::EC2::Subnet
AWS::EC2::VPNGateway
AWS::EC2::CustomerGateway

April 25, 2012

New Feature

AWS CloudFormation now allows you to add or remove elements from a stack when updating it. Updating AWS CloudFormation Stacks has been updated, and a new section has been added to the walkthrough: Change the Stack's Resources, which describes how to add and remove resources when updating the stack.

The reference topics: ElasticBeanstalk ConfigurationTemplate, and ElasticBeanstalk OptionSettings Property Type, have been significantly updated in response to developer requests for more information.

April 13, 2012

New Feature

AWS CloudFormation now provides support for resources in an existing Amazon Virtual Private Cloud (VPC). With this release, you can:

  • Launch an EC2 Dedicated Instance into an existing VPC. For more information, see AWS::EC2::Instance.

  • Set the SourceDestCheck attribute of an Amazon EC2 instance that resides in an existing VPC. For more information, see AWS::EC2::Instance

  • Create Amazon Elastic IP Addresses in an existing VPC. For more information, see AWS::EC2::EIP

  • Use CloudFormation to create VPC security groups and ingress/egress rules in an existing VPC. For more information, see AWS::EC2::SecurityGroup.

  • Associate an Auto Scaling Group with an existing Amazon VPC by setting the VPCZoneIdentifier property of your AWS::AutoScaling::AutoScalingGroup resource. For more information, see AWS::AutoScaling::AutoScalingGroup.

  • Attach an Elastic Load Balancing LoadBalancer to a VPC subnet and create security groups for the LoadBalancer. For more information, see AWS::ElasticLoadBalancing::LoadBalancer.

  • Create an RDS instance in an existing VPC. For more information, see AWS::RDS::DBInstance.

February 2, 2012

New Feature

You can now update properties for the following resources in an existing stack:

For the full list of updateable resources and details about things to consider when updating a stack, see Updating AWS CloudFormation Stacks.

February 2, 2012

Restructured Guide

Reorganized existing sections into new sections: Working with AWS CloudFormation Templates and Managing Stacks. Moved Template Reference to the top level of the Table of Contents. Moved Estimating the Cost of Your AWS CloudFormation Stack to the Getting Started section.

February 2, 2012

New Content

Added three new sections:

February 2, 2012

New Feature

AWS CloudFormation now provides the cfn-list-stacks command, which enables you to list stacks filtered by stack status. Deleted stacks can be listed for up to 90 days after they have been deleted. For more information, see Describing and Listing Your Stacks.

May 26, 2011

New Features

The cfn-describe-stack-resources and cfn-get-template commands now enable you to get information from stacks which have been deleted for 90 days after they have been deleted. For more information, see Listing Member Resources and Retrieving a Template.

May 26, 2011

New Link

AWS CloudFormation endpoint information is now located in the Amazon Web Services General Reference. For more information, go to Regions and Endpoints in Amazon Web Services General Reference.

March 1, 2011

Initial Release

This is the initial public release of AWS CloudFormation.

February 25, 2011