更新时间:2025-08-15 GMT+08:00

切换集群子网

功能介绍

该接口可以在集群创建成功后,切换集群子网,扩容等添加节点场景下使用新子网绑定新增节点。

同VPC下的子网默认网络联通,请确保新子网与您业务系统的网络连通性。另:开启了自动创建ipv6地址的集群只支持切换到开启了ipv6的新子网。

调用方法

请参见如何调用API

URI

POST /v1.0/{project_id}/clusters/{cluster_id}/subnet/change

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释

项目ID。获取方法请参见获取项目ID和名称

约束限制

不涉及

取值范围

账户的项目ID。

默认取值

不涉及

cluster_id

String

参数解释

待切换子网的集群ID。获取方法请参见获取集群ID

约束限制

不涉及

取值范围

集群ID。

默认取值

不涉及

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

subnet_id

String

参数解释

子网ID。

约束限制

格式为标准的UUID格式:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

取值范围

格式为标准的UUID格式:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

默认取值

不涉及

响应参数

状态码:200

请求已成功。

请求示例

修改集群当前子网。

POST /v1.0/6204a5bd270343b5885144cf9c8c158d/clusters/ea244205-d641-45d9-9dcb-ab2236bcd07e/subnet/change

{
  "subnet_id" : "b1234567-1f77-4ae9-b64d-9af56e123456"
}

响应示例

状态码

状态码

描述

200

请求已成功。

400

非法请求。

建议直接修改该请求,不要重试该请求。

403

请求被拒绝访问。

返回该状态码,表明请求能够到达服务端,且服务端能够理解用户请求,但是拒绝做更多的事情,因为该请求被设置为拒绝访问,建议直接修改该请求,不要重试该请求。

错误码

请参见错误码