ec2-create-volume

Amazon Elastic Compute Cloud: 2008-08-08

previous page next page

ec2-create-volume

Syntax

ec2-create-volume [--size size | --snapshot snapshot] --availability-zone zone

Description

Creates an Amazon EBS volume of a size you specify or from a snapshot.

[Note]Note

You must specify an availability zone when creating a volume. The volume and the instance to which it attaches must be in the same availability zone.

Options

OptionDescriptionRequired

--size size

The size of the Amazon EBS volume, in GiB. Required if you are not creating a volume from a snapshot.

Example: 800

Conditional

--snapshot snapshot

The snapshot from which to create the new volume. Required if you do not specify a volume size.

Example: snap-78a54011

Conditional

--availability-zone zone

The availability zone in which to create the new volume.

Example: us-east-1a

Yes

Output

Amazon EBS returns a table that contains the following information:

  • VOLUME identifier

  • ID of the volume

  • Size of the volume, in GiBs

  • Snapshot from which the volume was created, if applicable

  • Availability zone in which the volume was created

  • Volume state (e.g., creating, available)

  • Time stamp when volume creation was initiated

Amazon EBS displays errors on stderr.

Example

This example creates a new 800 GiB volume in availability zone us-east-1a.

PROMPT> ec2-create-volume --size 800 --availability-zone us-east-1a
VOLUME vol-4d826724 800 us-east-1a creating 2008-02-14T00:00:00+0000

Related Topics

ec2-delete-volume

  • ec2-describe-volumes

  • ec2-attach-volume

  • ec2-detach-volume

  • ec2-describe-availability-zones

    • previous page start next page