补登记历史计算实例所有权¶

为历史计算实例补登记工作区所有权。仅工作区的 super_admin 可以调用，此操作不转移所有者。

POST https://api.moi.matrixorigin.cn/v5/compute-resources/{resource_id}/adopt-legacy-ownership

调用前准备¶

确认当前角色为工作区的 super_admin。

先查询计算实例详情确认目标是需要修复的历史资源。准备可访问目标工作区的个人访问令牌、目标工作区 ID 和计算资源 ID。

请求参数¶

输入示例

curl -X POST "https://api.moi.matrixorigin.cn/v5/compute-resources/$RESOURCE_ID/adopt-legacy-ownership" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID"

参数说明

登记使用当前可信角色，不能指定其他所有者。请求标识和追踪标识以服务端记录为准。已有相同且有效的所有权记录时，可返回原有结果。

字段	类型	是否必填	说明
`resource_id`	string	是	计算资源 ID。

成功响应¶

响应示例

{
  "code": "OK",
  "msg": "OK",
  "data": {
    "workspace_id": "ws-01",
    "resource_type": "compute_resource",
    "resource_id": "cr-01",
    "owner_role_id": "role-owner",
    "authorized_role_id": "role-admin",
    "status": "active",
    "ownership_version": 1,
    "idempotent_replay": false
  }
}

字段说明

字段	类型	说明
`code`	string	成功时为 `OK`。
`msg`	string	成功时为 `OK`。
`data`	object	响应数据。
`data.workspace_id`	string	资源所属工作区 ID。
`data.resource_type`	string	资源类型。
`data.resource_id`	string	计算资源 ID。
`data.owner_role_id`	string	所有者角色 ID。
`data.authorized_role_id`	string	本次授权角色 ID。
`data.status`	string	所有权记录状态。
`data.ownership_version`	integer	所有权版本号。
`data.idempotent_replay`	boolean	是否为幂等重放。

错误响应¶

存在其他所有者，或所有权记录非活动、重复时，接口拒绝请求。

响应示例

{
  "code": "OWNERSHIP_REPAIR_FAILED",
  "msg": "服务器内部错误",
  "data": null
}

字段说明

字段	类型	说明
`code`	string	错误代码。
`msg`	string	错误说明。
`data`	null	错误时为空。

常见 HTTP 错误¶

HTTP 状态码	错误代码	常见原因	建议操作
400	`INVALID_PARAMS`	请求字段、工作区或操作前置条件无效。	修正参数后再提交。
401	`Unauthorized`	认证凭据缺失或无效。	检查凭据类型、有效期及认证头。
403	`ErrForbidden`	当前身份或有效角色无执行该操作的权限。	使用有权限的身份，或联系管理员授权。
404	`NOT_FOUND`	目标对象或所需引用未找到。	核对对象标识、所属工作区和当前状态。
500	`OWNERSHIP_REPAIR_FAILED`	内部处理失败；写操作可能已有部分效果。	保留请求和追踪信息，先核对当前结果。
503	`OWNERSHIP_REPAIR_FAILED`、`OWNERSHIP_REPAIR_UNAVAILABLE`、`ErrServiceUnavailable`	业务、运行时或授权依赖暂不可用。	恢复依赖后先核对已有结果，不自动重复写入。

最后更新于 2026 年 10 月 19 日