Het gedrag van Azure CDN caching bepalen met cache regelsControl Azure CDN caching behavior with caching rules

Notitie

Cache regels zijn alleen beschikbaar voor Azure CDN Standard van Verizon en Azure CDN Standard van Akamai -profielen.Caching rules are available only for Azure CDN Standard from Verizon and Azure CDN Standard from Akamai profiles. Voor Azure CDN van micro soft -profielen moet u de Standard Rules engine gebruiken voor Azure CDN Premium van Verizon -profielen. u moet de regel engine van Verizon Premium gebruiken in de portal beheren voor vergelijk bare functionaliteit.For Azure CDN from Microsoft profiles, you must use the Standard rules engine For Azure CDN Premium from Verizon profiles, you must use the Verizon Premium rules engine in the Manage portal for similar functionality.

Azure Content Delivery Network (CDN) biedt twee manieren om te bepalen hoe uw bestanden in de cache worden opgeslagen:Azure Content Delivery Network (CDN) offers two ways to control how your files are cached:

  • Regels voor opslaan in cache: in dit artikel wordt beschreven hoe u de regels voor het gebruik van CDN (Content Delivery Network) kunt gebruiken voor het instellen of wijzigen van het verloop van de standaard cache zowel globaal als met aangepaste voor waarden, zoals een URL-pad en bestands extensie.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 biedt twee typen regels voor opslaan in cache:Azure CDN provides two types of caching rules:

    • Globale regels voor opslaan in cache: u kunt voor elk eindpunt in uw profiel één globale regel voor opslaan in cache instellen, die geldt voor alle aanvragen op het eindpunt.Global caching rules: You can set one global caching rule for each endpoint in your profile, which affects all requests to the endpoint. De globale regel voor opslaan in cache overschrijft alle HTTP-headers met cache-instructies, indien aanwezig.The global caching rule overrides any HTTP cache-directive headers, if set.

    • Aangepaste regels voor opslaan in cache: u kunt een of meer aangepaste regels voor opslaan in cache instellen voor elk eindpunt in uw profiel.Custom caching rules: You can set one or more custom caching rules for each endpoint in your profile. Aangepaste regels voor opslaan in cache komen overeen met specifieke paden en bestandsextensies, worden in volgorde verwerkt en overschrijven de globale regel voor opslaan in cache, indien ingesteld.Custom caching rules match specific paths and file extensions, are processed in order, and override the global caching rule, if set.

  • Query reeks cache: u kunt aanpassen hoe de Azure CDN in de cache wordt behandeld voor aanvragen met query teken reeksen.Query string caching: You can adjust how the Azure CDN treats caching for requests with query strings. Zie voor meer informatie Control Azure CDN Caching with query strings.For information, see Control Azure CDN caching behavior with query strings. Als het bestand niet in cache kan worden opgeslagen, heeft de cache-instelling voor de query reeks geen effect, op basis van de cache regels en het standaard CDN-gedrag.If the file is not cacheable, the query string caching setting has no effect, based on caching rules and CDN default behaviors.

Zie How caching Works(Engelstalig) voor meer informatie over het standaard gedrag van caching en het opslaan van instructie headers in de cache.For information about default caching behavior and caching directive headers, see How caching works.

Azure CDN regels voor caching gebruikenAccessing Azure CDN caching rules

  1. Open de Azure Portal, selecteer een CDN-profiel en selecteer vervolgens een eind punt.Open the Azure portal, select a CDN profile, then select an endpoint.

  2. Selecteer in het linkerdeelvenster onder Instellingen de optie Regels voor opslaan in cache.In the left pane under Settings, select Caching rules.

    Knop Regels voor CDN-caching

    De pagina Regels voor opslaan in cache wordt weergegeven.The Caching rules page appears.

    Pagina Regels voor CDN-caching

Instellingen voor cache gedragCaching behavior settings

Voor globale en aangepaste regels voor caching kunt u de volgende instellingen voor cache gedrag opgeven:For global and custom caching rules, you can specify the following Caching behavior settings:

  • Cache overs Laan: de door de oorsprong vermelde cache-instructie headers worden niet in de cache geplaatst en genegeerd.Bypass cache: Do not cache and ignore origin-provided cache-directive headers.

  • Negeren: oorspronkelijke cache duur van de oorsprong negeren; gebruik in plaats daarvan de meegeleverde cache duur.Override: Ignore origin-provided cache duration; use the provided cache duration instead. Hiermee wordt de cache-Control niet overschreven: geen cache.This will not override cache-control: no-cache.

  • Instellen indien ontbrekend: door de beheerder gestuurde cache-instructie headers, indien aanwezig. Gebruik anders de meegeleverde cache duur.Set if missing: Honor origin-provided cache-directive headers, if they exist; otherwise, use the provided cache duration.

Globale regels voor opslaan in cache

Aangepaste regels voor opslaan in cache

Verloop tijd van cacheCache expiration duration

