
restore-db-instance-from-db-snapshot
************************************


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

Creates a new DB Instance from a DB snapshot. The target database is
created from the source database restore point with the same
configuration as the original source database, except that the new RDS
instance is created with the default security group.


SYNOPSIS
========

   aws rds restore-db-instance-from-db-snapshot
     --db-snapshot-identifier <value>
     --db-instance-identifier <value>
     [--engine <value>]
     [--multi-az ]
     [--availability-zone <value>]
     [--option-group-name <value>]
     [--publicly-accessible ]
     [--iops <value>]
     [--license-model <value>]
     [--port <value>]
     [--db-name <value>]
     [--db-instance-class <value>]
     [--auto-minor-version-upgrade ]
     [--db-subnet-group-name <value>]


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

"--db-snapshot-identifier"  (string)
   Name of the DB Instance to create from the DB Snapshot. This
   parameter isn't case sensitive.

   Constraints:

   * Must contain from 1 to 255 alphanumeric characters or hyphens

   * First character must be a letter

   * Cannot end with a hyphen or contain two consecutive hyphens

   Example: "my-snapshot-id"

"--db-instance-identifier"  (string)
   The identifier for the DB Snapshot to restore from.

   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"

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

"--publicly-accessible"  (boolean)

"--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.

"--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"

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

   Default: The same port as the original DB Instance

   Constraints: Value must be "1150-65535"

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

   Note: This parameter doesn't apply to 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"

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

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