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:
Contains the parameters for CopyImage.
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.
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 #
Contains the output of CopyImage.
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.