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
ACK dedicated cluster master node configuration parameters are consolidated under the
control_plane_configfield.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
nodepoolsfield. 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 |
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
|
custom_san | extra_sans |
nat_gateway | snat_entry |
service_discovery_types | The
|
zone_id | zone_ids |
logging_type | Install the |
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 | |
DescribeClustersV1 | |
GetUpgradeStatus | |
PauseClusterUpgrade | |
CancelClusterUpgrade | |
ResumeUpgradeCluster |