AWS CloudFormation
User Guide (Version )

AWS::AutoScaling::LaunchConfiguration BlockDeviceMapping

BlockDeviceMapping is a property of LaunchConfiguration that describes a block device mapping for an Amazon EC2 Auto Scaling group.

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.

Syntax

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

JSON

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

YAML

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

Properties

DeviceName

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

Required: Yes

Type: String

Minimum: 1

Maximum: 255

Pattern: [\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*

Update requires: No interruption

Ebs

The information about the Amazon EBS volume.

You can specify either VirtualName or Ebs, but not both.

Required: No

Type: BlockDevice

Update requires: No interruption

NoDevice

Suppresses the device mapping. If this property is set to true for the root device, the instance might fail the Amazon EC2 health check. Amazon EC2 Auto Scaling launches a replacement instance if the instance fails the health check.

Required: No

Type: Boolean

Update requires: No interruption

VirtualName

The name of the virtual device. The name must be in the form ephemeralX where X is a number starting from zero (0), for example, ephemeral0.

You can specify either VirtualName or Ebs, but not both.

Required: No

Type: String

Minimum: 1

Maximum: 255

Pattern: [\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*

Update requires: No interruption

See Also

On this page: