调用CreateDrdsDB接口创建数据库。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String CreateDrdsDB

系统规定参数。取值:CreateDrdsDB

DrdsInstanceId String drdshbgal154****

实例ID。

DbName String testdb

数据库名称。

Encode String utf8

数据库所用编码。

Password String drds_sample_password

数据库访问密码。

Type String HORIZONTAL

库的拆分方式。取值范围如下:

  • HORIZONTAL:表示水平拆分,即通常所说的分库分表方式。
  • VERTICAL:表示垂直拆分。
DbInstType String RDS

挂载的存储类型,目前仅支持RDS。

DbInstanceIsCreating Boolean false

建库所涉及的RDS是否正在创建中。

AccountName String drds_sample_account

该参数仅在垂直拆分时使用。

参数表示垂直拆分场景下,拥有所有RDS上相应数据库访问权限的一个账号名称。

RdsInstance.N String ["drds_sample_rds_id1", "drds_sample_rds_id2"]

该参数仅在水平拆分时必填,参数是一个符合JSON数组格式的字符串。

RdsSuperAccount.N.Password String drds_sample_rds_super_password

RDS超级账号密码。

RdsSuperAccount.N.DbInstanceId String drds_sample_rds_id

RDS实例ID。

RdsSuperAccount.N.AccountName String drds_sample_rds_super_account

RDS超级账号名称。

InstDbName.N.DbInstanceId String drds_sample_rds_id

需要垂直拆分的RDS ID,该参数仅在垂直拆分时使用。

InstDbName.N.ShardDbName.N String ["db1", "db2"]

参数表示对应RDS实例中需要垂直拆分的数据库列表,参数是一个符合JSON数组格式的字符串。

该参数仅在垂直拆分时使用。

返回数据

名称 类型 示例值 描述
Success Boolean true

请求结果。

RequestId String FF13E47D-4E38-4A5A-BA68-32A554AD45T6

请求ID。

示例

请求示例

http(s)://[Endpoint]/?Action=CreateDrdsDB
&DrdsInstanceId=drdshbgal154****
&DbName=testdb
&Encode=utf8
&Password=drds_sample_password
&Type=HORIZONTAL
&DbInstType=RDS
&DbInstanceIsCreating=false
&AccountName=drds_sample_account
&RdsInstance=["drds_sample_rds_id1", "drds_sample_rds_id2"]
&RdsSuperAccount=[{"Password":"drds_sample_rds_super_password","DbInstanceId":"drds_sample_rds_id","AccountName":"drds_sample_rds_super_account"}]
&InstDbName=[{"DbInstanceId":"drds_sample_rds_id","ShardDbName":["db1", "db2"]}]
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateDrdsDBResponse>
    <Success>true</Success>
    <RequestId>FF13E47D-4E38-4A5A-BA68-32A554AD45T6</RequestId>
</CreateDrdsDBResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

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

错误码

HttpCode 错误码 错误信息 描述
500 InternalError The request processing has failed due to some unknown error. 请求失败,内部错误

访问错误中心查看更多错误码。