Safe Haskell | None |
---|---|
Language | Haskell2010 |
Copies a point-in-time snapshot of an EBS volume and stores it in Amazon S3. You can copy the snapshot within the same region or from one region to another. You can use the snapshot to create EBS volumes or Amazon Machine Images (AMIs). The snapshot is copied to the regional endpoint that you send the HTTP request to.
Copies of encrypted EBS snapshots remain encrypted. Copies of unencrypted snapshots remain unencrypted.
Copying snapshots that were encrypted with non-default AWS Key Management Service (KMS) master keys is not supported at this time.
For more information, see Copying an Amazon EBS Snapshot in the AmazonElastic Compute Cloud User Guide.
http://docs.aws.amazon.com/AWSEC2/latest/APIReference/ApiReference-query-CopySnapshot.html
- data CopySnapshot
- copySnapshot :: Text -> Text -> CopySnapshot
- csDescription :: Lens' CopySnapshot (Maybe Text)
- csDestinationRegion :: Lens' CopySnapshot (Maybe Text)
- csDryRun :: Lens' CopySnapshot (Maybe Bool)
- csPresignedUrl :: Lens' CopySnapshot (Maybe Text)
- csSourceRegion :: Lens' CopySnapshot Text
- csSourceSnapshotId :: Lens' CopySnapshot Text
- data CopySnapshotResponse
- copySnapshotResponse :: CopySnapshotResponse
- csrSnapshotId :: Lens' CopySnapshotResponse (Maybe Text)
Request
data CopySnapshot Source
Request constructor
CopySnapshot
constructor.
The fields accessible through corresponding lenses are:
Request lenses
csDescription :: Lens' CopySnapshot (Maybe Text) Source
A description for the EBS snapshot.
csDestinationRegion :: Lens' CopySnapshot (Maybe Text) Source
The destination region to use in the PresignedUrl
parameter of a snapshot
copy operation. This parameter is only valid for specifying the destination
region in a PresignedUrl
parameter, where it is required.
CopySnapshot
sends the snapshot copy to the regional endpoint that you send
the HTTP request to, such as 'ec2.us-east-1.amazonaws.com' (in the AWS CLI,
this is specified with the '--region' parameter or the default region in your
AWS configuration file).
csDryRun :: Lens' CopySnapshot (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
.
csPresignedUrl :: Lens' CopySnapshot (Maybe Text) Source
The pre-signed URL that facilitates copying an encrypted snapshot. This
parameter is only required when copying an encrypted snapshot with the Amazon
EC2 Query API; it is available as an optional parameter in all other cases.
The PresignedUrl
should use the snapshot source endpoint, the CopySnapshot
action, and include the SourceRegion
, SourceSnapshotId
, and DestinationRegion
parameters. The PresignedUrl
must be signed using AWS Signature Version 4.
Because EBS snapshots are stored in Amazon S3, the signing algorithm for this
parameter uses the same logic that is described in Authenticating Requests byUsing Query Parameters (AWS Signature Version 4) in the Amazon Simple StorageService API Reference. An invalid or improperly signed PresignedUrl
will
cause the copy operation to fail asynchronously, and the snapshot will move
to an error
state.
csSourceRegion :: Lens' CopySnapshot Text Source
The ID of the region that contains the snapshot to be copied.
csSourceSnapshotId :: Lens' CopySnapshot Text Source
The ID of the EBS snapshot to copy.
Response
Response constructor
copySnapshotResponse :: CopySnapshotResponse Source
CopySnapshotResponse
constructor.
The fields accessible through corresponding lenses are:
Response lenses
csrSnapshotId :: Lens' CopySnapshotResponse (Maybe Text) Source
The ID of the new snapshot.