如何在WSO2 API Manager Publisher中批量切换API端点至其他环境？

方法一：用APIM CLI（apictl）批量操作 #

这是官方最常用的批量操作方式，步骤如下：

• 配置环境并登录
  先把目标环境添加到apictl工具：

  apictl add env -n prod -e https://prod-apim.example.com:9443
  

  登录目标环境：

  apictl login prod -u admin -p admin -k
  

• 批量导出需要修改的API
  先列出当前环境的所有API：

  apictl list apis -e dev -k > api_list.txt
  

  写个简单的shell脚本循环导出所有API：

  while read line; do
    api_name=$(echo $line | awk '{print $1}')
    api_version=$(echo $line | awk '{print $2}')
    apictl export apis -n "$api_name" -v "$api_version" -e dev -k
  done < api_list.txt
  

• 批量替换端点URL
  用sed命令批量修改导出的API配置文件里的端点：

  sed -i 's/https:\/\/dev-backend.example.com/https:\/\/prod-backend.example.com/g' ~/.wso2apictl/exported/apis/dev/**/api.yaml
  

• 批量导入到目标环境
  同样用脚本循环导入：

  for dir in ~/.wso2apictl/exported/apis/dev/*/; do
    apictl import api -f "$dir" -e prod -k
  done
  

方法二：调用REST API批量更新 #

适合自动化集成场景，步骤：

• 获取API列表
  调用Publisher的API列表接口，带上认证Token（先通过POST /oauth2/token获取）：

  curl -X GET "https://dev-apim.example.com:9443/api/am/publisher/v1/apis" -H "Authorization: Bearer <ACCESS_TOKEN>" -k
  

  从返回结果中提取所有需要修改的API的id字段。
• 批量更新端点配置
  写个Python脚本遍历API ID，逐个发送PUT请求更新端点：

  import requests
  import json
  
  token = "<ACCESS_TOKEN>"
  base_url = "https://prod-apim.example.com:9443/api/am/publisher/v1/apis"
  headers = {"Authorization": f"Bearer {token}", "Content-Type": "application/json"}
  
  api_ids = ["api-uuid-1", "api-uuid-2"]  # 替换为实际获取的API ID列表
  new_endpoints = {
      "endpointConfig": {
          "endpoint_type": "http",
          "production_endpoints": {"url": "https://prod-backend.example.com/prod"},
          "sandbox_endpoints": {"url": "https://prod-backend.example.com/sandbox"}
      }
  }
  
  for api_id in api_ids:
      response = requests.put(f"{base_url}/{api_id}/endpoint-config", headers=headers, json=new_endpoints, verify=False)
      print(f"Updated API {api_id}: {response.status_code}")
  

方法三：提前用环境变量模板（长期最优方案） #

如果需要频繁切换环境，建议提前做配置规划：

• 创建API时，端点URL用占位符，比如${BACKEND_PROD_URL}和${BACKEND_SANDBOX_URL}
• 在不同环境的APIM节点的deployment.toml中配置对应变量：

  [apim.environment.variables]
  BACKEND_PROD_URL = "https://prod-backend.example.com/prod"
  BACKEND_SANDBOX_URL = "https://prod-backend.example.com/sandbox"
  

• 切换环境时，只需要修改目标环境APIM节点的deployment.toml，重启服务后所有API自动生效，无需逐个修改API配置

注意事项 #

• 操作前必须备份：用apictl export all -e dev -k导出所有API，或者备份APIM的数据库，防止操作失误
• 切换后验证：调用几个核心API测试端点连通性，确认订阅状态、限流策略不受影响
• 权限要求：操作账号必须拥有Publisher的API修改权限（比如admin角色或自定义的API编辑角色）

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