AWS::AutoScaling::LaunchConfiguration BlockDeviceMapping - Amazon CloudFormation
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

AWS::AutoScaling::LaunchConfiguration BlockDeviceMapping

BlockDeviceMapping specifies a block device mapping for the BlockDeviceMappings property of the AWS::AutoScaling::LaunchConfiguration resource.

Each instance that is launched has an associated root device volume, either an Amazon EBS volume or an instance store volume. You can use block device mappings to specify additional EBS volumes or instance store volumes to attach to an instance when it is launched.

For more information, see Example block device mapping in the Amazon EC2 User Guide for Linux Instances.


To declare this entity in your Amazon CloudFormation template, use the following syntax:


{ "DeviceName" : String, "Ebs" : BlockDevice, "NoDevice" : Boolean, "VirtualName" : String }


DeviceName: String Ebs: BlockDevice NoDevice: Boolean VirtualName: String



The device name assigned to the volume (for example, /dev/sdh or xvdh). For more information, see Device naming on Linux instances in the Amazon EC2 User Guide for Linux Instances.


To define a block device mapping, set the device name and exactly one of the following properties: Ebs, NoDevice, or VirtualName.

Required: Yes

Type: String

Update requires: Replacement


Information to attach an EBS volume to an instance at launch.

Required: No

Type: BlockDevice

Update requires: Replacement


Setting this value to true prevents a volume that is included in the block device mapping of the AMI from being mapped to the specified device name at launch.

If NoDevice is true for the root device, instances might fail the EC2 health check. In that case, Amazon EC2 Auto Scaling launches replacement instances.

Required: No

Type: Boolean

Update requires: Replacement


The name of the instance store volume (virtual device) to attach to an instance at launch. The name must be in the form ephemeralX where X is a number starting from zero (0), for example, ephemeral0.

Required: No

Type: String

Update requires: Replacement

See also