euca-describe-images (1)

euca-describe-images [-a] [-o ACCOUNT] [-x ACCOUNT] [--show-empty-fields] [--region USER@REGION | -U URL] [-I KEY_ID] [-S KEY] [--filter NAME=VALUE] [--debug] [--debugger] [--version] [-h] [IMAGE [IMAGE ...]]

Show information about images

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)"

--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 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 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")