Compartir a través de

Incorporación del almacenamiento en caché para mejorar el rendimiento en Azure API Management

APLICA A: desarrollador | Básico | Básico v2 | Estándar | Estándar v2 | Premium | Premium v2 | Aislado

Las API y operaciones de API Management pueden configurarse con almacenamiento en caché de respuesta. El almacenamiento en caché de respuesta puede reducir considerablemente la latencia de los llamadores de API y la carga de back-end de los proveedores de API. En este artículo se describe cómo agregar almacenamiento en caché a las API.

Importante

La caché integrada es volátil y la comparten todas las unidades de la misma región en la misma instancia de API Management. Independientemente del tipo de caché usado (interno o externo), si las operaciones relacionadas con la caché no se pueden conectar a la caché debido a la volatilidad de la caché o por cualquier otro motivo, la llamada API que usa la operación relacionada con la caché no genera un error y la operación de caché se completa correctamente. En el caso de una operación de lectura, se devuelve un valor null a la expresión de directiva que realiza la llamada. El código de directiva debe diseñarse para asegurarse de que hay un mecanismo de reserva para recuperar datos que no se encuentran en la memoria caché.

Para más información acerca del almacenamiento en caché, consulte directivas de Almacenamiento en caché de API Management y Almacenamiento en caché personalizado en Azure API Management.

Captura de pantalla que muestra las directivas de caché en API Management.

En este artículo, puede:

  • Agregar almacenamiento en caché de respuesta a una API
  • Comprobación de que el almacenamiento en caché funciona

Nota:

El almacenamiento en caché interno no está disponible en el nivel Consumo de Azure API Management. Puede usar una instancia externa de Azure Redis Cache en su lugar. También puede configurar una caché externa en otros niveles de servicio de API Management.

Requisitos previos

Adición de directivas de almacenamiento en caché

Con las directivas de almacenamiento en caché que se muestran en este ejemplo, la primera solicitud a una operación de prueba devuelve una respuesta del servicio back-end. Dicha respuesta se almacena en la caché, con una clave especificada mediante encabezados y parámetros de la cadena de consulta. Las llamadas posteriores a la operación, con parámetros coincidentes, devolverán la respuesta almacenada en caché hasta que expire el intervalo de duración de la memoria caché.

  1. Inicie sesión en Azure Portal.

  2. Vaya a la instancia de API Management.

  3. Seleccione APIs>APIs en el menú de la izquierda.

  4. Seleccione la API para la que desea configurar el almacenamiento en caché.

  5. En la parte superior de la pantalla, seleccione la pestaña Diseño .

  6. En la sección Procesamiento de entrada , seleccione el <icono /> :

    Captura de pantalla que muestra las API de API Management en el portal.

  7. En el elemento inbound, agregue la siguiente directiva:

    <cache-lookup vary-by-developer="false" vary-by-developer-groups="false">
    <vary-by-header>Accept</vary-by-header>
    <vary-by-header>Accept-Charset</vary-by-header>
    <vary-by-header>Authorization</vary-by-header>
</cache-lookup>

  8. En el elemento outbound, agregue la siguiente directiva:

    <cache-store duration="20" />

    En esta directiva, duration especifica el intervalo de expiración de las respuestas almacenadas en caché. El intervalo es de 20 segundos.

  9. Haga clic en Guardar.

Sugerencia

Si usa una caché externa, como se describe en Uso de una instancia externa de Azure Cache for Redis en Azure API Management, puede especificar el caching-type atributo de las directivas de almacenamiento en caché. Consulte Directivas de almacenamiento en caché de API Management para obtener más información.

Llamada a una operación para probar el almacenamiento en caché

Para probar el almacenamiento en caché, ejecute una operación en el portal.

  1. En Azure Portal, vaya a la instancia de API Management.
  2. Seleccione APIs>APIs en el menú de la izquierda.
  3. Seleccione la API a la que ha agregado directivas de almacenamiento en caché.
  4. Seleccione una operación para probar.
  5. Seleccione la pestaña Prueba en la parte superior de la ventana.
  6. Seleccione Seguimiento dos o tres veces de manera seguida y rápida.
  7. En Respuesta HTTP, seleccione la pestaña Seguimiento.
  8. Vaya a la sección Entrante y desplácese hasta la directiva cache-lookup. Debería ver un mensaje similar al de la captura de pantalla siguiente, que indica un acierto de caché: Captura de pantalla de la búsqueda en caché al probar una API en el portal.

Contenido relacionado