Container for the parameters to the CreateDBInstance operation.

Creates a new DB instance.

Namespace: Amazon.RDS.Model
Assembly: AWSSDK (in AWSSDK.dll) Version: 1.4.10.0 (1.4.10.0)

Syntax

         
 C#  Visual Basic  Visual C++ 
public class CreateDBInstanceRequest : AmazonWebServiceRequest
Public Class CreateDBInstanceRequest _
	Inherits AmazonWebServiceRequest
public ref class CreateDBInstanceRequest : public AmazonWebServiceRequest

Members

            
 All Members  Constructors   Properties   Methods  
 Public

 Protected
 Instance

 Static 
 Declared

 Inherited
 XNA Framework Only 

 .NET Compact Framework Only 

 MemberDescription
CreateDBInstanceRequest()()()()
Initializes a new instance of the CreateDBInstanceRequest class
AllocatedStorage
The amount of storage (in gigabytes) to be initially allocated for the database instance. MySQL Constraints: Must be an integer from 5 to 1024. Type: Integer Oracle Constraints: Must be an integer from 10 to 1024.
AutoMinorVersionUpgrade
Indicates that minor engine upgrades will be applied automatically to the DB Instance during the maintenance window. Default: true
AvailabilityZone
The EC2 Availability Zone that the database instance will be created in. Default: A random, system-chosen Availability Zone in the endpoint's region. Example: us-east-1d Constraint: The AvailabilityZone parameter cannot be specified if the MultiAZ parameter is set to true. The specified Availability Zone must be in the same region as the current endpoint.
BackupRetentionPeriod
The number of days for which automated backups are retained. Setting this parameter to a positive number enables backups. Setting this parameter to 0 disables automated backups. Default: 1 Constraints:
  • Must be a value from 0 to 8
  • Cannot be set to 0 if the DB Instance is a master instance with read replicas
DBInstanceClass
The compute and memory capacity of the DB Instance. Valid Values: db.m1.small | db.m1.large | db.m1.xlarge | db.m2.xlarge |db.m2.2xlarge | db.m2.4xlarge
DBInstanceIdentifier
The DB Instance identifier. This parameter is stored as a lowercase string. 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.
Example: mydbinstance
DBName
The meaning of this parameter differs according to the database engine you use. MySQL The name of the database to create when the DB Instance is created. If this parameter is not specified, no database is created in the DB Instance. Constraints:
  • Must contain 1 to 64 alphanumeric characters
  • Cannot be a word reserved by the specified database engine
Type: String Oracle The Oracle System ID (SID) of the created DB Instance. Default: ORACL Constraints:
  • Cannot be longer than 8 characters
DBParameterGroupName
The name of the DB Parameter Group to associate with this DB instance. If this argument is omitted, the default DBParameterGroup for the specified engine will be used. Constraints:
  • Must be 1 to 255 alphanumeric characters
  • First character must be a letter
  • Cannot end with a hyphen or contain two consecutive hyphens
DBSecurityGroups
A list of DB Security Groups to associate with this DB Instance. Default: The default DB Security Group for the database engine.
DBSubnetGroupName
A DB Subnet Group to associate with this DB Instance. If there is no DB Subnet Group, then it is a non-VPC DB instance.
Engine
The name of the database engine to be used for this instance. Valid Values: MySQL | oracle-se1 | oracle-se | oracle-ee
EngineVersion
The version number of the database engine to use. MySQL Example: 5.1.42 Type: String Oracle Example: 11.2.0.2.v2
Equals(Object)
Determines whether the specified Object is equal to the current Object.
(Inherited from Object.)
GetHashCode()()()()
Serves as a hash function for a particular type.
(Inherited from Object.)
GetType()()()()
Gets the Type of the current instance.
(Inherited from Object.)
LicenseModel
License model information for this DB Instance. Valid values: license-included | bring-your-own-license | general-public-license
MasterUsername
The name of master user for the client DB Instance. MySQL Constraints:
  • Must be 1 to 16 alphanumeric characters.
  • First character must be a letter.
  • Cannot be a reserved word for the chosen database engine.
