euca-describe-images

Shows information about an image you own, or an image you have been given permission ot execute, or a public image owned by someone else.

Syntax

euca-describe-images  [-a][-o owner ][-x executable_by ]
      [ image ] [[--filter "name=value"] ...]

Options

Option Description Required
image Image ID to describe No
-a, --all Describe all Eucalyptus machine images (EMIs) No
-o, --owner owner Returns EMIs owned by the specified owner.

Valid values: self | Account ID

No
-x, --executable-by user_id Returns EMIs the specified user ID has launch permissions for No
-F, --filter name=value Filter for limiting the results. See the table in the Available Filters section for a list of filters. Use quotation marks if the value has a space ("name=value example"). On a Windows system, use quotation marks even without a space in the value ("name=value"). No

Available Filters

You can add filters to your request so that the response includes information for only certain images. For example, you can use a filter to specify that you want to find images that use a specific kernel. Some tips for using filters with this command:

The following are the available filters for euca-describe-images:

Filter Description
architecture Image architecture.

Valid values: i386 | x86_64

block-device-mapping​.delete-on-termination Whether the EBS volume is deleted on instance termination.
block-device-mapping​.device-name Device name (for example, /dev/sdh) for an EBS volume mapped to the image.
block-device-mapping​.snapshot-id Snapshot ID for an EBS volume mapped to the image.
block-device-mapping​.volume-size Volume size for an EBS volume mapped to the image.
block-device-mapping​.volume-type Volume type for an EBS volume mapped to the image.

Valid values: standard | io1

description Description of the EMI
hypervisor Hypervisor type of the image.

Valid values: ovm | xen

image-id ID of the image
image-type Type of the image.

Valid values: machine | kernel | ramdisk

is-public Whether the image is public

Valid values: true | false

kernel-id Kernel ID
manifest-location Path to the image manifest
name Name of the EMI
owner-alias Account alias (for example, eucalyptus or self)
owner-id Eucalyptus account ID of the image owner
platform Enter windows if you have Windows-based EMIs. Otherwise leave blank.
product-code Product code associated with the EMI
ramdisk-id ID of the ramdisk
root-device-name Root device name of the EMI (for example, /dev/sda1)
root-device-type Root device type the EMI uses.

Valid Values: ebs | instance-store

state State of the image.

Valid values: available | pending | failed

tag-key Key of a tag assigned to the resource you want to filter. This filter is independent of the tag-value filter and returns all resources assigned the tag key you use, regardless of the value. To filter on a specific key and value set, use the tag:key filter.
tag-value Value of a tag assigned to the resource. This filter is independent of the tag-key filter and returns all resources assigned the tag value you use, regardless of the key. To filter on a specific key and value set, use the tag:key filter.
tag:key Filters the results based on a specific tag/value combination

Common Options

Option Description
--show-empty-fields Show empty fields as "(nil)".
--region user@region Region and/or user name to search when looking up config file data. Only valid for EC2 endpoints.
-U,--url url URL of the cloud service to connect to. For administrative commands, this should be <ip_address>:8773/services/Empyrean.
-I,--access-key-id key_id User's access key ID.
-S,--secret-key secret_key User's secret key.
--security-token token User's security token.
--debug Prints what the command sends to the server and what it receives from the server. Use when you're trying to debug Euca2ools.
--debugger Enable interactive debugger on error.
-h,--help Display the manual page for the command.
--version Display the version of this tool.

Output

Example

euca-describe-images
IMAGE   eki-3E5B3B31
mah-bukkit/vmlinuz-2.6.28-11-generic.manifest.xml  000000000001
available   public      x86_64  kernel          instance-store
IMAGE   emi-815A395B    mah-bukkit/ubuntu.9-04.x86-64.img.manifest.xml
790547641019    available   public      x86_64  machine eki-3E5B3B31
 eri-32B338DC    instance-store
IMAGE   eri-32B338DC
mah-bukkit/initrd.img-2.6.28-11-generic.manifest.xml   000000000001
available   public      x86_64  ramdisk         instance-store
x