查询当前调用身份的能力¶
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 形状不同。
最后更新于