查看当前身份角色¶

查看当前调用身份在目标工作区中拥有的角色，用于确认其可执行的权限范围。

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

调用前准备¶

准备具有目标工作区访问权限的个人访问令牌和目标工作区 ID。

请求参数¶

输入示例

curl -X GET "https://api.moi.matrixorigin.cn/v5/workspaces/$WORKSPACE_ID/iam/me/roles" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID"

参数说明

参数	类型	是否必填	说明
workspace_id	string	是	目标工作区 ID。

成功响应¶

成功时返回当前身份在工作区中的直接角色、默认角色、显式候选角色和最终生效角色。服务不会在默认角色缺失或候选无效时自动选择其他角色。

响应示例

{
  "code": "OK",
  "msg": "OK",
  "data": {
    "roles": [],
    "default_role_id": "role-001",
    "default_role_version": 2,
    "explicit_role_id": "",
    "effective_role_id": "role-001",
    "role_context_status": "ready",
    "schema_version": "schema-v1",
    "capability_version": "capability-v1",
    "request_id": "req-001",
    "trace_id": "trace-001"
  }
}

字段说明

字段	类型	说明
code	string	成功时为 OK。
msg	string	成功时为 OK。
data.roles	array of object	当前身份直接绑定的角色及其可选状态。
data.default_role_id	string	当前默认角色 ID。
data.default_role_version	integer	默认角色版本。
data.explicit_role_id	string	请求中指定并通过验证的显式角色 ID；未指定时为空。
data.effective_role_id	string	本次请求最终使用的角色 ID。
data.role_context_status	string	角色上下文状态：ready、default_missing、candidate_invalid 或 role_disabled。
data.schema_version	string	权限 Schema 版本。
data.capability_version	string	能力投影版本。
data.request_id	string	请求关联 ID。
data.trace_id	string	链路追踪 ID。

错误响应¶

响应示例

{
  "code": "ErrIAMCoreUnavailable",
  "msg": "服务暂时不可用",
  "data": null
}

字段说明

字段	类型	说明
code	string	错误代码。
msg	string	错误信息。
data	null	—

最后更新于 2026 年 9 月 11 日