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

调试

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

请求参数

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

系统规定参数,取值为CreateAccount

AccountName String testacc

账号名称,需符合如下要求:

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

账号密码,需符合如下要求:

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

集群ID。

AccountType String Normal

账号类型,取值范围如下:

  • Normal:普通账号。
  • Super:高权限账号。
说明
  • 若该参数留空,则默认创建Super账号。
  • 每个集群最多只允许创建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只读权限,您需要设置DBNameDB1,DB2,并设置AccountPrivilegeReadWrite,ReadOnly
  • 仅PolarRDB MySQL集群普通账号支持设置该参数。

返回数据

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

请求ID。

示例

请求示例

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

正常返回示例

XML 格式

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

JSON 格式

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

错误码

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