euca-describe-images man page

euca-describe-images — Show information about images

Synopsis

euca-describe-images [-a] [-o ACCOUNT] [-x ACCOUNT]

[--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 ...]]

Description

Show information about images

Description

By default, only images your account owns and images for which your account has explicit launch permissions are shown.

positional arguments

IMAGE
limit results to specific images

optional arguments

-a, --all
describe all images
-o ACCOUNT, --owner ACCOUNT
describe images owned by the specified owner
-x ACCOUNT, --executable-by ACCOUNT
describe images for which the specified account has explicit launch permissions
--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
block-device-mapping.delete-on-termination
whether a volume is deleted upon instance termination
block-device-mapping.device-name
device name for a volume mapped to the image
block-device-mapping.snapshot-id
snapshot ID for a volume mapped to the image
block-device-mapping.volume-size
volume size for a volume mapped to the image
block-device-mapping.volume-type
volume type for a volume mapped to the image
description
image description
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")
state-reason-code
reason code for the most recent state change
state-reason-message
message for the most recent state change
tag-key
key of a tag assigned to the image
tag-value
value of a tag assigned to the image
tag:KEY
specific tag key/value combination
virtualization-type
virtualization type ("paravirtual" or "hvm")

Info

October 2015 euca2ools 3.3.0 User Commands