您可以創建自動彈性伸縮配置,讓系統能夠按照配置的伸縮規則自動增加或減少計算資源,滿足您的集群工作負載的需求。創建過程中,您可以指定擴縮容的度量指標和閾值、擴容順序、靜默時間等。
調試
您可以在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 數量)之間的時間間隔。單位:分鐘。默認值:10 分鐘。 | 10m |
unneeded_duration | string | 否 | 靜默時間。距離最近一次擴容完成后,彈性組件不執行縮容的時間間隔。 擴容出的節點,在靜默時間過后,才能進入縮容判斷。單位:分鐘。 | 10m |
utilization_threshold | string | 否 | 縮容閾值,節點上 Request 的資源與總資源量的比值。 僅當該比值低于配置的閾值時,即節點的 CPU 和內存資源利用率均低于縮容閾值時,節點才有可能被縮容。 | 0.5 |
gpu_utilization_threshold | string | 否 | GPU 縮容閾值,節點上 Request 的資源與總資源量的比值。 僅當該比值低于配置的閾值時,即節點的 CPU、內存和 GPU 資源利用率均低于 GPU 縮容閾值時,GPU 節點才有可能被縮容。 | 0.5 |
scan_interval | string | 否 | 彈性靈敏度,用于調整系統判斷伸縮的間隔時間。單位:s。默認值為 60s。 | 30s |
scale_down_enabled | boolean | 否 | 是否允許進行節點縮容。取值:
| true |
expander | string | 否 | 節點池擴容順序策略。取值:
| least-waste |
skip_nodes_with_system_pods | boolean | 否 | cluster-autoscaler 是否縮容運行在 kube-system 命名空間下的 Pod 所在的節點,此功能對 DaemonSet Pod 和 Mirror Pod 不生效。取值:
| true |
skip_nodes_with_local_storage | boolean | 否 | cluster-autoscaler 是否縮容包含本地存儲(如 EmptyDir 或 HostPath)的 Pod 所在的節點。取值:
| false |
daemonset_eviction_for_nodes | boolean | 否 | cluster-autoscaler 縮容時,是否驅逐節點上的 DaemonSet Pods。取值:
| false |
max_graceful_termination_sec | integer | 否 | 縮容節點時等待節點上 Pod 終止的最長時間。單位:s。 | 14400s |
min_replica_count | integer | 否 | 節點縮容前每個 ReplicaSet 中允許的 Pod 最小數量。 | 0 |
recycle_node_deletion_enabled | boolean | 否 | 極速模式節點縮容成功后,是否刪除其對應的 K8s Node 對象。關于極速模式更多信息,請參見伸縮模式 。默認值:false。取值:
| false |
scale_up_from_zero | boolean | 否 | 集群 Ready 節點數為 0 時,cluster-autoscaler 是否執行擴容。默認值:true。取值:
| true |
返回參數
示例
正常返回示例
JSON
格式
{
"cluster_id": "cc212d04dfe184547bffaa596********",
"task_id": "T-5fd211e924e1d007********",
"request_id": "AF8BE105-C32B-1269-9774-5510********"
}
錯誤碼
訪問錯誤中心查看更多錯誤碼。
變更歷史
變更時間 | 變更內容概要 | 操作 |
---|---|---|
2024-12-05 | OpenAPI 返回結構發生變更 | 查看變更詳情 |
2023-06-02 | API 內部配置變更,不影響調用 | 查看變更詳情 |