NAME

eclat-lsvol, eclat-describe-volumes - list EBS volumes

SYNOPSIS

eclat lsvol [FILTER...] [ID...]

eclat lsvol --help

DESCRIPTION

This command displays the EBS volumes in your account. By default, all volumes are shown. To select particular volumes, give their IDs in the command line.

If ID mapping is enabled (see the section MAPS in eclat(1)), this command treats the IDs as volume names and translates them to the AWS IDs using the VolumeId map.

FILTERS

Filters allow you to select only volumes matching particular criteria. The following filters are defined:

attachment.attach-time=date

The time stamp when the attachment initiated.

attachment.delete-on-termination=boolean

Whether the volume is deleted on instance termination.

attachment.device=string

The device name that is exposed to the instance (for example, /dev/sda1).

attachment.instance-id=string

attachment.status=value

The attachment state. Valid values are: attaching, attached, detaching, detached.

availability-zone=string

The availability zone in which the volume was created.

create-time=date

size=integer

The size of the volume, in GiB.

snapshot-id=string

The snapshot from which the volume was created.

status=value

The status of the volume. Allowed value is one of: creating, available, in-use, deleting, deleted, error.

tag-key=string

The key of a tag assigned to the resource, regardless of its value. Note, that this filter works independently of the tag-value filter, i.e. tag-key=foo tag-value=bar will return all snapshots that have the tag foo defined and all snapshots that have bar as a value of any of their tags. To request a snapshot that has the tag foo set to the value bar see the tag:KEY filter below.

tag-value=string

The value of a tag assigned to the resource, regardless of the tag's key. See the comment above.

tag:KEY=VAL

Selects the snapshots having the specified tag KEY set to the value VAL. For example:

tag:Name="root partition"

volume-id=ID

The volume ID. This filter has the same effect as specifying ID as the command line argument. It is needed mostly when you use ID mapping but wish to identify some modules by their IDs and another by their symbolic name, e.g.:

eclat -x lsvol root volume-id=vol-1aeb5008 srv

volume-type=value

The Amazon EBS volume type. Valid values are standard and io1.

OUTPUT

Each volume is listed on a separate line. Output fields are separated by horizontal tab characters. The fields are: the volume ID, its size in GiB, and status. Following this, volume attachments are described. Each attachment consists of four fields: the volume ID, the ID of the instance it is attached to, the device name it is known as, and the attachment status. For example:

vol-4282672b 80 in-use vol-4282672b i-6058a509 /dev/sdh attached

AUTHORS

Sergey Poznyakoff

BUG REPORTS

Report bugs to <bug-eclat@gnu.org.ua>.

COPYRIGHT

Copyright © 2012-2018 Sergey Poznyakoff
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.