查询当前调用身份的能力

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

调用前准备

准备工作区凭据与当前角色上下文;可复用已配置的 SDK/CLI 工作区角色映射。此接口返回当前调用身份的能力,不查询任意目标角色。

请求

curl -X GET "https://api.moi.matrixorigin.cn/v5/workspaces/$WORKSPACE_ID/iam/me/capabilities" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID" \
  --get \
  --data-urlencode "capability_id=action.role.create" \
  --data-urlencode "capability_id=navigation.roles"
curl -X GET "https://api.moi.matrixorigin.cn/v5/workspaces/$WORKSPACE_ID/iam/me/capabilities" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID"

省略筛选读取现有完整清单:

字段

类型

说明

capability_id

重复的 string 查询项

省略表示全量;按 ID 选择时每项独立传递,不用逗号拼接。

返回结果

{
  "code": "OK",
  "msg": "OK",
  "data": {
    "effective_role_id": "7",
    "capability_version": "definition-example",
    "request_id": "request-example",
    "trace_id": "trace-example",
    "items": [
      {
        "capability_id": "action.role.create",
        "action_id": "role.create",
        "resource_type": "workspace",
        "reason_code": "",
        "allowed": true,
        "all_resources": true,
        "resource_ids": []
      },
      {
        "capability_id": "navigation.roles",
        "action_id": "role.read",
        "resource_type": "workspace",
        "reason_code": "",
        "allowed": true,
        "all_resources": true,
        "resource_ids": []
      }
    ],
    "unsupported_capability_ids": []
  }
}

支持项及不支持项分别去重并按 ID 排序;未知 ID(包括空字符串)原样进入 unsupported_capability_ids,不使整个请求失败,也不自动 trim 或拆分。全部不支持仍为 200 和空 items,但仍执行当前身份/角色及成员有效性验证。查询编码损坏为 400 INVALID_ARGUMENT。

allowed=false 是明确返回的拒绝,不是不支持或查询失败。对象操作还需按 all_resources/resource_ids 判断范围;未请求项不能当无权限,旧版本/切换角色前的结果也不能作为当前授权。该结果不替代写操作实时鉴权。独立接口保留 action/resource/version 元数据,与 user/info 的精简 bootstrap 形状不同。

最后更新于