CreateSnapshot

Amazon Elastic Compute Cloud: 2008-12-01

previous page next page

CreateSnapshot

The CreateSnapshot operation creates a snapshot of an Amazon EBS volume and stores it in Amazon S3. You can use snapshots for backups, to make identical copies of instance devices, and to save data before shutting down an instance. For more information, see Amazon Elastic Block Store.

Request Parameters

The following table describes the request parameters for CreateSnapshot. Parameter names are case sensitive.

Name Description Required

Name	Description	Required
`volumeId`	The ID of the Amazon EBS volume to snapshot Type: xsd:string Default: none Valid Values: ID of a volume that you own Constraints: ID of a volume that you own	Yes

volumeId

The ID of the Amazon EBS volume to snapshot

Type: xsd:string

Default: none

Valid Values: ID of a volume that you own

Constraints: ID of a volume that you own

Yes

Response Elements

The following table describes the default response tags included in CreateSnapshot responses.

Name	Description
`snapshotId`	The ID of the snapshot Type: xsd:string
`volumeId`	The ID of the volume Type: xsd:string
`status`	Snapshot state (e.g., `pending`, `completed`) Type: xsd:string
`startTime`	Time stamp when the snapshot was initiated Type: xsd:dateTime
`progress`	The progress of the snapshot, in percentage Type: xsd:string

Sample Request

<CreateSnapshot xmlns="http://ec2.amazonaws.com/doc/2008-12-01">
  <volumeId>vol-4d826724</volumeId>
</CreateSnapshot>

Sample Response

<CreateSnapshotResponse xmlns="http://ec2.amazonaws.com/doc/2008-12-01">
  <snapshotId>snap-78a54011</snapshotId>
  <volumeId>vol-4d826724</volumeId>
  <status>pending</status>
  <startTime>2008-05-07T12:51:50.000Z</startTime>
  <progress></progress>
</CreateSnapshotResponse>

Related Operations

previous page start next page