查询角色删除前的所有权列表¶
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 核对;部分类型的名称补充可能为空。工作流名称从同工作区系统库补充,失败不返回部分页面。读取本页不会转移、删除对象或删除角色。
最后更新于