调用CreateDrdsDB接口创建数据库(2019版)_云原生数据库 PolarDB(PolarDB)-阿里云帮助中心

调试

您可以在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.	请求失败，内部错误

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