云服务器IP / API接口 / 节点切换
节点切换
推荐阅读时长：4分钟云服务器IP线路切换接口用于按订单编号批量切换线路。接口会校验订单归属和状态，切换任务进入队列后异步处理。
接口信息
| 请求方式 | POST |
|---|---|
| 接口路径 | /api/v1/cloud/change |
| 鉴权要求 | Authorization: Bearer {token} |
| Content-Type | application/json |
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
orderNo | array<string> | 是 | 订单编号列表。 |
nodes | array | 是 | 切换后的节点信息数组，至少 1 项。 |
nodes[].regionId | integer | 是 | 目标地区/线路 ID。 |
nodes[].count | integer | 是 | 该线路切换数量。 |
请求示例
{
"orderNo": [
"NOR66aabbccddeef"
],
"nodes": [
{
"regionId": 10002,
"count": 1
}
]
}响应示例
{
"code": 200,
"msg": "线路切换成功",
"data": []
}提示：线路切换是异步处理。接口返回成功表示任务已提交，最终线路状态建议通过订单查询或业务侧连接测试确认。
