Herramientas de persistencia en Edge

Estás viendo la documentación de Apigee Edge.
Ve a la documentación de Apigee X.
info

Qué encontrarás aquí

Los mecanismos de Apigee Edge para la persistencia y la caché incluyen la persistencia a corto plazo y a largo plazo. Existen políticas para el almacenamiento en caché de respuesta y de uso general. Usa la API de administración para administrar las cachés.

Almacenamiento en caché de respuesta de backend

Puedes almacenar en caché la respuesta de un recurso de backend con la política de almacenamiento en caché de respuestas.

Esto es especialmente útil cuando los datos de backend se actualizan solo de forma periódica. La política de ResponseCache puede reducir las llamadas a las fuentes de datos de backend.

A través de la política ResponseCache, también puedes hacer que Edge observe ciertos encabezados de almacenamiento en caché de respuesta HTTP y tome medidas de acuerdo con las directivas de encabezado. Por ejemplo, en las respuestas de los objetivos de backend, Edge admite el encabezado Cache-Control. Este encabezado se puede usar para controlar la antigüedad máxima de una respuesta almacenada en caché, entre otras tareas. Para obtener más información, consulta Compatibilidad con los encabezados de respuesta HTTP.

Almacenamiento en caché de uso general de corta duración

Con las políticas de almacenamiento en caché de uso general, puedes conservar cualquier objeto que requiera el proxy en varias sesiones de solicitud/respuesta.

Con la política PopulateCache, la política LookupCache y la política InvalidateCache, puedes propagar, recuperar y vaciar datos almacenados en caché en el entorno de ejecución.

Por ejemplo, puedes almacenar lo siguiente de forma temporal:

  • ID de sesión para la administración de sesiones.
  • Credenciales para llamadas salientes (como claves de API o tokens de acceso de OAuth).
  • Contenido de respuesta que se debe paginar para las apps.

En el entorno de ejecución, las políticas de caché copian los valores entre las variables de proxy y la caché configurada que especifiques. Cuando se coloca un valor en la caché, se copia de la variable que especificas a la caché. Cuando se recupera de la caché, se copia en la variable para que la use tu proxy.

Para ver un ejemplo con código, consulta Ejemplo: Almacenamiento en caché de uso general.

Persistencia a largo plazo con mapas clave-valor (KVM)

Para almacenar datos estructurados de forma indefinida o encriptada, puedes crear y propagar mapas de clave-valor (KVM) que contienen pares clave-valor arbitrarios. Por ejemplo, puedes almacenar lo siguiente:

  • Un mapa que correlaciona direcciones IP con códigos de país.
  • Una lista de direcciones IP para incluir en la lista de entidades permitidas o denegadas
  • Un mapa que correlaciona URL largas con URL acortadas.
  • Datos específicos del entorno, como recuentos de cuotas y fechas de vencimiento de tokens de OAuth.

Los KVM pueden tener uno de tres alcances: organización, entorno o apiproxy. Por ejemplo, si los pares clave-valor se usarán para todas las API de una organización, crea un KVM a nivel de la organización. Si solo un proxy de API específico debe tener acceso a claves y valores, crea el KVM en el permiso apiproxy. Puedes crear, administrar y recuperar mapas de pares clave-valor de varias maneras. Para obtener más información, consulta Cómo trabajar con mapas de par clave-valor.

Cómo administrar la caché con la API de administración

Si deseas crear, ver, actualizar, borrar y borrar caché fuera del alcance de las políticas en un flujo de mensajes, puedes usar la API de administración de cachés.