全部產品
Search
文件中心

Container Service for Kubernetes:關於ACK叢集管理相關的OpenAPI出入參變化及OpenAPI下線的公告

更新時間:Dec 23, 2025

自2026年07月04日起,Container Service for KubernetesACK將對部分OpenAPI進行調整,包括部分出入參數下線、OpenAPI下線等。下線後的參數不再生效,下線後的OpenAPI不再支援調用。請參見本文瞭解並使用推薦的解決方案。

變更內容及影響範圍

  • 變更時間:自2026年07月04日起逐個地區變更,預計2026年09月30日所有地區變更完成。

  • 變更內容及影響範圍:本次變更涉及部分OpenAPI出入參變化和部分OpenAPI的直接下線。如您正在使用下表中的OpenAPI(包括Terraform、Resource Orchestration Service服務ROS等基於OpenAPI構建的請求),則均在本次變更影響範圍內。

    變更類型

    下線說明

    涉及API

    OpenAPI出入參下線

    操作類API:部分請求入參不再生效,或請求校正報錯,錯誤狀態代碼為400。

    • CreateCluster

    • CreateClusterByResourcesGroup

    • ModifyCluster

    • UpgradeCluster

    查詢類API:響應體(Response body)不再返回下線欄位。

    • DescribeClusterDetail

    OpenAPI下線

    OpenAPI停止服務,無法被調用,且不可見。

    • DescribeClusters

    • DescribeClustersV1

    • GetUpgradeStatus

    • PauseClusterUpgrade

    • CancelClusterUpgrade

    • ResumeUpgradeCluster

下線參數及解決方案

下方表格的替代參數列中,如直接提供了參數,則預設為同一OpenAPI介面下的參數。

CreateCluster

說明
  • ACK專有叢集Master節點配置的相關參數收斂至control_plane_config欄位下。

    ACK專有叢集已停止建立,請參見建立ACK專有叢集(已停止建立)
  • 叢集中Worker節點配置的相關參數收斂至nodepools欄位下。建議您在叢集建立完成後,通過CreateClusterNodePool的同名欄位建立和配置節點池。

待下線參數

替代參數

master_vswitch_ids

vswitch_ids

master_instance_charge_type

control_plane_config.charge_type

master_period

control_plane_config.period

master_period_unit

control_plane_config.period_unit

master_auto_renew

control_plane_config.auto_renew

master_auto_renew_period

control_plane_config.auto_renew_period

master_instance_types

control_plane_config.instance_types

master_system_disk_category

control_plane_config.system_disk_category

master_system_disk_size

control_plane_config.system_disk_size

master_system_disk_performance_level

control_plane_config.system_disk_performance_level

master_system_disk_snapshot_policy_id

control_plane_config.system_disk_snapshot_policy_id

master_deploymentset_id

control_plane_config.deploymentset_id

master_count

control_plane_config.size

node_port_range

control_plane_config.node_port_range

num_of_nodes

nodepools[].scaling_group.desired_size

worker_vswitch_ids

nodepools[].scaling_group.vswitch_ids

worker_instance_types

nodepools[].scaling_group.instance_types

worker_system_disk_category

nodepools[].scaling_group.system_disk_category

worker_system_disk_size

nodepools[].scaling_group.system_disk_size

worker_system_disk_snapshot_policy_id

nodepools[].scaling_group.system_disk_snapshot_policy_id

worker_system_disk_performance_level

nodepools[].scaling_group.system_disk_performance_level

worker_data_disks

nodepools[].scaling_group.data_disks

worker_instance_charge_type

nodepools[].scaling_group.instance_charge_type

worker_period_unit

nodepools[].scaling_group.period_unit

worker_period

nodepools[].scaling_group.period

worker_auto_renew

nodepools[].scaling_group.auto_renew

worker_auto_renew_period

nodepools[].scaling_group.auto_renew_period

user_data

nodepools[].scaling_group.user_data

ACK專有叢集的Master節點不再支援此參數。

node_name_mode

nodepools[].scaling_group.node_name_mode

ACK專有叢集的Master節點不再支援此參數。

rds_instances

nodepools[].scaling_group.rds_instances

taints

nodepools[].scaling_group.taints

ACK專有叢集的Master節點不再支援此參數。

instances

叢集和節點池建立完成後,通過AttachInstancesToNodePool將已有節點添加到節點池中

