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 com-
       mand 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 at-
       tachment	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-2015 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)

NAME | SYNOPSIS | DESCRIPTION | FILTERS | OUTPUT | SEE ALSO | AUTHORS | BUG REPORTS | COPYRIGHT

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

home | help