| Euca2ools Guide / EC2-Compatible Commands | |
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.
euca-describe-images [-a][-o owner ][-x executable_by ]
[ image ] [[--filter "name=value"] ...]
| 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 |
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 |
| 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. |
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