DescribeVolumes
Description
Describes the specified Amazon EBS volumes that you own. If you do not specify one or more volume IDs, Amazon EBS describes all volumes that you own. For more information about Amazon EBS, go to the
Request Parameters
| Name | Description | Required |
|---|---|---|
|
|
Type: DescribeVolumesType Ancestor: None Children: |
|
|
Set of volumes. Type: DescribeVolumesSetType Ancestor: Children: |
|
|
Information for a volume. Type: DescribeVolumesSetItemType Ancestor: Children: |
|
|
The ID of the volume to list. Type: xsd:string Default: Describes all volumes that you own. Ancestor: Children: None |
No |
Response Elements
| Name | Description |
|---|---|
|
|
Type: DescribeVolumesResponseType Ancestor: None Children: |
|
The ID of the request. Type: xsd:string Ancestor: Children: None |
|
Volume set. Type: DescribeVolumesSetResponseType Ancestor: Children: |
|
Information for a volume. Type: DescribeVolumesSetItemResponseType Ancestor: Children: |
|
The ID of the volume. Type: xsd:string Ancestor: Children: None |
|
The size of the volume, in GiBs. Type: xsd:string Ancestor: Children: None |
|
Snapshot from which the volume was created (optional). Type: xsd:string Ancestor: Children: None |
|
Availability Zone in which the volume was created. Type: xsd:string Ancestor: Children: None |
|
Volume state (e.g., Type: xsd:string Ancestor: Children: None |
|
Time stamp when volume creation was initiated. Type: xsd:dateTime Ancestor: Children: None |
|
Attachment set. Type: AttachmentSetResponseType Ancestor: Children: |
|
Information for a attachment set. Type: AttachmentSetItemResponseType Ancestor: Children: |
|
The ID of the volume. Type: xsd:string Ancestor: Children: None |
|
The ID of the instance. Type: xsd:string Ancestor: Children: None |
|
Specifies how the device is exposed to the instance (e.g., /dev/sdh). Type: xsd:string Ancestor: Children: None |
|
Attachment state. Type: xsd:string Valid Values: Ancestor: Children: None |
|
Time stamp when the association was created. Type: xsd:dateTime Ancestor: Children: None |
Examples
Example Request
This example describes all volumes associated with your account.
<DescribeVolumes xmlns="http://ec2.amazonaws.com/doc/2009-08-15/"></DescribeVolumes>
Example Response
<DescribeVolumesResponse xmlns="http://ec2.amazonaws.com/doc/2009-08-15/">
<volumeSet>
<item>
<volumeId>vol-4282672b</volumeId>
<size>800</size>
<snapshotId/>
<availabilityZone>us-east-1a</availabilityZone>
<status>in-use</status>
<createTime>2008-05-07T11:51:50.000Z</createTime>
<attachmentSet>
<item>
<volumeId>vol-4282672b</volumeId>
<instanceId>i-6058a509</instanceId>
<device>/dev/sdh</device>
<status>attached</status>
<attachTime>2008-05-07T12:51:50.000Z</attachTime>
</item>
</attachmentSet>
</item>
</DescribeVolumesResponse>