The RegisterImage operation registers an
AMI with Amazon EC2. Images must be registered before they can be
launched.
Each AMI is associated with an unique ID which is provided by the EC2 service via the Registerimage operation. As part of the registration process, Amazon EC2 will retrieve the specified image manifest from Amazon S3 and verify that the image is owned by the user requesting image registration.
The image manifest is retrieved once and stored within the Amazon EC2 network. Any modifications to an image in Amazon S3 invalidate this registration. If you do have to make changes and upload a new image deregister the previous image and register the new image.
The following table describes the request parameters for
RegisterImage. Parameter names are case
sensitive.
| Element Name | Definition | Required? | Type |
|---|---|---|---|
imageLocation
| Full path to your AMI manifest in Amazon S3 storage. | Yes | xsd:string |
The following table describes the default response tags included
in RegisterImage responses.
| Element Name | Definition | Type |
|---|---|---|
imageId
| Unique ID of the newly registered machine image. | xsd:string |
<RegisterImage xmlns="http://ec2.amazonaws.com/doc/2007-01-19"> <imageLocation>/mybucket/myimage.manifest.xml</imageLocation> </RegisterImage>
<RegisterImageResponse xmlns="http://ec2.amazonaws.com/doc/2007-01-19"> <imageId>ami-61a54008</imageId> </RegisterImageResponse>