自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欄位指定:
|
custom_san | extra_sans |
nat_gateway | snat_entry |
service_discovery_types | private_zone能力不再支援。請通過addons配置managed-coredns或coredns組件,完成服務發現配置。格式為:
|
zone_id | zone_ids |
logging_type | 通過addons安裝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 | |
docker_version | |
external_loadbalancer_id | |
network_mode | 不再支援,參數下線 |
subnet_cidr | container_cidr |
zone_id | 不再支援,參數下線 可通過vswitch_ids結合DescribeVSwitches 查詢相關可用性區域資訊。 |
private_zone | 不再支援,參數下線 |
parameters | 不再支援,參數下線 如需查詢相關結果,參見DescribeClusterDetail文檔擷取替代方案。 |
outputs | 不再支援,參數下線 如需查詢相關結果,參見DescribeClusterDetail和DescribeClusterResources。 |
upgrade_components | 不再支援,參數下線 通過DescribeKubernetesVersionMetadata查詢 |
maintenance_info | 不再支援,參數下線 |
next_version |
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 | |
DescribeClustersV1 | |
GetUpgradeStatus | |
PauseClusterUpgrade | |
CancelClusterUpgrade | |
ResumeUpgradeCluster |