Cambios importantes en las áreas de trabajo, parte 2 (marzo de 2025)
SE APLICA A: Premium
Importante
Estos cambios importantes solo se aplican a las áreas de trabajo en versión preliminar de Azure API Management. Si ha creado áreas de trabajo después de la versión disponible con carácter general de agosto de 2024 y usa áreas de trabajo con puertas de enlace del espacio de trabajo, estas áreas de trabajo no deberían verse afectadas por estos cambios.
Las áreas de trabajo de Azure API Management ahora están disponibles con carácter general y hemos introducido varias actualizaciones de características con esa versión. Como parte de nuestro desarrollo continuo de áreas de trabajo, vamos a eliminar la compatibilidad con áreas de trabajo en versión preliminar (creadas antes de agosto de 2024). Si ha creado áreas de trabajo en versión preliminar en Azure API Management y quiere seguir usándolas, debe migrarlas a la versión disponible con carácter general.
Después del 31 de marzo de 2025, las áreas de trabajo en versión preliminar y las API administradas en ellas pueden dejar de funcionar si no ha migrado a las funcionalidades más recientes de áreas de trabajo. Este cambio no afecta a las API y los recursos administrados fuera de las áreas de trabajo.
¿Mi servicio se verá afectado por estos cambios?
El servicio puede verse afectado por estos cambios si creó áreas de trabajo en versión preliminar en la instancia de API Management, antes de la versión disponible con carácter general de las áreas de trabajo de agosto de 2024. Las áreas de trabajo creadas después de la fecha de lanzamiento disponible con carácter general que usan puertas de enlace del espacio de trabajo para el entorno de ejecución de la API no se verán afectadas por estos cambios importantes.
Cambios importantes
A continuación se muestran cambios importantes que requieren que realice una acción para migrar las áreas de trabajo en versión preliminar a la versión disponible con carácter general:
- Se requiere la puerta de enlace de API del área de trabajo: cada área de trabajo debe estar asociada a una puerta de enlace de API del área de trabajo que aísla el tráfico en tiempo de ejecución del área de trabajo. En versión preliminar, las áreas de trabajo comparten una puerta de enlace con el servicio.
- No se admiten identidades administradas de nivel de servicio: para mejorar la seguridad de las áreas de trabajo, las identidades administradas asignadas por el sistema y asignadas por el usuario habilitadas en el nivel de servicio no se pueden usar en áreas de trabajo. Actualmente, las características relacionadas de API Management que dependen de identidades administradas, como almacenar valores con nombre y certificados en Azure Key Vault y usar la directiva
authentication-managed-identity, no se admiten en áreas de trabajo.
Nota:
Estos cambios importantes se agregan a los cambios importantes de junio de 2024 de las áreas de trabajo en versión preliminar que se anunciaron anteriormente.
¿Cuál es la fecha límite del cambio?
Los cambios importantes se aplicarán en áreas de trabajo en versión preliminar después del 31 de marzo de 2025. Se recomienda encarecidamente realizar todos los cambios necesarios en la configuración de las áreas de trabajo en versión preliminar antes de esa fecha.
¿Qué tengo que hacer?
Si las áreas de trabajo se ven afectadas por estos cambios, debe migrar las áreas de trabajo para que se alineen con las funcionalidades disponibles con carácter general. En las secciones siguientes se proporcionan instrucciones sobre cómo migrar las áreas de trabajo.
Uso del nivel Premium de la instancia de API Management
Asegúrese de que la instancia de API Management se ejecuta en el nivel Premium para seguir usando áreas de trabajo. Como se anunció anteriormente, si la instancia está en el nivel Estándar o Desarrollador, debe actualizar al nivel Premium.
Confirmación de la región de la instancia
La adición de una puerta de enlace del espacio de trabajo a un área de trabajo requiere que la puerta de enlace esté en la misma región que la instancia. Actualmente, las puertas de enlace del espacio de trabajo se admiten en un subconjunto de regiones en las que API Management está disponible. Las regiones compatibles con las puertas de enlace del espacio de trabajo se actualizarán con el tiempo.
Para determinar si un área de trabajo en versión preliminar está en una región admitida:
- Vaya a la instancia de API Management en Azure Portal.
- En el menú de la izquierda, en API, seleccione Áreas de trabajo y seleccione un área de trabajo.
- Si el área de trabajo está en una región que no admite puertas de enlace del espacio de trabajo, verá un mensaje en el portal parecido a "Las áreas de trabajo no están disponibles actualmente en la región de su servicio API Management".
- Si ve este mensaje, puede trasladar la instancia de API Management a una región admitida.
- Si no ve este mensaje, el área de trabajo se encuentra en una región admitida y puede continuar con la adición de una puerta de enlace del espacio de trabajo.
Adición de una puerta de enlace del espacio de trabajo al área de trabajo
A continuación se indican los pasos abreviados para agregar una puerta de enlace del espacio de trabajo a un área de trabajo. Para conocer las opciones de red de la puerta de enlace, los requisitos previos y las instrucciones detalladas, consulte Creación y administración de un área de trabajo.
Nota:
- La puerta de enlace del espacio de trabajo incurre en cargos adicionales. Para más información, consulte los precios de API Management.
- Estamos introduciendo la capacidad de asociar varias áreas de trabajo a una puerta de enlace de áreas de trabajo, lo que ayuda a las organizaciones a administrar las API con áreas de trabajo a un costo menor. Esta característica se está implementando a partir de diciembre de 2024 y es posible que no esté disponible para todos los servicios elegibles antes de enero. Más información
- Vaya a la instancia de API Management en Azure Portal.
- En el menú de la izquierda, en API, seleccione Áreas de trabajo.
- Seleccione un área de trabajo.
- En el menú de la izquierda, en Implementación e infraestructura, seleccione Puertas de enlace>+ Agregar.
- Finalice el asistente para crear una puerta de enlace. Actualmente, el aprovisionamiento de la puerta de enlace puede tardar entre varios minutos y un máximo de 3 horas o incluso más.
- Una vez aprovisionada la puerta de enlace, vaya a la página Información general de la puerta de enlace. Anote el valor de Nombre de host en tiempo de ejecución. Use este valor para actualizar las aplicaciones cliente que llaman a las API del área de trabajo.
- Repita los pasos anteriores para las áreas de trabajo restantes.
Actualización de las aplicaciones cliente para que usen el nuevo nombre de host de la puerta de enlace
Después de agregar una puerta de enlace al área de trabajo, debe actualizar las aplicaciones cliente que llaman a las API del área de trabajo para usar el nuevo nombre de host de la puerta de enlace en lugar del nombre de host de puerta de enlace de la instancia de API Management.
Nota:
Para ayudarle a migrar las áreas de trabajo, todavía se puede acceder a las API de las áreas de trabajo en tiempo de ejecución hasta octubre de 2024 mediante el nombre de host de la puerta de enlace de la instancia de API Management, incluso si una puerta de enlace del espacio de trabajo está asociada a un área de trabajo. Se recomienda encarecidamente completar la migración antes de esta fecha. Si las puertas de enlace del área de trabajo están configuradas con acceso de entrada y salida privado, asegúrese de que la conectividad con la puerta de enlace integrada de la instancia de API Management también está protegida.
Actualización de dependencias en identidades administradas en el nivel de servicio
Si usa identidades administradas en el nivel de servicio en la configuración de entidades del área de trabajo (por ejemplo, valores con nombre o certificados), deberá actualizar las configuraciones. Los pasos recomendados varían en función de la entidad. Ejemplo: actualice los valores con nombre para que usen valores de secreto en lugar de los secretos almacenados en Azure Key Vault.
Ayuda y soporte técnico
Si tiene alguna pregunta, obtenga respuestas de expertos de la comunidad en Microsoft Q&A. Si tiene un plan de soporte técnico y necesita ayuda técnica, cree una solicitud de soporte técnico.
Más información
Contenido relacionado
Consulte todos los próximos cambios importantes y retiradas de características.