Skip to content
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.

Commit bb07d65

Browse files
author
dksimpson
committedNov 10, 2017
task 656: Topic overhaul and new screenshots, add multiple query string note
1 parent c9ddd0f commit bb07d65

File tree

5 files changed

+33
-40
lines changed

5 files changed

+33
-40
lines changed
 

‎articles/cdn/cdn-query-string-premium.md

Lines changed: 14 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ ms.workload: tbd
1313
ms.tgt_pltfrm: na
1414
ms.devlang: na
1515
ms.topic: article
16-
ms.date: 01/23/2017
16+
ms.date: 11/09/2017
1717
ms.author: mazha
1818

1919
---
@@ -25,34 +25,32 @@ ms.author: mazha
2525
>
2626
2727
## Overview
28-
Query string caching controls how files are to be cached when they contain query strings.
28+
Query string caching controls how files are cached when a request contains query strings. For example, \http://www.domain.com/content.mov?data=true. If there is more than one query string in a request, the order of the query strings does not matter.
2929

3030
> [!IMPORTANT]
31-
> 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](cdn-query-string.md).
32-
>
33-
>
31+
> The standard and premium CDN products provide the same query string caching functionality, but the user interface differs. This article 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](cdn-query-string.md).
32+
>
3433
35-
Three modes are available:
34+
Three query string modes are available:
3635

37-
* **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.
38-
* **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.
39-
* **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.
36+
- **standard-cache**: Default mode. In this mode, the CDN edge node passes the query strings from the requestor to the origin on the first request and caches the asset. All subsequent requests for the asset that are served from the edge node ignore the query strings until the cached asset expires.
37+
- **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.
38+
- **unique-cache**: This mode treats each request with query strings as a unique asset with its own cache. For example, the response from the origin for a request for *foo.ashx?q=bar* is cached at the edge node and returned for subsequent caches with the same query strings. A request for *foo.ashx?q=somethingelse* is cached as a separate asset with its own time-to-live setting.
4039

4140
## Changing query string caching settings for premium CDN profiles
42-
1. From the CDN profile blade, click the **Manage** button.
41+
1. From the CDN profile blade, click **Manage**.
4342

44-
![CDN profile blade manage button](./media/cdn-query-string-premium/cdn-manage-btn.png)
43+
![CDN profile Manage button](./media/cdn-query-string-premium/cdn-manage-btn.png)
4544

4645
The CDN management portal opens.
47-
2. Hover over the **HTTP Large** tab, then hover over the **Cache Settings** flyout. Click on **Query-String Caching**.
46+
2. Hover over the **HTTP Large** tab, then hover over the **Cache Settings** flyout. Click **Query-String Caching**.
4847

4948
Query string caching options are displayed.
5049

5150
![CDN query string caching options](./media/cdn-query-string-premium/cdn-query-string.png)
52-
3. After making your selection, click the **Update** button.
51+
3. Select a query string mode, then click **Update**.
5352

5453
> [!IMPORTANT]
55-
> The settings changes may not be immediately visible, as it takes time for the registration to propagate through the CDN. For <b>Azure CDN from Verizon</b> profiles, propagation will usually complete within 90 minutes, but in some cases can take longer.
56-
>
57-
>
54+
> Because it takes time for the registration to propagate through the CDN, cache string settings changes might not be immediately visible. For **Azure CDN Premium from Verizon** profiles, propagation usually completes within 90 minutes, but in some cases can take longer.
55+
5856

‎articles/cdn/cdn-query-string.md

Lines changed: 19 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: Control Azure CDN caching behavior with query strings | Microsoft Docs
3-
description: Azure CDN query string caching controls how files are to be cached when they contain query strings.
3+
description: Azure CDN query string caching controls how files are cached when they contain query strings.
44
services: cdn
55
documentationcenter: ''
66
author: zhangmanling
@@ -13,49 +13,44 @@ ms.workload: tbd
1313
ms.tgt_pltfrm: na
1414
ms.devlang: na
1515
ms.topic: article
16-
ms.date: 01/23/2017
16+
ms.date: 11/09/2017
1717
ms.author: mazha
1818

