|
|||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectcom.amazonaws.AmazonWebServiceRequest
com.amazonaws.services.rds.model.CreateDBInstanceRequest
public class CreateDBInstanceRequest
Container for the parameters to the CreateDBInstance operation
.
This API creates a new DB instance.
AmazonRDS.createDBInstance(CreateDBInstanceRequest)
Constructor Summary | |
---|---|
CreateDBInstanceRequest()
Default constructor for a new CreateDBInstanceRequest object. |
|
CreateDBInstanceRequest(String dBInstanceIdentifier,
Integer allocatedStorage,
String dBInstanceClass,
String engine,
String masterUsername,
String masterUserPassword)
Constructs a new CreateDBInstanceRequest object. |
Method Summary | |
---|---|
Integer |
getAllocatedStorage()
The amount of storage (in gigabytes) to be initially allocated for the database instance. |
Boolean |
getAutoMinorVersionUpgrade()
Indicates that minor engine upgrades will be applied automatically to the DB Instance during the maintenance window. |
String |
getAvailabilityZone()
The EC2 Availability Zone that the database instance will be created in. |
Integer |
getBackupRetentionPeriod()
The number of days for which automated backups are retained. |
String |
getDBInstanceClass()
The compute and memory capacity of the DB Instance. |
String |
getDBInstanceIdentifier()
The DB Instance identifier. |
String |
getDBName()
The name of the database to create when the DB Instance is created. |
String |
getDBParameterGroupName()
The name of the database parameter group to associate with this DB instance. |
List<String> |
getDBSecurityGroups()
A list of DB Security Groups to associate with this DB Instance. |
String |
getEngine()
The name of the database engine to be used for this instance. |
String |
getEngineVersion()
The version number of the database engine to use. |
String |
getMasterUsername()
The name of master user for the client DB Instance. |
String |
getMasterUserPassword()
The password for the master DB Instance user. |
Boolean |
getMultiAZ()
Specifies if the DB Instance is a Multi-AZ deployment. |
Integer |
getPort()
The port number on which the database accepts connections. |
String |
getPreferredBackupWindow()
The daily time range during which automated backups are created if automated backups are enabled, using the BackupRetentionPeriod parameter. |
String |
getPreferredMaintenanceWindow()
The weekly time range (in UTC) during which system maintenance can occur. |
Boolean |
isAutoMinorVersionUpgrade()
Indicates that minor engine upgrades will be applied automatically to the DB Instance during the maintenance window. |
Boolean |
isMultiAZ()
Specifies if the DB Instance is a Multi-AZ deployment. |
void |
setAllocatedStorage(Integer allocatedStorage)
The amount of storage (in gigabytes) to be initially allocated for the database instance. |
void |
setAutoMinorVersionUpgrade(Boolean autoMinorVersionUpgrade)
Indicates that minor engine upgrades will be applied automatically to the DB Instance during the maintenance window. |
void |
setAvailabilityZone(String availabilityZone)
The EC2 Availability Zone that the database instance will be created in. |
void |
setBackupRetentionPeriod(Integer backupRetentionPeriod)
The number of days for which automated backups are retained. |
void |
setDBInstanceClass(String dBInstanceClass)
The compute and memory capacity of the DB Instance. |
void |
setDBInstanceIdentifier(String dBInstanceIdentifier)
The DB Instance identifier. |
void |
setDBName(String dBName)
The name of the database to create when the DB Instance is created. |
void |
setDBParameterGroupName(String dBParameterGroupName)
The name of the database parameter group to associate with this DB instance. |
void |
setDBSecurityGroups(Collection<String> dBSecurityGroups)
A list of DB Security Groups to associate with this DB Instance. |
void |
setEngine(String engine)
The name of the database engine to be used for this instance. |
void |
setEngineVersion(String engineVersion)
The version number of the database engine to use. |
void |
setMasterUsername(String masterUsername)
The name of master user for the client DB Instance. |
void |
setMasterUserPassword(String masterUserPassword)
The password for the master DB Instance user. |
void |
setMultiAZ(Boolean multiAZ)
Specifies if the DB Instance is a Multi-AZ deployment. |
void |
setPort(Integer port)
The port number on which the database accepts connections. |
void |
setPreferredBackupWindow(String preferredBackupWindow)
The daily time range during which automated backups are created if automated backups are enabled, using the BackupRetentionPeriod parameter. |
void |
setPreferredMaintenanceWindow(String preferredMaintenanceWindow)
The weekly time range (in UTC) during which system maintenance can occur. |
String |
toString()
Returns a string representation of this object; useful for testing and debugging. |
CreateDBInstanceRequest |
withAllocatedStorage(Integer allocatedStorage)
The amount of storage (in gigabytes) to be initially allocated for the database instance. |
CreateDBInstanceRequest |
withAutoMinorVersionUpgrade(Boolean autoMinorVersionUpgrade)
Indicates that minor engine upgrades will be applied automatically to the DB Instance during the maintenance window. |
CreateDBInstanceRequest |
withAvailabilityZone(String availabilityZone)
The EC2 Availability Zone that the database instance will be created in. |
CreateDBInstanceRequest |
withBackupRetentionPeriod(Integer backupRetentionPeriod)
The number of days for which automated backups are retained. |
CreateDBInstanceRequest |
withDBInstanceClass(String dBInstanceClass)
The compute and memory capacity of the DB Instance. |
CreateDBInstanceRequest |
withDBInstanceIdentifier(String dBInstanceIdentifier)
The DB Instance identifier. |
CreateDBInstanceRequest |
withDBName(String dBName)
The name of the database to create when the DB Instance is created. |
CreateDBInstanceRequest |
withDBParameterGroupName(String dBParameterGroupName)
The name of the database parameter group to associate with this DB instance. |
CreateDBInstanceRequest |
withDBSecurityGroups(Collection<String> dBSecurityGroups)
A list of DB Security Groups to associate with this DB Instance. |
CreateDBInstanceRequest |
withDBSecurityGroups(String... dBSecurityGroups)
A list of DB Security Groups to associate with this DB Instance. |
CreateDBInstanceRequest |
withEngine(String engine)
The name of the database engine to be used for this instance. |
CreateDBInstanceRequest |
withEngineVersion(String engineVersion)
The version number of the database engine to use. |
CreateDBInstanceRequest |
withMasterUsername(String masterUsername)
The name of master user for the client DB Instance. |
CreateDBInstanceRequest |
withMasterUserPassword(String masterUserPassword)
The password for the master DB Instance user. |
CreateDBInstanceRequest |
withMultiAZ(Boolean multiAZ)
Specifies if the DB Instance is a Multi-AZ deployment. |
CreateDBInstanceRequest |
withPort(Integer port)
The port number on which the database accepts connections. |
CreateDBInstanceRequest |
withPreferredBackupWindow(String preferredBackupWindow)
The daily time range during which automated backups are created if automated backups are enabled, using the BackupRetentionPeriod parameter. |
CreateDBInstanceRequest |
withPreferredMaintenanceWindow(String preferredMaintenanceWindow)
The weekly time range (in UTC) during which system maintenance can occur. |
Methods inherited from class com.amazonaws.AmazonWebServiceRequest |
---|
copyPrivateRequestParameters, getRequestClientOptions, getRequestCredentials, setRequestCredentials |
Methods inherited from class java.lang.Object |
---|
equals, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Constructor Detail |
---|
public CreateDBInstanceRequest()
public CreateDBInstanceRequest(String dBInstanceIdentifier, Integer allocatedStorage, String dBInstanceClass, String engine, String masterUsername, String masterUserPassword)
dBInstanceIdentifier
- The DB Instance identifier. This parameter
is stored as a lowercase string. Constraints:
Example:
mydbinstance
allocatedStorage
- The amount of storage (in gigabytes) to be
initially allocated for the database instance. Must be an integer from
5 to 1024.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
engine
- The name of the database engine to be used for this
instance. Valid Values: MySQL
masterUsername
- The name of master user for the client DB
Instance. Constraints:
masterUserPassword
- The password for the master DB Instance
user. Constraints: Must contain 4 to 41 alphanumeric characters.
Method Detail |
---|
public String getDBName()
Constraints:
Constraints:
public void setDBName(String dBName)
Constraints:
dBName
- 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:
public CreateDBInstanceRequest withDBName(String dBName)
Constraints:
Returns a reference to this object so that method calls can be chained together.
dBName
- 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:
public String getDBInstanceIdentifier()
Constraints:
Example: mydbinstance
Constraints:
Example: mydbinstance
public void setDBInstanceIdentifier(String dBInstanceIdentifier)
Constraints:
Example: mydbinstance
dBInstanceIdentifier
- The DB Instance identifier. This parameter is stored as a lowercase
string. Constraints:
Example: mydbinstance
public CreateDBInstanceRequest withDBInstanceIdentifier(String dBInstanceIdentifier)
Constraints:
Example: mydbinstance
Returns a reference to this object so that method calls can be chained together.
dBInstanceIdentifier
- The DB Instance identifier. This parameter is stored as a lowercase
string. Constraints:
Example: mydbinstance
public Integer getAllocatedStorage()
public void setAllocatedStorage(Integer allocatedStorage)
allocatedStorage
- The amount of storage (in gigabytes) to be initially allocated for the
database instance. Must be an integer from 5 to 1024.public CreateDBInstanceRequest withAllocatedStorage(Integer allocatedStorage)
Returns a reference to this object so that method calls can be chained together.
allocatedStorage
- The amount of storage (in gigabytes) to be initially allocated for the
database instance. Must be an integer from 5 to 1024.
public String getDBInstanceClass()
Valid Values:
db.m1.small | db.m1.large | db.m1.xlarge | db.m2.xlarge
|db.m2.2xlarge | db.m2.4xlarge
Valid Values:
db.m1.small | db.m1.large | db.m1.xlarge | db.m2.xlarge
|db.m2.2xlarge | db.m2.4xlarge
public void setDBInstanceClass(String dBInstanceClass)
Valid Values:
db.m1.small | db.m1.large | db.m1.xlarge | db.m2.xlarge
|db.m2.2xlarge | db.m2.4xlarge
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
public CreateDBInstanceRequest withDBInstanceClass(String dBInstanceClass)
Valid Values:
db.m1.small | db.m1.large | db.m1.xlarge | db.m2.xlarge
|db.m2.2xlarge | db.m2.4xlarge
Returns a reference to this object so that method calls can be chained together.
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
public String getEngine()
Valid Values: MySQL
Valid Values: MySQL
public void setEngine(String engine)
Valid Values: MySQL
engine
- The name of the database engine to be used for this instance.
Valid Values: MySQL
public CreateDBInstanceRequest withEngine(String engine)
Valid Values: MySQL
Returns a reference to this object so that method calls can be chained together.
engine
- The name of the database engine to be used for this instance.
Valid Values: MySQL
public String getMasterUsername()
Constraints:
Constraints:
public void setMasterUsername(String masterUsername)
Constraints:
masterUsername
- The name of master user for the client DB Instance. Constraints:
public CreateDBInstanceRequest withMasterUsername(String masterUsername)
Constraints:
Returns a reference to this object so that method calls can be chained together.
masterUsername
- The name of master user for the client DB Instance. Constraints:
public String getMasterUserPassword()
Constraints: Must contain 4 to 41 alphanumeric characters.
Constraints: Must contain 4 to 41 alphanumeric characters.
public void setMasterUserPassword(String masterUserPassword)
Constraints: Must contain 4 to 41 alphanumeric characters.
masterUserPassword
- The password for the master DB Instance user. Constraints: Must contain 4 to 41 alphanumeric characters.
public CreateDBInstanceRequest withMasterUserPassword(String masterUserPassword)
Constraints: Must contain 4 to 41 alphanumeric characters.
Returns a reference to this object so that method calls can be chained together.
masterUserPassword
- The password for the master DB Instance user. Constraints: Must contain 4 to 41 alphanumeric characters.
public List<String> getDBSecurityGroups()
Default: The default DB Security Group for the database engine.
Default: The default DB Security Group for the database engine.
public void setDBSecurityGroups(Collection<String> dBSecurityGroups)
Default: The default DB Security Group for the database engine.
dBSecurityGroups
- A list of DB Security Groups to associate with this DB Instance. Default: The default DB Security Group for the database engine.
public CreateDBInstanceRequest withDBSecurityGroups(String... dBSecurityGroups)
Default: The default DB Security Group for the database engine.
Returns a reference to this object so that method calls can be chained together.
dBSecurityGroups
- A list of DB Security Groups to associate with this DB Instance. Default: The default DB Security Group for the database engine.
public CreateDBInstanceRequest withDBSecurityGroups(Collection<String> dBSecurityGroups)
Default: The default DB Security Group for the database engine.
Returns a reference to this object so that method calls can be chained together.
dBSecurityGroups
- A list of DB Security Groups to associate with this DB Instance. Default: The default DB Security Group for the database engine.
public String getAvailabilityZone()
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.
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.
public void setAvailabilityZone(String availabilityZone)
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.
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.
public CreateDBInstanceRequest withAvailabilityZone(String availabilityZone)
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.
Returns a reference to this object so that method calls can be chained together.
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.
public String getPreferredMaintenanceWindow()
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.
Valid Days: Mon, Tue, Wed, Thu, Fri, Sat, Sun
Constraints: Minimum 30-minute window.
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.
Valid Days: Mon, Tue, Wed, Thu, Fri, Sat, Sun
Constraints: Minimum 30-minute window.
public void setPreferredMaintenanceWindow(String preferredMaintenanceWindow)
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.
Valid Days: Mon, Tue, Wed, Thu, Fri, Sat, Sun
Constraints: Minimum 30-minute window.
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.
Valid Days: Mon, Tue, Wed, Thu, Fri, Sat, Sun
Constraints: Minimum 30-minute window.
public CreateDBInstanceRequest withPreferredMaintenanceWindow(String preferredMaintenanceWindow)
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.
Valid Days: Mon, Tue, Wed, Thu, Fri, Sat, Sun
Constraints: Minimum 30-minute window.
Returns a reference to this object so that method calls can be chained together.
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.
Valid Days: Mon, Tue, Wed, Thu, Fri, Sat, Sun
Constraints: Minimum 30-minute window.
public String getDBParameterGroupName()
Constraints:
Constraints:
public void setDBParameterGroupName(String dBParameterGroupName)
Constraints:
dBParameterGroupName
- The name of the database parameter group to associate with this DB
instance. If this argument is omitted, the default DBParameterGroup
for the specified engine will be used. Constraints:
public CreateDBInstanceRequest withDBParameterGroupName(String dBParameterGroupName)
Constraints:
Returns a reference to this object so that method calls can be chained together.
dBParameterGroupName
- The name of the database parameter group to associate with this DB
instance. If this argument is omitted, the default DBParameterGroup
for the specified engine will be used. Constraints:
public Integer getBackupRetentionPeriod()
Default: 1
Constraints:
Default: 1
Constraints:
public void setBackupRetentionPeriod(Integer backupRetentionPeriod)
Default: 1
Constraints:
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:
public CreateDBInstanceRequest withBackupRetentionPeriod(Integer backupRetentionPeriod)
Default: 1
Constraints:
Returns a reference to this object so that method calls can be chained together.
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:
public String getPreferredBackupWindow()
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.
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.
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.
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.
public void setPreferredBackupWindow(String preferredBackupWindow)
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.
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.
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.
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.
public CreateDBInstanceRequest withPreferredBackupWindow(String preferredBackupWindow)
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.
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.
Returns a reference to this object so that method calls can be chained together.
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.
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.
public Integer getPort()
Default: 3306
Valid Values: 1150-65535
Default: 3306
Valid Values: 1150-65535
public void setPort(Integer port)
Default: 3306
Valid Values: 1150-65535
port
- The port number on which the database accepts connections.
Default: 3306
Valid Values: 1150-65535
public CreateDBInstanceRequest withPort(Integer port)
Default: 3306
Valid Values: 1150-65535
Returns a reference to this object so that method calls can be chained together.
port
- The port number on which the database accepts connections.
Default: 3306
Valid Values: 1150-65535
public Boolean isMultiAZ()
public void setMultiAZ(Boolean multiAZ)
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.public CreateDBInstanceRequest withMultiAZ(Boolean multiAZ)
Returns a reference to this object so that method calls can be chained together.
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.
public Boolean getMultiAZ()
public String getEngineVersion()
Example:
5.1.42
Example:
5.1.42
public void setEngineVersion(String engineVersion)
Example:
5.1.42
engineVersion
- The version number of the database engine to use. Example:
5.1.42
public CreateDBInstanceRequest withEngineVersion(String engineVersion)
Example:
5.1.42
Returns a reference to this object so that method calls can be chained together.
engineVersion
- The version number of the database engine to use. Example:
5.1.42
public Boolean isAutoMinorVersionUpgrade()
Default:
true
Default:
true
public void setAutoMinorVersionUpgrade(Boolean autoMinorVersionUpgrade)
Default:
true
autoMinorVersionUpgrade
- Indicates that minor engine upgrades will be applied automatically to
the DB Instance during the maintenance window. Default:
true
public CreateDBInstanceRequest withAutoMinorVersionUpgrade(Boolean autoMinorVersionUpgrade)
Default:
true
Returns a reference to this object so that method calls can be chained together.
autoMinorVersionUpgrade
- Indicates that minor engine upgrades will be applied automatically to
the DB Instance during the maintenance window. Default:
true
public Boolean getAutoMinorVersionUpgrade()
Default:
true
Default:
true
public String toString()
toString
in class Object
Object.toString()
|
|||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |