Call createddsdb to create a DRDS database.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String No CreateDrdsDB

The operation that you want to perform. Set the value to CreateDrdsDB.

DrdsInstanceId String No drds_sample_instance_id

DRDS instance ID

DbName String Yes drds_sample_db

Database Name

Encode String Yes drds_sample_encode

Encoding used by the database

Password String Yes drds_sample_password

The logon password of the database instance.

RdsInstance.N RepeatList No ["drds_sample_rds_id1", "drds_sample_rds_id2"]

This parameter is required only for vertical partitioning.

The parameter is a string that follows the JSON Array format.

Type String Yes HORIZONTAL

Database Sharding method. For more information, see scalability principle. Valid values:

  • HORIZONTAL: indicates HORIZONTAL partitioning, which is commonly known as database and table sharding.
  • VERTICAL
DbInstType String Yes RDS

The type of the attached storage. Currently, only RDS databases are supported.

RdsSuperAccount.N.DbInstanceId String Yes drds_sample_rds_id

ID of the RDS instance.

RdsSuperAccount.N.AccountName String Yes drds_sample_rds_super_account

The name of the RDS privileged account.

RdsSuperAccount.N.Password String Yes drds_sample_rds_super_password

RDS privileged account password

InstDbName.N.DbInstanceId String Yes drds_sample_rds_id

The list of databases to be vertically partitioned on the RDS instance, which is a JSON array string.

The ID of the RDS instance.

InstDbName.N.ShardDbName.N RepeatList No ["drds_sample_db1", "drds_sample_db2"]

The list of databases to be vertically partitioned on the RDS instance, which is a JSON array string.

The parameter represents a list of databases that need to be vertically split in the corresponding RDS instance. The parameter is a string that conforms to the JSON Array format.

DbInstanceIsCreating Boolean No false

Check whether the RDS instance is being created.

AccountName String Yes drds_sample_account

The list of databases to be vertically partitioned on the RDS instance, which is a JSON array string.

The parameter indicates the name of an account with the corresponding permission to access all RDS databases in the vertical partitioning scenario.

Response parameters

Parameter Type Example Description
RequestId String FF13E47 D-4E38-4A5A-BA68-32A554 desensitization algorithm instance *

The ID of the request.

Success Boolean True

Indicates whether the DRDS database was created.

Examples

Sample request

http(s)://drds.aliyuncs.com/? Action=CreateDrdsDB
&DrdsInstanceId=drds_sample_instance_id
&DbName=drds_sample_db
&Encode=utf8mb4
&Password=drds_sample_password
&RdsInstance=["drds_sample_rds_id1", "drds_sample_rds_id2"]
&Type=HORIZONTAL
&DbInstType=RDS
&DbInstanceIsCreating=false
&<Common request parameters>

Sample success responses

XML format

<CreateDrdsDB>
      <RequestId>FF13E47D-4E38-4A5A-BA68-32A554******</RequestId>
      <Success>true</Success>
</CreateDrdsDB>

JSON format

{
    "RequestId": "FF13E47D-4E38-4A5A-BA68-32A554E610EF",
    "Success": true
}

Error codes

For a list of error codes, visit the API Error Center.