Configuración de caché para las API de REST en API Gateway

Puede habilitar el almacenamiento en caché de la API en API Gateway para almacenar en caché las respuestas del punto de conexión. Con el almacenamiento en caché, puede reducir el número de llamadas realizadas al punto de enlace y mejorar también la latencia de las solicitudes a la API.

Cuando habilita el almacenamiento en caché para una etapa, API Gateway almacena en caché las respuestas del punto de enlace durante el período de tiempo de vida (TTL) especificado, en segundos. A continuación, API Gateway responde a la solicitud buscando la respuesta del punto de enlace en la caché en lugar de realizar una solicitud al punto de enlace. El valor de TTL predeterminado para el almacenamiento en caché de la API es de 300 segundos. El valor de TTL máximo es de 3600 segundos. TTL = 0 significa que el almacenamiento en caché está deshabilitado.

El tamaño máximo de una respuesta que se puede almacenar en la caché es 1048576 bytes. El cifrado de datos en la caché puede aumentar el tamaño de la respuesta cuando se almacena en la caché.

Se trata de un servicio compatible con HIPAA. Para obtener más información acerca de AWS, la ley de responsabilidad y portabilidad de seguros médicos de Estados Unidos de 1996 (HIPAA) y el uso de los servicios de AWS para procesar, almacenar y transmitir información sanitaria protegida (PHI), consulte Información general sobre la HIPAA.

Activar almacenamiento en caché de Amazon API Gateway

En API Gateway, puede habilitar el almacenamiento en caché para una etapa específica.

Al habilitar el almacenamiento en caché, debe elegir una capacidad de caché. En general, una capacidad mayor ofrece un mejor desempeño, pero también cuesta más. Para conocer los tamaños de la memoria caché admitidos, consulte cacheClusterSize en la referencia de API de API Gateway.

API Gateway permite el almacenamiento en caché creando una instancia de caché dedicada. Este proceso puede tardar hasta cuatro minutos.

API Gateway cambia la capacidad de almacenamiento en caché eliminando al instancia de caché y creando una nueva con una capacidad modificada. Todos los datos almacenados en la memoria caché existente se eliminan.

En la consola de API Gateway, se configura el almacenamiento en caché en la página Etapas. Debe aprovisionar la caché de etapas y especificar una configuración de caché predeterminada en el nivel de método. Si activa la caché en el nivel de método predeterminada, la caché en el nivel de método se activa para todos los métodos GET de la etapa, a menos que ese método tenga una invalidación de método. Cualquier método GET adicional que implemente en la etapa tendrá una caché en el nivel de método. Para configurar los ajustes de almacenamiento en caché en el nivel de método para métodos específicos de la etapa, puede utilizar invalidaciones de método. Para obtener más información acerca de las invalidaciones de métodos, consulte Invalidación del almacenamiento en caché en el nivel de etapa de API Gateway para el almacenamiento en caché en el nivel de método.

Cuando se habilita el almacenamiento en caché en Configuración de caché de la etapa, solo se almacenan en caché los métodos GET. Para garantizar la seguridad y la disponibilidad de la API, le recomendamos que no cambie esta configuración. Sin embargo, puede habilitar el almacenamiento en caché para otros métodos invalidando la configuración del método.

Si desea comprobar si el almacenamiento en caché funciona según lo previsto, tiene dos opciones generales:

Invalidación del almacenamiento en caché en el nivel de etapa de API Gateway para el almacenamiento en caché en el nivel de método

Puede invalidar la configuración de caché en el nivel de etapa activando o desactivando el almacenamiento en caché para un método específico. Puede también modificar el periodo de TTL o activar o desactivar el cifrado para respuestas almacenadas en caché.

Si cambia la configuración predeterminada del almacenamiento en caché en el nivel de método en Detalles de la etapa, la configuración de la caché en el nivel de método que tiene invalidaciones no se verá afectada.

