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

FreeBSD Manual Pages

  
 
  

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

NAME
       eclat-lsinst,  eclat-describe-instances	-  describe  available EC2 in-
       stances

SYNOPSIS
       eclat lsinst [FILTER...]

       eclat lsinst --help

DESCRIPTION
       This command lists your EC2 instances.

FILTERS
       The following filters are defined:

       architecture=i386 | x86_64
	      The architecture of the instance.

       availability-zone=string
	      The availability zone of the instance.

       block-device-mapping.attach-time=date
	      The date/time when an EBS	volume was attached to the instance.

       block-device-mapping.delete-on-termination=boolean
	      Whether the device is deleted on termination of the instance.

       block-device-mapping.device-name=string
	      The name of the device corresponding to an Amazon	EBS volume.

       block-device-mapping.status=string
	      The status of the	device.

       block-device-mapping.volume-id=string
	      The volume ID of the EBS volume.

       client-token=string
	      The idempotency token provided when launching the	instance.

       dns-name=string
	      The public DNS name of the instance.

       group-id=string
	      The ID of	a EC2 security group the instance  pertains  to.   For
	      VPC security groups, see instance.group-id.

       group-name=string
	      The  name	of a EC2 security group	the instance pertains to.  For
	      VPC security groups, see instance.group-name.

       image-id=string
	      The ID of	the image used to create the instance.

       instance-id=string
	      The ID of	the instance.

       instance-lifecycle=spot
	      Matches only Spot	Instances.

       instance-state-code=number
	      An integer code representing the state of	the instance.  Allowed
	      values  for  number  are:	 0  (pending), 16 (running), 32	(shut-
	      ting-down), 48 (terminated), 64 (stopping), 80 (stopped).

       instance-state-name=state
	      The state	of the instance.  Allowed values for state are:	 pend-
	      ing, running, shutting-down, terminated, stopping, stopped.

       instance-type=string
	      The type of instance (e.g., m1.small).

       instance.group-id=string
	      The ID of	a VPC security group the instance pertains to.

       instance.group-name=string
	      Tha name of a VPC	security group the instance pertains to.

       ip-address=string
	      The public IP address of the instance.

       kernel-id=string
	      The kernel ID.

       key-name=string
	      The name of the key pair used when the instance was launched.

       launch-index=string
	      The  zero-based  index  of  the instance in the launch group, if
	      multiple instances were launched.

       launch-time=date
	      Date/time	when the instance was launched.

       monitoring-state=disabled | enabled
	      Instance monitoring state.

       owner-id=string
	      The ID of	the instance owner.

       placement-group-name=string
	      The name of the placement	group the instance is in.

       private-dns-name=string
	      Private DNS name of the instance.

       private-ip-address=string
	      Private IP address of the	instance.

       product-code=string
	      The product code associated with the AMI used to launch the  in-
	      stance.

       product-code.type=devpay	| marketplace
	      The type of product code.

       ramdisk-id=string
	      The ID of	the RAM	disk.

       reason=string
	      The reason why the instance is in	its current state.

       requester-id=string
	      The  ID  of the entity that launched the instance	on your	behalf
	      (for example, AWS	Management Console, Auto Scaling, and so on).

       reservation-id=string
	      The ID of	the instance reservation.  It is created any  time  an
	      instance or a group of instances is launched.  Depending on this
	      a	single reservation ID can correspond to	a single or to	multi-
	      ple instances.

       root-device-name=string
	      The name of the root device.

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

       source-dest-check=boolean
	      Indicates	  whether  the	instance  performs  source/destination
	      checking.	 It must be false for the instance to perform NAT in a
	      VPC.

       spot-instance-request-id=string
	      The ID of	the Spot Instance request.

       state-reason-code=string
	      The reason code for the state change.

       state-reason-message=string
	      A	message	describing the state change.

       tag-key=string
	      The  key	of  a  tag assigned to the instance, regardless	of its
	      value.  Note,  that  this	 filter	 works	independently  of  the
	      tag-value	filter,	i.e.  tag-key=foo tag-value=bar	will match all
	      instances	that have the tag foo defined as well  as  those  that
	      have  bar	as a value of any of their tags.  To request instances
	      that have	the tag	foo set	to the value bar see the tag:KEY  fil-
	      ter below.

       tag-value=string
	      The  value  of a tag assigned to the instance, regardless	of the
	      tag's key.  See the comment above.

       tag:key=string
	      Selects the instances having the specified tag KEY  set  to  the
	      value VAL.

       virtualization-type=paravirtual | hvm
	      The virtualization type of the instance.

       hypervisor=ovm |	xen
	      The hypervisor type of the instance.

   VPC FILTERS
       The  following  filters	are valid only if using	Amazon Virtual Private
       Cloud:

       subnet-id=string
	      The ID of	the subnet the instance	is.

       vpc-id=string
	      The ID of	the VPC	the instance is	in.

       network-interface.description=string
	      The description of the network interface.

       network-interface.subnet-id=string
	      The ID of	the subnet of the network interface.

       network-interface.vpc-id=string
	      The VPC ID of the	network	interface.

       network-interface.network-interface.id=string
	      The ID of	the network interface.

       network-interface.owner-id=string
	      The ID of	the owner of the network interface.

       network-interface.availability-zone=string
	      The availability zone of the network interface.

       network-interface.requester-id=string
	      The requester ID of the network interface.

       network-interface.requester-managed=boolean
	      Indicates	whether	the network interface is being managed	by  an
	      AWS  service  (for example, AWSManagement	Console, Auto Scaling,
	      and so on).

       network-interface.status=available | in-use
	      The status of the	network	interface.

       network-interface.mac-address=string
	      The MAC address of the network interface.

       network-interface-private-dns-name=string
	      The private DNS name of the network interface.

       network-interface.source-destination-check=Boolean
	      Indicates	whether	the network interface performs source/destina-
	      tion  checking.  This value must be false	if the interface is to
	      perform NAT in a VPC.

       network-interface.group-id=string
	      The ID of	a VPC security group associated	with the  network  in-
	      terface.

       network-interface.group-name=string
	      The name of a VPC	security group associated with the network in-
	      terface.

       network-interface.attachment.attachment-id=string
	      The ID of	the interface attachment.

       network-interface.attachment.instance-id=string
	      The ID of	the instance to	which the  network  interface  is  at-
	      tached.

       network-interface.attachment.instance-owner-id=string
	      The  owner  ID of	the instance to	which the network interface is
	      attached

       network-interface.addresses.private-ip-address=string
	      The private IP address associated	with the network interface.

       network-interface.attachment.device-index=integer
	      The device index to which	the network interface is attached.

       network-interface.attachment.status=value
	      The status of the	attachment.  Allowed  values  are:  attaching,
	      attached,	detaching, detached.

       network-interface.attachment.attach-time=date
	      The  time	 when  the  network  interface was attached to the in-
	      stance.

       network-interface.attachment.delete-on-termination=boolean
	      Specifies	whether	the attachment is deleted when an instance  is
	      terminated.

       network-interface.addresses.primary=boolean
	      Specifies	whether	the IP address of the network interface	is the
	      primary private IP address.

       network-interface.addresses.association.public-ip=string
	      The ID representing the association of a VPC Elastic IP  address
	      with a network interface in a VPC.

       network-interface.addresses.association.ip-owner-id=string
	      The  owner ID of the private IP address associated with the net-
	      work interface.

       association.public-ip=string
	      The Elastic IP address bound to the network interface.

       association.ip-owner-id=string
	      The owner	of the Elastic IP address associated with the  network
	      interface.

       association.allocation-id=string
	      The  allocation  ID that AWS returned when an Elastic IP address
	      was allocated for	the network interface.

