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

FreeBSD Manual Pages

  
 
  

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

NAME
       eclat-lsimg, eclat-describe-images - describe available Amazon images

SYNOPSIS
       eclat lsimg [-a]	[-u ID]	[-x ID]	[--owner=ID] [--executable-by=ID]
       [FILTER...] [AMI...]

       eclat lsimg --help

DESCRIPTION
       This command lists available Amazon images.

       The list	of returned images can be abridged using command line options,
       filters and arguments.

       Filters are any arguments that have the key=value structure.  When fil-
       ters  are  supplied,  only  those  images that match them are returned.
       Multiple	filters	are joined using logical AND.	Multiple values	 sepa-
       rated by	commas can be specified	for a given key, in which case a logi-
       cal  OR is implied.  See	the section FILTERS below for a	list of	avail-
       able filters.

       Any command line	argument that is not an	option or filter is treated as
       image ID	(or image name,	if ID mapping is enabled) to return.  Any num-
       ber of IDs can be specified.  If	ID mapping is enabled (see the section
       MAPS in eclat(1)), this command uses the	ImageId	map to translate image
       names to	the corresponding identifiers.

       Image IDs, filters and options can be used in conjunction.

OPTIONS
       -u, --owner ID
	      Filters the images owned by the specified	owner.	 The  argument
	      is  either the ID	of the owner, or one of	the following reserved
	      words:

	   self	  Returns the images you own.

	   amazon Returns the public Amazon images.

	   all	  Returns all available	images.

	   aws-marketplace
		  Returns images from the AWS marketplace.

       -x, --executable-by=ID
	      Returns AMIs for which the specified user	ID has explicit	launch
	      permissions.  The	ID is either an	AWS user ID or one of the fol-
	      lowing reserved words:

	   self	  Returns the images which you can launch.

	   all	  Returns all images.

FILTERS
       architecture=i386 | x86_64
	      Selects images by	architecture.

       block-device-mapping.delete-on-termination=BOOL
	      Selects images based on  whether	their  Amazon  EBS  volume  is
	      deleted on instance termination.

       block-device-mapping.device-name=NAME
	      The device name for the volume.

       block-device-mapping.snapshot-id=ID
	      The ID of	the snapshot used for the volume.

       block-device-mapping.volume-size=NUMBER
	      The volume size in GB.

       block-device-mapping.volume-type=standard | io1
	      The type of the volume.

       description=STRING
	      The textual description of the AMI.

       image-id=ID
	      The ID of	the image.

       image-type=machine | kernel | ramdisk
	      The type of the image.

       is-public=BOOL
	      Whether the image	is public.

       kernel-id=STRING
	      The kernel ID.

       manifest-location=STRING
	      The location of the AMI manifest.

       name=STRING
	      The name of the AMI.

       owner-alias=STRING
	      The account alias.

       owner-id=STRING
	      The ID of	the image owner.

       platform=windows
	      Selects Windows-based AMIs.

       product-code=STRING

       product-code.type=devpay	| marketplace

       ramdisk-id=STRING
	      The RAM disk ID.

       root-device-name=STRING
	      The name of the root volume.

       root-device-type=ebs | instance-store
	      The name of the root device volume.

       state=available | pending | failed
	      State of the AMI.

       state-reason-code=STRING
	      The reason code of the latest state change.

       state-reason-message=STRING
	      Message describing the reason of the latest state	change.

       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 images that have the tag foo defined	and  all  images  that
	      have  bar	as a value of any of their tags.  To request the image
	      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  images  having  the  specified tag KEY set to the value
	      VAL.  For	example:

	      tag:Name="db server"

       virtualization-type=paravirtual | hvm

       hypervisor=ovm |	xen

OUTPUT
EXAMPLE
SEE ALSO
       eclat(1), eclat-mkimg(1), eclat-deimg(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/licens-
       es/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-LSIMG(1)

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

home | help