Copyright | (c) 2013-2016 Brendan Hay |
---|---|
License | Mozilla Public License, v. 2.0. |
Maintainer | Brendan Hay <brendan.g.hay@gmail.com> |
Stability | auto-generated |
Portability | non-portable (GHC extensions) |
Safe Haskell | None |
Language | Haskell2010 |
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.
For more information, see Copying AMIs in the Amazon Elastic Compute Cloud User Guide.
- copyImage :: Text -> Text -> Text -> CopyImage
- data CopyImage
- ciClientToken :: Lens' CopyImage (Maybe Text)
- ciEncrypted :: Lens' CopyImage (Maybe Bool)
- ciKMSKeyId :: Lens' CopyImage (Maybe Text)
- ciDescription :: Lens' CopyImage (Maybe Text)
- ciDryRun :: Lens' CopyImage (Maybe Bool)
- ciSourceRegion :: Lens' CopyImage Text
- ciSourceImageId :: Lens' CopyImage Text
- ciName :: Lens' CopyImage Text
- copyImageResponse :: Int -> CopyImageResponse
- data CopyImageResponse
- coprsImageId :: Lens' CopyImageResponse (Maybe Text)
- coprsResponseStatus :: Lens' CopyImageResponse Int
Creating a Request
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:
See: copyImage
smart constructor.
Request Lenses
ciClientToken :: Lens' CopyImage (Maybe Text) Source
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.
ciEncrypted :: Lens' CopyImage (Maybe Bool) Source
Specifies whether the destination snapshots of the copied image should
be encrypted. The default CMK for EBS is used unless a non-default AWS
Key Management Service (AWS KMS) CMK is specified with KmsKeyId
. For
more information, see
Amazon EBS Encryption
in the Amazon Elastic Compute Cloud User Guide.
ciKMSKeyId :: Lens' CopyImage (Maybe Text) Source
The full ARN of the AWS Key Management Service (AWS KMS) CMK to use when
encrypting the snapshots of an image during a copy operation. This
parameter is only required if you want to use a non-default CMK; if this
parameter is not specified, the default CMK for EBS is used. The ARN
contains the 'arn:aws:kms' namespace, followed by the region of the CMK,
the AWS account ID of the CMK owner, the key
namespace, and then the
CMK ID. For example,
arn:aws:kms:us-east-1:012345678910:key/abcd1234-a123-456a-a12b-a123b4cd56ef.
The specified CMK must exist in the region that the snapshot is being
copied to. If a KmsKeyId
is specified, the Encrypted
flag must also
be set.
ciDescription :: Lens' CopyImage (Maybe Text) Source
A description for the new AMI in the destination region.
ciDryRun :: Lens' CopyImage (Maybe Bool) Source
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
.
ciSourceRegion :: Lens' CopyImage Text Source
The name of the region that contains the AMI to copy.
ciSourceImageId :: Lens' CopyImage Text Source
The ID of the AMI to copy.
Destructuring the Response
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:
data CopyImageResponse Source
See: copyImageResponse
smart constructor.
Response Lenses
coprsImageId :: Lens' CopyImageResponse (Maybe Text) Source
The ID of the new AMI.
coprsResponseStatus :: Lens' CopyImageResponse Int Source
The response status code.