Estás consultando la documentación de Apigee Edge.
Consulta la
documentación de Apigee X. Información
Como cliente actual de Apigee Edge, puedes migrar tu instalación a Apigee X para aprovechar las capacidades nuevas o la disponibilidad regional diferente.
En esta página, se describen los antipatrones de la configuración que deberás abordar antes de migrar a Apigee X, así como otros cambios de comportamiento que debes tener en cuenta antes de la migración.
En la lista más amplia de Antipatrones de Apigee Edge se describen las prácticas de uso que se deben evitar en todos los casos. En esta página, se describen las prácticas de uso no recomendadas específicas que bloquearán una migración. Resuélvelos ahora para evitar problemas durante la migración a Apigee X.
Apps sin productos de API | ||||||||||||||
Resumen | ¿Requiere cambios del cliente? | Solución | ||||||||||||
Hay apps sin productos de API. Diferencia entre Apigee Edge y Apigee X:
|
No. |
Resolución: Apps sin productos de APIAsocia cada credencial de app con al menos un producto de API. Si deseas obtener más información para hacerlo, consulta Registra apps y administra claves de API. Una ruta fácil es asignar a cada app acceso a todos los productos de API. Esto será equivalente a lo que se puede lograr en Apigee Edge. El desafío será que si deseas aplicar un enfoque de “privilegio mínimo”, deberás determinar la lista mínima de productos de API a los que debe tener acceso cada credencial de app. Puedes analizar esto con los informes de Analytics de Apigee Edge, basados en el ID de cliente. |
||||||||||||
Caché sin hora de vencimiento | ||||||||||||||
Resumen | ¿Requiere cambios del cliente? | Solución | ||||||||||||
Las memorias caché no tienen fecha de vencimiento. Diferencia entre Apigee Edge y Apigee X:
|
No |
Resolución: Caché sin hora de vencimientoEstablece una hora de vencimiento para todas las memorias caché. |
||||||||||||
Expresiones de filtro JSONPath en rutas no definidas | ||||||||||||||
Resumen | ¿Requiere cambios del cliente? | Solución | ||||||||||||
En el caso de las rutas de acceso no definitivas, la consulta del resultado de una expresión de filtro no forma parte de la especificación de JSONPath. Consulta https://goessner.net/articles/JsonPath/. Diferencia entre Apigee Edge y Apigee X: Cuando navegues por esta estructura de ejemplo, { "books": [ { "name": "A", }, { "name": "B", } ] } Con la expresión
Con la expresión
|
Sí |
Resolución: expresiones de filtro JSONPath en rutas no definidasBuscar y reemplazar las búsquedas afectadas |
||||||||||||
Expresiones JSONPath para índices que no están presentes | ||||||||||||||
Resumen | ¿Requiere cambios del cliente? | Solución | ||||||||||||
Las expresiones de JSONPath con un índice que no está presente tienen comportamientos diferentes en Apigee X y en Apigee Edge. Apigee X muestra un error Diferencia entre Apigee Edge y Apigee X: Cuando navegues por esta estructura de ejemplo, { "books": [ { "name": "A", }, { "name": "B", } ] } Con la expresión
|
Sí |
Resolución: expresiones JSONPath para índices que no están presentesBuscar y reemplazar las búsquedas afectadas |
||||||||||||
Expresiones JSONPath con un índice de array que no muestran un objeto de array | ||||||||||||||
Resumen | ¿Requiere cambios del cliente? | Solución | ||||||||||||
Las expresiones de JSONPath con un índice o porciones de array muestran un objeto de array en Apigee X. Diferencia entre Apigee Edge y Apigee X: Cuando navegues por esta estructura de ejemplo, { "books": [ { "name": "A", }, { "name": "B", } ] } Con la expresión
Con la expresión
Con la expresión
|
Sí |
Resolución: expresiones JSONPath con un índice de array que no muestra un objeto de arrayBusca y reemplaza expresiones que puedan mostrar resultados diferentes después de la actualización. |
||||||||||||
Restricciones de nombres de almacenes de claves |
||||||||||||||
Resumen | ¿Requiere cambios del cliente? | Solución | ||||||||||||
Los nombres de los almacenes de claves de Apigee X solo pueden contener letras, números y guiones. Los nombres de los almacenes de claves perimetrales no imponen estas restricciones. |
No |
Resolución: restricciones de nombres de almacenes de clavesVerifica los nombres de los almacenes de claves y actualízalos para quitar los caracteres no compatibles si es necesario. |
||||||||||||
Varias rutas base implementadas para un proxy de API |
||||||||||||||
Resumen | ¿Requiere cambios del cliente? | Solución | ||||||||||||
Se implementan varias revisiones de un proxy de API en un entorno y cada una tiene una ruta base diferente. Diferencia entre Apigee Edge y Apigee X:
|
No |
Resolución: Varias rutas base implementadas para un proxy de APIActualiza todos los conjuntos para que solo se implemente una revisión de un paquete en un entorno, sin importar la ruta base. |
||||||||||||
Mensajes HTTP que no cumplen con las políticas |
||||||||||||||
Resumen | ¿Requiere cambios del cliente? | Solución | ||||||||||||
Los clientes o el proxy de API envían mensajes (solicitudes o respuestas) que no cumplen con el estándar HTTP. Por ejemplo, nombres de encabezado no válidos, duplicaciones en algunos encabezados restringidos, etcétera. No puedes migrar a Apigee X si la ejecución de tu API tiene uno o más de los siguientes errores:
|
Sí, es posible. |
Resolución: Mensajes HTTP que no cumplen con las políticasDebes corregir cualquier error en los protocolos HTTP antes de migrar a Apigee X. Si se origina un error en una aplicación cliente, debes pedirle al desarrollador de la app cliente que corrija el problema. |
||||||||||||
La hora de vencimiento del token de OAuth 2.0 no es válida |
||||||||||||||
Resumen | ¿Requiere cambios del cliente? | Solución | ||||||||||||
Los límites de vencimiento de los tokens de OAuth 2.0 están fuera del rango prescrito. Diferencia entre Apigee Edge y Apigee X:
|
No |
Resolución: La hora de vencimiento del token de OAuth 2.0 no es válida
Usa la política OAuthV2 y especifica la hora de vencimiento en |
||||||||||||
Límites de productos excedidos |
||||||||||||||
Resumen | ¿Requiere cambios del cliente? | Solución | ||||||||||||
La configuración de Apigee Edge no cumple con los límites del producto definidos. Algunos límites de productos documentados, pero que no se aplican en Apigee Edge, se aplican en Apigee X. |
No |
Resolución: Se excedieron los límites de productosCorrige cualquier uso que exceda los límites del producto antes de migrar a Apigee X. |
||||||||||||
Políticas de ServiceFeatured con especificadores de conexión de extremo y de ruta de acceso |
||||||||||||||
Resumen | ¿Requiere cambios del cliente? | Solución | ||||||||||||
En la política ServiceFeatured, el elemento
Apigee Edge documenta este requisito, pero no lo aplica. Apigee X detiene el procesamiento si encuentra un |
No |
Resolución: Políticas de ServiceFeatured con especificadores de conexión de destino y extremo de ruta de acceso
Verifica la configuración de la política de ServiceReferencia y elimina los
parámetros de configuración de |
||||||||||||
Restricciones de nombres de servidor de destino |
||||||||||||||
Resumen | ¿Requiere cambios del cliente? | Solución | ||||||||||||
Los nombres de los servidores de destino de Apigee X solo pueden contener letras, números, guiones y puntos. Los nombres de los servidores de destino perimetral no imponen estas restricciones. |
No |
Resolución: restricciones de nombres de servidor de destinoVerifica los nombres de los servidores de destino y actualízalos para quitar los caracteres no compatibles si es necesario. |
||||||||||||
Certificado de prueba en un host virtual |
||||||||||||||
Resumen | ¿Requiere cambios del cliente? | Solución | ||||||||||||
Uno o más hosts virtuales usan el certificado de “prueba gratuita” proporcionado por Apigee. Esto hace que el host virtual responda a las solicitudes en dominios como Diferencia entre Apigee Edge y Apigee X:
|
Sí |
Resolución: Certificado de prueba en un host virtualDebes configurar tu propio dominio y aprovisionar los certificados de forma adecuada.
Cualquier aplicación cliente que dependa del nombre de dominio heredado con el formato |
||||||||||||
DNS sin resolver |
||||||||||||||
Resumen | ¿Requiere cambios del cliente? | Solución | ||||||||||||
Los extremos de destino tienen nombres de dominio sin resolver. Diferencia entre Apigee Edge y Apigee X:
|
No |
Resolución: DNS sin resolverActualiza el extremo de destino con un nombre de dominio válido. |