查询角色成员

GET https://api.moi.matrixorigin.cn/v5/workspaces/{workspace_id}/iam/roles/{role_id}/members

调用前准备

先读取角色列表取得规范正整数角色 ID;准备有工作区 role.read 的当前角色、工作区凭据。返回的是直接绑定用户,不能把显示名或邮箱当 user_id。

请求

curl -X GET "https://api.moi.matrixorigin.cn/v5/workspaces/$WORKSPACE_ID/iam/roles/$ROLE_ID/members" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID" \
  --get \
  --data-urlencode "limit=1"
curl -X GET "https://api.moi.matrixorigin.cn/v5/workspaces/$WORKSPACE_ID/iam/roles/$ROLE_ID/members" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID" \
  --get \
  --data-urlencode "limit=1" \
  --data-urlencode "cursor=$NEXT_CURSOR"

返回非空 next_cursor 时将其原样保存为 NEXT_CURSOR,再读取:

字段

类型

说明

limit

integer

默认 50,1–200;空值使用默认值。

cursor

string

上一页的 next_cursor;首次省略。

返回结果

{
  "code": "OK",
  "msg": "OK",
  "data": {
    "role_id": "8",
    "members": [
      {
        "user_id": "canonical-user-example",
        "display_name": "Example user",
        "email": "",
        "default_role": false,
        "default_role_version": 2,
        "binding_created_at": 1794390000
      }
    ],
    "next_cursor": "canonical-user-example",
    "request_id": "request-example",
    "trace_id": "trace-example"
  }
}

结果按 canonical user_id 升序,next_cursor 为空时结束。目录资料按当前页批量补充;确认资料缺失保留用户及空展示值,目录读取失败返回依赖错误,不改成空列表。binding_created_at 为 Unix 秒,default_role_version 是该用户默认角色版本。

空列表不能单独证明角色存在;当前所读服务/DAO 未先按目标角色查存在性。列表不汇总继承成员,也不解绑用户。用于删除时还需另外读取当前删除影响,读取空成员页不代表可删除。

最后更新于