.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.47.3.
.TH EUCA-DESCRIBE-IMAGES "1" "March 2016" "euca2ools 3.3" "User Commands"
.SH NAME
euca-describe-images \- Show information about images
.SH SYNOPSIS
euca\-describe\-images [\-a] [\-o ACCOUNT] [\-x ACCOUNT]
.TP
[\-\-show\-empty\-fields] [\-U URL]
[\-\-region USER@REGION] [\-I KEY_ID] [\-S KEY]
[\-\-security\-token TOKEN] [\-\-filter NAME=VALUE]
[\-\-debug] [\-\-debugger] [\-\-version] [\-h]
[IMAGE [IMAGE ...]]
.SH DESCRIPTION
Show information about images
.SH DESCRIPTION
By default, only images your account owns and images for which your
account has explicit launch permissions are shown.
.SS "positional arguments:"
.TP
IMAGE
limit results to specific images
.SS "optional arguments:"
.TP
\fB\-a\fR, \fB\-\-all\fR
describe all images
.TP
\fB\-o\fR ACCOUNT, \fB\-\-owner\fR ACCOUNT
describe images owned by the specified owner
.TP
\fB\-x\fR ACCOUNT, \fB\-\-executable\-by\fR ACCOUNT
describe images for which the specified account has
explicit launch permissions
.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
block\-device\-mapping.delete\-on\-termination
whether a volume is deleted upon instance
termination
.TP
block\-device\-mapping.device\-name
device name for a volume mapped to the image
.TP
block\-device\-mapping.snapshot\-id
snapshot ID for a volume mapped to the image
.TP
block\-device\-mapping.volume\-size
volume size for a volume mapped to the image
.TP
block\-device\-mapping.volume\-type
volume type for a volume mapped to the image
.TP
description
image description
.TP
hypervisor
image's hypervisor type
image\-id
image\-type            image type ("machine", "kernel", or "ramdisk")
is\-public             whether the image is public
kernel\-id
manifest\-location
name
owner\-alias           image owner's account alias
owner\-id              image owner's account ID
platform              "windows" for Windows images
product\-code          product code associated with the image
product\-code.type     type of product code associated with the image
("devpay", "marketplace")
ramdisk\-id
root\-device\-name
root\-device\-type      root device type ("ebs" or "instance\-store")
state                 image state ("available", "pending", or
"failed")
.TP
state\-reason\-code
reason code for the most recent state change
.TP
state\-reason\-message
message for the most recent state change
.TP
tag\-key
key of a tag assigned to the image
.TP
tag\-value
value of a tag assigned to the image
.TP
tag:KEY
specific tag key/value combination
.TP
virtualization\-type
virtualization type ("paravirtual" or "hvm")