Amazon Relational Database Service
Command Line Interface Reference (API Version 2012-04-23)
Print this pageEmail this pageGo to the ForumsView the PDFShare this page on TwitterShare this page on FacebookBookmark this page on DeliciousSubmit this page to RedditSubmit this page to DiggDid this page help you?  Yes  No   Tell us about it...

rds-copy-db-snapshot

Description

Creates a copy of all data and configuration associated with the specified DB Snapshot.

Syntax

rds-copy-db-snapshot SourceDBSnapshotIdentifier

-t (--target-db-snapshot-identifier) value

[General Options]

Options

NameDescriptionRequired

SourceDBSnapshotIdentifier

Source DB Snapshot identifier. This is the unique key that identifies an existing DB Snapshot to copy.

This parameter can also be set using --source-db-snapshot-identifier value

Type: String

Default: None

Constraints: Must be the identifer of an active DB Snapshot.

Example: --source-db-instance-identifier mydbsnapshot

Yes

-t value

--target-db-snapshot-identifier value

The identifier for the target DB Snapshot.

Type: String

Default: None

Constraints: Cannot be null, empty, or blank. Cannot be a word reserved by the database engine. Must contain 1 to 255 alphanumeric characters or hyphens. First character must be a letter. Cannot end with a hyphen or contain two consecutive hyphens.

Example: -t my-copied-snapshot-id

Yes

Output

The command returns the following information:

  • DBSnapshotId—Name of the DB Snapshot

  • Snapshot Created—The time (in 24 hour UTC) when the DB Snapshot was taken

  • DBInstanceId—User-supplied database identifier; this is the unique key that identifies a DB Instance

  • Instance Created—The date and time when the DB Instance was created

  • Engine—The name and version of the database engine used

  • Storage—The size of the DB Snapshot's allocated storage (GB)

  • Status—Status of the DB Snapshot. Valid values: creating | available | deleting

  • Master Username—The login name of the database's master user.

  • AZ—The original Availability Zone of the database from which the DB Snapshot was taken. This column appears only in the --show-long view

  • Port—The original port of the database from which the DB Snapshot was taken. This column appears only with the --show-long-view command option

  • Version—The database engine's version number.

  • License—TBD

  • Type—TBD

  • VpcId—TBD

Examples

Copy a Database Snapshot

This example copies a DB Snapshot.

PROMPT> rds-copy-db-snapshot -s rds:mydb-2012-01-15-00-01 -t snapshotdec01