Creates a recoverable DB snapshot of all data associated with a DB instance.
This operation is not supported for Read Replica DB instances.
DB instance identifier. This is the unique key that identifies a DB instance. This parameter is stored as a lowercase string.
This parameter is the default parameter and can be passed as the first
value in the command and without a parameter name, for example:
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.
The identifier for the 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.
The name of a tag to add for the new DB snapshot.
The value of the tag to add for the new 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:
AZ—The original Availability Zone of the database from which the DB snapshot was taken. This column appears only in the
Iops—The provisioned IOPS allocated, expressed as I/O operations per second
Port—The original port of the database from which the DB snapshot was taken. This column appears only with the
Create a Database Snapshot
This example creates a new DB snapshot.
rds-create-db-snapshot -i mydbinstance -s mytestsnapshot