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

```{raw} html
<div class="mo-api-page-show-toc" aria-hidden="true"></div>
```

```text
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 读取，本接口只读取一页对象。

## 请求

:::::::{div} mo-api-tabs
::::::{tab-set}
:::::{tab-item} 输入示例

```bash
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"
```

```bash
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"
```

:::::
:::::{tab-item} 参数说明

有下一游标时：



| 字段 | 类型 | 说明 |
| --- | --- | --- |
| limit | integer | 默认 10，1–100；显式空值无效。 |
| cursor | string | 上一页 next_cursor，不能跨工作区/源角色复用。 |
| transfer_requested | boolean | 仅 true/false；省略为 false，空值无效。 |

:::::
::::::
:::::::

## 返回结果

:::::::{div} mo-api-tabs mo-api-response-tabs
::::::{tab-set}
:::::{tab-item} 响应示例

```json
{
  "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"
  }
}
```

:::::
:::::{tab-item} 字段说明

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

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

:::::
::::::
:::::::
