调用CreateAccount接口创建PolarDB数据库账号。

调试

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

请求参数

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

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

DBClusterId String 是 pc-**************

集群ID。
AccountName String 是 testacc

账号名称，需符合如下要求：

  • 以小写字母开头，以字母或数字结尾。
  • 由小写字母、数字或下划线组成。
  • 长度为2~16个字符。
  • 不能使用某些预留的用户名，如root、admin等。
AccountPassword String 是 Test1111

账号密码，需符合如下要求：

  • 至少包含大写字母、小写字母、数字或特殊字符中的任意三种。
  • 长度为8~32个字符。
  • 特殊字符为!@#$%^&*()_+-=。
AccountType String 否 Normal

账号类型，取值范围如下：

  • Normal：普通账号。
  • Super：高权限账号。
说明
  • 若该参数留空，则默认创建Super账号。
  • 当集群为PolarDB O引擎或PolarDB PostgreSQL引擎时，每个集群允许创建多个高权限账号，高权限账号相比普通账号拥有更多权限，创建数据库账号详情参见创建数据库账号。
  • 当集群为PolarDB MySQL引擎时，每个集群最多只允许创建1个高权限账号，高权限账号相比普通账号拥有更多权限，创建数据库账号详情参见创建数据库账号。
AccountDescription String 否 testdes

账号备注说明，需满足如下要求：

  • 不能以http://或https://开头。
  • 长度为2~256个字符。
DBName String 否 testdb

允许目标账号访问的数据库名称，支持传入多个数据库名称，多个数据库名称间用英文逗号（,）分隔。

说明 仅PolarDB MySQL引擎集群的普通账号支持该参数。
AccountPrivilege String 否 ReadWrite

账号权限，取值范围如下：

  • ReadWrite：读写
  • ReadOnly：只读
  • DMLOnly：只允许DML
  • DDLOnly：只允许DDL
  • ReadIndex：只读+索引
说明
  • 若该参数留空，则默认设置账号权限为ReadWrite。
  • 若为DBName参数传入了多个数据库名称，您需要为分别授权目标数据库相应的权限，多个账号权限间用英文逗号（,）分隔。例如，需要授权数据库DB1读写权限，授权数据库DB2只读权限，您需要设置DBName为DB1,DB2，并设置AccountPrivilege为ReadWrite,ReadOnly。
  • 仅PolarDB MySQL引擎集群的普通账号支持设置该参数。
ClientToken String 否 6000170000591aed949d0f54a343f1a4233c1e7d1c5c******

用于保证请求的幂等性，防止重复提交请求。由客户端生成该参数值，保证在不同请求间唯一，大小写敏感、不超过64个ASCII字符。

返回数据

名称 类型 示例值 描述
RequestId String CED079B7-A408-41A1-BFF1-EC608E******

请求ID。

示例

请求示例

http(s)://polardb.aliyuncs.com/?Action=CreateAccount
&AccountName=testacc
&AccountPassword=Test1111
&DBClusterId=pc-**************
&<公共请求参数>

正常返回示例

XML格式 

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateAccountResponse>
<RequestId>CED079B7-A408-41A1-BFF1-EC608E******</RequestId>
</CreateAccountResponse>

JSON格式 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "CED079B7-A408-41A1-BFF1-EC608E******"
}

错误码

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