Download Amazon Elastic Compute Cloud Developer Guide API

Amazon Elastic Compute Cloud Developer Guide
ec2-describe-images
•
•
•
•
DescribeImageAttribute
ec2-modify-image-attribute
ec2-reset-image-attribute
Sharing AMIs
ec2-describe-images
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,
the AMIs described can be controlled with the optional parameters. If no optional parameters are
specified, it returns all AMIs owned by the user, AMIs for which the user has explicit launch
permissions, public AMIs, and Amazon-owned AMIs.
Note
The default behaviour of ec2-describe-images changed from version 2006-06-26 to
version 2006-10-01. In the 2006-06-26 version all images to which the user has access,
including public images, are returned. In the version 2006-10-01 and later, only images
which the user owns or has explicit access 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
product codes, if any are attached the instance
Errors are displayed on stderr.
Options
Option
Definition
Required?
-a
All AMIs the user owns and has exeNo
cution permissions for, both public and
explicit are returned.
-a
-o OWNER
AMIs owned by the specified owner
are returned. Multiple owners may be
specified. OWNER is a AWS user ac-
-o 123456789012
API Version 2007-03-01
130
No
Example