查询应用侧角色成员列表

权限

身份管理API是以应用维度授权的，在调用接口前需为不同的应用设置接口权限，详情请参考API权限。

权限代码	描述
app_role_read	应用侧角色接口的读权限
read	所有读接口的权限
all	全部接口读写权限

请求说明

请求头

参数名	中文名称	必须	类型	描述
Authorization	授权	是	String	格式：Bearer {access_token}
Content-Type	内容类型	是	String	固定值：application/json; charset=utf-8

请求示例

无

请求参数

参数名	中文名称	必须	类型	描述
app_id	应用ID	是	String	目标应用ID
role_id	角色ID	是	String	目标角色ID
offset	分页页码	是	Int	从第0页开始
limit	每页数量	是	Int	每页数量在1-50之间

返回示例

成功示例

HTTP/1.1 200 OK

{
    "total": 1,
    "offset": 0,
    "limit": 10,
    "role_members": [
        {
            "id": "20220415171558023-84A4-ED5C390B8",
            "account_name": "test1",
            "name": null,
            "org_id": "20220414152016409-6146-2B006A262",
            "disabled": false,
            "account_type": "PUBLIC_ACCOUNT",
            "extension": {}
        }
    ]
}

错误示例

HTTP/1.1 400 Bad Request

{
    "error_code": " APP.ROLE.0002",
    "error_msg": "应用侧角色不存在"
}

返回参数

参数名	中文名称	类型	描述
total	总数	Int
offset	第几页	Int
limit	每页大小	Int
role_members	角色集合	List
--id	应用账号ID	String
--account_name	应用账号	String
--name	应用账号名称	String
--org_id	应用组织ID	String
--disabled	是否禁用	Boolean
--account_type	应用账号类型	String
-- extension	扩展属性	Object

错误码

状态码	错误码	中文错误信息	英文错误信息	处理措施
400	APP.ROLE.0002	应用侧角色不存在	The application side role does not exist	请检查应用侧角色是否已被删除
400	APP.OBJECTMODEL.0006	未开启应用角色模型	The application role model is not opened	请检查应用角色模型是否开启
400	APP.0001	应用不存在	App does not exist	请检查应用是否已被删除