Compartir a través de


Ciclo de vida de la API de la versión preliminar de AKS

Las API de versión preliminar de Azure Kubernetes Service (AKS) (API que terminan en -preview) tienen una duración de aproximadamente un año a partir de su fecha de versión. Esto significa que puede esperar que la API 2023-01-02-versión preliminar esté en desuso en algún lugar alrededor del 1 de enero de 2024.

Nos encanta cuando los usuarios prueban nuestras características en versión preliminar y nos proporcionan comentarios, por lo que le animamos a usar las API de versión preliminar y las herramientas creadas en ellas (como la extensión de la CLI de la versión preliminar de AKS).

Después de que una versión de API esté en desuso, ya no funcionará. Le recomendamos que lo haga rutinariamente:

  • Actualice las plantillas de ARM/BICEP mediante versiones preliminares de la API para usar la versión más reciente de la API de versión preliminar.
  • Actualice la extensión de la CLI de la versión preliminar de AKS a la versión más reciente.
  • Actualice los SDK de versión preliminar u otras herramientas basadas en la API de versión preliminar a la versión más reciente.

Debe realizar estas actualizaciones como mínimo cada 6 a 9 meses. Si no lo hace, se le notificará que está usando una versión de API en desuso pronto como enfoques de desuso.

Cómo comprobar qué versiones de API se está usando

Si no está seguro de qué cliente o herramienta usa esta versión de API, compruebe los registros de actividad con el comando siguiente:

Establezca la versión de API que desea inspeccionar para el uso reciente en el registro de actividad. En este ejemplo, estamos comprobando la versión de la 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')]"

Actualización a una versión más reciente de la API

  • Para SDK de Azure: use una versión de API más reciente mediante la actualización a una versión más reciente del SDK.
  • Para la CLI de Azure: actualice la propia CLI y la extensión aks-preview (si se usa) a la versión más reciente mediante la ejecución de az upgrade y az extension update --name "aks-preview".
  • Para Terraform: actualice la versión más reciente del módulo de Terraform de AzureRM. Para averiguar qué versión de la API usa una versión determinada de Terraform, consulte las notas de la versión de Terraform o el registro de Git de este archivo.
  • Para otras herramientas: actualice la herramienta a la versión más reciente.

Próximas desusaciones

Versión de API Fecha de anuncio Fecha de desuso
2022-09-02-versión preliminar 27 de marzo de 2024 20 de junio de 2024
2022-10-02-versión preliminar 27 de marzo de 2024 20 de junio de 2024
2023-01-02-versión preliminar 27 de marzo de 2024 20 de junio de 2024
2023-02-02-versión preliminar 27 de marzo de 2024 20 de junio de 2024
2023-03-02-avance 21 de octubre de 2024 3 de febrero de 2025
2023-04-02-avance 21 de octubre de 2024 10 de febrero de 2025
2023-05-02-vista previa 21 de octubre de 2024 17 de febrero de 2025
2023-06-02-vista previa 21 de octubre de 2024 24 de febrero de 2025
2023-07-02-vista previa 21 de octubre de 2024 3 de marzo de 2025
2023-08-02-avance 21 de octubre de 2024 10 de marzo de 2025

Desusos completados

Versión de API Fecha de anuncio Fecha de desuso
2018-08-01-versión preliminar 7 de marzo de 2023 1 de junio de 2023
2021-11-01-versión preliminar 23 de marzo de 2023 1 de julio de 2023
2022-02-02-versión preliminar 27 de abril 27 de 2023 1 de agosto de 2023
2022-01-02-versión preliminar 3 de mayo de 2023 1 de septiembre de 2023
2022-03-02-versión preliminar 3 de mayo de 2023 1 de septiembre de 2023
2022-04-02-versión preliminar 3 de mayo de 2023 1 de septiembre de 2023
2022-05-02-versión preliminar 3 de mayo de 2023 1 de septiembre de 2023
2022-06-02-versión preliminar 3 de mayo de 2023 1 de septiembre de 2023
2022-07-02-versión preliminar 20 de noviembre de 2023 14 de febrero de 2024
2022-08-02-versión preliminar 27 de marzo de 2024 20 de junio de 2024
2022-08-03-versión preliminar 27 de marzo de 2024 20 de junio de 2024
2022-11-02-versión preliminar 27 de marzo de 2024 20 de junio de 2024