AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.
For Amazon EBS-backed instances, CreateImage creates and registers the AMI in a single request, so you don't have to register the AMI yourself.
You can also use RegisterImage
to create an Amazon EBS-backed Linux AMI
from a snapshot of a root device volume. For more information, see Launching
an Instance from a Snapshot in the Amazon Elastic Compute Cloud User Guide.
Some Linux distributions, such as Red Hat Enterprise Linux (RHEL) and SUSE Linux Enterprise
Server (SLES), use the EC2 billingProduct
code associated with an AMI
to verify subscription status for package updates. Creating an AMI from an EBS snapshot
does not maintain this billing code, and subsequent instances launched from such an
AMI will not be able to connect to package update infrastructure.
Similarly, although you can create a Windows AMI from a snapshot, you can't successfully launch an instance from the AMI.
To create Windows AMIs or to create AMIs for Linux operating systems that must retain AMI billing codes to work properly, see CreateImage.
If needed, you can deregister an AMI at any time. Any modifications you make to an AMI backed by an instance store volume invalidates its registration. If you make changes to an image, deregister the previous image and register the new image.
You can't register an image where a secondary (non-root) snapshot has AWS Marketplace product codes.
Namespace: Amazon.EC2.Model
Assembly: AWSSDK.dll
Version: (assembly version)
public class RegisterImageRequest : AmazonEC2Request IRequestEvents
The RegisterImageRequest type exposes the following members
Name | Description | |
---|---|---|
RegisterImageRequest() | Empty constructor used to set properties independently even when a simple constructor is available | |
RegisterImageRequest(string) | Instantiates RegisterImageRequest with the parameterized properties |
Name | Type | Description | |
---|---|---|---|
Architecture | Amazon.EC2.ArchitectureValues |
Gets and sets the property Architecture.
The architecture of the AMI.
Default: For Amazon EBS-backed AMIs, |
|
BlockDeviceMappings | System.Collections.Generic.List<Amazon.EC2.Model.BlockDeviceMapping> |
Gets and sets the property BlockDeviceMappings.
One or more block device mapping entries. |
|
Description | System.String |
Gets and sets the property Description.
A description for your AMI. |
|
ImageLocation | System.String |
Gets and sets the property ImageLocation.
The full path to your AMI manifest in Amazon S3 storage. |
|
KernelId | System.String |
Gets and sets the property KernelId.
The ID of the kernel. |
|
Name | System.String |
Gets and sets the property Name.
A name for your AMI. Constraints: 3-128 alphanumeric characters, parentheses (()), square brackets ([]), spaces ( ), periods (.), slashes (/), dashes (-), single quotes ('), at-signs (@), or underscores(_) |
|
RamdiskId | System.String |
Gets and sets the property RamdiskId.
The ID of the RAM disk. |
|
RootDeviceName | System.String |
Gets and sets the property RootDeviceName.
The name of the root device (for example, |
|
SriovNetSupport | System.String |
Gets and sets the property SriovNetSupport.
Set to There is no way to disable enhanced networking at this time. This option is supported only for HVM AMIs. Specifying this option with a PV AMI can make instances launched from the AMI unreachable. |
|
VirtualizationType | System.String |
Gets and sets the property VirtualizationType.
The type of virtualization.
Default: |
.NET Framework:
Supported in: 4.5, 4.0, 3.5
.NET for Windows Store apps:
Supported in: Windows 8.1, Windows 8
.NET for Windows Phone:
Supported in: Windows Phone 8.1, Windows Phone 8