Usa el almacenamiento en caché negativo

En esta página, se proporcionan instrucciones para usar el almacenamiento en caché negativo con Cloud CDN. El almacenamiento en caché negativo te permite establecer un TTL diferente para cada código de estado.

El propósito de esto es aplicar un control detallado sobre el almacenamiento en caché para redireccionamientos o errores comunes. Esto puede reducir la carga tus orígenes y mejorar la experiencia del usuario final mediante la reducción de la latencia de respuesta.

Antes de comenzar

Códigos de estado y TTL predeterminados

El almacenamiento en caché negativo se aplica a los códigos de estado específicos, que se enumeran en la siguiente tabla.

Cloud CDN aplica los siguientes TTL predeterminados a estos códigos de estado:

Código de estado Significado TTL
HTTP 300 Opción múltiple 10 minutos
HTTP 301 y 308 Redireccionamientos permanentes 10 minutos
HTTP 302 y 307 Redireccionamientos temporales No se almacena en caché de forma predeterminada
HTTP 404 No encontrado 120 segundos
HTTP 405 No se encontró el método 60 segundos
HTTP 410 No disponible 120 segundos
HTTP 451 No disponible por motivos legales 120 segundos
HTTP 501 No se implementó 60 segundos

Puedes anular estos valores predeterminados mediante el almacenamiento en caché negativo a fin de establecer un TTL de caché para el código de estado HTTP especificado.

Configura el almacenamiento en caché negativo

El almacenamiento en caché negativo te permite configurar tu servicio para almacenar en caché las fallas y los éxitos. Esto permite a Cloud CDN proteger los orígenes de las solicitudes que generan errores (como 404 Not Found) de la misma manera que protege a los orígenes de las solicitudes que generan respuestas exitosas.

Console

  1. En la consola de Google Cloud, ve a la página Balanceo de cargas.

    Ir a la página Balanceo de cargas

  2. Haz clic en el nombre de tu balanceador de cargas de aplicaciones externo.
  3. Haz clic en Editar .
  4. En Configuración de backend, selecciona un backend y haz clic en Editar .
  5. Asegúrate de que la opción Habilitar Cloud CDN esté seleccionada.
  6. En la parte inferior de la ventana, haz clic en Configuración avanzada.
  7. Haz clic en Habilitar almacenamiento en caché negativo.
  8. Haz clic en Agregar política de almacenamiento en caché negativo.
    1. Ingresa un código de estado HTTP.
    2. Selecciona el tiempo de actividad (TTL) en caché.
  9. Haz clic en Actualizar.
  10. Vuelve a hacer clic en Actualizar.

gcloud

En los buckets de backend, usa el comando gcloud compute backend-buckets create o gcloud compute backend-buckets update con la marca --negative-caching.

En los servicios de backend, usa el comando gcloud compute backend-services create o gcloud compute backend-services update con la marca --negative-caching.

gcloud compute backend-buckets (create | update) BACKEND_BUCKET_NAME
    --negative-caching
gcloud compute backend-services (create | update) BACKEND_SERVICE_NAME
    --negative-caching

Si deseas habilitar el almacenamiento en caché negativo de solo dos respuestas de error específicas, por ejemplo, configura las respuestas con el código de estado 404 para que se almacenen en caché durante 60 segundos y las respuestas con el código de estado 405 para que se almacenen en caché durante 120 segundos.

gcloud compute backend-services update BACKEND_SERVICE_NAME \
    --negative-caching \
    --cache-mode=CACHE_ALL_STATIC \
    --default-ttl=86400 \
    --negative-caching-policy='404=60,405=120'

api

En los buckets de backend, usa la llamada a la API Method: backendBuckets.insert o Method: backendBuckets.update.

En los servicios de backend, usa la llamada a la API Method: backendServices.insert o Method: backendServices.update.

Usa una de las siguientes llamadas a la API:

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/backendBuckets
PUT https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/backendBuckets/BACKEND_BUCKET
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/backendServices
PUT https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/backendServices/BACKEND_SERVICE

Agrega el siguiente fragmento al cuerpo de solicitud JSON:

"cdnPolicy": {
  "negativeCaching": ON,
  "negativeCachingPolicy": [
    {
      "code": STATUS_CODE,
      "ttl": TTL_SECONDS
    }
  ]
}

El almacenamiento en caché negativo debe estar habilitado para establecer la configuración de negativeCachingPolicy. Si omites la política y tienes negativeCaching habilitado, Cloud CDN usa los valores predeterminados enumerados en Códigos de estado y TTL predeterminados.

