调用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:只读+索引
说明
  • 必须要传入DBName参数,AccountPrivilege才能生效。
  • 若为DBName参数传入了多个数据库名称,您需要为目标数据库分别授予相应的权限,多个账号权限间用英文逗号(,)分隔。例如,需要授权数据库DB1读写权限,授权数据库DB2只读权限,您需要设置DBNameDB1,DB2,并设置AccountPrivilegeReadWrite,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******"
}

错误码

HttpCode 错误码 错误信息 描述
400 LockTimeout The request processing has failed due to lock timeout. 由于锁定超时,请求处理失败
400 EngineMigration.ActionDisabled Specified action is disabled while custins is in engine migration. 当custins处于引擎迁移中时,指定的操作被禁用
404 InvalidDBClusterId.NotFound The DBClusterId provided does not exist in our records. 当前的记录中不存在提供的 DBClusterId。

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