Amazon Relational Database Service
Command Line Interface Reference (API Version 2014-09-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...

rds-create-db-snapshot

Description

Creates a recoverable DB snapshot of all data associated with a DB instance.

Note

This operation is not supported for read replica DB instances.

Syntax

rds-create-db-snapshot DBInstanceIdentifier

-s (--db-snapshot-identifier) value

[General Options]

Options

NameDescriptionRequired

DBInstanceIdentifier

DB instance identifier. This is the unique key that identifies a DB instance. This parameter is stored as a lowercase string.

This parameter can also be set using --db-instance-identifier value

Type: String

Default: None

Constraints: Must contain 1 to 63 alphanumeric characters or hyphens. First character must be a letter. Cannot end with a hyphen or contain two consecutive hyphens.

Example: --db-instance-identifier mydbinstance

Yes

-s value

--db-snapshot-identifier value

The identifier for the 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: -s my-snapshot-id

Yes

Output

The command returns the following information:

Note

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)

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

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

  • Iops—The provisioned IOPS allocated, expressed as I/O operations per second

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

  • 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

Examples

Create a Database Snapshot

This example creates a new DB snapshot.

PROMPT> rds-create-db-snapshot -i mydbinstance -s mytestsnapshot