当您不再需要集群节点继续工作时，可以调用DeleteClusterNodes接口将集群中的节点移出集群。移除节点时，您可以选择是否同时释放ECS、是否自动排空节点。
接口说明
-
移除节点时，请通过本接口或容器服务控制台执行标准化操作。请勿使用
kubectl delete node方式手动移除节点。 -
请勿直接在 ECS 或者 ESS 控制台（或通过相关 API）主动释放节点、移除实例，或因包年包月实例到期而被动释放节点。这些情况下，节点会直接停机，自动从容器服务管理控制台中移除。
-
如果节点池设置了期望节点数，为了将节点个数始终维持在期望节点数，节点池会根据相应配置自动扩容其他实例。
-
移除节点涉及 Pod 的迁移，可能会影响业务，请在业务低峰期操作。操作过程中可能存在非预期风险，请提前做好相关的数据备份。
-
移除节点时，ACK 会执行排水操作，请确保集群其他节点的资源充足，以避免业务 Pod 无法调度。
-
需检查待移除节点上的 Pod 的节点亲和性规则和调度策略，确保 Pod 不会因为节点移除而无法调度到其他节点。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：
- 操作：是指具体的权限点。
- 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
- 资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用
全部资源表示。
- 条件关键字：是指云产品自身定义的条件关键字。
- 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。
| 操作 | 访问级别 | 资源类型 | 条件关键字 | 关联操作 |
|---|---|---|---|---|
| cs:DeleteClusterNodes | delete | *Cluster acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId} |
| 无 |
请求语法
POST /clusters/{ClusterId}/nodes HTTP/1.1
DELETE /clusters/{ClusterId}/nodes HTTP/1.1
POST /clusters/{ClusterId}/nodes HTTP/1.1
DELETE /clusters/{ClusterId}/nodes HTTP/1.1
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| ClusterId | string | 是 | 集群 ID。 | c850429a2287b4d968e27e87a4921**** |
| body | object | 否 | 请求体参数。 | |
| drain_node | boolean | 否 | 是否自动排空节点上的 Pod。取值：
默认值： | false |
| release_node | boolean | 否 | 是否同时移除 ECS。取值：
默认值： 说明
当节点为包年包月实例时，不支持同时移除 ECS。
| true |
| nodes | array | 是 | 移除节点列表，节点名称必须是节点在集群中的名称，例如： | |
| string | 否 | 节点名称。 | cn-hangzhou.192.168.xx.xx |
返回参数
示例
正常返回示例
JSON格式
{
"cluster_id": "c104d5d5f301c4e2a8ee578c37******",
"request_id": "A9891419-D125-4D89-AFCA-688466******",
"task_id": "T-60fea8ad2e27000ae9******"
}错误码
访问错误中心查看更多错误码。
变更历史
| 变更时间 | 变更内容概要 | 操作 |
|---|