Compartilhar via


Ciclo de vida da API de Visualização do Gerenciador de Frota de Kubernetes do Azure

As APIs REST do Azure Resource Manager (ARM) de versão prévia do Azure Kubernetes Fleet Manager (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 2024-05-02-preview seja preterida por volta de 3 de maio de 2025.

Adoramos quando as pessoas experimentam nossos recursos de visualização e nos fornecem comentários, por isso incentivamos você a usar as APIs de visualização e as ferramentas criadas nelas.

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

  • Atualize seus modelos ARM/Bicep/Terraform usando versões prévias da API para usar a versão mais recente compatível da API.
  • 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 você não fizer isso, será notificado de que está usando uma versão da API preterida em breve à medida que a substituição se aproxima.

Este artigo aborda as substituições da API do Gerenciador de Frota de Kubernetes do Azure. Para informações sobre a descontinuação da API do Serviço de Kubernetes do Azure (AKS), consulte o ciclo de vida da API de pré-visualização do AKS.

Substituições futuras da API

Versão da API Data de anúncio Data de descontinuação
2025-04-01-preview TBC TBC
2024-05-02-preview TBC TBC
2024-02-02-preview TBC TBC

Substituições de API concluídas

Versão da API Data de anúncio Data de descontinuação
2023-08-15-prévia 16 de dezembro de 2024 14 de abril de 2025
2023-06-15-preview 16 de dezembro de 2024 14 de abril de 2025
2023-03-15-preview 16 de dezembro de 2024 14 de abril de 2025
2022-09-02-preview 16 de dezembro de 2024 14 de abril de 2025
2022-07-02-prévia 16 de dezembro de 2024 14 de abril de 2025
2022-06-02-preview 16 de dezembro de 2024 14 de abril de 2025

Como verificar as versões da API em uso

Se você não tiver certeza de qual cliente ou ferramenta está usando uma versão de API específica, verifique os logs de atividades usando o comando a seguir. Atualize o com a versão que você deseja verificar.

API_VERSION="2024-05-02-preview"
az monitor activity-log list \
    --offset 30d \
    --max-events 10000 \
    --namespace microsoft.containerservice.fleets \
    --query "[?eventName.value == 'EndRequest' && contains(not_null(httpRequest.uri,''), '${API_VERSION}')]"

Como verificar as versões de API usadas em modelos

  • Bicep modelos
  • Modelos do ARM
  • Modelos do Terraform

Em modelos Bicep, examine a versão do recurso que aparece no final do tipo de recurso (@2024-05-02-preview).

resource symbolicname 'Microsoft.ContainerService/fleets@2024-05-02-preview' = {
    ...
}

Como atualizar ferramentas e SDKs

Importante

A Azure CLI e a extensão fleet devem ser atualizadas para a versão mais recente usando az upgrade e az extension update --name fleet.

  • Para SDKs do Azure: Use uma versão mais recente da API atualizando para uma versão mais recente do SDK.
  • 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.