# 转移对象所有者角色

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

```text
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 例外，但尚未在该链路确认，详见本页末尾。

## 请求

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

```bash
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}')"
```

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

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| target_role_id | string，必填 | 接收对象的角色，与当前所有者不同。 |
| expected_ownership_version | integer，必填 | 该对象的当前整数版本，必须大于 0；不是删除集合版本。 |
| request_id | string，必填 | 固定本次转移身份；未知结果保留原内容。 |

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

## 返回结果

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

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

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

所有权、版本、幂等回执及审计同事务提交。当前记录必须 active 且无 repair_state，接收角色须 active/ready；版本或请求内容冲突为 409 ErrIAMObjectGrantConflict，输入无效为 422 ErrIAMObjectGrantInvalid，缺失为 404 ErrIAMResourceNotFound。重放同请求返回原回执，后续实时授权仍需通过。

此接口转移单对象的规范 Ownership，不删除角色，不把源角色的 MatrixOne 数据权限复制给接收者。多个独立对象逐一转移时，先前成功项不因后续失败而自动回退。

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

## 待澄清的权限合同

规范的对象 Owner（含继承 Owner）例外与当前权限检查边界的固定 workspace role.manage_policy 要求存在差异。没有真实 owner-only 调用或完整 PDP 反证，不能对外承诺仅为 Owner 就可调用，也不能把实现差异自动改成长期产品规则。该页只作内部待澄清稿。
