Skip to content

cdn-caching-rules-tutorial.md

Latest commit

 

History

History
102 lines (63 loc) · 4.69 KB

cdn-caching-rules-tutorial.md

File metadata and controls

102 lines (63 loc) · 4.69 KB
title Tutorial - Set Azure Content Delivery Network caching rules
description In this tutorial, you set an Azure Content Delivery Network global caching rule and a custom caching rule.
services cdn
author halkazwini
ms.author halkazwini
manager danielgi
ms.service azure-cdn
ms.topic tutorial
ms.date 02/28/2026
ms.custom mvc
ROBOTS NOINDEX

Tutorial: Set Azure Content Delivery Network caching rules

[!INCLUDE Azure CDN from Microsoft (classic) retirement notice]

This tutorial describes how you can use Azure Content Delivery Network 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 Content Delivery Network provides two types of caching rules:

  • Global caching rules: You can set one global caching rule for each endpoint in your profile, which affects all requests to the endpoint. The global caching rule overrides any HTTP cache-directive headers, if set.

  • Custom caching rules: You can set one or more custom caching rules for each endpoint in your profile. Custom caching rules match specific paths and file extensions, are processed in order, and override the global caching rule, if set.

In this tutorial, you learn how to:

[!div class="checklist"]

  • Open the caching rules page.
  • Create a global caching rule.
  • Create a custom caching rule.

[!INCLUDE quickstarts-free-trial-note]

Prerequisites

Before you can complete the steps in this tutorial, you must first create a content delivery network profile and at least one content delivery network endpoint. For more information, see Quickstart: Create an Azure Content Delivery Network profile and endpoint.

Open the Azure content delivery network caching rules page

  1. In the Azure portal, select a content delivery network profile, then select an endpoint.

  2. In the left pane under Settings, select Caching rules.

    The Caching rules page appears.

Set global caching rules

Create a global caching rule as follows:

  1. Under Global caching rules, set Query string caching behavior to Ignore query strings.

  2. Set Caching behavior to Set if missing.

  3. For Cache expiration duration, enter 10 in the Days field.

    The global caching rule affects all requests to the endpoint. This rule honors the origin cache-directive headers, if they exist (Cache-Control or Expires); otherwise, if they are not specified, it sets the cache to 10 days.

    Global caching rules

Set custom caching rules

Create a custom caching rule as follows:

  1. Under Custom caching rules, set Match condition to Path and Match value to /images/*.jpg.

  2. Set Caching behavior to Override and enter 30 in the Days field.

    This custom caching rule sets a cache duration of 30 days on any .jpg image files in the /images folder of your endpoint. It overrides any Cache-Control or Expires HTTP headers that are sent by the origin server.

    Custom caching rules

Clean up resources

In the preceding steps, you created caching rules. If you no longer want to use these caching rules, you can remove them by performing these steps:

  1. Select a content delivery network profile, then select the endpoint with the caching rules you want to remove.

  2. In the left pane under Settings, select Caching rules.

  3. Under Global caching rules, set Caching behavior to Not set.

  4. Under Custom caching rules, select the checkbox next to the rule you want to delete.

  5. Select Delete.

  6. From the top of the page, select Save.

Next steps

In this tutorial, you learned how to:

[!div class="checklist"]

  • Open the caching rules page.
  • Create a global caching rule.
  • Create a custom caching rule.

Advance to the next article to learn how to configure additional caching rule settings.

[!div class="nextstepaction"] Control Azure Content Delivery Network caching behavior with caching rules