All Products
Search
Document Center

Container Service for Kubernetes:Announcement on ACK API parameter changes and deprecation

Last Updated:Dec 25, 2025

Container Service for Kubernetes (ACK) is scheduled to adjust several APIs on July 4, 2026, including parameter deprecation and full interface decommissioning. Deprecated parameters will cease to function, and decommissioned APIs will no longer be callable. This topic provides recommended solutions.

Change details and impact scope

  • Implementation time: Regional rollout begins July 4, 2026, with global completion expected by September 30, 2026.

  • Impact scope: This update involves parameter changes to specific APIs and the full decommissioning of others. Any usage of the APIs in the table below—whether via direct calls, Terraform configurations, Resource Orchestration Service (ROS) templates, or other API-based requests—are affected by this change.

    Change type

    Deprecation details

    Affected APIs

    API parameter deprecation

    Operational APIs: Some request parameters become invalid or request validation reports an error code 400.

    • CreateCluster

    • CreateClusterByResourcesGroup

    • ModifyCluster

    • UpgradeCluster

    Query APIs: The response body no longer returns deprecated fields.

    • DescribeClusterDetail

    API decommissioning

    APIs are permanently disabled and inaccessible.

    • DescribeClusters

    • DescribeClustersV1

    • GetUpgradeStatus

    • PauseClusterUpgrade

    • CancelClusterUpgrade

    • ResumeUpgradeCluster

Deprecated parameters and solutions

The parameter listed in the alternative parameters column of the table below is available within the same API interface as the parameter to be deprecated.

CreateCluster

Note
  • ACK dedicated cluster master node configuration parameters are consolidated under the control_plane_config field.

    ACK dedicated cluster creation has been discontinued. For more information, see Create an ACK dedicated cluster (discontinued).
  • Worker node configuration parameters in the cluster are consolidated under the nodepools field. After creating a cluster, we recommend that you create and configure node pools through the same fields in CreateClusterNodePool.

Deprecated parameter

Alternative parameters

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 dedicated cluster master nodes no longer support this parameter.

node_name_mode

nodepools[].scaling_group.node_name_mode

ACK dedicated cluster master nodes no longer support this parameter.

rds_instances

nodepools[].scaling_group.rds_instances

taints

nodepools[].scaling_group.taints

ACK dedicated cluster master nodes no longer support this parameter.

instances

After the cluster and node pool are created, add existing nodes to the node pool through 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

Configure CPU policies through the kubelet_config field of CreateClusterNodePool.

control_plane_config.cpu_policy

This parameter is deprecated.

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

Specify through the config field of the Terway component:

  • If Create VPC is selected, the control plane vSwitch list will be automatically filled in.

  • If Select Existing VPC is selected, you must manually specify in the following format:

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

custom_san

extra_sans

nat_gateway

snat_entry

service_discovery_types

The private_zone capability is no longer supported. Configure service discovery by setting addons to managed-coredns or coredns using the following format:

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

zone_id

zone_ids

logging_type

Install the loongcollector component through addons in the following format:

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

sls_project_name

disable_rollback

This parameter is deprecated.

timeout_mins

This parameter is deprecated.

access_control_list

After cluster creation, see Resource Access Management for manual configuration through the API.

enable_rrsa

rrsa_config.enabled

DescribeClusterDetail

Deprecated parameter

Alternative parameter

vswitch_id

vswitch_ids

worker_ram_role_name

Query through DescribeClusterResources.

docker_version

Query through DescribeClusterNodePoolDetail.

external_loadbalancer_id

Query through DescribeClusterResources.

network_mode

This parameter is deprecated.

subnet_cidr

container_cidr

zone_id

This parameter is deprecated.

You can query related zone information through vswitch_ids and DescribeVSwitches.

private_zone

This parameter is deprecated.

parameters

This parameter is deprecated.

To query related results, see DescribeClusterDetail for alternative solutions.

outputs

This parameter is deprecated.

To query related results, see DescribeClusterDetail and DescribeClusterResources.

upgrade_components

This parameter is deprecated.

Query through DescribeKubernetesVersionMetadata.

maintenance_info

This parameter is deprecated.

next_version

Query through DescribeKubernetesVersionMetadata.

ModifyCluster

Deprecated parameter

Alternative parameter

instance_deletion_protection

This parameter is deprecated.

ingress_loadbalancer_id

This parameter is deprecated.

access_control_list

This parameter is deprecated.

After cluster creation, see Resource Access Management for manual configuration through the API.

UpgradeCluster

Deprecated parameter

Alternative parameter

rolling_policy

We recommend using UpgradeClusterNodepool to upgrade worker nodes.

rolling_policy.max_parallelism

We recommend using UpgradeClusterNodepool to upgrade Worker nodes.

Deprecated APIs and solutions

Deprecated API

Alternative API

DescribeClusters

DescribeClustersForRegion

DescribeClustersV1

GetUpgradeStatus

DescribeTaskInfo

PauseClusterUpgrade

PauseTask

CancelClusterUpgrade

CancelTask

ResumeUpgradeCluster

ResumeTask