如何在WSO2 APIM 4.0.0中更改API提供者

WSO2 APIM 4.0.0 原生支持API提供者（所有者）变更，直接修改wso2am_db单表数据失败的核心原因是API元数据关联了多张数据库表、注册表资源、网关运行时配置，仅修改AM_API表的API_PROVIDER字段会导致数据不一致，触发权限异常、API不可见、网关转发报错等问题。

注意：所有操作请先在测试环境验证通过，操作前必须全量备份wso2am_db数据库、APIM节点的<APIM_HOME>/repository/deployment/server/synapse-configs/default/api目录，避免操作失误导致服务故障。
变更前请确认目标用户已在用户存储中创建完成，且拥有API创建、发布的对应权限。

方案一：调用官方Publisher REST API（推荐，无数据一致性风险） #

该方案是官方原生支持的操作路径，会自动同步所有关联的数据库记录、注册表权限、运行时配置，单API/批量操作均适用：

• 先通过Password Grant或Client Credentials Grant获取管理员账号的Access Token，后续所有请求头携带Authorization: Bearer <管理员Token>
• 调用API列表查询接口，过滤条件指定provider=admin，拉取所有需要变更所有者的API UUID，接口基础路径为/api/am/publisher/v4/apis
• 遍历拿到的API UUID，逐个调用所有者变更接口：
  • 请求方法：POST
  • 接口路径：/api/am/publisher/v4/apis/change-owner
  • 请求体示例：

  {
    "apiId": "替换为待变更API的UUID",
    "newOwner": "替换为目标用户名",
    "newOwnerTenantDomain": "carbon.super",
    "keepOldOwnerPermissions": false
  }
  

  • 参数说明：
    • 若使用多租户部署，将newOwnerTenantDomain替换为目标用户所属的租户域名
    • keepOldOwnerPermissions设为true时会给原所有者admin保留该API的查看、编辑权限，不需要则设为false
• 所有API变更完成后，分别到Publisher控制台、DevPortal控制台抽查API的提供者字段，验证API订阅、调用功能是否正常。

如果API数量较多，可以写简单的Shell/Python脚本循环调用上述接口，批量执行效率远高于手动操作。

方案二：直接修改数据库（不推荐，仅适合离线维护场景） #

如果因环境限制必须直接改库，不能只修改AM_API表的API_PROVIDER字段，需要同步更新所有关联位置：

• 同步更新AM_API表中对应API记录的CREATED_BY、UPDATED_BY、API_PROVIDER字段为目标用户名
• 同步更新AM_API_DOCS、AM_API_COMMENTS、AM_API_RATINGS、AM_API_SUBSCRIPTIONS表中关联的创建人、提供者字段
• 进入WSO2管理控制台的注册表资源页面，修改/_system/governance/apimgt/applicationdata/provider/admin/路径下对应API的资源路径、资源权限，把admin替换为目标用户名
• 修改<APIM_HOME>/repository/deployment/server/synapse-configs/default/api目录下对应API的XML配置文件，替换所有硬编码的admin提供者字段
  所有修改完成后，删除所有APIM节点<APIM_HOME>/tmp、<APIM_HOME>/work目录下的缓存文件，重启全节点生效。

常见问题处理 #

• 变更完成后如果DevPortal看不到对应API，检查目标用户是否在API的可见范围内，可在Publisher端打开API配置点击保存后重新发布一次，触发权限同步
• 变更后如果网关调用报错，检查Synapse配置文件是否已同步更新，未同步的话可在Publisher端重新保存发布一次API，触发生成新的运行时配置

内容的提问来源于stack exchange，提问作者Frank