该接口用于在PolarDB集群下创建一个新的数据库。

集群必须满足以下条件,否则将创建失败:

  • 当前集群状态:运行中。
  • 当前集群锁定模式:正常。

调试

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

请求参数

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

系统规定参数,取值:CreateDatabase

CharacterSetName String utf8

字符集,取值参见字符集表

DBClusterId String pc-xxxxxxxxxx

集群ID。

DBName String testDB

数据库名。

  • 由小写字母、数字、中划线(-)、下划线(_)组成。
  • 以小写字母开头,以字母或数字结尾,最长64个字符。
DBDescription String DBDesc

数据库备注:

  • 不能以http://https://开头。
  • 长度为2-256个字符。
AccountName String testacc

授权访问该数据库的账号名。可通过接口DescribeAccounts查询账号信息。

说明 只支持输入普通账号,高权限账号默认拥有数据库全部权限无需授权。
AccountPrivilege String ReadWrite

账号权限:

  • ReadWrite:读写。
  • ReadOnly:只读。
  • DMLOnly:只允许DML。
  • DDLOnly:只允许DDL。

若不填,则默认为:ReadWrite

说明 该参数仅在AccountName不为空时有效。
Collate String C

语言环境设置,用于指定新建数据库的排序规则。

说明 语言环境必须与CharacterSetName参数设置的字符集兼容。
Ctype String C

语言环境设置,用于指定数据库的字符分类。

说明
  • 语言环境必须与CharacterSetName参数设置的字符集兼容。
  • Ctype传入信息一致。

返回数据

名称 类型 示例值 描述
RequestId String 2FED790E-FB61-4721-8C1C-07C627FA5A19

请求ID。

示例

请求示例

http(s)://[Endpoint]/?Action=CreateDatabase
&CharacterSetName=utf8
&DBClusterId=pc-xxxxxxxxxx
&DBName=testDB
&<公共请求参数>

正常返回示例

XML 格式

<CreateDatabaseResponse>  
       <RequestId>2FED790E-FB61-4721-8C1C-07C627FA5A19</RequestId>
</CreateDatabaseResponse>

JSON 格式

{
   "RequestId": "2FED790E-FB61-4721-8C1C-07C627FA5A19"
}

错误码

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