format_disk

keep_instance_name

cloud_monitor_flags

nodepools[].kubernetes_config.cms_enabled

control_plane_config.cloud_monitor_flags

soc_enabled

nodepools[].kubernetes_config.soc_enabled

control_plane_config.soc_enabled

security_hardening_os

nodepools[].kubernetes_config.security_hardening_os

control_plane_config.security_hardening_os

cis_enabled

nodepools[].kubernetes_config.security_hardening_os

cpu_policy

通過CreateClusterNodePool的kubelet_config欄位配置CPU Policy

control_plane_config.cpu_policy

不再支援,參數下線

runtime.name

nodepools[].kubernetes_config.runtime

control_plane_config.runtime

runtime.version

nodepools[].kubernetes_config.runtime_version

image_type

nodepools[].scaling_group.image_type

control_plane_config.image_type

image_id

nodepools[].scaling_group.image_id

control_plane_config.image_id

platform

nodepools[].scaling_group.image_type

control_plane_config.image_type

os_type

nodepools[].scaling_group.os_type

key_pair

nodepools[].scaling_group.key_pair

control_plane_config.key_pair

login_password

nodepools[].scaling_group.login_password

control_plane_config.login_password

pod_vswitch_ids

通過Terway組件的config欄位指定:

  • 選擇自動建立VPC時,會自動填寫控制面交換器列表。

  • 選擇使用已有VPC時,需手動指定,格式為:

    {
        "addons": [
            {
                "name": "terway-eniip",
                "config": "{\"PodVswitchId\":{\"cn-shanghai-b\":[\"vsw-uf6wzbnvt9n3rzp*****\"]}}"
            }
        ]
    }

custom_san

extra_sans

nat_gateway

snat_entry

service_discovery_types

private_zone能力不再支援。請通過addons配置managed-coredns或coredns組件,完成服務發現配置。格式為:

  • {
       "addons": [
          {
             "name": "managed-coredns"
          }
       ]
    }
  • {
       "addons": [
          {
             "name": "coredns"
          }
       ]
    }

zone_id

zone_ids

logging_type

通過addons安裝loongcollector組件,格式為:

{
   "addons": [
      {
         "name": "loongcollector"
      }
   ]
}

sls_project_name

disable_rollback

不再支援,參數下線

timeout_mins

不再支援,參數下線

access_control_list

叢集建立後參見存取控制下的OpenAPI手動設定

enable_rrsa

rrsa_config.enabled

DescribeClusterDetail

待下線參數

替代參數

vswitch_id

vswitch_ids

worker_ram_role_name

通過DescribeClusterResources查詢

docker_version

通過DescribeClusterNodePoolDetail查詢

external_loadbalancer_id

通過DescribeClusterResources查詢

network_mode

不再支援,參數下線

subnet_cidr

container_cidr

zone_id

不再支援,參數下線

可通過vswitch_ids結合DescribeVSwitches 查詢相關可用性區域資訊。

private_zone

不再支援,參數下線

parameters

不再支援,參數下線

如需查詢相關結果,參見DescribeClusterDetail文檔擷取替代方案。

outputs

不再支援,參數下線

如需查詢相關結果,參見DescribeClusterDetailDescribeClusterResources

upgrade_components

不再支援,參數下線

通過DescribeKubernetesVersionMetadata查詢

maintenance_info

不再支援,參數下線

next_version

通過DescribeKubernetesVersionMetadata查詢

ModifyCluster

待下線參數

替代參數

instance_deletion_protection

不再支援,參數下線

ingress_loadbalancer_id

不再支援,參數下線

access_control_list

不再支援,參數下線

叢集建立後參見存取控制下的OpenAPI手動設定

UpgradeCluster

待下線參數

替代參數

rolling_policy

推薦使用UpgradeClusterNodepool升級Worker節點

rolling_policy.max_parallelism

推薦使用UpgradeClusterNodepool升級Worker節點

下線的OpenAPI及解決方案

待下線OpenAPI

替代OpenAPI

DescribeClusters

DescribeClustersForRegion

DescribeClustersV1

GetUpgradeStatus

DescribeTaskInfo

PauseClusterUpgrade

PauseTask

CancelClusterUpgrade

CancelTask

ResumeUpgradeCluster

ResumeTask