PolarDB-X 云原生分布式数据库 CreateDrdsDB

By | 2021年4月22日

通过调用CreateDrdsDB接口创建DRDS数据库。

调试

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

请求参数

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

系统规定参数。取值:CreateDrdsDB。

DrdsInstanceId String drds_sample_instance_id

DRDS 实例 ID

DbName String drds_sample_db

数据库名称

Encode String drds_sample_encode

数据库所用编码

Password String drds_sample_password

数据库访问密码

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

该参数仅在水平拆分时必填。

参数是一个符合 JSON 数组格式的字符串

Type String HORIZONTAL

库的拆分方式,详情请参见扩展性原理。取值范围如下:

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

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

RdsSuperAccount.N.DbInstanceId String drds_sample_rds_id

RDS 实例 ID

RdsSuperAccount.N.AccountName String drds_sample_rds_super_account

RDS 超级账号名称

RdsSuperAccount.N.Password String drds_sample_rds_super_password

RDS 超级账号密码

InstDbName.N.DbInstanceId String drds_sample_rds_id

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

需要垂直拆分的 RDS ID

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

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

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

DbInstanceIsCreating Boolean false

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

AccountName String drds_sample_account

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

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

返回数据

名称 类型 示例值 描述
RequestId String FF13E47D-4E38-4A5A-BA68-32A554******

请求 ID

Success Boolean true

建库结果

示例

请求示例

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
&<公共请求参数>

正常返回示例

XML 格式

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

JSON 格式

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

错误码

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


请关注公众号获取更多资料

发表回复

您的电子邮箱地址不会被公开。 必填项已用*标注

Iconic One Theme | Powered by Wordpress