Amazon Elastic Compute Cloud
API Reference (API Version 2013-02-01)
« PreviousNext »
View the PDF for this guide.Go to the AWS Discussion Forum for this product.Did this page help you?  Yes | No |  Tell us about it...

CopySnapshot

Description

Copies a point-in-time snapshot of an Amazon Elastic Block Store (Amazon EBS) volume and stores it in Amazon Simple Storage Service (Amazon S3). You can copy the snapshot within the same region or from one region to another. You can use the snapshot to create new Amazon EBS volumes or Amazon Machine Images (AMIs). For more information about Amazon EBS, see Amazon Elastic Block Store (Amazon EBS).

Request Parameters

SourceRegion

The ID of the AWS region that contains the snapshot to be copied.

Type: String

Default: None

Required: Yes

SourceSnapshotId

The ID of the Amazon EBS snapshot to copy.

Type: String

Default: None

Required: Yes

Description

A description of the new Amazon EBS snapshot.

Type: String

Default: None

Constraints: Up to 255 characters

Required:No

Response Elements

The following elements are returned in a CopySnapshotResponse element.

requestId

The ID of the request.

Type: xsd:string

snapshotId

The ID of the new snapshot.

Type: xsd:string

Examples

Example Request

This example copies Amazon EBS snapshot snap-1a2b3c4d located in the us-west-1 region.

https://ec2.amazonaws.com/?Action=CopySnapshot
&AWSAccessKeyId=AKIAIOSFODNN7EXAMPLE
&Description=My%20snapshot
&Signature=VjpSFePIKxDc1IUy92W3SBApdLiap7nno4pEc9iEXAMPLE
&SignatureMethod=HmacSHA256
&SignatureVersion=2
&SourceRegion=us-west-1
&SourceSnapshotId=snap-1a2b3c4d
&Timestamp=2012-12-11T02%3A03%3A35.713Z
&Version=2012-12-01

Example Response

<CopySnapshotResponse xmlns="http://ec2.amazonaws.com/doc/2013-02-01/">
<requestId>60bc441d-fa2c-494d-b155-5d6a3EXAMPLE</requestId>
<snapshotId>snap-2a2b3c4d</snapshotId>
</CopySnapshotResponse>