DescribeVolumes

Amazon Elastic Compute Cloud: 2008-12-01

previous page next page

DescribeVolumes

The DescribeVolumes operation lists one or more Amazon EBS volumes that you own, If you do not specify any volumes, Amazon EBS returns all volumes that you own. For more information about Amazon EBS, see Amazon Elastic Block Store.

Request Parameters

The following table describes the request parameters for DescribeVolumes. Parameter names are case sensitive.

Name Description Required

Name	Description	Required
`VolumeId``.n`	The ID of the volume to list Type: String Default: Describes all volumes that you own Valid Values: IDs of one or more volumes that you own Constraints: none	No

VolumeId.n

The ID of the volume to list

Type: String

Default: Describes all volumes that you own

Valid Values: IDs of one or more volumes that you own

Constraints: none

Response Elements

The following table describes the default response tags included in DescribeVolumes responses.

Name	Description
`volumeId`	The ID of the volume Type: xsd:string
`size`	The size of the volume, in GiBs Type: xsd:string
`status`	Volume state (e.g., `creating`, `available`) Type: xsd:string
`createTime`	Time stamp when volume creation was initiated Type: xsd:dateTime
`snapshotId`	The ID of the snapshot from which the volume was created Type: xsd:string
`availabilityZone`	Availability Zone in which the volume is located Type: xsd:string
`attachmentSet`	Specifies an attachment of a volume to an instance Type: AttachmentSet
`volumeId`	The ID of the volume Type: xsd:string Ancestor: item
`instanceId`	The ID of the instance Type: xsd:string Ancestor: item
`device`	The name of the device Type: xsd:string Ancestor: item
`status`	Attachment state (e.g., `attaching`, `attached`, `detaching`, or `detached`) Type: xsd:string Ancestor: item
`attachTime`	Time stamp when the association was created Type: xsd:dateTime Ancestor: item

Sample Request

https://ec2.amazonaws.com/
?Action=DescribeVolumes
&...auth parameters...

Sample Response

<DescribeVolumesResponse xmlns="http://ec2.amazonaws.com/doc/2008-12-01">
<volumeSet>
  <item>
    <volumeId>vol-4282672b</volumeId>
    <size>800</size>
    <status>in-use</status>
    <createTime>2008-05-07T11:51:50.000Z</createTime>
    <attachmentSet>
      <item>
        <volumeId>vol-4282672b</volumeId>
        <instanceId>i-6058a509</instanceId>
        <size>800</size>
        <snapshotId>snap-12345678</snapshotId>
        <availabilityZone>us-east-1a</availabilityZone>
        <status>attached</status>
        <attachTime>2008-05-07T12:51:50.000Z</attachTime>
      </item>
    </attachmentSet>
  </item>
</volumeSet>

Related Operations

previous page start next page