Control del comportamiento del almacenamiento en caché de Azure CDN con reglas de cachéControl Azure CDN caching behavior with caching rules

Nota

Las reglas de almacenamiento en caché solo están disponibles para los perfiles Azure CDN estándar de Verizon y Azure CDN estándar de Akamai.Caching rules are available only for Azure CDN Standard from Verizon and Azure CDN Standard from Akamai profiles. Para perfiles Azure CDN premium de Verizon, debe usar el motor de reglas de Azure CDN en el portal Administrar para una funcionalidad similar.For Azure CDN Premium from Verizon profiles, you must use the Azure CDN rules engine in the Manage portal for similar functionality.

Azure Content Delivery Network (CDN) ofrece dos formas de controlar cómo los archivos se almacenan en caché:Azure Content Delivery Network (CDN) offers two ways to control how your files are cached:

  • Reglas de almacenamiento en cache: en este artículo se describe cómo puede usar reglas de almacenamiento en caché de la red de entrega de contenido (CDN) para establecer o modificar el comportamiento de expiración de caché predeterminado, tanto globalmente como con condiciones personalizadas, como una ruta de dirección URL y extensión de archivo.Caching rules: This article describes how you can use content delivery network (CDN) caching rules to set or modify default cache expiration behavior both globally and with custom conditions, such as a URL path and file extension. Azure CDN proporciona dos tipos de reglas de almacenamiento en caché:Azure CDN provides two types of caching rules:

    • Reglas de almacenamiento en caché globales: puede establecer una regla de almacenamiento en caché global para cada punto de conexión en su perfil, lo que afecta a todas las solicitudes al punto de conexión.Global caching rules: You can set one global caching rule for each endpoint in your profile, which affects all requests to the endpoint. La regla de almacenamiento en caché global invalida todos los encabezados de directiva de caché HTTP, si está establecida.The global caching rule overrides any HTTP cache-directive headers, if set.

    • Reglas de almacenamiento en caché personalizadas: puede establecer una o varias reglas de almacenamiento en caché para cada punto de conexión en el perfil.Custom caching rules: You can set one or more custom caching rules for each endpoint in your profile. Las reglas de almacenamiento en caché personalizadas coinciden con rutas de acceso y extensiones de archivo específicas, se procesan en orden e invalidan la regla de almacenamiento en caché global, si está establecida.Custom caching rules match specific paths and file extensions, are processed in order, and override the global caching rule, if set.

  • Almacenamiento en caché de cadenas de consulta: puede ajustar cómo Azure CDN trata el almacenamiento en caché para las solicitudes con cadenas de consulta.Query string caching: You can adjust how the Azure CDN treats caching for requests with query strings. Para información, consulte Control del comportamiento del almacenamiento en caché de Azure Content Delivery Network con cadenas de consulta.For information, see Control Azure CDN caching behavior with query strings. Si el archivo no se puede almacenar en caché, la configuración del almacenamiento en caché de las cadenas de consulta no tiene ningún efecto, según los comportamientos predeterminados de la red CDN y las reglas de almacenamiento en caché.If the file is not cacheable, the query string caching setting has no effect, based on caching rules and CDN default behaviors.

Para información sobre el comportamiento de almacenamiento en caché predeterminado y los encabezados de directiva de almacenamiento en caché, consulte Cómo funciona el almacenamiento en caché.For information about default caching behavior and caching directive headers, see How caching works.

Acceso a las reglas de almacenamiento en caché de Azure CDNAccessing Azure CDN caching rules

  1. Abra Azure Portal, seleccione un perfil de red CDN y luego seleccione un punto de conexión.Open the Azure portal, select a CDN profile, then select an endpoint.

  2. En el panel izquierdo, debajo de Configuración, haga clic en Reglas de caché.In the left pane under Settings, select Caching rules.

    Botón Reglas de caché de CDN

    Aparece la página Reglas de caché.The Caching rules page appears.

    Página de reglas de almacenamiento en caché de CDN

Configuración del comportamiento del almacenamiento en cachéCaching behavior settings

Para las reglas de almacenamiento en caché globales y personalizadas, puede especificar la siguiente configuración para Comportamiento de almacenamiento en caché:For global and custom caching rules, you can specify the following Caching behavior settings:

  • Omitir caché: no almacenar en caché y omitir los encabezados de directiva de caché proporcionados por el origen.Bypass cache: Do not cache and ignore origin-provided cache-directive headers.

  • Invalidar: omitir la duración de la caché proporcionada por el origen; en su lugar, utilizar la duración de caché proporcionada.Override: Ignore origin-provided cache duration; use the provided cache duration instead. Esto no invalidará cache-control: no-cache.This will not override cache-control: no-cache.

  • Establecer si falta: respetar los encabezados de directiva de caché proporcionados por el origen, si existen; en caso contrario, utilizar la duración de caché proporcionada.Set if missing: Honor origin-provided cache-directive headers, if they exist; otherwise, use the provided cache duration.

Reglas de almacenamiento en caché globales

Reglas de almacenamiento en caché personalizadas

Duración de expiración de cachéCache expiration duration

