The Amazon RDS Command Line Interface (AWS CLI) has been deprecated. Instead, use the AWS CLI for RDS. To learn how to download and use the AWS CLI, see
AWS Command Line Interface User Guide. For
RDS commands available in the AWS CLI, see
AWS CLI Reference for Amazon RDS.
The AWS CLI does not currently support the DownloadCompleteDBLogFile
REST API action. To download an entire log file at once, rather than in parts using the
download-db-log-file-portion command, use the last published RDS CLI and the
Creates a copy of all data and configuration associated with the specified DB snapshot. You can copy an automated DB snapshot to create a manual DB snapshot in the same region, the manual snapshot will be retained after the automated snapshot is deleted. You can also copy either a manual or automated snapshot in one region to create a manual snapshot in another region.
Copying a DB snapshot out of the source region incurs Amazon RDS data transfer charges. For more information about RDS data transfer pricing, go to Amazon Relational Database Service Pricing.
You cannot copy a DB snapshot to or from the AWS GovCloud (US) Region. You also cannot copy a DB snapshot across regions if it was created from a DB instance that is using Oracle TDE.
Source DB snapshot identifier. This is the unique name that identifies an existing DB snapshot to copy.
This parameter is the default parameter and can be passed as the first
value in the command and without a parameter name, for example:
The identifier for the target DB snapshot.
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.
True to copy all tags from the source DB snapshot to the target DB snapshot; otherwise false. The default is false.
The name of a tag to add for the target DB snapshot.
The value of the tag to add for the target DB snapshot.
The command returns the following information:
Output values list the possible values returned by CLI commands. Not all values are returned for every call to a command. If a value is null or empty, it will not be included in the command output. For example, CLI commands to create or restore a DB instance will not return the Endpoint Address value because that value is null until the DB instance has finished being created or restored.
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)
Storage Type—The storage type of the DB snapshot
Encrypted—Indicates whether the DB snapshot is encrypted
KmsKeyId—If Storage Encrypted is
true, the KMS key identifier for the encrypted DB snapshot
Status—Status of the DB snapshot. Valid values:
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
Port—The original port of the database from which the DB snapshot was taken. This column appears only with the
Version—The database engine's version number.
Copy a Database Snapshot
This example copies an automated DB snapshot to create a manual DB snapshot in the same region.
rds-copy-db-snapshot -s rds:mydb-2012-01-15-00-01 -t snapshotdec01
Copy a DB Snapshot Across Regions
This example copies a manual DB snapshot in the us-east-1 region to create a manual DB snapshot in the us-west-2 region.
rds-copy-db-snapshot --source-db-snapshot-identifier arn:aws:rds:us-east-1:123456789012:snapshot:mysql-instance1-snapshot-20130805 --region us-west-2 --target-db-snapshot-identifier mysql-instance1-snapshot-20130805-copy