调用DescribeAccounts查找指定Redis实例的帐户列表信息或实例中某个账号的信息。

说明 本接口仅适用于4.0或以上版本的Redis实例。

调试

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

请求参数

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

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

RegionId String 否 cn-hangzhou

实例所属的地域ID。
InstanceId String 是 r-bp1zxszhcgatnx****

实例ID。
AccountName String 否 demoaccount

待查询的账号名。

返回数据

名称 类型 示例值 描述
RequestId String 6C9E114C-217C-4118-83C0-B4070222****

请求ID。
Accounts Array of Account

Redis实例的账号信息列表。
Account
AccountDescription String testdec

账号备注信息。
InstanceId String r-bp10noxlhcoim2****

实例ID。
AccountType String Normal

账号类型，返回值：

  • Normal：普通账号。
  • Super：超级账号。
AccountStatus String Available

账号状态，返回值：

  • Unavailable：不可用。
  • Available：可用。
AccountName String demoaccount

账号名称。
DatabasePrivileges Array of DatabasePrivilege

账号权限列表。
DatabasePrivilege
AccountPrivilege String RoleReadWrite

账号权限，返回值：

  • RoleReadOnly：只读权限。
  • RoleReadWrite：读写权限，默认值。

示例

请求示例

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

正常返回示例

XML格式 

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

<DescribeAccountsResponse>
    <RequestId>4A74FE3A-2BA8-4574-AB85-99C01707****</RequestId>
    <Accounts>
        <Account>
            <AccountStatus>Available</AccountStatus>
            <InstanceId>r-bp10noxlhcoim2****</InstanceId>
            <AccountType>Normal</AccountType>
            <DatabasePrivileges>
                <DatabasePrivilege>
                    <AccountPrivilege>RoleReadWrite</AccountPrivilege>
                </DatabasePrivilege>
            </DatabasePrivileges>
            <AccountName>r-bp10noxlhcoim2****</AccountName>
        </Account>
        <Account>
            <AccountDescription/>
            <AccountStatus>Available</AccountStatus>
            <InstanceId>r-bp10noxlhcoim2****</InstanceId>
            <AccountType>Normal</AccountType>
            <DatabasePrivileges>
                <DatabasePrivilege>
                    <AccountPrivilege>RoleReadWrite</AccountPrivilege>
                </DatabasePrivilege>
            </DatabasePrivileges>
            <AccountName>testaccount</AccountName>
        </Account>
    </Accounts>
</DescribeAccountsResponse>

JSON格式 

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

{
  "RequestId" : "4A74FE3A-2BA8-4574-AB85-99C01707****",
  "Accounts" : {
    "Account" : [ {
      "AccountStatus" : "Available",
      "InstanceId" : "r-bp10noxlhcoim2****",
      "AccountType" : "Normal",
      "DatabasePrivileges" : {
        "DatabasePrivilege" : [ {
          "AccountPrivilege" : "RoleReadWrite"
        } ]
      },
      "AccountName" : "r-bp10noxlhcoim2****"
    }, {
      "AccountDescription" : "",
      "AccountStatus" : "Available",
      "InstanceId" : "r-bp10noxlhcoim2****",
      "AccountType" : "Normal",
      "DatabasePrivileges" : {
        "DatabasePrivilege" : [ {
          "AccountPrivilege" : "RoleReadWrite"
        } ]
      },
      "AccountName" : "testaccount"
    } ]
  }
}

错误码

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