euca-describe-volumes

Shows information about volumes.

Syntax

euca-describe-volumes [ volume_id ] [-v] [[--filter "name=value"] ...]

Options

Option Description Required
volume_id Volume ID to describe No
-F, --filter name=value Filter for limiting the results. See the table in the Available Filters section for a list of filters. Use quotation marks if the value has a space ("name=value example"). On a Windows system, use quotation marks even without a space in the value ("name=value"). No

Available Filters

You can add filters to your request so that the response includes information for only certain volumes. For example, you can use a filter to specify that you want to find volumes whose status is available. Some tips for using filters with this command:

The following are the available filters for euca-describe-volumes:

Filter Description
attachment.attach-time Time stamp when the attachment initiated
attachment.delete-on-termination Whether the volume will be deleted on instance termination.
attachment.device How the volume is exposed to the instance (for example, /dev/sda1)
attachment.instance-id ID of the instance the volume is attached to
attachment.status Attachment state.

Valid values: attaching | attached | detaching |detached

availability-zone Availability Zone in which the volume was created
create-time Time stamp when the volume was created
size Size of the volume, in GB (for example, 20)
snapshot-id Snapshot from which the volume was created
status Status of the volume.

Valid values: pending | completed | error

tag-key Key of a tag assigned to the resource you want to filter. This filter is independent of the tag-value filter and returns all resources assigned the tag key you use, regardless of the value. To filter on a specific key and value set, use the tag:key filter.
tag-value Value of a tag assigned to the resource. This filter is independent of the tag-key filter and returns all resources assigned the tag value you use, regardless of the key. To filter on a specific key and value set, use the tag:key filter.
tag:key Filters the results based on a specific tag/value combination
volume-id ID of the volume the snapshot is for

Common Options

Option Description
--show-empty-fields Show empty fields as "(nil)".
--region user@region Region and/or user name to search when looking up config file data. Only valid for EC2 endpoints.
-U,--url url URL of the cloud service to connect to. For administrative commands, this should be <ip_address>:8773/services/Empyrean.
-I,--access-key-id key_id User's access key ID.
-S,--secret-key secret_key User's secret key.
--security-token token User's security token.
--debug Prints what the command sends to the server and what it receives from the server. Use when you're trying to debug Euca2ools.
--debugger Enable interactive debugger on error.
-h,--help Display the manual page for the command.
--version Display the version of this tool.

Output

Example

euca-describe-volumes 
VOLUME  vol-84B54112    5   zone00  available   2012-01-01T00:00:00.000Z
x