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 instances

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: pending,
	    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  multi-
	    ple 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 in-
	    stance or a group of instances is launched.   Depending  on  this  a
	    single  reservation ID can correspond to a single or to multiple in-
	    stances.

     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 filter 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/destination
	    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 inter-
	    face.

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

     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 attached.

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

     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,  at-
	    tached, detaching, detached.

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

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

     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  network
	    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 in-
	    terface.

     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 In-
     stance: 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-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-LSINST(1)

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

home | help