转移对象所有者角色

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 就可调用,也不能把实现差异自动改成长期产品规则。该页只作内部待澄清稿。

最后更新于