Collapse AllExpand All

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 ]

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

Common Options

Option Description
--region region Region to direct requests to. Only valid for EC2 endpoints.
-U,--url url URL of the cloud to connect to. Expects an EC2 endpoint /services/Eucalyptus.
-a,--access-key access_key_id User's access key ID
-s,--secret-key secret_key User's secret key
--config configuration_path Read credentials and cloud settings from the specified config file.
Default: $HOME/.eucarc or /etc/euca2ools/eucarc.
--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

  • Output type identifier ("IMAGE")
  • Image ID
  • Manifest path
  • Account ID that registered the image
  • Image status (available, pending, failed)
  • Image visibility (public or private)
  • Product codes, if any, attached to the instance
  • Image architecture (i386 or x86_64)
  • Image type (machine, kernel, or ramdisk)
  • Kernel ID of the kernel (machine images only)
  • RAM ID associated with the image (machine images only)
  • Root device type (ebs or instance-store)
  • Virtualization type (paravirtual or hvm)
  • Output type identifier ("BLOCKDEVICEMAPPING") for EMIs that use one or more EBS volumes
  • Any tags assigned to the image
  • Hypervisor type (xen or kvm)

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