RegisterImage
Description
Registers an AMI with Amazon EC2. Images must be registered before they can be launched. To launch instances, use the RunInstances operation.
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. To deregister an image, use the DeregisterImage operation.
Request Parameters
| Name | Description | Required |
|---|---|---|
| Full path to your AMI manifest in Amazon S3 storage. Type: String Default: None | Yes |
Response Elements
| Name | Description |
|---|---|
|
Type: |
Ancestor: None
Children: requestId, imageId
requestId
The ID of the request.
Type: xsd:string
Ancestor: RegisterImageResponse
Children: None
imageId
Unique ID of the newly registered machine image.
Type: xsd:string
Ancestor: RegisterImageResponse
Children: None
Examples
Example Request
This example registers the AMI specified in the image.manifest.xml manifest file.
https://ec2.amazonaws.com/?Action=RegisterImage&ImageLocation=mybucket-myimage.manifest.xml&AuthParams
Example Response
<RegisterImageResponse xmlns="http://ec2.amazonaws.com/doc/2009-04-04/"> <imageId>ami-61a54008</imageId> </RegisterImageResponse>