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

As APIs REST da prévia do Gerenciador de Frota de Kubernetes do Azure Resource Manager (ARM) que terminam em -preview têm um tempo de vida 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 de pré-visualização da API para utilizar a versão mais recente da API compatível.
• 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 substituições da API do AKS (Serviço de Kubernetes do Azure), consulte o ciclo de vida da API de versão prévia do AKS.

Substituições futuras da API

Versão da API	Data de anúncio	Data de descontinuação
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 API_VERSION 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

Modelos do Bicep

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' = {
    ...
}

Modelos do ARM

Nos modelos do ARM, verifique a propriedade apiVersion.

{
  "type": "Microsoft.ContainerService/fleets",
  "apiVersion": "2024-05-02-preview",
  ...
}

Modelos do Terraform

No Terraform, verifique o valor da type propriedade que define o tipo de recurso e a versão da API (@2024-05-02-preview).

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

Como atualizar ferramentas e SDKs

Importante

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

• No caso dos SDKs do Azure, atualize para uma versão mais recente da API ao instalar 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.