Download Amazon Elastic Compute Cloud User Guide for Linux

Amazon Elastic Compute Cloud User Guide for Linux
Instance Block Device Mapping
--block-device-mappings [mapping, ...]
For example, suppose that an EBS-backed AMI specifies the following block device mapping:
• /dev/sdb=ephemeral0
• /dev/sdh=snap-92d333fb
• /dev/sdj=:100
To prevent /dev/sdj from attaching to an instance launched from this AMI, use the following mapping:
{
"DeviceName": "/dev/sdj",
"NoDevice": ""
}
To increase the size of /dev/sdh to 300 GiB, specify the following mapping. Notice that you don't need
to specify the snapshot ID for /dev/sdh, because specifying the device name is enough to identify the
volume.
{
"DeviceName": "/dev/sdh",
"Ebs": {
"VolumeSize": 300
}
}
To attach an additional instance store volume, /dev/sdc, specify the following mapping. If the instance
type doesn't support multiple instance store volumes, this mapping has no effect.
{
"DeviceName": "/dev/sdc",
"VirtualName": "ephemeral1"
}
To add volumes to an instance using the Amazon EC2 CLI
Use the ec2-run-instances command to specify a block device mapping for an instance.
Specify the block device mapping using the following parameter:
-b "devicename=blockdevice"
devicename
The device name within Amazon EC2.
blockdevice
To omit a mapping for the device from the AMI, specify none.
To add an instance store volume, specify ephemeral[0..23].
To add an EBS volume to an EBS-backed instance, specify
[snapshot-id]:[size]:[delete-on-termination]:[type[:iops]].
• To add an empty EBS volume, omit the snapshot ID and specify a volume size instead.
API Version 2015-04-15
612