云数据库 RDS

产品文档

云数据库 RDS

describeAccounts

描述

查看某个RDS实例下所有账号信息,包括账号名称、对各个数据库的访问权限信息等

请求方式

GET

请求地址

https://rds.jdcloud-api.com/v1/regions/{regionId}/instances/{instanceId}/accounts

名称 类型 是否必需 默认值 描述
regionId String True 地域代码,取值范围参见《各地域及可用区对照表》
instanceId String True RDS 实例ID,唯一标识一个RDS实例

请求参数

名称 类型 是否必需 默认值 描述
pageNumber Integer False 显示数据的页码,默认为1,取值范围:[-1,∞)。pageNumber为-1时,返回所有数据页码;超过总页数时,显示最后一页;
pageSize Integer False 每页显示的数据条数,默认为100,取值范围:[10,100],用于查询列表的接口

返回参数

名称 类型 描述
result Result

Result

名称 类型 描述
accounts Account[ ]
totalCount Integer

Account

名称 类型 描述
accountName String 账号名,账号名的具体规则可参见帮助中心文档:名称及密码限制
accountStatus String 账号状态,参见枚举参数定义
- MySQL:不支持,不返回该字段
- SQL Server:返回该字段
accountType String 账号类型,normal:普通,super:高权限
- 仅支持SQL Server
createTime String 创建账号时间,格式为:YYYY-MM-DD HH:mm:ss
- 仅支持PostgreSQL
updateTime String 修改账号时间,格式为:YYYY-MM-DD HH:mm:ss
- 仅支持PostgreSQL
notes String 账号备注内容
- 仅支持PostgreSQL
accountPrivileges AccountPrivilege[ ] 具有的权限

AccountPrivilege

名称 类型 描述
dbName String 数据库名称,具体规则可参见帮助中心文档:名称及密码限制
privilege String 账号对数据库所具有的权限,权限的具体定义可以参见枚举参数定义

返回码

返回码 描述
200 OK

请求示例

GET

public void testDescribeAccounts() {
    DescribeAccountsRequest request = new DescribeAccountsRequest();
    request.setRegionId("cn-north-1");
    request.setInstanceId("mysql-wp4e9ztap2");
    DescribeAccountsResponse response = rdsClient.describeAccounts(request);
    System.out.println(new Gson().toJson(response));
}

返回示例

{
    "requestId": "bpa03bvk9sf8qkbri7215avh7k4q2rdv", 
    "result": {
        "accounts": [
            {
                "accountName": "dj_ac", 
                "accountPrivileges": [ ], 
                "accountStatus": "RUNNING"
            }
        ], 
        "totalCount": 1
    }
}
更新时间:2020-01-19 16:57:34
feedback