euca-describe-images(1)
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")