Skip to content

Latest commit

 

History

History
58 lines (45 loc) · 2.94 KB

cdn-query-string-premium.md

File metadata and controls

58 lines (45 loc) · 2.94 KB
title description services documentationcenter author manager editor ms.assetid ms.service ms.workload ms.tgt_pltfrm ms.devlang ms.topic ms.date ms.author
Control Azure CDN caching behavior with query strings - Premium | Microsoft Docs
Azure CDN query string caching controls how files are to be cached when they contain query strings.
cdn
zhangmanling
erikre
99db4a85-4f5f-431f-ac3a-69e05518c997
cdn
tbd
na
na
article
01/23/2017
mazha

Control Azure CDN caching behavior with query strings - Premium

[!div class="op_single_selector"]

Overview

Query string caching controls how files are to be cached when they contain query strings.

Important

The Standard and Premium CDN products provide the same query string caching functionality, but the user interface differs. This document describes the interface for Azure CDN Premium from Verizon. For query string caching with Azure CDN Standard from Akamai and Azure CDN Standard from Verizon, see Controlling caching behavior of CDN requests with query strings.

Three modes are available:

  • standard-cache: This is the default mode. The CDN edge node will pass the query string from the requestor to the origin on the first request and cache the asset. All subsequent requests for that asset that are served from the edge node will ignore the query string until the cached asset expires.
  • no-cache: In this mode, requests with query strings are not cached at the CDN edge node. The edge node retrieves the asset directly from the origin and passes it to the requestor with each request.
  • unique-cache: This mode treats each request with a query string as a unique asset with its own cache. For example, the response from the origin for a request for foo.ashx?q=bar would be cached at the edge node and returned for subsequent caches with that same query string. A request for foo.ashx?q=somethingelse would be cached as a separate asset with its own time to live.

Changing query string caching settings for premium CDN profiles

  1. From the CDN profile blade, click the Manage button.

    CDN profile blade manage button

    The CDN management portal opens.

  2. Hover over the HTTP Large tab, then hover over the Cache Settings flyout. Click on Query-String Caching.

    Query string caching options are displayed.

    CDN query string caching options

  3. After making your selection, click the Update button.

Important

The settings changes may not be immediately visible, as it takes time for the registration to propagate through the CDN. For Azure CDN from Verizon profiles, propagation will usually complete within 90 minutes, but in some cases can take longer.