Type: String Oracle Constraints:
  • Must be 1 to 30 alphanumeric characters.
  • First character must be a letter.
  • Cannot be a reserved word for the chosen database engine.
MasterUserPassword
The password for the master DB Instance user. MySQL Constraints: Cannot contain more than 41 alphanumeric characters. Type: String Oracle Constraints: Cannot contain more than 30 alphanumeric characters.
MultiAZ
Specifies if the DB Instance is a Multi-AZ deployment. You cannot set the AvailabilityZone parameter if the MultiAZ parameter is set to true.
Port
The port number on which the database accepts connections. MySQL Default: 3306 Valid Values: 1150-65535 Type: Integer Oracle Default: 1521 Valid Values: 1150-65535
PreferredBackupWindow
The daily time range during which automated backups are created if automated backups are enabled, using the BackupRetentionPeriod parameter. Default: A 30-minute window selected at random from an 8-hour block of time per region. The following list shows the time blocks for each region from which the default backup windows are assigned.
  • US-East (Northern Virginia) Region: 03:00-11:00 UTC
  • US-West (Northern California) Region: 06:00-14:00 UTC
  • EU (Ireland) Region: 22:00-06:00 UTC
  • Asia Pacific (Singapore) Region: 14:00-22:00 UTC
  • Asia Pacific (Tokyo) Region: 17:00-03:00 UTC
Constraints: Must be in the format hh24:mi-hh24:mi. Times should be Universal Time Coordinated (UTC). Must not conflict with the preferred maintenance window. Must be at least 30 minutes.
PreferredMaintenanceWindow
The weekly time range (in UTC) during which system maintenance can occur. Format: ddd:hh24:mi-ddd:hh24:mi Default: A 30-minute window selected at random from an 8-hour block of time per region, occurring on a random day of the week. The following list shows the time blocks for each region from which the default maintenance windows are assigned.
  • US-East (Northern Virginia) Region: 03:00-11:00 UTC
  • US-West (Northern California) Region: 06:00-14:00 UTC
  • EU (Ireland) Region: 22:00-06:00 UTC
  • Asia Pacific (Singapore) Region: 14:00-22:00 UTC
  • Asia Pacific (Tokyo) Region: 17:00-03:00 UTC
Valid Days: Mon, Tue, Wed, Thu, Fri, Sat, Sun Constraints: Minimum 30-minute window.
ToString()()()()
Returns a String that represents the current Object.
(Inherited from Object.)
WithAllocatedStorage(Int32)
Sets the AllocatedStorage property
WithAutoMinorVersionUpgrade(Boolean)
Sets the AutoMinorVersionUpgrade property
WithAvailabilityZone(String)
Sets the AvailabilityZone property
WithBackupRetentionPeriod(Int32)
Sets the BackupRetentionPeriod property
WithDBInstanceClass(String)
Sets the DBInstanceClass property
WithDBInstanceIdentifier(String)
Sets the DBInstanceIdentifier property
WithDBName(String)
Sets the DBName property
WithDBParameterGroupName(String)
Sets the DBParameterGroupName property
WithDBSecurityGroups(IEnumerable<(Of <<'(String>)>>))
Adds elements to the DBSecurityGroups collection
WithDBSecurityGroups(array<String>[]()[][])
Adds elements to the DBSecurityGroups collection
WithDBSubnetGroupName(String)
Sets the DBSubnetGroupName property
WithEngine(String)
Sets the Engine property
WithEngineVersion(String)
Sets the EngineVersion property
WithLicenseModel(String)
Sets the LicenseModel property
WithMasterUsername(String)
Sets the MasterUsername property
WithMasterUserPassword(String)
Sets the MasterUserPassword property
WithMultiAZ(Boolean)
Sets the MultiAZ property
WithPort(Int32)
Sets the Port property
WithPreferredBackupWindow(String)
Sets the PreferredBackupWindow property
WithPreferredMaintenanceWindow(String)
Sets the PreferredMaintenanceWindow property

Inheritance Hierarchy

System..::..Object
  Amazon.Runtime..::..AmazonWebServiceRequest
    Amazon.RDS.Model..::..CreateDBInstanceRequest

See Also