Registers an AMI with Amazon EC2.
Declaration Syntax
C# |
RegisterImageResponse RegisterImage( RegisterImageRequest request )
Parameters
- request (RegisterImageRequest)
- Register Image request
Return Value
Register Image Response from the service
Remarks
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.
Exceptions
Exception | Condition |
---|---|
WebException | |
AmazonEC2Exception |