Share via


Áreas de trabajo: cambios importantes (junio de 2024)

SE APLICA A: Desarrollador | Estándar | Premium

Después del 14 de junio de 2024, como parte de nuestro desarrollo de áreas de trabajo (versión preliminar) en Azure API Management, presentamos varios cambios importantes.

Después del 14 de junio de 2024, las áreas de trabajo y las API administradas en ellas pueden dejar de funcionar si todavía dependen de las funcionalidades establecidas para cambiar. Este cambio no afecta a las API y los recursos administrados fuera de las áreas de trabajo.

¿Mi servicio se ve afectado por estos cambios?

El servicio puede verse afectado por estos cambios si configuró áreas de trabajo (versión preliminar) en la instancia de API Management. Esta característica se introdujo en los niveles Premium, Estándar y Desarrollador .

Cambios importantes

Revise los siguientes cambios importantes para determinar si necesita tomar medidas:

Cambio a los niveles de servicio admitidos

Los siguientes niveles de servicio ya no admitirán áreas de trabajo: Estándar y Desarrollador. Las áreas de trabajo estarán disponibles en el nivel Premium .

Para obtener disponibilidad en los niveles v2, consulte Niveles de Azure API Management v2.

Cambios en la compatibilidad con la asignación de entidades de nivel de servicio en áreas de trabajo

Ya no se admitirán las siguientes asignaciones de entidades de área de trabajo a entidades de nivel de servicio:

  • Asignación de API de área de trabajo a productos de nivel de servicio

  • Asignación de API de área de trabajo a etiquetas de nivel de servicio

  • Asignación de productos de área de trabajo a etiquetas de nivel de servicio

  • Asignación de grupos de nivel de servicio a productos del área de trabajo para controles de visibilidad

    Nota:

    Los grupos invitados y desarrolladores integrados seguirán estando disponibles en las áreas de trabajo.

Cambios en objetos de contexto admitidos

Los objetos siguientes context ya no se admitirán en las directivas del área de trabajo ni en la directiva de todas las API en el nivel de servicio:

  • context.Api.Workspace
  • context.Product.Workspace

El context.Workspace objeto se puede usar en su lugar.

Nota:

Puede seguir haciendo referencia a los usuarios desde el nivel de servicio del context objeto en las directivas de nivel de área de trabajo.

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

Los cambios importantes se introducirán después del 14 de junio de 2024. Se recomienda encarecidamente realizar todos los cambios necesarios en la configuración de las áreas de trabajo antes de esa fecha.

¿Qué tengo que hacer?

Si las áreas de trabajo se ven afectadas por estos cambios, debe actualizar las configuraciones del área de trabajo para alinearse con las nuevas funcionalidades.

Clientes de nivel estándar

Si usa áreas de trabajo en el nivel Estándar , actualice al nivel Premium para continuar usando áreas de trabajo.

Clientes de nivel de desarrollador

El nivel Desarrollador se diseñó para casos de uso de usuario único o de equipo único. No se puede facilitar la colaboración entre varios equipos con áreas de trabajo debido a los recursos informáticos limitados, la falta de Acuerdo de Nivel de Servicio y ninguna redundancia de infraestructura. Si usa la versión preliminar de áreas de trabajo en el nivel Desarrollador , puede elegir una de las siguientes opciones:

  • Agregado en una instancia de nivel Premium

    Aunque actualizar cada instancia de nivel de desarrollador al nivel Premium es una opción, considere la posibilidad de agregar varios entornos de no producción en una sola instancia de nivel Premium. Use áreas de trabajo en el nivel Premium para aislar los distintos entornos.

  • Uso de instancias de nivel de desarrollador para el desarrollo, migración a áreas de trabajo en el nivel Premium para producción

    Puede usar instancias de nivel de desarrollador para entornos de desarrollo. Para entornos superiores, puede migrar la configuración de cada servicio de nivel de desarrollador a un área de trabajo de un servicio de nivel Premium, por ejemplo, mediante canalizaciones de CI/CD. Con este enfoque, puede encontrarse con problemas o conflictos al administrar las configuraciones entre entornos.

    Si actualmente usa áreas de trabajo en una instancia de nivel Desarrollador, puede migrar las configuraciones del área de trabajo a una instancia de nivel desarrollador sin áreas de trabajo:

    1. Exporte una plantilla de Resource Manager desde la instancia de API Management. Puede exportar la plantilla desde Azure Portal o mediante otras herramientas.
    2. Quite la siguiente subcadena de los valores de identificador de recurso: /workspaces/[^/]+
    3. Implemente la plantilla. Para más información, consulte Inicio rápido: Creación e implementación de plantillas de ARM mediante Azure Portal.

    En función del caso de uso, es posible que tenga que realizar otros cambios de configuración en la instancia de API Management.

Asignación de entidades de nivel de área de trabajo

Si asignó entidades de nivel de área de trabajo a entidades de nivel de servicio en la versión preliminar de áreas de trabajo, consulte la tabla siguiente para obtener instrucciones de migración.

La asignación ya no se admite Paso de migración recomendado
Asignación de API de área de trabajo a productos de nivel de servicio Uso de productos de nivel de área de trabajo
Asignación de API de área de trabajo o productos a etiquetas de nivel de servicio Uso de etiquetas de nivel de área de trabajo

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.

Información adicional

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