Compartilhar via


Ciclo de vida da API de versão prévia do AKS

As APIs de versão prévia do AKS (Serviço de Kubernetes do Azure) (APIs que terminam em -preview) têm uma vida útil de aproximadamente um ano a partir da data de lançamento. Isso significa que você pode esperar que a API 2023-01-02-preview seja preterida por volta de 1º de janeiro de 2024.

Adoramos quando as pessoas experimentam nossas versões prévias de recursos e nos enviam comentários, por isso incentivamos você a usar as APIs de versão prévia e as ferramentas criadas com base nelas (como a Extensão da CLI de versão prévia do AKS).

Depois que uma versão da API for preterida, ela não funcionará mais! É recomendável fazer isso rotineiramente:

  • Atualize seus modelos ARM/BICEP usando versões de API de versão prévia para usar a versão mais recente da API de versão prévia.
  • Atualize a extensão da CLI de versão prévia do AKS para a versão mais recente.
  • Atualize os SDKs de versão prévia ou outras ferramentas criadas na API de versão prévia para a versão mais recente.

Execute essas atualizações no mínimo a cada 6 a 9 meses. Se não fizer isso, você será notificado de que está usando uma versão da API que será preterida em breve, à medida que a desativação se aproxima.

Como verificar as versões de API que você está usando

Se você não tiver certeza de qual cliente ou ferramenta está usando esta versão da API, verifique os logs de atividades usando o seguinte comando:

Defina a versão da API que você deseja inspecionar para uso recente no log de atividades. Neste exemplo, estamos verificando a versão da 2022-04-01-preview API.

export API_VERSION="2022-04-01-preview"
az monitor activity-log list --offset 30d --max-events 10000 --namespace microsoft.containerservice --query "[?eventName.value == 'EndRequest' && contains(not_null(httpRequest.uri,''), '$API_VERSION')]"

Como atualizar para uma versão mais recente da API

  • Para SDKs do Azure: use uma versão mais recente da API atualizando para uma versão mais recente do SDK.
  • Para a CLI do Azure: atualize a própria CLI e a extensão aks-preview (se usada) para a versão mais recente executando az upgrade e az extension update --name "aks-preview".
  • Para o Terraform: atualize para a versão mais recente do módulo Terraform do AzureRM. Para descobrir qual versão da API uma versão específica do Terraform está usando, verifique as Notas de versão do Terraform ou execute o registro em log deste arquivo no Git.
  • Para outras ferramentas: atualize a ferramenta para a versão mais recente.

Futuras desativações

Versão da API Data de anúncio Data de reprovação
2022-09-02-preview 27 de março de 2024 20 de junho de 2024
2022-10-02-preview 27 de março de 2024 20 de junho de 2024
2023-01-02-preview 27 de março de 2024 20 de junho de 2024
2023-02-02-preview 27 de março de 2024 20 de junho de 2024
2023-03-02-preview 21 de outubro de 2024 3 de fevereiro de 2025
2023-04-02-preview 21 de outubro de 2024 10 de fevereiro de 2025
2023-05-02-preview 21 de outubro de 2024 17 de fevereiro de 2025
2023-06-02-preview 21 de outubro de 2024 24 de fevereiro de 2025
2023-07-02-preview 21 de outubro de 2024 3 de março de 2025
2023-08-02-preview 21 de outubro de 2024 10 de março de 2025

Desativações concluídas

Versão da API Data de anúncio Data de reprovação
2018-08-01-preview 7 de março de 2023 1º de junho de 2023
2021-11-01-preview 23 de março de 2023 1º de julho de 2023
2022-02-02-preview 27 de abril de 2023 1º de agosto de 2023
2022-01-02-preview 3 de maio de 2023 1 de setembro de 2023
2022-03-02-preview 3 de maio de 2023 1 de setembro de 2023
2022-04-02-preview 3 de maio de 2023 1 de setembro de 2023
2022-05-02-preview 3 de maio de 2023 1 de setembro de 2023
2022-06-02-preview 3 de maio de 2023 1 de setembro de 2023
2022-07-02-prévia 20 de novembro de 2023 14 de fevereiro de 2024
2022-08-02-preview 27 de março de 2024 20 de junho de 2024
2022-08-03-preview 27 de março de 2024 20 de junho de 2024
2022-11-02-preview 27 de março de 2024 20 de junho de 2024