CreateAutoscalingConfig - 建立Auto Scaling配置 - Container Service for Kubernetes

您可以建立自動Auto Scaling配置，讓系統能夠按照配置的伸縮規則自動增加或減少計算資源，滿足您的叢集工作負載的需求。建立過程中，您可以指定擴縮容的度量指標和閾值、擴容順序、靜默時間等。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

cs:CreateAutoscalingConfig

create

*Cluster

acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId}

無

請求文法

POST /cluster/{ClusterId}/autoscale/config/ HTTP/1.1

路徑參數

名稱	類型	必填	描述	樣本值
ClusterId	string	是	叢集 ID。	cdde1f21ae22e483ebcb068a6eb7f****

請求參數

名稱	類型	必填	描述	樣本值
body	object	否	請求體參數。
cool_down_duration	string	否	縮容觸發時延，從檢測到有縮容需求（達到縮容閾值）到實際執行縮容操作（縮容 Pod 數量）之間的時間間隔。取值範圍：[1,60]，單位：分鐘。預設值：10。	10
unneeded_duration	string	否	靜默時間。距離最近一次擴容完成後，彈性組件不執行縮容的時間間隔。擴容出的節點，在靜默時間過後，才能進入縮容判斷。取值範圍：[1,60]，單位：分鐘。預設值：10。	10
utilization_threshold	string	否	縮容閾值，節點上 Request 的資源與總資源量的比值。僅當該比值低於配置的閾值時，即節點的 CPU 和記憶體資源使用率均低於縮容閾值時，節點才有可能被縮容。取值範圍：[0.1~1]。預設值：0.5，即 50%。	0.5
gpu_utilization_threshold	string	否	GPU 縮容閾值，節點上 Request 的資源與總資源量的比值。僅當該比值低於配置的閾值時，即節點的 CPU、記憶體和 GPU 資源使用率均低於 GPU 縮容閾值時，GPU 節點才有可能被縮容。取值範圍：[0.1~1]。預設值：0.3，即 30%。	0.3
scan_interval	string	否	彈性靈敏度，用於調整系統判斷伸縮的間隔時間。取值範圍：15，30，60，120，180，300。單位：秒。預設值：60。	30
scale_down_enabled	boolean	否	是否允許進行節點縮容。取值： `true`：允許縮容。 `false`：禁止縮容。枚舉值： true : true false : false	true
expander	string	否	節點池擴容順序策略。取值： `least-waste` ：預設策略。如果可擴容節點池有多個，從中選擇一個資源浪費最少的節點池進行擴容。 `random`：隨機策略。如果可擴容節點池有多個，從中任意選擇一個節點池進行擴容。 `priority` ：優先順序策略。如果可擴容節點池有多個，會按照您自訂的伸縮組順序，選擇優先順序高的節點池進行擴容。節點池優先順序通過`priorities`參數定義。枚舉值： random : random least-waste : least-waste priority : priority	least-waste
skip_nodes_with_system_pods	boolean	否	cluster-autoscaler 是否縮容運行在 kube-system 命名空間下的 Pod 所在的節點，此功能對 DaemonSet Pod 和 Mirror Pod 不生效。取值： `true`：不會縮容。 `false`：縮容。枚舉值： true : true false : false	true
skip_nodes_with_local_storage	boolean	否	cluster-autoscaler 是否縮容包含本機存放區（如 EmptyDir 或 HostPath）的 Pod 所在的節點。取值： `true`：不會縮容。 `false`：縮容。枚舉值： true : true false : false	false
daemonset_eviction_for_nodes	boolean	否	cluster-autoscaler 縮容時，是否驅逐節點上的 DaemonSet Pods。取值： `true`：驅逐。 `false`：不會驅逐。枚舉值： true : true false : false	false
max_graceful_termination_sec	integer	否	縮容情境下，節點排水時 cluster-autoscaler 等待 Pod 終止的逾時時間長度。單位：秒。預設值：14400。	14400
min_replica_count	integer	否	節點縮容前每個 ReplicaSet 中允許的 Pod 最小數量。預設值：0。	0
recycle_node_deletion_enabled	boolean	否	極速模式節點縮容成功後，是否刪除其對應的 K8s Node 對象。關於極速模式更多資訊，請參見伸縮模式。預設值：false。取值： `true`：極速模式停機後 K8s Node 對象也被刪除。不建議設定為 true，可能導致 K8s 對象資料不一致的問題。 `false`：極速模式停機後 K8s Node 對象保留。枚舉值： true : true false : false	false
scale_up_from_zero	boolean	否	叢集 Ready 節點數為 0 時，cluster-autoscaler 是否執行擴容。預設值：true。取值： `true`：執行擴容。 `false`：不執行擴容。枚舉值： true : true false : false	true
scaler_type	string	否	彈性組件類型，叢集版本 1.24 及以上預設為 goatscaler，以下預設為 cluster-autoscaler。取值： `goatscaler`：即時彈性。 `cluster-autoscaler`：自動調整。枚舉值： goatscaler : goatscaler cluster-autoscaler : cluster-autoscaler	goatscaler
priorities	object	否	自動調整優先順序配置，建立開啟了彈性的節點池後，可以通過啟用節點自動調整選擇是否配置優先順序策略與優先順序配置，為指定的自動調整節點池伸縮組配置優先順序。取值範圍為[1, 100]，必須為正整數。數字越大，優先順序越高。
	array	否	同一優先順序的自動調整節點池伸縮組 ID。
	string	否	自動調整節點池的伸縮組 ID。	asg-bp1fe63lqz******

返回參數

名稱	類型	描述	樣本值
	object
cluster_id	string	叢集 ID。	cc212d04dfe184547bffaa596********
task_id	string	任務 ID。	T-5fd211e924e1d007********
request_id	string	請求 ID。	AF8BE105-C32B-1269-9774-5510********

樣本

正常返回樣本

JSON格式

{
  "cluster_id": "cc212d04dfe184547bffaa596********",
  "task_id": "T-5fd211e924e1d007********",
  "request_id": "AF8BE105-C32B-1269-9774-5510********"
}

錯誤碼

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

變更歷史

更多資訊，參考變更詳情。