Leer en inglés

Compartir a través de

Retiradas de la versión de API (junio de 2024)

  • Artículo

SE APLICA A: Consumo | Desarrollador | Básico | Estándar | Premium

Azure API Management usa Azure Resource Manager (ARM) para configurar las instancias de API Management. La versión de la API se inserta en el uso de plantillas que describen la infraestructura, las herramientas que se usan para configurar el servicio y los programas que se escribe para administrar los servicios de Azure API Management.

A partir del 1 de junio de 2024, todas las versiones de API del servicio Azure API Management anteriores al 2021-08-01 se están retirando (deshabilitadas). La fecha de retirada previamente comunicada fue el 30 de septiembre de 2023. En cualquier momento después del 1 de junio de 2024, las llamadas API que usan una versión de API anterior a 2021-08-01 pueden producir un error sin previo aviso. Ya no podrá crear ni administrar los servicios de API Management con plantillas, herramientas, scripts y programas existentes mediante una versión de API retirada hasta que se hayan actualizado para usar la versión de API 2021-08-01 o posterior. Las operaciones del plano de datos (como la mediación de solicitudes de API en la puerta de enlace) no se verán afectadas por esta actualización, incluido después del 1 de junio de 2024.

¿Mi servicio se ve afectado?

Aunque el servicio no se ve afectado por este cambio, ninguna herramienta, script o programa que use Azure Resource Manager (como la CLI de Azure, Azure PowerShell, el Kit de recursos de Azure API Management DevOps o Terraform) para interactuar con el servicio API Management y llamar a una versión de API Management anterior al 2021-08-01 se ve afectada por este cambio. Después de retirar una versión de API, no podrá ejecutar las herramientas afectadas correctamente a menos que actualice las herramientas.

¿Cuál es la fecha límite del cambio?

Las versiones de API afectadas se retirarán gradualmente a partir del 1 de junio de 2024.

Después de retirar una versión de API, si prefiere no actualizar las herramientas, scripts y programas afectados, los servicios seguirán ejecutándose. Sin embargo, no podrá agregar ni quitar API, cambiar la directiva de API ni configurar el servicio API Management con herramientas afectadas.

Acción necesaria

Actualice las herramientas, los scripts y los programas mediante los detalles de la sección siguiente.

También se recomienda establecer la versión de LA API mínima en la instancia de API Management.

Actualización de las herramientas, scripts y programas

  • Plantillas de ARM, Bicep o Terraform: actualice la plantilla para usar la versión de API 2021-08-01 o posterior.

  • CLI de Azure: ejecute az version para comprobar la versión. Si ejecuta la versión 2.42.0 o posterior, no es necesario realizar ninguna acción. Use el comando az upgrade para actualizar la CLI de Azure si es necesario. Para más información, consulte Actualización de la CLI de Azure.

  • Azure PowerShell: ejecute Get-Module -ListAvailable -Name Az para comprobar la versión. Si ejecuta la versión 8.1.0 o posterior, no es necesario realizar ninguna acción. Si es necesario, ejecute Update-Module -Name Az -Repository PSGallery para actualizar el módulo. Para más información, consulte Instalación del módulo Azure Az PowerShell.

  • Otras herramientas: use las siguientes versiones (o posteriores):

    • Kit de recursos de DevOps de API Management: 1.0.0
    • Proveedor de Azurerm de Terraform: 3.0.0

  • SDK de Azure: actualice los SDK de Azure API Management a las versiones más recientes o al menos las siguientes versiones:

    • .NET: v1.1.0
    • Go 1.0.0
    • Python: 3.0.0
    • JavaScript: 8.0.1
    • Java: 1.0.0-beta3

Actualización de la configuración de la versión mínima de la API en la instancia de API Management

Se recomienda establecer la versión de API mínima para la instancia de API Management mediante Azure Portal o mediante la API REST u otras herramientas. Esta configuración limita las llamadas API del plano de control a la instancia a una versión de API igual o posterior a este valor. Al establecer este valor en 2021-08-01, puede evaluar el impacto de las retiradas de la versión de la API en las herramientas.

Para establecer la versión mínima de la API en el portal:

  1. Vaya a la instancia de API Management en Azure Portal.
  2. En el menú de la izquierda, en Implementación e infraestructura, seleccione API de administración.
  3. Seleccione la pestaña Configuración de la API de administración.
  4. En Aplicar versión mínima de LA API, seleccione Sí. Aparece la versión mínima de la API.
  5. Seleccione Guardar.

Importante

Si la versión mínima de la API en el portal está atenuada, solo puede actualizar la configuración mediante programación, por ejemplo, mediante la API REST o el comando az apim update en la CLI de Azure.

Información adicional

Contenido relacionado

Consulte todos los próximos cambios importantes y retiradas de características.