转移对象所有者角色¶
PUT https://api.moi.matrixorigin.cn/v5/workspaces/{workspace_id}/iam/permissions/objects/{resource_type}/{resource_id}/owner
调用前准备¶
准备真实资源类型/ID、当前单对象 ownership_version、目标 active/ready 角色及请求标识。当前源码的正式权限检查边界要求工作区 role.manage_policy;规范还描述 Owner 例外,但尚未在该链路确认,详见本页末尾。
请求¶
curl -X PUT "https://api.moi.matrixorigin.cn/v5/workspaces/$WORKSPACE_ID/iam/permissions/objects/$RESOURCE_TYPE/$RESOURCE_ID/owner" \
-H "X-API-Key: $AI_STUDIO_API_KEY" \
-H "X-Workspace-ID: $WORKSPACE_ID" \
-H 'Content-Type: application/json' \
--data-binary "$(jq -n --arg target "$TARGET_ROLE_ID" --arg request "$REQUEST_ID" --argjson version "$OWNERSHIP_VERSION" '{target_role_id:$target,expected_ownership_version:$version,request_id:$request}')"
字段 |
类型 |
说明 |
|---|---|---|
target_role_id |
string,必填 |
接收对象的角色,与当前所有者不同。 |
expected_ownership_version |
integer,必填 |
该对象的当前整数版本,必须大于 0;不是删除集合版本。 |
request_id |
string,必填 |
固定本次转移身份;未知结果保留原内容。 |
返回结果¶
{
"code": "OK",
"msg": "OK",
"data": {
"workspace_id": "workspace-example",
"resource_type": "connector",
"resource_id": "connector-example",
"previous_owner_role_id": "8",
"owner_role_id": "7",
"ownership_version": 4,
"request_id": "transfer-example",
"idempotent_replay": false
}
}
所有权、版本、幂等回执及审计同事务提交。当前记录必须 active 且无 repair_state,接收角色须 active/ready;版本或请求内容冲突为 409 ErrIAMObjectGrantConflict,输入无效为 422 ErrIAMObjectGrantInvalid,缺失为 404 ErrIAMResourceNotFound。重放同请求返回原回执,后续实时授权仍需通过。
此接口转移单对象的规范 Ownership,不删除角色,不把源角色的 MatrixOne 数据权限复制给接收者。多个独立对象逐一转移时,先前成功项不因后续失败而自动回退。
待澄清的权限合同¶
规范的对象 Owner(含继承 Owner)例外与当前权限检查边界的固定 workspace role.manage_policy 要求存在差异。没有真实 owner-only 调用或完整 PDP 反证,不能对外承诺仅为 Owner 就可调用,也不能把实现差异自动改成长期产品规则。该页只作内部待澄清稿。
最后更新于