更新时间：2026-09-02 GMT+08:00

切换集群子网

功能介绍

当集群所属子网中IP不足，无法执行扩容等添加节点的操作时，可使用本接口切换子网，切换后，扩容等添加节点场景下将使用新子网绑定新增节点，已有节点不会改变。

同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。约束限制：如果集群开启了自动创建ipv6地址，只支持切换到开启了ipv6的新子网。取值范围：子网ID需要和当前集群在同一个VPC下。默认取值：不涉及

响应参数

状态码：200

请求成功。

无

请求示例

切换集群子网。

POST https://{Endpoint}/v1.0/6204a5bd270343b5885144cf9c8c158d/clusters/ea244205-d641-45d9-9dcb-ab2236bcd07e/subnet/change

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

响应示例

无

状态码

状态码	描述
200	请求成功。
400	非法请求。建议直接修改该请求，不要重试该请求。
409	服务器在完成请求时发生冲突。返回该状态码，表明客户端尝试创建的资源已经存在，或者由于冲突请求的更新操作不能被完成。
412	未满足前提条件，服务器未满足请求者在请求中设置的其中一个前提条件。

错误码

请参见错误码。

父主题： 集群管理