SOAP
Fault-
Code/
Error-
Code
Definition Notes
Cli-
ent.Inva
lidPara-
meterCom
bination
RunInstances was called with min-
Count and maxCount set to 0 or min-
Count > maxCount.
Serv-
er.Inter
nalError
Internal Error. Should not occur. Please let us know. Try to re-
produce.
Serv-
er.Insuf
ficientI
nstance-
Capacity
Not enough available instances to
satify your minimum request.
You can lower your request or wait for additional
capacity to become available.
Serv-
er.Unava
ilable
Indicates the server is overloaded
and cannot handle request.
Amazon EC2
Developer Guide
55
Operations
The Amazon EC2 API consists of web service operations for every task the service can perform. This
section describes each operation in detail.
RegisterImage
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.
Request Parameters
The following table describes the request parameters for RegisterImage. Parameter names are case
sensitive.
Element Name Definition Re-
quired?
Type
imageLocation Full path to your AMI manifest in
Amazon S3 storage.
Yes xsd:string
Response Tags
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
Sample Request
<RegisterImage xmlns="http://ec2.amazonaws.com/doc/2006-06-26">
<imageLocation>/mybucket/myimage.manifest</imageLocation>
</RegisterImage>
Sample Response
<RegisterImageResponse xmlns="http://ec2.amazonaws.com/doc/2006-06-26">
<imageId>ami-61a54008</imageId>
</RegisterImageResponse>
Amazon EC2
Developer Guide
56
Previous Page Next Page