更换代理

请求路径

/api/open/app/instance/change/v2

请求参数

主接口中的params参数

参数二级参数类型必填说明
instanceNo-string是平台实例编号，必须是当前渠道商名下运行中的实例
appOrderNo-string(64)是渠道商更换代理订单号，同一渠道商下保持唯一；重复提交同一个订单号会返回已有更换订单状态，不会重复更换
targetProductNo-string否目标平台产品编号，预留字段；未传时由平台按当前实例和供应商规则更换
targetCidrBlocks-array否目标IP网段，预留字段
-cidrstring否目标网段，例如 192.168.0.0/24
-countint否目标网段数量
reason-string否更换原因，最多64个字符

eg

{
    "instanceNo": "c_gz3h2igp6dz9cq3",
    "appOrderNo": "CHANGE20260609143000",
    "reason": "代理不可用"
}

返回数据

参数二级参数类型必填说明
orderNo-string是平台更换代理订单号
appOrderNo-string是渠道商更换代理订单号，原样返回
instanceNo-string是平台实例编号
status-int8是更换状态 1=待处理 2=处理中 3=处理成功 4=处理失败
备注：
  • 更换代理为异步操作。接口返回后会创建更换代理订单并进入后台处理，处理完成后按订单回调，具体查看回调章节。
  • 更换成功后，原平台实例编号不变，实例的IP、端口、账号、密码等代理连接信息可能会更新。收到回调后请通过获取订单信息或获取实例信息拉取最新实例信息。
  • 获取订单信息支持通过平台更换代理订单号 orderNo 或渠道商更换代理订单号 appOrderNo 查询更换结果，订单类型为 5=更换代理。
  • 同一实例同一时间只允许一个更换代理任务处理中。只有产品返回 changeProxy=1 且渠道商已开通更换代理能力时，才可调用该接口。