PolarDB-X 1.0-API参考-1.0（2017版本）-数据库管理类 API-创建数据库

功能描述

创建 DRDS 数据库。该接口只是向控制台提交了一个创建分布式数据库的任务，接入方需要依据 DescribeDrdsDB 接口（查询数据库信息的接口）的返回结果来判断分布式数据库是否创建成功。

调用 CreateDrdsDB（创建数据库接口）完成并返回成功后，尝试去调用 DescribeDrdsDB 接口查询建库结果时，如果 CreateDrdsDB 的返回值里的 Status 属性为1，则表示库建成功；否则，表示建库不成功。要连接上这个数据库需要 IP（DRDS 实例的 IP），port（DRDS 实例的端口），dbname（建库时提供的库名），username（目前默认创建了和 dbname 同名的帐号，暂不支持自主建帐号），password（建库时提供的密码）。

请求参数

参数名	类型	是否必须	描述
Action	String	是	系统规定参数，取值：CreateDrdsDB
DrdsInstanceId			DRDS 实例 ID
DbName			分布式数据库的名称（小写字母、数字、下划线组成，字母开头，不超过24字符）
Encode			数据库编码（取值可以为 utf8，gbk，latin1，utf8mb4）
Password			分布式数据库密码（8-30个字符。）
RdsInstances			RDS 实例名列表（RDS 实例名就是 RDS 的 DBInstanceId），字符串形式的 JSON 数组，比如，RDS 实例 ID 为 rdsId1，rdsId2，那么该请求参数的值应该设置为[“rdsId1”, “rdsId2”]

返回值

无公共返回值

错误码

	报错信息	错误描述	HTTP 状态码
InvalidParameter.Mismatch	RDS instance and drds instance must belong to owner	指定的 RDS 实例和 DRDS 实例不属于同一个用户	400
QuotaExceeded.DrdsDB	The quota of create DrdsDB exceeds.	用户的 DRDS 数据库个数已经达到上限
InvalidDbname.MalFormed	The specified parameter Dbname is not valid.	Dbname 不合法
InvalidEncode. ValueNotSupported	The specified parameter encode is not valid.	Encode 不支持
OperationDenied.RdsDbNameExists	The operation is not permitted due to RDS DbName exist.	RDS 数据库上的库已经存在
OperationDenied.RdsAccoutExists	The operation is not permitted due to RDS accout exist.	RDS 上帐号已存在
InvalidPassword.MalFormed	The specified parameter password is not valid.	密码不合法
InvalidParameter_DbprefixCannotEndWithUnderline	DB prefix can not end up with underline.	数据库名不能以下划线（_）结尾
DrdsVersionIsOld	This drds instance version too old.not allow create drds db	DRDS 实例的版本不支持建库
InvalidDbprefixDuplicated	db name in this drds instance duplicate	数据库名重复
InvalidRds.RegionNotMatch	The rds region does not match Drds region	RDS 的区域与 DRDS 实例不匹配