Container Service for Kubernetes (ACK) ajustará diversas APIs em 4 de julho de 2026. As mudanças incluem a descontinuação de parâmetros e a remoção completa de interfaces. Os parâmetros descontinuados deixarão de funcionar e as APIs removidas não poderão mais ser chamadas. Este tópico apresenta as soluções recomendadas.
Detalhes das alterações e escopo de impacto
Cronograma de implementação: a implantação regional começa em 4 de julho de 2026, com conclusão global prevista para 30 de setembro de 2026.
-
Escopo de impacto: esta atualização altera parâmetros em APIs específicas e desativa outras totalmente. O uso das APIs listadas na tabela abaixo — seja por chamadas diretas, configurações do Terraform, modelos do Resource Orchestration Service (ROS) ou outras requisições baseadas em API — será afetado.
Tipo de alteração
Detalhes da descontinuação
APIs afetadas
Descontinuação de parâmetro de API
APIs operacionais: alguns parâmetros de requisição tornam-se inválidos ou a validação retorna o código de erro 400.
CreateCluster
CreateClusterByResourcesGroup
ModifyCluster
UpgradeCluster
APIs de consulta: o corpo da resposta deixa de retornar campos descontinuados.
DescribeClusterDetail
Desativação de API
As APIs são desativadas permanentemente e ficam inacessíveis.
DescribeClusters
DescribeClustersV1
GetUpgradeStatus
PauseClusterUpgrade
CancelClusterUpgrade
ResumeUpgradeCluster
Parâmetros descontinuados e soluções
O parâmetro listado na coluna de parâmetros alternativos da tabela abaixo está disponível na mesma interface de API do parâmetro a ser descontinuado.
CreateCluster
-
Os parâmetros de configuração do nó mestre do cluster dedicado ACK foram consolidados no campo
control_plane_config.A criação de clusters dedicados ACK foi descontinuada. Para mais informações, consulte Criar um cluster dedicado ACK (descontinuado) .
Os parâmetros de configuração dos nós worker no cluster foram consolidados no campo
nodepools. Após criar um cluster, crie e configure pools de nós pelos mesmos campos em CreateClusterNodePool.
Parâmetro descontinuado | Parâmetros alternativos |
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 | Após criar o cluster e o pool de nós, adicione nós existentes ao pool de nós usando 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 políticas de CPU pelo campo |
control_plane_config.cpu_policy | Este parâmetro foi descontinuado. |
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 | Especifique pelo campo
|
custom_san | extra_sans |
nat_gateway | snat_entry |
service_discovery_types | A funcionalidade
|
zone_id | zone_ids |
logging_type | Instale o componente |
sls_project_name | |
disable_rollback | Este parâmetro foi descontinuado. |
timeout_mins | Este parâmetro foi descontinuado. |
access_control_list | Após criar o cluster, consulte Resource Access Management para configurar manualmente via API. |
enable_rrsa | rrsa_config.enabled |
DescribeClusterDetail
Parâmetro descontinuado | Parâmetro alternativo |
vswitch_id | vswitch_ids |
worker_ram_role_name | Consulte usando DescribeClusterResources. |
docker_version | Consulte usando DescribeClusterNodePoolDetail. |
external_loadbalancer_id | Consulte usando DescribeClusterResources. |
network_mode | Este parâmetro foi descontinuado. |
subnet_cidr | container_cidr |
zone_id | Este parâmetro foi descontinuado. Para consultar informações da zona, use vswitch_ids e DescribeVSwitches. |
private_zone | Este parâmetro foi descontinuado. |
parameters | Este parâmetro foi descontinuado. Para obter resultados relacionados, consulte as soluções alternativas em DescribeClusterDetail. |
outputs | Este parâmetro foi descontinuado. Para obter resultados relacionados, consulte DescribeClusterDetail e DescribeClusterResources. |
upgrade_components | Este parâmetro foi descontinuado. Consulte usando DescribeKubernetesVersionMetadata. |
maintenance_info | Este parâmetro foi descontinuado. |
next_version | Consulte usando DescribeKubernetesVersionMetadata. |
ModifyCluster
|
Parâmetro descontinuado |
Parâmetro alternativo |
|
instance_deletion_protection |
Este parâmetro foi descontinuado. |
|
ingress_loadbalancer_id |
Este parâmetro foi descontinuado. |
|
access_control_list |
Este parâmetro foi descontinuado. Após criar o cluster, consulte Resource Access Management para configurar manualmente via API. |
UpgradeCluster
|
Parâmetro descontinuado |
Parâmetro alternativo |
|
rolling_policy |
Use UpgradeClusterNodepool para atualize nós worker. |
|
rolling_policy.max_parallelism |
Use UpgradeClusterNodepool para atualize nós worker. |
APIs descontinuadas e soluções
API descontinuada | API alternativa |
DescribeClusters | |
DescribeClustersV1 | |
GetUpgradeStatus | |
PauseClusterUpgrade | |
CancelClusterUpgrade | |
ResumeUpgradeCluster |