自2026年07月04日起,容器服务 Kubernetes 版ACK将对部分OpenAPI进行调整,包括部分出入参数下线、OpenAPI下线等。下线后的参数不再生效,下线后的OpenAPI不再支持调用。请参见本文了解并使用推荐的解决方案。
变更内容及影响范围
变更时间:自2026年07月04日起逐个地域变更,预计2026年09月30日所有地域变更完成。
变更内容及影响范围:本次变更涉及部分OpenAPI出入参变化和部分OpenAPI的直接下线。如您正在使用下表中的OpenAPI(包括Terraform、资源编排服务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 |