1919
---
20-
# Control Azure CDN caching behavior with query strings
20+
# Control Azure Content Delivery Network caching behavior with query strings
2121
> [!div class="op_single_selector"]
2222
> * [Standard](cdn-query-string.md)
2323
> * [Azure CDN Premium from Verizon](cdn-query-string-premium.md)
2424
>
25-
>
2625
2726
## Overview
28-
Query string caching controls how files are to be cached when they contain query strings.
27+
Query string caching controls how files are cached when a request contains query strings. For example, \http://www.domain.com/content.mov?data=true. If there is more than one query string in a request, the order of the query strings does not matter.
2928

3029
> [!IMPORTANT]
31-
> 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 Standard from Akamai** and **Azure CDN Standard from Verizon**. For query string caching with **Azure CDN Premium from Verizon**, see [Controlling caching behavior of CDN requests with query strings - Premium](cdn-query-string-premium.md).
32-
>
33-
>
30+
> The standard and premium CDN products provide the same query string caching functionality, but the user interface differs. This article describes the interface for **Azure CDN Standard from Akamai** and **Azure CDN Standard from Verizon**. For query string caching with **Azure CDN Premium from Verizon**, see [Controlling caching behavior of CDN requests with query strings - Premium](cdn-query-string-premium.md).
3431
35-
Three modes are available:
32+
Three query string modes are available:
3633

37-
* **Ignore query strings**: 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.
38-
* **Bypass caching for URL with query strings**: 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.
39-
* **Cache every unique URL**: 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.
34+
- **Ignore query strings**: Default mode. In this mode, the CDN edge node passes the query strings from the requestor to the origin on the first request and caches the asset. All subsequent requests for the asset that are served from the edge node ignore the query strings until the cached asset expires.
35+
- **Bypass caching for query strings**: 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.
36+
- **Cache every unique URL**: In this mode, each request with a query string is treated as a unique asset with its own cache. For example, the response from the origin for a request for *foo.ashx?q=bar* is cached at the edge node and returned for subsequent caches with the same query string. A request for *foo.ashx?q=somethingelse* is cached as a separate asset with its own time-to-live setting.
4037

4138
## Changing query string caching settings for standard CDN profiles
42-
1. From the CDN profile blade, click the CDN endpoint you wish to manage.
39+
1. Select a CDN profile, then select the CDN endpoint you want to manage.
4340

44-
![CDN profile blade endpoints](./media/cdn-query-string/cdn-endpoints.png)
41+
![CDN profile endpoints](./media/cdn-query-string/cdn-endpoints.png)
4542

46-
The CDN endpoint blade opens.
47-
2. Click the **Configure** button.
43+
The CDN endpoint blade opens.
44+
2. Under Settings, click **Cache**.
4845

49-
![CDN profile blade manage button](./media/cdn-query-string/cdn-config-btn.png)
46+
![CDN profile Cache button](./media/cdn-query-string/cdn-cache-btn.png)
5047

51-
The CDN Configuration blade opens.
52-
3. Select a setting from the **Query string caching behavior** dropdown.
48+
The CDN cache blade opens.
49+
3. In the **Query string caching behavior** list, select a query string mode, then click **Save**.
5350

54-
![CDN query string caching options](./media/cdn-query-string/cdn-query-string.png)
55-
4. After making your selection, click the **Save** button.
51+
<!--- Replace screen shot after general caching goes live ![CDN query string caching options](./media/cdn-query-string/cdn-query-string.png) --->
5652

5753
> [!IMPORTANT]
58-
> The settings changes may not be immediately visible, as it takes time for the registration to propagate through the CDN. For <b>Azure CDN from Akamai</b> profiles, propagation will usually complete within one minute. For <b>Azure CDN from Verizon</b> profiles, propagation will usually complete within 90 minutes, but in some cases can take longer.
59-
>
60-
>
54+
> Because it takes time for the registration to propagate through the CDN, cache string settings changes might not be immediately visible. For **Azure CDN from Akamai** profiles, propagation usually completes within one minute. For **Azure CDN from Verizon** profiles, propagation usually completes within 90 minutes, but in some cases can take longer.
55+
6156

Loading
Loading
Loading

0 commit comments

Comments
 (0)
Please sign in to comment.