DescribeVolumes

Amazon Elastic Compute Cloud: 2008-08-08

previous page next page

DescribeVolumes

The DescribeVolumes operation lists the specified Amazon EBS volumes that you own. If you do not specify one or more volume IDs, Amazon EBS lists 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`	The ID of the volume to list Type: xsd:string Default: Describes all volumes that you own Valid Values: IDs of one or more volumes that you own Constraints: none	No

volumeId

The ID of the volume to list

Type: xsd: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
`attachmentSet`	Specifies an attachment of a volume to an instance Type: AttachmentSetItem
`volumeId`	The ID of the volume Type: xsd:string Ancestor: attachmentSet
`instanceId`	The ID of the instance Type: xsd:string Ancestor: attachmentSet
`status`	Attachment state (e.g., `attaching`, `attached`, `detaching`, or `detached`) Type: xsd:string Ancestor: attachmentSet
`attachTime`	Time stamp when the association was created Type: xsd:dateTime Ancestor: attachmentSet
`availabilityZone`	Availability zone in which the volume is located Type: xsd:string Ancestor: item

Sample Request

<DescribeVolumes xmlns="http://ec2.amazonaws.com/doc/2008-08-08">
</DescribeVolumes>

Sample Response

<DescribeVolumesResponse xmlns="http://ec2.amazonaws.com/doc/2008-08-08">
<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>
        <status>attached</status>
        <attachTime>2008-05-07T12:51:50.000Z</attachTime>
      </item>
    </attachmentSet>
  </item>
</volumeSet>

Related Operations

previous page start next page