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.
Inheritance Hierarchy
Namespace: Amazon.EC2.Model
Assembly: AWSSDK.dll
Version: 2.0.0.3
Syntax
public class RegisterImageRequest : AmazonWebServiceRequest IRequestEvents
The RegisterImageRequest type exposes the following members
Constructors
| Name | Description | |
|---|---|---|
|
RegisterImageRequest() |
Properties
| Name | Description | |
|---|---|---|
|
|
Architecture |
The architecture of the image. Valid Values: |
|
|
BlockDeviceMappings | The block device mappings for the new AMI, which specify how different block devices (ex: EBS volumes and ephemeral drives) will be exposed on instances launched from the new image. |
|
|
Description | The description describing the new AMI. |
|
|
ImageLocation | The full path to your AMI manifest in Amazon S3 storage. |
|
|
KernelId | The optional ID of a specific kernel to register with the new AMI. |
|
|
Name |
The name to give the new Amazon Machine Image. Constraints: 3-128 alphanumeric characters, parenthesis ( |
|
|
RamdiskId | The optional ID of a specific ramdisk to register with the new AMI. Some kernels require additional drivers at launch. Check the kernel requirements for information on whether you need to specify a RAM disk. |
|
|
RootDeviceName |
The root device name (e.g., |
Version Information
.NET Framework:
Supported in: 4.5, 4.0, 3.5
.NET for Windows Store apps:
Supported in: Windows 8
.NET for Windows Phone:
Supported in: Window Phone 8