Cuando especifiques una política de almacenamiento en caché negativo, asegúrate de especificar un TTL de caché para todos los códigos de respuesta que deseas almacenar en caché. Cloud CDN no aplica ningún almacenamiento en caché negativo predeterminado cuando existe una política.

Para STATUS_CODE, puedes especificar los siguientes códigos de estado HTTP:

  • 300, 301, 302, 307, 308
  • 404, 405, 410, 421, 451
  • 501

Puedes especificar una cantidad de segundos para almacenar respuestas en caché en cada código de estado. Para inhabilitar el almacenamiento en caché negativo para el código de estado, excluye el código de tu política de almacenamiento en caché negativo.

El valor máximo permitido es de 1800 segundos (30 minutos). Sin embargo, los objetos a los que se accede con poca frecuencia pueden expulsarse de la caché antes del TTL definido.

Cuando el modo de almacenamiento en caché se establece como CACHE_ALL_STATIC o USE_ORIGIN_HEADERS, el almacenamiento en caché negativo se aplica a las respuestas con el código de respuesta especificado que no cuentan con Cache-Control ni encabezados Expires.

Cuando el modo de almacenamiento en caché se establece en FORCE_CACHE_ALL, el almacenamiento en caché negativo anula los encabezados almacenados en caché que establece el origen y Cloud CDN almacenará en caché la respuesta durante el período que especifica el TTL, o no se almacenará en caché si no está configurado el TTL.

Además, cuando el modo de caché se establece en FORCE_CACHE_ALL, Cloud CDN también modificará el max-age enviado al cliente en el encabezado Cache-Control. En particular, si un error determinado tiene una configuración de TTL configurada, Cloud CDN tomará la menor configuración de TTL y la configuración de client_ttl, y enviará un encabezado Cache-Control: public,max-age=N con ese valor. Si un error determinado no tiene una configuración de TTL configurada, Cloud CDN quitará cualquier encabezado Cache-Control que envíe el origen. Cloud CDN siempre quitará cualquier encabezado Expires que envíe el origen.

Si un origen tiene el almacenamiento en caché negativo habilitado inicialmente, pero luego inhabilitado (ya sea de forma manual o inhabilitando el almacenamiento en caché de un código de respuesta específico), las respuestas de error almacenadas en caché se consideran válidas solo en función de sus encabezados Cache-Control o Expires. Por lo tanto, una vez que se inhabilita el almacenamiento en caché negativo, una respuesta sin directivas de antigüedad de almacenamiento en caché en sus encabezados no se entrega desde la caché.

Cloud CDN almacena en caché en respuesta a solicitudes GET. Para obtener más información, consulta Contenido que se puede almacenar en caché.

Cada entrada de caché se identifica mediante una clave de caché.

Inhabilita el almacenamiento en caché negativo

Console

  1. En la consola de Google Cloud, ve a la página Balanceo de cargas.

    Ir a la página Balanceo de cargas

  2. Haz clic en el nombre de tu balanceador de cargas de aplicaciones externo.
  3. Haz clic en Editar .
  4. En Configuración de backend, selecciona un backend y haz clic en Editar .
  5. Asegúrate de que la opción Habilitar Cloud CDN esté seleccionada.
  6. En la parte inferior de la ventana, haz clic en Configuración avanzada.
  7. Desmarca la casilla de verificación junto a Habilitar almacenamiento en caché negativo.
  8. Haz clic en Actualizar.
  9. Vuelve a hacer clic en Actualizar.

gcloud

En los buckets de backend, usa el comando gcloud compute backend-buckets create o gcloud compute backend-buckets update con la marca --no-negative-caching.

En los servicios de backend, usa el comando gcloud compute backend-services create o gcloud compute backend-services update con la marca --no-negative-caching.

gcloud compute backend-services (create | update) (BACKEND_SERVICE_NAME | BACKEND_BUCKET_NAME)
    --no-negative-caching

api

En los buckets de backend, usa la llamada a la API Method: backendBuckets.insert o Method: backendBuckets.update.

En los servicios de backend, usa la llamada a la API Method: backendServices.insert o Method: backendServices.update.

Usa una de las siguientes llamadas a la API:

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/backendBuckets
PUT https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/backendBuckets/BACKEND_BUCKET
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/backendServices
PUT https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/backendServices/BACKEND_SERVICE

Agrega el siguiente fragmento al cuerpo de solicitud JSON:

"cdnPolicy": {
  "negativeCaching": OFF
}