查看角色继承关系¶

查看指定角色的直接父角色及当前继承关系，为添加或删除继承关系提供依据。

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

调用前准备¶

先选择角色。

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

请求参数¶

输入示例

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

参数说明

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

成功响应¶

成功时返回该角色的直接继承边和当前角色图版本。更新继承关系时应提交此版本。

响应示例

{
  "code": "OK",
  "msg": "OK",
  "data": {
    "edges": [
      {
        "child_role_id": "role-001",
        "parent_role_id": "role-parent",
        "with_grant_option": false,
        "grant_id": "grant-001"
      }
    ],
    "role_graph_version": "graph-v1"
  }
}

字段说明

字段	类型	说明
code	string	成功时为 OK。
msg	string	成功时为 OK。
data.edges	array of object	当前角色的直接继承边。
data.edges[].child_role_id	string	子角色 ID。
data.edges[].parent_role_id	string	父角色 ID。
data.edges[].with_grant_option	boolean	是否继承转授权限。
data.edges[].grant_id	string	继承授权 ID。
data.role_graph_version	string	当前角色图版本。

错误响应¶

响应示例

{
  "code": "ErrParamInvalid",
  "msg": "请求参数无效",
  "data": null
}

字段说明

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

后续操作¶

确认继承关系¶

添加或删除角色继承前，先确认当前直接父角色关系，并以本页读取到的当前关系为准准备变更。

最后更新于 2026 年 9 月 11 日