ec2-describe-images

Prev		Next

SYNOPSIS

ec2-describe-images[AMI ...] [-a] [-o OWNER ...] [-x USER]

DESCRIPTION

Describes the current state of each AMI specified on the command line. If no AMIs are explicitly listed then the AMIs described can be controlled with the optional parameters. If no optional parameters are specified all AMIs that the user owns or has explicit launch permissions for are displayed.

Note:

The default behaviour of ec2-describe-images has changed from version 2006-06-26 to version 2006-10-01. In the 2006-06-26 version all images the user has access to, including public images, are returned. In the 2006-10-01 version only images the user owns or has explicit access to are returned. Public images are not returned.

OUTPUT

A table containing the following information is returned:

A record type identifier ("IMAGE")
image identifier
manifest location
user identifier of the user that registered the image
image status
public or private indicating whether or not the image is visible to all users

Errors are displayed on stderr.

OPTIONS

Option	Definition	Required?	Example
`-a`	All AMIs the user owns and has execution permissions for, both public and explicit are returned.	No	-a
`-o OWNER`	AMIs owned by the specified owner are returned. Multiple owners may be specified. OWNER is an AWS account id or one of the following special values: `amazon` Include AMIs owned by Amazon in the result set. `self` Include AMIs owned by the caller in the result set.	No	-o 123456789012
`-x USER`	Returns AMIs owned by the caller which the specified user has launch permissions for. Multiple users may be specified. USER is an AWS account id or one of the following special values: `all` Include public AMIs in the result set. `self` Include AMIs the caller has explicit launch permissions for in the result set.	No	-x self

EXAMPLE

$ ec2-describe-images ami-78a54011
IMAGE ami-78a54011 powerdns/image.manifest.xml 495219933132 available private