调用CreateAccount可以在Redis实例中创建有特定权限的账号。

说明
  • 该API仅支持4.0或以上版本的Redis实例；
  • 使用该API需要实例状态为运行中；
  • 一个实例下最多可创建18个账号。

该API对应的控制台操作请参见账号管理。

调试

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

请求参数

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

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

AccountName String 是 demoaccount

账号名，需满足以下条件：

  • 以英文字母开头，由小写英文字母、数字或下划线（_）组成。
  • 长度不超过100个字符。
  • 不能为Redis账号名保留字。
AccountPassword String 是 uWonno21****

账号的密码。长度为8~32位，需包含大写字母、小写字母、特殊字符和数字中的至少三种，允许的特殊字符包括!@#$%^&*()_+-=。

InstanceId String 是 r-bp1zxszhcgatnx****

实例ID。
AccountPrivilege String 否 RoleReadOnly

账号权限，取值：

  • RoleReadOnly：只读权限。
  • RoleReadWrite：读写权限，默认值。
AccountDescription String 否 testaccount

账号描述。

  • 需以中文、英文字母开头，不能以http: //或https: //开头。
  • 可以包含中文、英文字母、数字、下划线（_）和短划线（-）。
  • 长度为2~256个字符。
AccountType String 否 Normal

账号类型，取值固定为Normal（普通账号）。

RegionId String 否 cn-hangzhou

实例所属的地域ID。

返回数据

名称 类型 示例值 描述
AcountName String demoaccount

账号名称。
InstanceId String r-bp1zxszhcgatnx****

实例ID。
RequestId String ABAF95F6-35C1-4177-AF3A-70969EBD****

请求ID。

示例

请求示例

https://r-kvstore.aliyuncs.com/?Action=CreateAccount
&AccountName=demoaccount
&AccountPassword=uWonno21****
&InstanceId=r-bp1zxszhcgatnx****
&<公共请求参数>

正常返回示例

XML格式 

<CreateAccountResponse>
      <RequestId>D3876765-1983-4CBC-BB45-79EEBD6D****</RequestId>
      <InstanceId>r-bp1zxszhcgatnx****</InstanceId>
      <AcountName>demoaccount</AcountName>
</CreateAccountResponse>

JSON格式 

{
	"RequestId": "D3876765-1983-4CBC-BB45-79EEBD6D****",
	"InstanceId": "r-bp1zxszhcgatnx****",
	"AcountName": "demoaccount"
}

错误码

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