Para las reglas de almacenamiento en caché globales y personalizadas, puede especificar la duración de expiración de caché en días, horas, minutos y segundos:For global and custom caching rules, you can specify the cache expiration duration in days, hours, minutes, and seconds:

  • Para las configuraciones Invalidar y Establecer si falta correspondientes a Comportamiento de almacenamiento en caché, el intervalo de las duraciones de caché válido está comprendido entre 0 segundos y 366 días.For the Override and Set if missing Caching behavior settings, valid cache durations range between 0 seconds and 366 days. Para un valor de 0 segundos, la red CDN almacena en caché el contenido, pero debe volver a validar cada solicitud con el servidor de origen.For a value of 0 seconds, the CDN caches the content, but must revalidate each request with the origin server.

  • Para la configuración Omitir caché, la duración de caché se establece automáticamente en 0 segundos y no se puede cambiar.For the Bypass cache setting, the cache duration is automatically set to 0 seconds and cannot be changed.

Condiciones de coincidencia de reglas de almacenamiento en caché personalizadasCustom caching rules match conditions

Para las reglas de caché personalizadas, hay dos condiciones de coincidencia disponibles:For custom cache rules, two match conditions are available:

  • Ruta de acceso: esta condición coincide con la ruta de acceso de la dirección URL, sin incluir el nombre de dominio, y admite el símbolo de comodín (*).Path: This condition matches the path of the URL, excluding the domain name, and supports the wildcard symbol (*). Por ejemplo, /myfile.html, /my/folder/* , and /my/images/*.jpg.For example, /myfile.html, /my/folder/*, and /my/images/*.jpg. La longitud máxima es de 260 caracteres.The maximum length is 260 characters.

  • Extensión: esta condición coincide con la extensión de archivo del archivo solicitado.Extension: This condition matches the file extension of the requested file. Puede proporcionar una lista de extensiones de archivo separadas por comas para coincidir.You can provide a list of comma-separated file extensions to match. Por ejemplo, .jpg, .mp3 o .png.For example, .jpg, .mp3, or .png. El número máximo de extensiones es 50 y el número máximo de caracteres por extensión es 16.The maximum number of extensions is 50 and the maximum number of characters per extension is 16.

Orden de procesamiento de las reglas globales y personalizadasGlobal and custom rule processing order

Las reglas de almacenamiento en caché globales y personalizadas se procesan en el orden siguiente:Global and custom caching rules are processed in the following order:

  • Las reglas de almacenamiento en caché globales tienen prioridad sobre el comportamiento predeterminado de almacenamiento en caché de la red CDN (configuración del encabezado de la directiva de caché HTTP).Global caching rules take precedence over the default CDN caching behavior (HTTP cache-directive header settings).

  • Las reglas de almacenamiento en caché personalizadas tienen prioridad sobre las reglas de almacenamiento en caché globales, donde se apliquen.Custom caching rules take precedence over global caching rules, where they apply. Las reglas de almacenamiento en caché personalizadas se procesan en orden de arriba a abajo.Custom caching rules are processed in order from top to bottom. Es decir, si una solicitud cumple ambas condiciones, las reglas situadas abajo en la lista tienen prioridad sobre las reglas situadas en la parte de arriba de la lista.That is, if a request matches both conditions, rules at the bottom of the list take precedence over rules at the top of the list. Por lo tanto, debe colocar las reglas más específicas en la parte inferior de la lista.Therefore, you should place more specific rules lower in the list.

Ejemplo:Example:

  • Regla de almacenamiento en caché global:Global caching rule:

    • Comportamiento del almacenamiento en caché: InvalidarCaching behavior: Override
    • Duración de expiración de caché: 1 díaCache expiration duration: 1 day
  • Regla de almacenamiento en caché personalizada nº 1:Custom caching rule #1:

    • Condición de coincidencia: PathMatch condition: Path
    • Valor de coincidencia: /home/*Match value: /home/*
    • Comportamiento del almacenamiento en caché: InvalidarCaching behavior: Override
    • Duración de expiración de caché: 2 díasCache expiration duration: 2 days
  • Regla de almacenamiento en caché personalizada nº 2:Custom caching rule #2:

    • Condición de coincidencia: ExtensiónMatch condition: Extension
    • Valor de coincidencia: .htmlMatch value: .html
    • Comportamiento del almacenamiento en caché: Establecer si faltaCaching behavior: Set if missing
    • Duración de expiración de caché: 3 díasCache expiration duration: 3 days

Cuando se establecen estas reglas, una solicitud de <endpoint hostname> .azureedge.net/home/index.html desencadena la regla de almacenamiento en caché personalizada n.º 2, que se establece en: Establecer si falta y 3 días.When these rules are set, a request for <endpoint hostname>.azureedge.net/home/index.html triggers custom caching rule #2, which is set to: Set if missing and 3 days. Por lo tanto, si el archivo index.html tiene los encabezados HTTP Cache-Control o Expires, se respetan; de lo contrario, si estos encabezados no están establecidos, el archivo se almacena en caché durante 3 días.Therefore, if the index.html file has Cache-Control or Expires HTTP headers, they are honored; otherwise, if these headers are not set, the file is cached for 3 days.

Nota

Los archivos que se almacenan en caché antes de un cambio de regla mantienen su valor de duración de caché de origen.Files that are cached before a rule change maintain their origin cache duration setting. Para restablecer sus duraciones de caché, debe purgar el archivo.To reset their cache durations, you must purge the file.

Los cambios en la configuración de Azure CDN pueden tardar un tiempo en propagarse por la red:Azure CDN configuration changes can take some time to propagate through the network:

  • En los perfiles de Azure CDN estándar, la propagación normalmente se completa en un minuto.For Azure CDN Standard from Akamai profiles, propagation usually completes within one minute.
  • En los perfiles de Azure CDN estándar de Verizon, la propagación normalmente se completa en 10 minutos.For Azure CDN Standard from Verizon profiles, propagation usually completes in 10 minutes.

Otras referenciasSee also