查询用户列表

更新时间：2023-10-09 08:06:25下载pdf

本文介绍查询用户列表的 API。

接口描述

根据权限 ID，查询指定权限关联的用户列表。

接口地址

GET: /v2.0/cloud/iam/user/permission/{permission_id}

请求参数

参数名	类型	参数位置	是否必填	说明
permission_id	Long	uri	true	权限 ID。
last_row_key	Long	query	false	起始查询 ID。
page_size	Integer	query	false	单页页面大小。

返回参数

参数名	类型	说明
success	Boolean	请求是否成功。 `true`：请求成功。 `false`：请求失败。
error_code	String	详见错误码。
error_msg	String	错误信息，成功时为空。
result	QueryUserListByPermissionRes	返回结果。

result 说明

参数名	类型	说明
permission_id	Long	权限 ID。
permission_name	String	权限名称。
permission_desc	String	权限描述。
user_ids	List	用户 ID（UID）列表。
last_row_key	Long	起始查询 ID。
page_size	Integer	单页页面大小。
total	Integer	总数。

user_ids 说明

参数名	类型	说明
user_id	String	用户 ID。
gmt_create	Long	创建时间。

请求示例

GET: /v2.0/cloud/iam/user/permission/123?last_row_key=0&page_size=100

返回示例

{
    "tid": "195bceee56b411ee801ef25dabf95fef",
    "result": {
        "last_row_key": 181044,
        "user_ids": [
            {
                "gmt_create": 1695104201,
                "user_id": "uid123"
            }
        ],
        "permission_id": 232371810,
        "permission_name": "权限名称",
        "total": 15,
        "permission_desc": "描述",
        "page_size": 10
    },
    "t": 1695104201504,
    "success": true
}

错误码

参考错误码。

上一篇查询权限数据

下一篇创建权限