---
name: "euca-describe-instances"
section: "1"
platform: "linux"
package: "euca2ools"
version: "3.3.1-2"
release: "Debian 10 (Buster)"
platforms: ["linux"]
url: "https://new.carta.tech/euca-describe-instances"
---

# euca-describe-instances(1)

Show information about instances

## NAME

euca-describe-instances - Show information about instances

## SYNOPSIS

euca-describe-instances \[--show-empty-fields\] \[-U URL\]

- \[--region USER@REGION\] \[-I KEY\_ID\] \[-S KEY\]

  \[--security-token TOKEN\] \[--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)"

- **-U** URL, **--url** URL

  compute service endpoint URL

- **--region** USER@REGION

  region and/or user names to search when looking up config file data

**-I** KEY\_ID, **--access-key-id** KEY\_ID

**-S** KEY, **--secret-key** KEY

**--security-token** TOKEN

- **--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

- iam-instance-profile.arn

  ARN of the instance's instance profile

- 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 ("true" or "false")

- 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 ("true" or "false")

- 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 ("true" or "false")

- 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

- requester-id

  ID of the entity that launched an instance

- reservation-id

  ID of the instance's reservation

- 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