Related Operations
DescribeImages
DeregisterImage
DescribeImages
The DescribeImages operation returns information about AMIs available for use by the user making
the request. This includes both public AMIs (those available for any user to launch) and private images
(those available for launch by the image owner only).
An optional list of AMI IDs may be provided to request information for those AMIs only. If no AMI IDs
are provided, information of all relevant AMIs will be returned. If an image is specified that does not
exist a fault is returned. If an image is specified that exists but is not owned by the user making the
request, then that image will not be included in the returned results.
Deregistered images will be included in the returned results for an unspecified interval subsequent to
deregistration.
Request Parameters
The following table describes the request parameters for DescribeImages. Parameter names are case
sensitive.
Element Name Definition Re-
quired?
Type
imageSet AMI IDs to describe. Yes (but
may be
empty)
xsd:string[]
Response Tags
The following table describes the default response tags included in DescribeImages responses.
Element Name Definition
imagesSet A list of image descriptions
Sample Request
<DescribeImages xmlns="http://ec2.amazonaws.com/doc/2006-06-26">
<imagesSet>
<item>
<imageId>ami-61a54008</imageId>
</item>
</imagesSet>
</DescribeImages></SOAP-ENV:Body></SOAP-ENV:Envelope>
Sample Response
Amazon EC2
Developer Guide
57
<DescribeImagesResponse xmlns="http://ec2.amazonaws.com/doc/2006-06-26">
<imagesSet>
<item>
<imageId>ami-61a54008</imageId>
<imageLocation>aes-ttylinux/image.manifest</imageLocation>
<imageState>available</imageState>
<imageOwnerId>UYY3TLBUXIEON5NQVUUX6OMPWBZIQNFM</imageOwnerId>
<isPublic>false</isPublic>
</item>
</imagesSet>
</DescribeImagesResponse>
Related Operations
DescribeInstances
DeregisterImage
The DeregisterImage operation deregisters an AMI. Once deregistered, instances of the AMI may no
longer be launched.
Request Parameters
The following table describes the request parameters for DeregisterImage. Parameter names are case
sensitive.
Element Name Definition Re-
quired?
Type
imageId Unique ID of a machine image, returned
by a call to RegisterImage or De-
scribeImages.
Yes xsd:string
Response Tags
The following table describes the default response tags included in DeregisterImage responses.
Element Name Definition
return true if deregistration succeeded, otherwise false.
Sample Request
<DeregisterImage xmlns="http://ec2.amazonaws.com/doc/2006-06-26">
<imageId>ami-61a54008</imageId>
</DeregisterImage>
Sample Response
<DeregisterImageResponse xmlns="http://ec2.amazonaws.com/doc/2006-06-26">
<return>true</return>
Amazon EC2
Developer Guide
58
Previous Page Next Page