
restore-db-instance-to-point-in-time
************************************


DESCRIPTION
===========

Restores a DB Instance to an arbitrary point-in-time. Users can
restore to any point in time before the latestRestorableTime for up to
backupRetentionPeriod days. The target database is created from the
source database with the same configuration as the original database
except that the DB instance is created with the default DB security
group.


SYNOPSIS
========

   aws rds restore-db-instance-to-point-in-time
     --source-db-instance-identifier <value>
     --target-db-instance-identifier <value>
     [--engine <value>]
     [--multi-az ]
     [--availability-zone <value>]
     [--db-subnet-group-name <value>]
     [--publicly-accessible ]
     [--auto-minor-version-upgrade ]
     [--license-model <value>]
     [--use-latest-restorable-time ]
     [--port <value>]
     [--iops <value>]
     [--db-name <value>]
     [--db-instance-class <value>]
     [--restore-time <value>]
     [--option-group-name <value>]


REQUIRED PARAMETERS
===================

"--source-db-instance-identifier"  (string)
   The identifier of the source DB Instance from which to restore.

   Constraints:

   * Must be the identifier of an existing database instance

   * Must contain from 1 to 63 alphanumeric characters or hyphens

   * First character must be a letter

   * Cannot end with a hyphen or contain two consecutive hyphens

"--target-db-instance-identifier"  (string)
   The name of the new database instance to be created.

   Constraints:

   * Must contain from 1 to 63 alphanumeric characters or hyphens

   * First character must be a letter

   * Cannot end with a hyphen or contain two consecutive hyphens


OPTIONAL PARAMETERS
===================

"--engine"  (string)
   The database engine to use for the new instance.

   Default: The same as source

   Constraint: Must be compatible with the engine of the source

   Example: "oracle-ee"

"--multi-az"  (boolean)
   Specifies if the DB Instance is a Multi-AZ deployment.

   Constraint: You cannot specify the --availability-zone parameter if
   the --multi-az parameter is set to "true" .

"--availability-zone"  (string)
   The EC2 Availability Zone that the database instance will be
   created in.

   Default: A random, system-chosen Availability Zone.

   Constraint: You cannot specify the --availability-zone parameter if
   the --multi-az parameter is set to true.

   Example: "us-east-1a"

"--db-subnet-group-name"  (string)
   The DB subnet group name to use for the new instance.

"--publicly-accessible"  (boolean)

"--auto-minor-version-upgrade"  (boolean)
   Indicates that minor version upgrades will be applied automatically
   to the DB Instance during the maintenance window.

"--license-model"  (string)
   License model information for the restored DB Instance.

   Default: Same as source.

   Valid values: "license-included" | "bring-your-own-license" |
   "general-public-license"

"--use-latest-restorable-time"  (boolean)
   Specifies whether ( "true" ) or not ( "false" ) the DB Instance is
   restored from the latest backup time.

   Default: "false"

   Constraints: Cannot be specified if --restore-time parameter is
   provided.

"--port"  (integer)
   The port number on which the database accepts connections.

   Constraints: Value must be "1150-65535"

   Default: The same port as the original DB Instance.

"--iops"  (integer)
   The amount of Provisioned IOPS (input/output operations per second)
   to be initially allocated for the DB Instance.

   Constraints: Must be an integer greater than 1000.

"--db-name"  (string)
   The database name for the restored DB Instance.

   Note: This parameter is not used for the MySQL engine.

"--db-instance-class"  (string)
   The compute and memory capacity of the Amazon RDS DB instance.

   Valid Values: "db.t1.micro | db.m1.small | db.m1.medium |
   db.m1.large | db.m1.xlarge | db.m2.2xlarge | db.m2.4xlarge"

   Default: The same --db-instance-class as the original DB Instance.

"--restore-time"  (timestamp)
   The date and time to restore from.

   Valid Values: Value must be a UTC time

   Constraints:

   * Must be before the latest restorable time for the DB Instance

   * Cannot be specified if --use-latest-restorable-time parameter is
     true

   Example: "2009-09-07T23:45:00Z"

"--option-group-name"  (string)