Voor globale en aangepaste cache regels kunt u de verloop duur van de cache opgeven in dagen, uren, minuten en seconden:For global and custom caching rules, you can specify the cache expiration duration in days, hours, minutes, and seconds:

  • Voor de instellingen negeren en instellen als het gedrag voor het Opslaan van de cache ontbreekt, geldt een geldige cache duur van 0 seconden en 366 dagen.For the Override and Set if missing Caching behavior settings, valid cache durations range between 0 seconds and 366 days. Voor een waarde van 0 seconden wordt de inhoud in de CDN opgeslagen, maar moet elke aanvraag opnieuw worden gevalideerd met de oorspronkelijke server.For a value of 0 seconds, the CDN caches the content, but must revalidate each request with the origin server.

  • Voor de bypass cache -instelling wordt de cache duur automatisch ingesteld op 0 seconden en kan niet worden gewijzigd.For the Bypass cache setting, the cache duration is automatically set to 0 seconds and cannot be changed.

Aangepaste regels voor caching voldoen aan de voor waardenCustom caching rules match conditions

Voor aangepaste cache regels zijn twee match-voor waarden beschikbaar:For custom cache rules, two match conditions are available:

  • Pad: deze voor waarde komt overeen met het pad van de URL, met uitzonde ring van de domein naam, en ondersteunt het Joker teken (*).Path: This condition matches the path of the URL, excluding the domain name, and supports the wildcard symbol (*). Bijvoorbeeld, /MyFile.html, /mijn/map/* en /My/images/*. jpg.For example, /myfile.html, /my/folder/*, and /my/images/*.jpg. De maximale lengte is 260 tekens.The maximum length is 260 characters.

  • Extensie: deze voor waarde komt overeen met de bestands extensie van het aangevraagde bestand.Extension: This condition matches the file extension of the requested file. U kunt een lijst met door komma's gescheiden bestands extensies opgeven.You can provide a list of comma-separated file extensions to match. Bijvoorbeeld . jpg, _. mp3_of . png.For example, .jpg, .mp3, or .png. Het maximum aantal uitbrei dingen is 50 en het maximum aantal tekens per uitbrei ding is 16.The maximum number of extensions is 50 and the maximum number of characters per extension is 16.

Algemene en aangepaste verwerkings volgorde voor regelsGlobal and custom rule processing order

Globale en aangepaste regels voor opslaan in cache worden in de volgende volg orde verwerkt:Global and custom caching rules are processed in the following order:

  • Algemene regels voor opslaan in cache hebben voor rang op de standaard instelling voor het gedrag van de CDN-cache (HTTP-cache-header-instellingen).Global caching rules take precedence over the default CDN caching behavior (HTTP cache-directive header settings).

  • Aangepaste regels voor opslaan in cache hebben voor rang op algemene regels voor caching, waar ze van toepassing zijn.Custom caching rules take precedence over global caching rules, where they apply. Aangepaste regels voor opslaan in cache worden van boven naar beneden verwerkt.Custom caching rules are processed in order from top to bottom. Als een aanvraag overeenkomt met beide voor waarden, hebben regels onder aan de lijst voor rang boven de regels boven aan de lijst.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. Daarom moet u meer specifieke regels in de lijst plaatsen.Therefore, you should place more specific rules lower in the list.

Voorbeeld:Example:

  • Algemene regel voor opslaan in cache:Global caching rule:

    • Cache gedrag: overschrijvenCaching behavior: Override
    • Verloop tijd van cache: 1 dagCache expiration duration: 1 day
  • Aangepaste regel voor opslaan in cache #1:Custom caching rule #1:

    • Overeenkomst voor waarde: padMatch condition: Path
    • Overeenkomende waarde: /Home/*Match value: /home/*
    • Cache gedrag: overschrijvenCaching behavior: Override
    • Verloop tijd van cache: 2 dagenCache expiration duration: 2 days
  • Aangepaste regel voor opslaan in cache #2:Custom caching rule #2:

    • Voor waarde match: ExtensionMatch condition: Extension
    • Overeenkomende waarde: . htmlMatch value: .html
    • Cache gedrag: instellen als ontbreektCaching behavior: Set if missing
    • Verloop tijd van cache: 3 dagenCache expiration duration: 3 days

Wanneer deze regels zijn ingesteld, wordt een aanvraag voor <eindpunt-hostnaam> . azureedge.net/Home/index.html activeert de aangepaste regel voor caching #2, die is ingesteld op: instellen als ontbrekend en 3 dagen.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. Als het bestand index. html Cache-Control-of Expires http-headers heeft, worden deze daarom nageleefd. Als deze headers niet zijn ingesteld, wordt het bestand drie dagen in de cache opgeslagen.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.

Notitie

Bestanden die in de cache worden opgeslagen voordat een regel wijziging de waarde voor de oorspronkelijke cache duur behouden.Files that are cached before a rule change maintain their origin cache duration setting. Als u de cache duur opnieuw wilt instellen, moet u het bestand leegmaken.To reset their cache durations, you must purge the file.

Wijzigingen in de configuratie van Azure CDN kan enige tijd duren voordat het netwerk kan worden door gegeven:Azure CDN configuration changes can take some time to propagate through the network:

  • Profielen van Azure CDN Standard van Akamai worden doorgaans binnen één minuut doorgegeven.For Azure CDN Standard from Akamai profiles, propagation usually completes within one minute.
  • Voor Azure CDN standaard van Verizon -profielen wordt de doorgifte doorgaans in tien minuten voltooid.For Azure CDN Standard from Verizon profiles, propagation usually completes in 10 minutes.

Zie ookSee also