Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
ECLAT-LSVOL(1)		      Eclat User Reference		  ECLAT-LSVOL(1)

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, de-
	    taching, 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, avail-
	    able, 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 map-
	    ping  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 at-
     tachment 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 (C) 2012-2018 Sergey Poznyakoff
     License GPLv3+: GNU GPL version 3 or later <http://gnu.org/li-
     censes/gpl.html>
     This is free software: you are free to change and redistribute  it.   There
     is NO WARRANTY, to the extent permitted by law.

ECLAT				January 26, 2015		  ECLAT-LSVOL(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=eclat-lsvol&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help