调用CreateDB接口创建数据库。

调试

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

请求参数

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

系统规定参数。取值为CreateDB

AccountName String test_acc

数据库所属的账号名称。

说明
  • 仅支持传入普通账号的账号名称,因为默认模式下的高权限账号默认拥有所有数据库的所有权限,而三权分立模式下的系统管理员账号、安全管理员账号和审计管理员账号均不需要该授权。
  • 您可以调用DescribeAccountList接口查看目标实例的账号信息,包括账号名称。
AccountPrivilege String ReadWrite

数据库所属账号在目标数据库下的权限,取值范围如下:

  • ReadWrite:读写
  • ReadOnly:只读
  • DML:仅DML
  • DDL:仅DDL
  • ReadIndex:只读和索引
Charset String utf8

目标数据库所使用的编码字符集。

说明 您可以调用DescribeCharacterSet接口查询数据库支持的字符集类型。
DBInstanceName String pxc-****************

实例ID。

说明 您可以调用DescribeDBInstances接口查看目标地域下所有实例的详情,包括实例ID。
DbName String test_db

新建数据库的名称。数据库名称需满足如下要求:

  • 由小写字母、数字、下划线(_)或中划线(-)组成,长度需为2~16个字符。
  • 需以字母开头,以字母或数字结尾。
  • 不能和已有的数据库名称重复。
RegionId String cn-hangzhou

实例所在地域ID。

说明 您可以调用DescribeRegions接口查看PolarDB-X支持的地域详情,包括地域ID。
DbDescription String test

数据库描述。最多支持256个字符。

SecurityAccountName String test_dsa

安全管理员账号名称。

说明 若已开启三权分立模式,该参数必填。更多关于三权分立模式的信息,请参见三权分立
SecurityAccountPassword String Pw@11111

安全管理员账号的密码。

说明 若已开启三权分立模式,该参数必填。更多关于三权分立模式的信息,请参见三权分立

返回数据

名称 类型 示例值 描述
Message String ****

请求返回消息。

说明 请求成功时该参数为空,请求失败时会返回请求异常信息(如错误码等)。
RequestId String DC45C486-E7FA-409B-B002-9D16E4******

请求ID。

Success Boolean true

请求是否成功。

示例

请求示例

http(s)://polardbx.cn-hangzhou.aliyuncs.com/?Action=CreateDB
&AccountName=test_acc
&AccountPrivilege=ReadWrite
&Charset=utf8
&DBInstanceName=pxc-****************
&DbName=test_db
&RegionId=cn-hangzhou
&<公共请求参数>

正常返回示例

XML格式

<code>200</code>
<data>
    <RequestId>DC45C486-E7FA-409B-B002-9D16E4******</RequestId>
    <Message/>
    <Success>true</Success>
</data>
<requestId>DC45C486-E7FA-409B-B002-9D16E4******</requestId>
<successResponse>true</successResponse>

JSON格式

{"RequestId":"DC45C486-E7FA-409B-B002-9D16E4******","Message":"****","Success":"true"}

错误码

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