ECLAT-LSVOL
NAMESYNOPSIS
DESCRIPTION
FILTERS
OUTPUT
SEE ALSO
AUTHORS
BUG REPORTS
COPYRIGHT
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
SEE ALSO
eclat(1).
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.
Manpage server at man.gnu.org.ua.
Powered by mansrv 1.1