且构网

分享程序员开发的那些事...
且构网 - 分享程序员编程开发的那些事

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

更新时间:2022-01-10 03:19:43

功能描述

创建 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