全部產品
Search
文件中心

Container Service for Kubernetes:DeleteClusterNodes - 移除叢集節點

更新時間:Apr 04, 2026

當您不再需要叢集節點繼續工作時,可以調用DeleteClusterNodes介面將叢集中的節點移出叢集。移除節點時,您可以選擇是否同時釋放ECS、是否自動排空節點。

介面說明

  • 移除節點時,請通過本介面或Container Service控制台執行標準化操作。請勿使用kubectl delete node方式手動移除節點。

  • 請勿直接在 ECS 或者 ESS 控制台(或通過相關 API)主動釋放節點、移除執行個體,或因訂用帳戶執行個體到期而被動釋放節點。這些情況下,節點會直接停機,自動從Container Service管理主控台中移除。

  • 如果節點池設定了期望節點數,為了將節點個數始終維持在期望節點數,節點池會根據相應配置自動擴容其他執行個體。

  • 移除節點涉及 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******"
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情