功能描述
创建 DRDS 数据库。该接口只是向控制台提交了一个创建分布式数据库的任务,接入方需要依据 DescribeDrdsDB 接口(查询数据库信息的接口)的返回结果来判断分布式数据库是否创建成功。
调用 CreateDrdsDB(创建数据库接口)完成并返回成功后,尝试去调用 DescribeDrdsDB 接口查询建库结果时,如果 CreateDrdsDB 的返回值里的 Status 属性为1,则表示库建成功;否则,表示建库不成功。要连接上这个数据库需要 IP(DRDS 实例的 IP),port(DRDS 实例的端口),dbname(建库时提供的库名),username(目前默认创建了和 dbname 同名的帐号,暂不支持自主建帐号),password(建库时提供的密码)。
请求参数
参数名 | 类型 | 是否必须 | 描述 |
Action | String | 是 | 系统规定参数,取值:CreateDrdsDB |
DrdsInstanceId | String | 是 | DRDS 实例 ID |
DbName | String | 是 | 分布式数据库的名称(小写字母、数字、下划线组成,字母开头,不超过24字符) |
Encode | String | 是 | 数据库编码(取值可以为 utf8,gbk,latin1,utf8mb4) |
Password | String | 是 | 分布式数据库密码(8-30个字符。) |
RdsInstances | String | 是 | 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 数据库个数已经达到上限 | 400 |
InvalidDbname.MalFormed | The specified parameter Dbname is not valid. | Dbname 不合法 | 400 |
InvalidEncode. ValueNotSupported | The specified parameter encode is not valid. | Encode 不支持 | 400 |
OperationDenied.RdsDbNameExists | The operation is not permitted due to RDS DbName exist. | RDS 数据库上的库已经存在 | 400 |
OperationDenied.RdsAccoutExists | The operation is not permitted due to RDS accout exist. | RDS 上帐号已存在 | 400 |
InvalidPassword.MalFormed | The specified parameter password is not valid. | 密码不合法 | 400 |
InvalidParameter_DbprefixCannotEndWithUnderline | DB prefix can not end up with underline. | 数据库名不能以下划线(_)结尾 | 400 |
DrdsVersionIsOld | This drds instance version too old.not allow create drds db | DRDS 实例的版本不支持建库 | 400 |
InvalidDbprefixDuplicated | db name in this drds instance duplicate | 数据库名重复 | 400 |
InvalidRds.RegionNotMatch | The rds region does not match Drds region | RDS 的区域与 DRDS 实例不匹配 | 400 |