OUTPUT
       Each instance is	described in a separate	multi-line block, between  the
       Instance:  and  End  of	instance markers.  The information within that
       block is	indented by one	tab stop to improve readablility.

       Each instance description is prefaced by	its reservation	and owner  IDs
       and a list of groups it pertains	to.  For example:

       Reservation ID: r-0ece705a
       Owner ID: 053230519467
       Groups:

       Instance: i-7a00642e
	    Image ID: ami-1cd4924e
	    State: running
	    Kernel ID:
	    Architecture: x86_64
	    Private DNS:
	    Public DNS:
	    Key: VPCKey
	    Type: c1.medium
	    Launch Time: 2012-06-28T17:41:48.000Z
	    Availability Zone: ap-southeast-1b
	    Group Name:
	    Tenancy: default
	    Private IP:	10.0.0.12
	    Public IP: 46.51.219.63
	    Groups:
		 sg-374b565b --	quick-start-3
	    Root Device	Type: ebs
	    Root Device	Name: /dev/sda1
	    Device mapping:
		 /dev/sda1 vol-9e151bfc	attached 2012-06-28T17:42:05.000Z true
	    Virtualization: hvm
	    Tag	Set:
		 Name=SingleENI
	    Hypervisor:	xen
	    EBS	Optimized:
       End of instance

SEE ALSO
       eclat(1),     eclat-lsiattr(1),	   eclat-reboot(1),    eclat-start(1),
       eclat-stop(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-LSINST(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-lsinst&sektion=1&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help