|
|||||||
| 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, as determined by the BackupRetentionPeriod. |
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, as determined by the BackupRetentionPeriod. |
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, as determined by the BackupRetentionPeriod. |
CreateDBInstanceRequest |
withPreferredMaintenanceWindow(String preferredMaintenanceWindow)
The weekly time range (in UTC) during which system maintenance can occur. |
| Methods inherited from class com.amazonaws.AmazonWebServiceRequest |
|---|
copyPrivateRequestParameters, 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: Depends on the Region the database was created in. These are the default maintenance windows for each Region:
Valid Days: Mon, Tue, Wed, Thu, Fri, Sat, Sun
Constraints: Minimum four-hour period.
Format: ddd:hh24:mi-ddd:hh24:mi
Default: Depends on the Region the database was created in. These are the default maintenance windows for each Region:
Valid Days: Mon, Tue, Wed, Thu, Fri, Sat, Sun
Constraints: Minimum four-hour period.
public void setPreferredMaintenanceWindow(String preferredMaintenanceWindow)
Format: ddd:hh24:mi-ddd:hh24:mi
Default: Depends on the Region the database was created in. These are the default maintenance windows for each Region:
Valid Days: Mon, Tue, Wed, Thu, Fri, Sat, Sun
Constraints: Minimum four-hour period.
preferredMaintenanceWindow - The weekly time range (in UTC) during which system maintenance can
occur. Format: ddd:hh24:mi-ddd:hh24:mi
Default: Depends on the Region the database was created in. These are the default maintenance windows for each Region:
Valid Days: Mon, Tue, Wed, Thu, Fri, Sat, Sun
Constraints: Minimum four-hour period.
public CreateDBInstanceRequest withPreferredMaintenanceWindow(String preferredMaintenanceWindow)
Format: ddd:hh24:mi-ddd:hh24:mi
Default: Depends on the Region the database was created in. These are the default maintenance windows for each Region:
Valid Days: Mon, Tue, Wed, Thu, Fri, Sat, Sun
Constraints: Minimum four-hour period.
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: Depends on the Region the database was created in. These are the default maintenance windows for each Region:
Valid Days: Mon, Tue, Wed, Thu, Fri, Sat, Sun
Constraints: Minimum four-hour period.
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. Default: Depends on the Region the database was created in. These are the default backup windows for each Region:
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 two hours.
BackupRetentionPeriod. Default: Depends on the Region the database was created in. These are the default backup windows for each Region:
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 two hours.
public void setPreferredBackupWindow(String preferredBackupWindow)
BackupRetentionPeriod. Default: Depends on the Region the database was created in. These are the default backup windows for each Region:
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 two hours.
preferredBackupWindow - The daily time range during which automated backups are created if
automated backups are enabled, as determined by the
BackupRetentionPeriod. Default: Depends on the Region the database was created in. These are the default backup windows for each Region:
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 two hours.
public CreateDBInstanceRequest withPreferredBackupWindow(String preferredBackupWindow)
BackupRetentionPeriod. Default: Depends on the Region the database was created in. These are the default backup windows for each Region:
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 two hours.
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, as determined by the
BackupRetentionPeriod. Default: Depends on the Region the database was created in. These are the default backup windows for each Region:
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 two hours.
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 ObjectObject.toString()
|
|||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||