Amazon Relational Database Service
Command Line Interface Reference (API Version 2013-05-15)
« 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...

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