查询角色删除前的所有权列表

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

调用前准备

准备规范角色 ID 和工作区凭据。普通删除检查要求 role.delete;transfer_requested=true 时额外要求 role.manage_policy。删除影响总量和阻断原因从既有 delete-impact 读取,本接口只读取一页对象。

请求

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

有下一游标时:

字段

类型

说明

limit

integer

默认 10,1–100;显式空值无效。

cursor

string

上一页 next_cursor,不能跨工作区/源角色复用。

transfer_requested

boolean

仅 true/false;省略为 false,空值无效。

返回结果

{
  "code": "OK",
  "msg": "OK",
  "data": {
    "items": [
      {
        "resource_type": "connector",
        "resource_id": "connector-example",
        "display_name": "Orders",
        "ownership_version": 3
      }
    ],
    "ownership_version": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
    "next_cursor": "eyJXb3Jrc3BhY2VJRCI6IndvcmtzcGFjZS1leGFtcGxlIiwiUm9sZUlEIjoiOCIsIlZlcnNpb24iOiJhYWFhYWFhYWFhYWFhYWFhYWFhYWFhYWFhYWFhYWFhYWFhYWFhYWFhYWFhYWFhYWFhYWFhYWFhYWFhYWFhYWFhIiwiUmVzb3VyY2VUeXBlIjoiY29ubmVjdG9yIiwiUmVzb3VyY2VJRCI6ImNvbm5lY3Rvci1leGFtcGxlIn0"
  }
}

items[].ownership_version 是单对象整数 CAS;外层 ownership_version 是删除集合版本字符串,两者不能互换。next_cursor 非空才继续。后续页承接首个集合版本,同时按当前数据读取,并非锁定不变快照;变更后应刷新,最终删除仍重新校验完整方案。

独立列表没有 owned_count 或全量总数。展示名缺失时使用规范资源 ID 核对;部分类型的名称补充可能为空。工作流名称从同工作区系统库补充,失败不返回部分页面。读取本页不会转移、删除对象或删除角色。

最后更新于