API参考—数据库管理—CreateDB

调试

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

请求参数

名称	类型	是否必选	示例值	描述
Action	String	是	CreateDB	系统规定参数。取值为CreateDB。
AccountName			test_acc	数据库所属的账号名称。 说明 仅支持传入普通账号的账号名称，因为默认模式下的高权限账号默认拥有所有数据库的所有权限，而三权分立模式下的系统管理员账号、安全管理员账号和审计管理员账号均不需要该授权。 您可以调用 DescribeAccountList 接口查看目标实例的账号信息，包括账号名称。
AccountPrivilege			ReadWrite	数据库所属账号在目标数据库下的权限，取值范围如下： ReadWrite：读写 ReadOnly：只读 DML：仅DML DDL：仅DDL ReadIndex：只读和索引
Charset			utf8	目标数据库所使用的编码字符集。 说明 您可以调用DescribeCharacterSet接口查询数据库支持的字符集类型。
DBInstanceName			pxc-****************	实例ID。 说明 您可以调用 DescribeDBInstances 接口查看目标地域下所有实例的详情，包括实例ID。
DbName			test_db	新建数据库的名称。数据库名称需满足如下要求： 由小写字母、数字、下划线（_）或中划线（-）组成，长度需为2~16个字符。 需以字母开头，以字母或数字结尾。 不能和已有的数据库名称重复。
RegionId			cn-hangzhou	实例所在地域ID。 DescribeRegions 接口查看PolarDB-X支持的地域详情，包括地域ID。
DbDescription		否	test	数据库描述。最多支持256个字符。
SecurityAccountName			test_dsa	安全管理员账号名称。 说明 若已开启三权分立模式，该参数必填。更多关于三权分立模式的信息，请参见 三权分立 。
SecurityAccountPassword			Pw@11111	安全管理员账号的密码。

返回数据

Message		****	请求返回消息。 说明 请求成功时该参数为空，请求失败时会返回请求异常信息（如错误码等）。
RequestId		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"}