关于ACK集群管理相关的OpenAPI出入参变化及OpenAPI下线的公告

20260704日起,容器服务 Kubernetes 版ACK将对部分OpenAPI进行调整,包括部分出入参数下线、OpenAPI下线等。下线后的参数不再生效,下线后的OpenAPI不再支持调用。请参见本文了解并使用推荐的解决方案。

变更内容及影响范围

  • 变更时间:自20260704日起逐个地域变更,预计20260930日所有地域变更完成。

  • 变更内容及影响范围:本次变更涉及部分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

通过CreateClusterNodePoolkubelet_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-uf6wzbnvt9n3rzpppjshw\"}]"
          }
       ]
    }

custom_san

extra_sans

nat_gateway

snat_entry

service_discovery_types

private_zone能力不再支持。请通过addons配置managed-corednscoredns组件,完成服务发现配置。格式为:

  • {
       "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