Network.AWS.EC2.CopyImage

Initiates the copy of an AMI from the specified source region to the current region. You specify the destination region by using its endpoint when making the request. AMIs that use encrypted EBS snapshots cannot be copied with this method.

For more information, see Copying AMIs in the Amazon Elastic Compute Cloud User Guide.

See: AWS API Reference for CopyImage.

Creating a Request

copyImage

Arguments

:: Text

ciSourceRegion

-> Text

ciSourceImageId

-> Text

ciName

-> CopyImage

Creates a value of CopyImage with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• ciClientToken
• ciDryRun
• ciDescription
• ciSourceRegion
• ciSourceImageId
• ciName

data CopyImage

See: copyImage smart constructor.

Instances

Eq CopyImage

Data CopyImage

Read CopyImage

Show CopyImage

Generic CopyImage

AWSRequest CopyImage

ToPath CopyImage

ToHeaders CopyImage

ToQuery CopyImage

Typeable * CopyImage

type Rep CopyImage

type Sv CopyImage = EC2

type Rs CopyImage = CopyImageResponse

Request Lenses

ciClientToken :: Lens' CopyImage (Maybe Text)

Unique, case-sensitive identifier you provide to ensure idempotency of the request. For more information, see How to Ensure Idempotency in the Amazon Elastic Compute Cloud User Guide.

ciDryRun :: Lens' CopyImage (Maybe Bool)

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

ciDescription :: Lens' CopyImage (Maybe Text)

A description for the new AMI in the destination region.

ciSourceRegion :: Lens' CopyImage Text

The name of the region that contains the AMI to copy.

ciSourceImageId :: Lens' CopyImage Text

The ID of the AMI to copy.

ciName :: Lens' CopyImage Text

The name of the new AMI in the destination region.

Destructuring the Response

copyImageResponse

Arguments

:: Int

coprsStatus

-> CopyImageResponse

Creates a value of CopyImageResponse with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• coprsImageId
• coprsStatus

data CopyImageResponse

See: copyImageResponse smart constructor.

Instances

Eq CopyImageResponse

Data CopyImageResponse

Read CopyImageResponse

Show CopyImageResponse

Generic CopyImageResponse

Typeable * CopyImageResponse

type Rep CopyImageResponse

Response Lenses

coprsImageId :: Lens' CopyImageResponse (Maybe Text)

The ID of the new AMI.

coprsStatus :: Lens' CopyImageResponse Int

The response status code.