调用CreateAccount接口创建普通账号。

更多关于实例账号的信息，请参见账号管理。

调试

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

请求参数

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

系统规定参数。取值为CreateAccount。

AccountName String 是 test

需要创建的账号名称。
AccountPassword String 是 Test@1111

需要新建的账号密码。
AccountPrivilege String 是 ReadWrite,ReadWrite

新创建的账号在目标数据库下的权限，取值范围如下：

  • ReadWrite：读写
  • ReadOnly：只读
  • DML：仅DML
  • DDL：仅DDL
  • ReadIndex：只读和索引
DBInstanceName String 是 pxc-****************

实例ID。

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

账号授权的数据库名称，多个数据库名称间用英文逗号（,）分隔。

说明 您可以调用DescribeDbList接口查看目标实例下的数据库详情，包括数据库名称。
RegionId String 是 cn-hangzhou

实例所在地域ID。

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

账号描述信息。最长支持256个字符。
SecurityAccountName String 否 test_dsa

安全管理员账号名称。

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

安全管理员账号的密码。

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

返回数据

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

请求返回消息。

说明 请求成功时该参数为空，请求失败时会返回请求异常信息（如错误码等）。
RequestId String B423E486-BB3C-4BED-828B-471B69******

请求ID。
Success Boolean true

请求是否成功。

示例

请求示例

http(s)://polardbx.cn-hangzhou.aliyuncs.com/?Action=CreateAccount
&AccountName=test
&AccountPassword=Test@1111
&AccountPrivilege=ReadWrite,ReadWrite
&DBInstanceName=pxc-****************
&DBName=db1,db2
&RegionId=cn-hangzhou
&<公共请求参数>

正常返回示例

XML格式 

<code>200</code>
<data>
    <RequestId>B423E486-BB3C-4BED-828B-471B69******</RequestId>
    <Message/>
    <Success>true</Success>
</data>
<httpStatusCode>200</httpStatusCode>
<requestId>B423E486-BB3C-4BED-828B-471B69******</requestId>
<successResponse>true</successResponse>

JSON格式 

{
	"code": "200",
	"data": {
		"RequestId": "B423E486-BB3C-4BED-828B-471B69******",
		"Message": "",
		"Success": true
	},
	"httpStatusCode": "200",
	"requestId": "B423E486-BB3C-4BED-828B-471B69******",
	"successResponse": true
}

错误码

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