Partilhar via


Ciclo de vida da API AKS Preview

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

Adoramos quando as pessoas experimentam nossos recursos de visualização e nos dão feedback, por isso encorajamos você a usar as APIs de visualização e as ferramentas criadas nelas (como a extensão AKS Preview CLI).

Depois que uma versão da API for preterida, ela não funcionará mais! Recomendamos que você rotineiramente:

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

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

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

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

Defina a versão da API que você deseja inspecionar quanto ao 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 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 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 registre este arquivo no git.
  • Para outras ferramentas: atualize a ferramenta para a versão mais recente.

Próximas descontinuações

Versão da API Data de Anúncio Data de substituição
2022-09-02-pré-visualização 27 de março de 2024 Junho 20, 2024
2022-10-02-pré-visualização 27 de março de 2024 Junho 20, 2024
2023-01-02-Pré-visualização 27 de março de 2024 Junho 20, 2024
2023-02-02-pré-visualização 27 de março de 2024 Junho 20, 2024
2023-03-02-visualização 21 de outubro, 2024 3 de fevereiro de 2025
2023-04-02-visualização 21 de outubro, 2024 Fevereiro 10, 2025
2023-05-02-Pré-visualização 21 de outubro, 2024 Fevereiro 17, 2025
2023-06-02-pré-visualização 21 de outubro, 2024 24 de fevereiro de 2025
2023-07-02-visualização 21 de outubro, 2024 3 de março de 2025
2023-08-02-visualização 21 de outubro, 2024 10 de março de 2025

Descontinuações concluídas

Versão da API Data de Anúncio Data de substituição
2018-08-01-visualização 7 de março de 2023 1 de junho de 2023
2021-11-01-pré-visualização 23 de março de 2023 1 de julho de 2023
2022-02-02-pré-visualização 27 de abril de 2023 1 de agosto de 2023
2022-01-02-visualização 3 de maio de 2023 1 de setembro de 2023
2022-03-02-pré-visualização 3 de maio de 2023 1 de setembro de 2023
2022-04-02-pré-visualização 3 de maio de 2023 1 de setembro de 2023
2022-05-02-pré-visualização 3 de maio de 2023 1 de setembro de 2023
2022-06-02-pré-visualização 3 de maio de 2023 1 de setembro de 2023
2022-07-02-pré-visualização 20 de novembro de 2023 Fevereiro 14, 2024
2022-08-02-pré-visualização 27 de março de 2024 Junho 20, 2024
2022-08-03-pré-visualização 27 de março de 2024 Junho 20, 2024
2022-11-02-pré-visualização 27 de março de 2024 Junho 20, 2024