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...

AWS CloudFormation EC2 Block Device Property Type

The EC2 EBS Block Device type is an embedded property of the EC2 Block Device Mapping type.

Syntax

{
   "DeleteOnTermination" : Boolean,
   "Iops" : Number,
   "SnapshotId" : String,
   "VolumeSize" : String,
   "VolumeType" : String
}     

Properties

DeleteOnTermination

Determines whether to delete the volume on instance termination. The default value is "true".

Required: No.

Type: Boolean.

Iops

The number of I/O operations per second (IOPS) that the volume supports. This can be an integer from 100 – 2000.

Required: Conditional. Required when the volume type is "io1"; not used with standard volumes.

Type: Number.

SnapshotId

The snapshot ID of the volume to use to create a block device.

Required: Conditional. If you specify both SnapshotId and VolumeSize, VolumeSize must be equal or greater than the size of the snapshot.

Type: String.

VolumeSize

The volume size, in gibibytes (GiB). This can be a number from 1 – 1024. If the volume type is "io1", the minimum value is 10.

Required: Conditional. If you specify both SnapshotId and VolumeSize, VolumeSize must be equal or greater than the size of the snapshot.

Type: String.

VolumeType

The volume type. Valid values are "standard" (the default) and "io1". If you set the type to "io1", you must also set the Iops property.

Required: No.

Type: String.

Example

{
   "DeviceName":"/dev/sdc",
   "Ebs":{
      "SnapshotId":"snap-xxxxxx",
      "VolumeSize":"50",
      "VolumeType":"io1",
      "Iops":"1000",
      "DeleteOnTermination":"false"
   }
}     

See Also

  • CreateVolume in the Amazon Elastic Compute Cloud API Reference