.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.47.3.
.TH EUCA-DESCRIBE-INSTANCES "1" "March 2016" "euca2ools 3.3" "User Commands"
.SH NAME
euca-describe-instances \- Show information about instances
.SH SYNOPSIS
euca\-describe\-instances [\-\-show\-empty\-fields] [\-U URL]
.TP
[\-\-region USER@REGION] [\-I KEY_ID] [\-S KEY]
[\-\-security\-token TOKEN] [\-\-filter NAME=VALUE]
[\-\-debug] [\-\-debugger] [\-\-version] [\-h]
[INSTANCE [INSTANCE ...]]
.SH DESCRIPTION
Show information about instances
.SS "positional arguments:"
.TP
INSTANCE
limit results to specific instances
.SS "optional arguments:"
.TP
\fB\-\-show\-empty\-fields\fR
show empty values as "(nil)"
.TP
\fB\-U\fR URL, \fB\-\-url\fR URL
compute service endpoint URL
.TP
\fB\-\-region\fR USER@REGION
region and/or user names to search when looking up
config file data
.HP
\fB\-I\fR KEY_ID, \fB\-\-access\-key\-id\fR KEY_ID
.HP
\fB\-S\fR KEY, \fB\-\-secret\-key\fR KEY
.HP
\fB\-\-security\-token\fR TOKEN
.TP
\fB\-\-filter\fR NAME=VALUE
restrict results to those that meet criteria
.TP
\fB\-\-debug\fR
show debugging output
.TP
\fB\-\-debugger\fR
launch interactive debugger on error
.TP
\fB\-\-version\fR
show the program's version and exit
.TP
\fB\-h\fR, \fB\-\-help\fR
show this help message and exit
.SS "allowed filter names:"
.TP
architecture
CPU architecture
.TP
association.allocation\-id
[VPC only] allocation ID bound to a network
interface's elastic IP address
.TP
association.association\-id
[VPC only] association ID returned when an
elastic IP was associated with a network
interface
.TP
association.ip\-owner\-id
[VPC only] ID of the owner of the elastic IP
address associated with a network interface
.TP
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
.TP
block\-device\-mapping.delete\-on\-termination
whether a volume is deleted upon instance
termination
.TP
block\-device\-mapping.device\-name
volume device name (e.g.  \fI\,/dev/sdf\/\fP)
.TP
block\-device\-mapping.status
volume status
.TP
block\-device\-mapping.volume\-id
volume ID
.TP
client\-token
idempotency token provided at instance run
time
.TP
dns\-name
public DNS name
.TP
group\-id
security group ID
.TP
group\-name
security group name
.TP
hypervisor
hypervisor type
.TP
iam\-instance\-profile.arn
ARN of the instance's instance profile
.TP
image\-id
machine image ID
.TP
instance.group\-id
security group ID
.TP
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
.TP
[VPC only] ID of the owner of the private IP
address associated with a network interface
.TP
network\-interface.addresses.association.public\-ip
[VPC only] ID of the association of an elastic
IP address with a network interface
.TP
network\-interface.addresses.primary
[VPC only] whether the IP address of the VPC
network interface is the primary private IP
address ("true" or "false")
.TP
network\-interface.addresses.private\-ip\-address
[VPC only] network interface's private IP
address
.TP
network\-interface.attachment.device\-index
[VPC only] device index to which a network
interface is attached
.TP
network\-interface.attachment.attach\-time
[VPC only] time a network interface was
attached to an instance
.TP
network\-interface.attachment.attachment\-id
[VPC only] ID of a network interface's
attachment
.TP
network\-interface.attachment.delete\-on\-termination
[VPC only] whether a network interface
attachment is deleted when an instance is
terminated ("true" or "false")
.TP
network\-interface.attachment.instance\-owner\-id
[VPC only] ID of the instance to which a
network interface is attached
.TP
network\-interface.attachment.status
[VPC only] network interface's attachment
status
.TP
network\-interface.availability\-zone
[VPC only] network interface's availability
zone
.TP
network\-interface.description
[VPC only] description of a network interface
.TP
network\-interface.group\-id
[VPC only] network interface's security group
ID
.TP
network\-interface.group\-name
[VPC only] network interface's security group
name
.TP
network\-interface.mac\-address
[VPC only] network interface's hardware
address
.TP
network\-interface.network\-interface.id
[VPC only] ID of a network interface
.TP
network\-interface.owner\-id
[VPC only] ID of a network interface's owner
.TP
network\-interface.private\-dns\-name
[VPC only] network interface's private DNS
name
.TP
network\-interface.requester\-id
[VPC only] network interface's requester ID
.TP
network\-interface.requester\-managed
[VPC only] whether the network interface is
managed by the service
.TP
network\-interface.source\-destination\-check
[VPC only] whether source/destination checking
is enabled for a network interface ("true" or
"false")
.TP
network\-interface.status
[VPC only] network interface's status
.TP
network\-interface.subnet\-id
[VPC only] ID of a network interface's subnet
.TP
network\-interface.vpc\-id
[VPC only] ID of a network interface's VPC
.TP
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")
.TP
ramdisk\-id
ramdisk image ID
.TP
reason
reason for the instance's current state
.TP
requester\-id
ID of the entity that launched an instance
.TP
reservation\-id
ID of the instance's reservation
.TP
root\-device\-name
root device name (e.g.  \fI\,/dev/sda1\/\fP)
.TP
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
.TP
subnet\-id
[VPC only] ID of the subnet the instance is in
.TP
tag\-key
name of any tag assigned to the instance
.TP
tag\-value
value of any tag assigned to the instance
.TP
tag:KEY
specific tag key/value combination
virtualization\-type
vpc\-id                [VPC only] ID of the VPC the instance is in