RegisterImage
The RegisterImage operation registers an
AMI with Amazon EC2. Images must be registered before they can be
launched. For more information, see
RunInstances.
Each AMI is associated with an unique ID which is provided by
the Amazon EC2 service through the RegisterImage
operation. During registration, Amazon EC2 retrieves the specified
image manifest from Amazon S3 and verifies that the image is owned
by the user registering the image.
The image manifest is retrieved once and stored within the Amazon EC2. Any modifications to an image in Amazon S3 invalidates this registration. If you make changes to an image, deregister the previous image and register the new image. For more information, see DeregisterImage.
Request Parameters
The following table describes the request parameters for
RegisterImage. Parameter names are case
sensitive.
| Name | Description | Required |
|---|---|---|
|
|
Full path to your AMI manifest in Amazon S3 storage. Type: String |
Yes |
Response Elements
The following table describes the default response tags included
in RegisterImage responses.
| Name | Description |
|---|---|
|
|
Unique ID of the newly registered machine image. Type: xsd:string |
Sample Request
https://ec2.amazonaws.com/ ?Action=RegisterImage &ImageLocation=mybucket-myimage.manifest.xml &...auth parameters...
Sample Response
<RegisterImageResponse xmlns="http://ec2.amazonaws.com/doc/2008-08-08"> <imageId>ami-61a54008</imageId> </RegisterImageResponse>