Cloud Application Architectures

Name

ec2-describe-images

Synopsis

ec2-describe-images [imageid1 [...imageidN]] [-a] [-o ownerid] [-x ownerid]

Describes the information associated with a specific image ID or any images that match the specified parameters. If you specify no parameters at all, the command will list out all images owned by your account.

Specific options include:

-a

Lists AMIs for which the user has execution rights.

-o ownerid

Lists AMIs belonging to the specified owner or owners. You may also use the special owner IDs: amazon (for public images), self (referring to your own images), and explicit (referring to the images for which you have launch permissions).

-x ownerid

Lists AMIs for which the specified owner or owners have launch permissions. In addition to a standard owner ID, you can specify self to access those images for which you have launch permissions or all to specify AMIs with public launch permissions.

A particularly useful variant for finding an image to get started with is:

ec2-describe-images -o amazon

Examples

# SHOW ALL OWNER IMAGES
$ ec2-describe-images
IMAGE  ami-f822a39b  myami/myami.manifest.xml  999999999999  available  private  
zz95xy  i386  machine    aki-a71cf9ce    ari-a51cf9cc

# SHOW IMAGES FOR A SPECIFIC USER
$ ec2-describe-images -o 063491364108 IMAGE ami-48de3b21 level22-ec2-images-64/ubuntu-7.10-gutsy-base- 64-20071203a.manifest.xml 063491364108 available public x86_64 machine IMAGE ami-dd22c7b4 level22-ec2-images-64/ubuntu-7.10-gutsy-base- 64-20071227a.manifest.xml 063491364108 available public ...