全部產品
Search

搜尋本產品

    Container Service for Kubernetes：ModifyCluster - 修改叢集配置

    文件中心

    Container Service for Kubernetes：ModifyCluster - 修改叢集配置

    更新時間：May 22, 2026

    您可以調用ModifyCluster介面修改ACK叢集的配置。

    介面說明

    重要 自 2026 年 07 月 04 日起，請求入參 instance_deletion_protection、ingress_loadbalancer_id、access_control_list 不再生效。變更詳情請參見關於 ACK 叢集管理相關的 OpenAPI 出入參變化及 OpenAPI 下線的公告。

    調試

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

    調試

    授權資訊

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

    • 操作：是指具體的許可權點。

    • 存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。

    • 資源類型：是指操作中支援授權的資源類型。具體說明如下：

      • 對於必選的資源類型，用前面加 * 表示。

      • 對於不支援資源級授權的操作，用全部資源表示。

    • 條件關鍵字：是指雲產品自身定義的條件關鍵字。

    • 關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    cs:ModifyCluster

    update

    *Cluster

    acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId}
    • cs:EnableApiServerEip
    • cs:ApiServerEipId
    		 無

    請求文法

    PUT /api/v2/clusters/{ClusterId} HTTP/1.1

    路徑參數

    名稱

    類型

    必填

    描述

    樣本值
    ClusterId

    string

    是

    叢集 ID。

    cb95aa626a47740afbf6aa099b65****

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    body

    object

    否

    請求體參數。

    true
    api_server_eip

    boolean

    否

    叢集是否綁定 EIP，用於公網訪問 API Server。取值：

    • true：叢集綁定 EIP。

    • false：叢集不綁定 EIP。

    true
    api_server_eip_id

    string

    否

    叢集 API Server 綁定的 EIP 執行個體 ID，僅當api_server_eip取值為true時生效。

    eip-wz9fnasl6dsfhmvci****
    deletion_protection

    boolean

    否

    叢集刪除保護，防止通過控制台或 API 誤刪除叢集。取值：

    • true：啟用叢集刪除保護，將不能通過控制台或 API 刪除叢集。

    • false：不啟用叢集刪除保護，則能通過控制台或 API 刪除叢集。

    預設值：false。

    false
    resource_group_id

    string

    否

    叢集資源群組 ID。

    rg-acfmyvw3wjm****
    maintenance_window maintenance_window

    否

    叢集維護視窗，該功能只在 ACK 託管叢集 Pro 版中生效。

    enable_rrsa

    boolean

    否

    啟用或禁用 RRSA 功能（只有託管版叢集支援配置該參數）。取值：

    • true：啟用。

    • false：禁用。

    true
    cluster_name

    string

    否

    自訂叢集名稱。由數字、漢字、英文字元或短劃線（-）組成，長度範圍 1~63 個字元，且不能以短劃線（-）開頭。

    cluster-new-name
    cluster_spec

    string

    否

    選擇cluster_type為ManagedKubernetes並配置profile時，叢集的規格。取值：

    • ack.pro.small：Pro 版

    • ack.pro.xlarge：Pro XL

    • ack.pro.2xlarge：Pro 2XL

    • ack.pro.4xlarge: Pro 4XL （需聯絡客服開通白名單）

    Pro XL、Pro 2XL、Pro 4XL 為ACK Pro 預設控制面提供的三個檔位，通過預先分配並固化控制面資源，確保 API 並發與 Pod 調度能力始終處於確定的高水平狀態，適用於 AI 訓練推理、超大規模叢集及關鍵任務型業務。

    Pro 版及預設控制面版本的叢集管理費用請參見叢集管理費用。

    ack.pro.small
    system_events_logging

    object

    否

    系統事件儲存配置。

    enabled

    boolean

    否

    是否開啟系統事件儲存。

    • true：開啟系統事件儲存。

    • false：不開啟系統事件儲存。

    true
    logging_project

    string

    否

    系統事件儲存的 LogProject 名稱。

    k8s-log-cb95aa626a47740afbf6aa099b65****
    operation_policy

    object

    否

    叢集自動營運策略。

    cluster_auto_upgrade

    object

    否

    叢集自動升級。

    enabled

    boolean

    否

    是否開啟叢集自動升級。

    • true：開啟自動升級。

    • false：不開啟自動升級。

    true
    channel

    string

    否

    叢集自動升級頻次。更多資訊，請參見升級頻次。

    可取值：

    • patch：最新補丁版本。

    • stable：次新次要版本。

    • rapid：最新次要版本。

    patch
    api_server_custom_cert_sans

    object

    否

    自訂 API Server 認證 SAN（Subject Alternative Name）。 用於在叢集 API Server 服務端認證的 SAN 欄位中添加自訂的 IP 或網域名稱，以實現對用戶端的存取控制。

    僅託管版叢集支援配置該參數。

    action

    string

    否

    覆蓋或追加 SAN 配置。取值：

    • overwrite: 覆蓋。

    • append: 追加。

    append
    subject_alternative_names

    array

    否

    SAN 列表。

    string

    否

    SAN。支援自訂 IP 位址或網域名稱，多個 IP 位址或網域名稱以英文逗號（,）隔開。

    aliyun.xxx.com,192.168.xx.xx
    vswitch_ids

    array

    否

    叢集控制面虛擬交換器。專有叢集變更後，將作用於新擴容的控制面節點。託管類叢集變更控制面虛擬交換器，請注意以下事項：

    • 該參數為覆蓋更新，需完全指定目標交換器列表。

    • 變更過程式控制制面組件會短暫重啟，請謹慎操作。

    • 請確保叢集所有安全性群組（包括控制面安全性群組、所有節點池的安全性群組、容器網路使用的安全性群組）的出入方向已允許存取新的虛擬交換器的 IP 網段，避免節點與容器無法串連 API server。

    • 如新的控制面交換器配置了 ACL 規則，請確保該 ACL 規則已經允許存取其與叢集節點、容器網路等 IP 網段的通訊。

    string

    否

    叢集控制面虛擬交換器。

    vsw-2ze4jvvvade1yk899****
    control_plane_config

    object

    否

    專有版叢集控制面配置。

    charge_type

    string

    否

    控制面節點執行個體付費類型，取值：

    • PrePaid：訂用帳戶。

    • PostPaid：隨用隨付。

    預設值：PostPaid。

    PostPaid
    period

    integer

    否

    控制面節點執行個體訂用帳戶時間長度，當charge_type取值為PrePaid時才生效且為必選值。

    當period_unit=Month時，取值範圍：{1, 2 , 3, 6, 12, 24, 36, 48, 60}。

    1
    period_unit

    string

    否

    控制面節點執行個體付費周期，當charge_type取值為PrePaid時才生效。

    Month：以月為計時單位，當前只支援以月為單位。

    Month
    auto_renew

    boolean

    否

    控制面節點執行個體是否開啟自動續約，當charge_type取值為PrePaid時才生效。取值：

    • true：自動續約。

    • false：不自動續約。

    預設值：false。

    false
    auto_renew_period

    integer

    否

    控制面節點執行個體單次自動續約的續約時間長度。

    取值範圍：{1, 2, 3, 6, 12}，單位：月。

    預設值：1。

    1
    instance_types

    array

    否

    執行個體規格。更多資訊，請參見執行個體規格類型系列。

    string

    否

    執行個體規格。

    ecs.g6.large
    image_type

    string

    否

    作業系統鏡像類型，取值範圍：

    • AliyunLinux3：Alinux3 鏡像。

    • Custom： 自訂鏡像。

    AliyunLinux3
    image_id

    string

    否

    自訂鏡像 ID。自訂鏡像時指定。

    aliyun_3_x64_20G_alibase_20240819.vhd
    key_pair

    string

    否

    金鑰組名稱，和login_password二選一。

    ack
    login_password

    string

    否

    SSH 登入密碼，和key_pair 二選一。密碼規則為 8~30 個字元，且至少同時包含三項（大小寫字母、數字和特殊符號）。如需要使用密碼登入，需在擴容時指定。

    Ack@2000.
    system_disk_category

    string

    否

    節點系統硬碟類型，取值：

    • cloud_efficiency：高效雲端硬碟。

    • cloud_ssd：SSD 雲端硬碟。

    • cloud_essd：ESSD 雲端硬碟。

    • cloud_auto：ESSD AutoPL 雲端硬碟。

    • cloud_essd_entry：ESSD Entry 雲端硬碟。

    cloud_essd
    system_disk_size

    integer

    否

    節點系統硬碟大小，取值範圍[40,500]，單位：GiB。

    120
    system_disk_snapshot_policy_id

    string

    否

    節點系統硬碟採用的自動快照策略 ID。

    sp-2zej1nogjvovnz4z****
    system_disk_performance_level

    string

    否

    節點系統硬碟磁碟效能等級， 僅對 ESSD 磁碟生效。磁碟效能等級和磁碟大小有關。更多資訊，請參見 ESSD 雲端硬碟。

    PL1
    system_disk_provisioned_iops

    integer

    否

    節點系統硬碟預配置的讀寫 IOPS。可能值：0~min{50,000, 1000*容量-基準效能}。 基準效能=min{1,800+50*容量, 50000}。

    當system_disk_category取值為cloud_auto時才支援設定該參數。更多資訊，請參見ESSD AutoPL 雲端硬碟。

    1000
    system_disk_bursting_enabled

    boolean

    否

    節點系統硬碟是否開啟 Burst（效能突發）。 取值：

    • true：是。

    • false：否。

    當system_disk_category 取值為cloud_auto時才支援設定該參數。更多資訊，請參見ESSD AutoPL 雲端硬碟。

    true
    deploymentset_id

    string

    否

    部署集 ID。

    ds-bp10b35imuam5amw****
    cloud_monitor_flags

    boolean

    否

    控制面節點是否安裝CloudMonitor外掛程式。取值：

    • true：安裝CloudMonitor外掛程式。

    • false：不安裝CloudMonitor外掛程式。

    true
    soc_enabled

    boolean

    否

    等保加固。更多資訊，請參見 ACK 等保加固使用說明。

    取值：

    • true：開啟等保加固。

    • false：不開啟等保加固。

    預設值：false。

    false
    security_hardening_os

    boolean

    否

    阿里雲 OS 安全強化。取值：

    • true：開啟阿里雲 OS 安全強化。

    • false：不開啟阿里雲 OS 安全強化。

    預設值：false。

    false
    cpu_policy

    string

    否

    節點 CPU 管理原則。當叢集版本在 1.12.6 及以上時支援以下兩種策略：

    • static：允許為節點上具有某些資源特徵 Pod 增強其 CPU 親和性和獨佔性。

    • none：表示啟用現有的預設 CPU 親和性方案。

    預設值：none。

    none
    runtime

    string

    否

    容器運行時名稱，取值範圍：

    • containerd：推薦使用，支援所有叢集版本。

    預設值：containerd。

    containerd
    node_port_range

    string

    否

    節點服務連接埠範圍。 可選連接埠範圍：[30000,65535]。

    預設值：30000-32767。

    30000-32767
    size

    integer

    否

    控制面節點數量。如需擴容專有版控制面，該參數為目標控制面節點數，需大於當前控制面節點數量。

    5
    security_group_id

    string

    否

    控制面安全性群組 ID。

    • 如您在安全性群組中配置了攔截規則，請確保安全性群組規則允許存取叢集依賴的協議和連接埠，關於建議的安全性群組規則範圍，請參見配置並管理叢集安全性群組。

    • 對於非 ACK 專有叢集，變更過程中，叢集控制面及已安裝的託管組件（例如 terway-controlplane 等）將短暫重啟，建議您在業務低峰期操作。變更控制面安全性群組後，叢集控制面及已安裝的託管組件使用的彈性網卡 ENI 將自動加入到新的安全性群組中。

    • 對於 ACK 專有叢集，變更控制面安全性群組後，新擴容的 Master 節點會自動應用新的控制面安全性群組，現有控制面節點不受影響。

    sg-bp1h6rk3pgct2a08***
    timezone

    string

    否

    叢集時區。請參見支援時區。

    • 變更時區後，叢集巡檢配置將採用新的時區設定。

    • 對於託管類叢集，變更過程中，叢集控制面及已安裝的託管組件（例如 terway-controlplane 等）將短暫重啟，建議您在業務低峰期操作。變更時區後，新擴容的節點會自動應用新的時區設定，現有節點不受影響，您可以通過節點池節點重設功能使現有節點生效。

    • 對於專有叢集，變更時區後，新擴容的節點（包括控制面節點）會自動應用新的時區設定，現有節點（包括控制面節點）不受影響，您可以通過節點池節點重設功能使現有節點生效。對於控制面節點，您需要通過擴容後再縮容的方式使全量控制面節點生效。

    Asia/Shanghai
    control_plane_endpoints_config

    object

    否

    叢集串連配置。

    internal_dns_config

    object

    否

    叢集內部網域名稱配置，適用於 ACK 託管叢集。叢集內部網域名稱用於 kubelet、kube-proxy 等節點側系統組件訪問 API Server；未開啟叢集內部網域名稱訪問時，節點側系統組件將通過 CLB IP 方式訪問。

    bind_vpcs

    array

    否

    叢集內部網域名稱記錄解析生效的 VPC。

    string

    否

    叢集內部網域名稱記錄解析生效的 VPC。

    vpc-xxxx
    enabled

    boolean

    否

    是否開啟叢集內部網域名稱訪問。 取值：

    • true：開啟叢集內部網域名稱訪問，節點側組件（kubelet、kube-proxy）將通過叢集內部網域名稱訪問 API Server。

    true
    access_control_list deprecated

    array

    否

    註冊叢集 API Server SLB 存取控制清單。

    string

    否

    註冊叢集 API Server SLB 存取控制清單。

    注意：不允許填寫 0.0.0.0/0 網段。

    192.168.XX.XX/24
    instance_deletion_protection deprecated

    boolean

    否

    執行個體刪除保護，防止通過控制台或 API 誤刪除釋放節點。取值：

    • true: 不能通過控制台或 API 誤刪除節點。

    • false：能通過控制台或 API 誤刪除節點。

    預設值：false。

    false
    ingress_domain_rebinding deprecated

    boolean

    否

    重新綁定叢集測試網域名稱。取值：

    • true：重新綁定叢集測試網域名稱。

    • false：不重新綁定叢集測試網域名稱。

    預設值：false。

    false
    ingress_loadbalancer_id deprecated

    string

    否

    被修改叢集的 SLB 執行個體 ID。

    lb-wz97kes8tnndkpodw****

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    返回資料體。

    cluster_id

    string

    叢集 ID。

    cb95aa626a47740afbf6aa09****
    request_id

    string

    請求 ID。

    687C5BAA-D103-4993-884B-C35E4314****
    task_id

    string

    任務 ID。

    T-5a54309c80282e39ea00****

    樣本

    正常返回樣本

    JSON格式

    {
  "cluster_id": "cb95aa626a47740afbf6aa09****",
  "request_id": "687C5BAA-D103-4993-884B-C35E4314****",
  "task_id": "T-5a54309c80282e39ea00****"
}

    錯誤碼

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

    變更歷史

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