全部產品
Search

搜尋本產品

    Container Service for Kubernetes：ModifyCluster

    文件中心

    Container Service for Kubernetes：ModifyCluster

    更新時間：Sep 10, 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
    access_control_list deprecated

    array

    否

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

    string

    否

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

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

    192.168.XX.XX/24
    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
    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****
    client_token

    string

    否

    用戶端 Token。

    af31042c-6355-495b-b6e3-exxb9669
    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
    control_plane_config

    object

    否

    專屬版叢集控制面設定。

    auto_renew

    boolean

    否

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

    • true：自動續費。

    • false：不自動續費。

    預設值：false。

    false
    auto_renew_period

    integer

    否

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

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

    預設值：1。

    1
    charge_type

    string

    否

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

    • PrePaid：包年包月。

    • PostPaid：按量付費。

    預設值：PostPaid。

    PostPaid
    cloud_monitor_flags

    boolean

    否

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

    • true：安裝雲端監控外掛程式。

    • false：不安裝雲端監控外掛程式。

    true
    cpu_policy

    string

    否

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

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

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

    預設值：none。

    none
    deploymentset_id

    string

    否

    部署集 ID。

    ds-bp10b35imuam5amw****
    image_id

    string

    否

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

    aliyun_3_x64_20G_alibase_20240819.vhd
    image_type

    string

    否

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

    • AliyunLinux3：Alinux3 映像。

    • Custom：自訂映像。

    AliyunLinux3
    instance_types

    array

    否

    執行個體規格。更多資訊，請參見執行個體規格族。

    string

    否

    執行個體規格。

    ecs.g6.large
    key_pair

    string

    否

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

    ack
    login_password

    string

    否

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

    Ack@2000.
    node_port_range

    string

    否

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

    預設值：30000-32767。

    30000-32767
    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
    runtime

    string

    否

    容器執行階段名稱，取值範圍：

    • containerd：建議使用，支援所有叢集版本。

    預設值：containerd。

    containerd
    security_hardening_os

    boolean

    否

    阿里雲 OS 安全性加固。取值：

    • true：啟用阿里雲 OS 安全性加固。

    • false：不啟用阿里雲 OS 安全性加固。

    預設值：false。

    false
    size

    integer

    否

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

    5
    soc_enabled

    boolean

    否

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

    取值：

    • true：啟用等保加固。

    • false：不啟用等保加固。

    預設值：false。

    false
    system_disk_bursting_enabled

    boolean

    否

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

    • true：是。

    • false：否。

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

    true
    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_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_size

    integer

    否

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

    120
    system_disk_snapshot_policy_id

    string

    否

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

    sp-2zej1nogjvovnz4z****
    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
    load_balancers_config

    array<object>

    否

    叢集存取負載平衡配置。

    object

    否

    叢集存取負載平衡配置。

    endpoint_type

    string

    否

    端點類型。

    public
    load_balancer_id

    string

    否

    端點關聯的 SLB 執行個體。

    nlb-xxxx
    deletion_protection

    boolean

    否

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

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

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

    預設值：false。

    false
    enable_rrsa

    boolean

    否

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

    • true：啟用。

    • false：停用。

    true
    ingress_domain_rebinding deprecated

    boolean

    否

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

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

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

    預設值：false。

    false
    ingress_loadbalancer_id deprecated

    string

    否

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

    lb-wz97kes8tnndkpodw****
    instance_deletion_protection deprecated

    boolean

    否

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

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

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

    預設值：false。

    false
    maintenance_window maintenance_window

    否

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

    operation_policy

    object

    否

    叢集自動維運策略。

    cluster_auto_upgrade

    object

    否

    叢集自動升級。

    channel

    string

    否

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

    可取值：

    • patch：最新修補程式版本。

    • stable：次新次要版本。

    • rapid：最新次要版本。

    patch
    enabled

    boolean

    否

    是否開啟叢集自動升級。

    • true：開啟自動升級。

    • false：不開啟自動升級。

    true
    resource_group_id

    string

    否

    叢集資源群組 ID。

    rg-acfmyvw3wjm****
    security_group_id

    string

    否

    控制面安全性群組 ID。

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

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

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

    sg-bp1h6rk3pgct2a08***
    system_events_logging

    object

    否

    系統事件儲存配置。

    enabled

    boolean

    否

    是否開啟系統事件儲存。

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

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

    true
    logging_project

    string

    否

    系統事件儲存的 LogProject 名稱。

    k8s-log-cb95aa626a47740afbf6aa099b65****
    timezone

    string

    否

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

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

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

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

    Asia/Shanghai
    vswitch_ids

    array

    否

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

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

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

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

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

    string

    否

    叢集控制面虛擬交換器。

    vsw-2ze4jvvvade1yk899****

    返回參數

    名稱

    類型

    描述

    樣本值

    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****"
}

    錯誤碼

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

    變更歷史

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