amazonka-ec2-0.2.1: Amazon Elastic Compute Cloud SDK.

Safe HaskellNone
LanguageHaskell2010

Network.AWS.EC2.RegisterImage

Contents

Description

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 AmazonElastic Compute Cloud User Guide for Linux.

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 AMI from a snapshot of a root device volume. For more information, see Launching anInstance from a Snapshot in the Amazon Elastic Compute Cloud User Guide forLinux.

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.

http://docs.aws.amazon.com/AWSEC2/latest/APIReference/ApiReference-query-RegisterImage.html

Synopsis

Request

Request constructor

Request lenses

ri1Architecture :: Lens' RegisterImage (Maybe ArchitectureValues) Source

The architecture of the AMI.

Default: For Amazon EBS-backed AMIs, i386. For instance store-backed AMIs, the architecture specified in the manifest file.

ri1BlockDeviceMappings :: Lens' RegisterImage [BlockDeviceMapping] Source

One or more block device mapping entries.

ri1Description :: Lens' RegisterImage (Maybe Text) Source

A description for your AMI.

ri1ImageLocation :: Lens' RegisterImage (Maybe Text) Source

The full path to your AMI manifest in Amazon S3 storage.

ri1KernelId :: Lens' RegisterImage (Maybe Text) Source

The ID of the kernel.

ri1Name :: Lens' RegisterImage Text Source

A name for your AMI.

Constraints: 3-128 alphanumeric characters, parentheses (()), square brackets ([]), spaces ( ), periods (.), slashes (/), dashes (-), single quotes ('), at-signs (@), or underscores(_)

ri1RamdiskId :: Lens' RegisterImage (Maybe Text) Source

The ID of the RAM disk.

ri1RootDeviceName :: Lens' RegisterImage (Maybe Text) Source

The name of the root device (for example, '/dev/sda1', or xvda).

ri1SriovNetSupport :: Lens' RegisterImage (Maybe Text) Source

Set to simple to enable enhanced networking for the AMI and any instances that you launch from the AMI.

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.

ri1VirtualizationType :: Lens' RegisterImage (Maybe Text) Source

The type of virtualization.

Default: paravirtual

Response

Response constructor

registerImageResponse :: RegisterImageResponse Source

RegisterImageResponse constructor.

The fields accessible through corresponding lenses are:

Response lenses

rirImageId :: Lens' RegisterImageResponse (Maybe Text) Source

The ID of the newly registered AMI.