Si prevé que un método que almacena en caché va a recibir información confidencial en sus respuestas, en Cache Settings (Configuración de caché), elija Encrypt cache data (Cifrar datos de caché).

Usar parámetros de método o integración como claves de caché para indexar las respuestas almacenadas en caché

Puede usar un parámetro de método o integración como claves de caché para indexar las respuestas almacenadas en caché. Esto incluye encabezados personalizados, rutas de URL o cadenas de consulta. Puede especificar alguno de estos parámetros o todos como la clave de caché, pero debe especificar al menos un valor. Cuando tiene una clave de caché, API Gateway almacena en caché las respuestas de cada valor de clave de forma independiente, incluso cuando la clave de caché no está presente.

Suponga, por ejemplo, que tiene una solicitud con el siguiente formato:

GET /users?type=... HTTP/1.1
host: example.com
...
        

En esta solicitud, type puede tomar un valor de admin o regular. Si incluye el parámetro type como parte de la clave de caché, las respuestas de GET /users?type=admin se almacenan en caché por separado de las de GET /users?type=regular.

Cuando una solicitud de método o integración toma más de un parámetro, puede elegir algunos o todos los parámetros para crear la clave de caché. Por ejemplo, puede incluir solamente el parámetro type en la clave de caché para la siguiente solicitud, realizada en el orden indicado dentro de un período de TTL:

GET /users?type=admin&department=A HTTP/1.1
host: example.com
...
        

La respuesta de esta solicitud se almacena en caché y se utiliza para servir la siguiente solicitud:

GET /users?type=admin&department=B HTTP/1.1
host: example.com
...
        

Para incluir un parámetro de solicitud de método o integración como parte de una clave de caché en la consola de API Gateway, seleccione Caching después de agregar el parámetro.

Vaciar la caché de etapa de API en API Gateway

Cuando el almacenamiento en caché de la API está habilitado, puede vaciar la caché de etapas de API para asegurarse de que los clientes de la API obtengan las respuestas más recientes de los puntos de conexión de integración.

Para vaciar la caché de etapas de API, elija el menú de acciones de la etapa y, a continuación, seleccione Vaciar la caché de etapas.

Invalidar una entrada de caché de API Gateway

Un cliente de la API puede invalidar una entrada de caché existente y volver a cargarla desde el punto de enlace de integración para las distintas solicitudes. El cliente debe enviar una solicitud que contenga el encabezado Cache-Control: max-age=0. El cliente recibe la respuesta directamente del punto de enlace de integración en lugar de la caché, siempre que el cliente esté autorizado para ello. Esto sustituye la entrada de caché existente por la nueva respuesta, que se obtiene del punto de enlace de integración.

Para conceder permiso a un cliente, asocie una política con el siguiente formato a una función de ejecución de IAM del usuario.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "execute-api:InvalidateCache"
      ],
      "Resource": [
        "arn:aws:execute-api:region:account-id:api-id/stage-name/GET/resource-path-specifier"
      ]
    }
  ]
}            
        

Esta política permite al servicio de ejecución de API Gateway invalidar la caché para las solicitudes en el recurso o recursos especificados. Para especificar un grupo de recursos de destino, utilice el carácter comodín (*) para account-id, api-id y otras entradas en el valor de ARN de Resource. Para obtener más información sobre cómo establecer permisos para el servicio de ejecución de API Gateway, consulte Control del acceso a una API de REST con permisos de IAM.

Si no impone una política InvalidateCache (o selecciona la casilla de verificación Require authorization (Solicitar autorización)), cualquier cliente puede invalidar la caché de la API. Si la mayoría o todos los clientes invalidan la caché de la API, esto podría aumentar considerablemente la latencia de la API.

Cuando la política está implantada, se habilita el almacenamiento en caché y se requiere autorización.

Puede controlar cómo se gestionan las solicitudes no autorizadas eligiendo una opción de Gestión de solicitudes no autorizadas en la consola de API Gateway.

Las tres opciones producen los siguientes comportamientos: