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 |
|---|---|---|
|
|
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 |
Response Elements
The following table describes the default response tags included
in DescribeVolumes responses.
| Name | Description |
|---|---|
|
|
The ID of the volume Type: xsd:string |
|
|
The size of the volume, in GiBs Type: xsd:string |
|
|
Availability Zone in which the volume is located Type: xsd:string |
|
|
Volume state (e.g., Type: xsd:string |
|
|
Time stamp when volume creation was initiated Type: xsd:dateTime |
|
|
Specifies an attachment of a volume to an instance Type: AttachmentSetItem |
|
|
The ID of the volume Type: xsd:string Ancestor: attachmentSet |
|
|
The ID of the instance Type: xsd:string Ancestor: attachmentSet |
|
|
Attachment state (e.g., Type: xsd:string Ancestor: attachmentSet |
|
|
Time stamp when the association was created Type: xsd:dateTime Ancestor: attachmentSet |
Sample Request
<DescribeVolumes xmlns="http://ec2.amazonaws.com/doc/2009-03-01/"> </DescribeVolumes>
Sample Response
<DescribeVolumesResponse xmlns="http://ec2.amazonaws.com/doc/2009-03-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>