DeleteClusterNodes - 移除集群节点 - 容器服务 Kubernetes 版 ACK

当您不再需要集群节点继续工作时，可以调用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

路径参数

名称	类型	必填	描述	示例值
ClusterId	string	是	集群 ID。	c850429a2287b4d968e27e87a4921****

请求参数

名称	类型	必填	描述	示例值
body	object	否	请求体参数。
drain_node	boolean	否	是否自动排空节点上的 Pod。取值： `true`：自动排空节点上的 Pod。 `false`：不自动排空节点上的 Pod。默认值：`false`。	false
release_node	boolean	否	是否同时移除 ECS。取值： `true`：同时移除 ECS。 `false`：保留 ECS。默认值：`false`。说明当节点为包年包月实例时，不支持同时移除 ECS。	true
nodes	array	是	移除节点列表，节点名称必须是节点在集群中的名称，例如：`cn-hangzhou.192.168.xx.xx`。
	string	否	节点名称。	cn-hangzhou.192.168.xx.xx

返回参数

名称	类型	描述	示例值
	object	返回数据体。
cluster_id	string	集群 ID。	c104d5d5f301c4e2a8ee578c37******
request_id	string	请求 ID。	A9891419-D125-4D89-AFCA-688466******
task_id	string	任务 ID。	T-60fea8ad2e27000ae9******

示例

正常返回示例

JSON格式

{
  "cluster_id": "c104d5d5f301c4e2a8ee578c37******",
  "request_id": "A9891419-D125-4D89-AFCA-688466******",
  "task_id": "T-60fea8ad2e27000ae9******"
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。