C# Class Amazon.EC2.Model.RegisterImageRequest

Container for the parameters to the RegisterImage operation. Registers an AMI. When you're creating an AMI, this is the final step you must complete before you can launch an instance from the AMI. For more information about creating AMIs, see Creating Your Own AMIs in the Amazon Elastic Compute Cloud User Guide.

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.

Inheritance: AmazonEC2Request
Show file Open project: aws/aws-sdk-net Class Usage Examples

Public Methods

Method Description
RegisterImageRequest ( ) : System

Empty constructor used to set properties independently even when a simple constructor is available

RegisterImageRequest ( string imageLocation ) : System

Instantiates RegisterImageRequest with the parameterized properties

Private Methods

Method Description
IsSetArchitecture ( ) : bool
IsSetBlockDeviceMappings ( ) : bool
IsSetDescription ( ) : bool
IsSetEnaSupport ( ) : bool
IsSetImageLocation ( ) : bool
IsSetKernelId ( ) : bool
IsSetName ( ) : bool
IsSetRamdiskId ( ) : bool
IsSetRootDeviceName ( ) : bool
IsSetSriovNetSupport ( ) : bool
IsSetVirtualizationType ( ) : bool

Method Details

RegisterImageRequest() public method

Empty constructor used to set properties independently even when a simple constructor is available
public RegisterImageRequest ( ) : System
return System

RegisterImageRequest() public method

Instantiates RegisterImageRequest with the parameterized properties
public RegisterImageRequest ( string imageLocation ) : System
imageLocation string The full path to your AMI manifest in Amazon S3 storage.
return System