NAME

       euca-describe-instances - Show information about instances

SYNOPSIS

       euca-describe-instances  [--show-empty-fields]  [--region  USER@REGION  |  -U  URL]  [-I KEY_ID] [-S KEY]
       [--filter NAME=VALUE] [--debug] [--debugger] [--version] [-h] [INSTANCE [INSTANCE ...]]

DESCRIPTION

       Show information about instances

   positional arguments:
       INSTANCE
              limit results to specific instances

   optional arguments:
       --show-empty-fields
              show empty values as "(nil)"

       --region USER@REGION
              name of the region and/or user in config files to use to connect to the service

       -U URL, --url URL
              compute service endpoint URL

       -I KEY_ID, --access-key-id KEY_ID

       -S KEY, --secret-key KEY

       --filter NAME=VALUE
              restrict results to those that meet criteria

       --debug
              show debugging output

       --debugger
              launch interactive debugger on error

       --version
              show the program's version and exit

       -h, --help
              show this help message and exit

   allowed filter names:
       architecture
              CPU architecture association.allocation-id [VPC only] allocation ID bound to a network interface's
              elastic IP address association.association-id [VPC only] association ID returned when  an  elastic
              IP  was  associated with a network interface association.ip-owner-id [VPC only] ID of the owner of
              the elastic IP address associated  with  a  network  interface  association.public-ip  [VPC  only]
              address   of   the   elastic   IP   address   bound   to  a  network  interface  availability-zone
              block-device-mapping.attach-time volume attachment time block-device-mapping.delete-on-termination
              whether a volume is deleted upon instance termination block-device-mapping.device-name

       volume device name (e.g.
              /dev/sdf) block-device-mapping.status volume status block-device-mapping.volume-id volume ID

       client-token
              idempotency token provided at instance run time

       dns-name
              public DNS name

       group-id
              security group ID

       group-name
              security group name

       hypervisor
              hypervisor type

       image-id
              machine image ID

       instance.group-id
              security group ID

       instance.group-name
              security  group  name  instance-id  instance-lifecycle     whether  this  is   a   spot   instance
              instance-state-code   numeric code identifying instance state instance-state-name   instance state
              instance-type  ip-address             public  IP  address  kernel-id              kernel  image ID
              key-name              key pair name provided at instance launch time launch-index           launch
              index   within   a   reservation   launch-time            instance  launch  time  monitoring-state
              monitoring state  ("enabled"  or  "disabled")  network-interface.addresses.association.ip-owner-id
              [VPC  only]  ID  of  the  owner  of  the  private  IP  address associated with a network interface
              network-interface.addresses.association.public-ip [VPC only] ID of the association of  an  elastic
              IP  address with a network interface network-interface.addresses.primary [VPC only] whether the IP
              address   of   the   VPC   network   interface    is    the    primary    private    IP    address
              network-interface.addresses.private-ip-address  [VPC  only] network interface's private IP address
              network-interface.attachment.device-index [VPC only] device index to which a network interface  is
              attached network-interface.attachment.attach-time [VPC only] time a network interface was attached
              to  an  instance network-interface.attachment.attachment-id [VPC only] ID of a network interface's
              attachment  network-interface.attachment.delete-on-termination  [VPC  only]  whether   a   network
              interface      attachment      is      deleted      when     an     instance     is     terminated
              network-interface.attachment.instance-owner-id [VPC only] ID of the instance to  which  a  network
              interface   is   attached   network-interface.attachment.status  [VPC  only]  network  interface's
              attachment status network-interface.availability-zone [VPC only] network interface's  availability
              zone    network-interface.description    [VPC   only]   description   of   a   network   interface
              network-interface.group-id    [VPC    only]    network    interface's    security     group     ID
              network-interface.group-name    [VPC    only]    network    interface's    security   group   name
              network-interface.mac-address    [VPC    only]    network     interface's     hardware     address
              network-interface.network-interface.id     [VPC     only]    ID    of    a    network    interface
              network-interface.owner-id    [VPC    only]    ID    of    a     network     interface's     owner
              network-interface.private-dns-name    [VPC    only]   network   interface's   private   DNS   name
              network-interface.requester-id     [VPC     only]     network     interface's     requester     ID
              network-interface.requester-managed  [VPC  only]  whether  the network interface is managed by the
              service network-interface.source-destination-check [VPC only] whether source/destination  checking
              is  enabled for a network interface network-interface.status [VPC only] network interface's status
              network-interface.subnet-id [VPC only] ID of a network interface's subnet network-interface.vpc-id
              [VPC only] ID of a network interface's VPC

       owner-id
              instance owner's account  ID  placement-group-name  platform               "windows"  for  Windows
              instances  private-dns-name  private-ip-address product-code product-code.type     type of product
              code ("devpay" or "marketplace")

       ramdisk-id
              ramdisk image ID

       reason reason for the instance's current state

       requestor-id
              ID of the entity that launched an instance reservation-id root-device-name      root  device  name
              (e.g.    /dev/sda1)   root-device-type        root   device   type   ("ebs"  or  "instance-store")
              spot-instance-request-id state-reason-code     reason  code  for  the  most  recent  state  change
              state-reason-message  message describing the most recent state change

       subnet-id
              [VPC only] ID of the subnet the instance is in

       tag-key
              name of any tag assigned to the instance

       tag-value
              value of any tag assigned to the instance

       tag:KEY
              specific  tag key/value combination virtualization-type vpc-id                [VPC only] ID of the
              VPC the instance is in

euca2ools 3.0.1                                    August 2013                        EUCA-DESCRIBE-INSTANCES(1)