You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/cdn/cdn-standard-rules-engine-actions.md
+12-12Lines changed: 12 additions & 12 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -13,7 +13,7 @@ ms.author: magattus
13
13
14
14
# Actions in the Standard rules engine for Azure CDN
15
15
16
-
In the [Standard rules engine](cdn-standard-rules-engine.md) for Azure Content Delivery Network (Azure CDN), a rule consists of a set of match conditions and an action. This article provides detailed descriptions of the actions you can use in the Standard rules engine for Azure CDN.
16
+
In the [Standard rules engine](cdn-standard-rules-engine.md) for Azure Content Delivery Network (Azure CDN), a rule consists of one or more match conditions and an action. This article provides detailed descriptions of the actions you can use in the Standard rules engine for Azure CDN.
17
17
18
18
The second part of a rule is an action. An action defines the behavior that's applied to the request type that a match condition or set of match conditions identifies.
19
19
@@ -29,7 +29,7 @@ Use this action to overwrite the time to live (TTL) value of the endpoint for re
29
29
30
30
Cache behavior | Description
31
31
---------------|----------------
32
-
Bypass Cache | When this option is selected and the rule matches, the content is not cached.
32
+
Bypass cache | When this option is selected and the rule matches, the content is not cached.
33
33
Override | When this option is selected and the rule matches, the TTL value returned from your origin is overwritten with the value specified in the action.
34
34
Set if missing | When this option is selected and the rule matches, if no TTL value was returned from your origin, the rule sets the TTL to the value specified in the action.
35
35
@@ -62,7 +62,7 @@ Action | HTTP header name | Value
62
62
-------|------------------|------
63
63
Append | When this option is selected and the rule matches, the header specified in **Header name** is added to the request with the specified value. If the header is already present, the value is appended to the existing value. | String
64
64
Overwrite | When this option is selected and the rule matches, the header specified in **Header name** is added to the request with the specified value. If the header is already present, the specified value overwrites the existing value. | String
65
-
Delete | When this option is selected and the rule matches, and the header specified in the rule is present, the header is deleted from the request. | String
65
+
Delete | When this option is selected, the rule matches, and the header specified in the rule is present, the header is deleted from the request. | String
66
66
67
67
### Modify response header
68
68
@@ -72,9 +72,9 @@ Use this action to modify headers that are present in responses returned to your
72
72
73
73
Action | HTTP Header name | Value
74
74
-------|------------------|------
75
-
Append | When this option is selected and the rule matches, the header specified in **Header name** is added to the response using the specified **Value**. If the header is already present, **Value** is appended to the existing value. | String
76
-
Overwrite | When this option is selected and the rule matches, the header specified in **Header name** is added to the response using the specified **Value**. If the header is already present, **Value** overwrites the existing value. | String
77
-
Delete | When this option is selected and the rule matches, and the header specified in the rule is present, the header is deleted from the response. | String
75
+
Append | When this option is selected and the rule matches, the header specified in **Header name** is added to the response by using the specified **Value**. If the header is already present, **Value** is appended to the existing value. | String
76
+
Overwrite | When this option is selected and the rule matches, the header specified in **Header name** is added to the response by using the specified **Value**. If the header is already present, **Value** overwrites the existing value. | String
77
+
Delete | When this option is selected, the rule matches, and the header specified in the rule is present, the header is deleted from the response. | String
78
78
79
79
### URL redirect
80
80
@@ -84,11 +84,11 @@ Use this action to redirect clients to a new URL.
84
84
85
85
Field | Description
86
86
------|------------
87
-
Type | Select the response type to return to the requestor. Options are: Found (302), Moved (301), Temporary redirect (307), and Permanent redirect (308).
88
-
Protocol | Match Request, HTTP, or HTTPS.
89
-
Hostname | Select the hostname you want the request to be redirected to. Leave blank to preserve the incoming host.
87
+
Type | Select the response type to return to the requestor: Found (302), Moved (301), Temporary redirect (307), and Permanent redirect (308).
88
+
Protocol | Match Request, HTTP, HTTPS.
89
+
Hostname | Select the host name you want the request to be redirected to. Leave blank to preserve the incoming host.
90
90
Path | Define the path to use in the redirect. Leave blank to preserve the incoming path.
91
-
Query String | Define the query string used in the redirect. Leave blank to preserve the incoming query string.
91
+
Query string | Define the query string used in the redirect. Leave blank to preserve the incoming query string.
92
92
Fragment | Define the fragment to use in the redirect. Leave blank to preserve the incoming fragment.
93
93
94
94
We highly recommend that you use an absolute URL. Using a relative URL might redirect Azure CDN URLs to an invalid path.
@@ -101,9 +101,9 @@ Use this action to rewrite the path of a request that's en route to your origin.
101
101
102
102
Field | Description
103
103
------|------------
104
-
Source Pattern | Define the source pattern in the URL path to replace. Currently, source pattern uses a prefix-based match. To match all URL paths, use “/” as the source pattern value.
104
+
Source pattern | Define the source pattern in the URL path to replace. Currently, source pattern uses a prefix-based match. To match all URL paths, use a forward slash (**/**) as the source pattern value.
105
105
Destination | Define the destination path to use in the rewrite. The destination path overwrites the source pattern.
106
-
Preserve unmatched path | If **Yes**, the remaining path after the source pattern is appended to the new destination path.
106
+
Preserve unmatched path | If set to **Yes**, the remaining path after the source pattern is appended to the new destination path.
Copy file name to clipboardExpand all lines: articles/cdn/cdn-standard-rules-engine-match-conditions.md
+14-14Lines changed: 14 additions & 14 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -13,13 +13,13 @@ ms.author: magattus
13
13
14
14
# Match conditions in the Standard rules engine for Azure CDN
15
15
16
-
In the [Standard rules engine](cdn-standard-rules-engine.md) for Azure Content Delivery Network (Azure CDN), a rule consists of a set of match conditions and an action. This article provides detailed descriptions of the match conditions you can use in the Standard rules engine for Azure CDN.
16
+
In the [Standard rules engine](cdn-standard-rules-engine.md) for Azure Content Delivery Network (Azure CDN), a rule consists of one or more match conditions and an action. This article provides detailed descriptions of the match conditions you can use in the Standard rules engine for Azure CDN.
17
17
18
18
The first part of a rule is a match condition or set of match conditions. In the Standard rules engine for Azure CDN, each rule can have up to four match conditions. A match condition identifies specific types of requests for which defined actions are performed. If you use multiple match conditions, the match conditions are grouped together by using AND logic.
19
19
20
20
For example, you can use a match condition to:
21
21
22
-
- Filter requests that are generated from a specific IP address, country, or region.
22
+
- Filter requests based on a specific IP address, country, or region.
23
23
- Filter requests by header information.
24
24
- Filter requests from mobile devices or desktop devices.
25
25
@@ -29,7 +29,7 @@ The following match conditions are available to use in the Standard rules engine
29
29
30
30
### Device type
31
31
32
-
Identifies requests made from a mobile device or desktop device based on the properties of the request.
32
+
Identifies requests made from a mobile device or desktop device.
33
33
34
34
#### Required fields
35
35
@@ -64,7 +64,7 @@ String | [Standard operator list](#standard-operator-list) | String, Int | No tr
64
64
- Cookie name comparisons are case-insensitive.
65
65
- To specify multiple cookie values, use a single space between each cookie value.
66
66
- Cookie values can take advantage of wildcard values.
67
-
- If a wildcard value hasn't been specified, only an exact match will satisfy this match condition. For example, "Value" will match "Value" but not "Value1".
67
+
- If a wildcard value hasn't been specified, only an exact match satisfies this match condition. For example, "Value" will match "Value" but not "Value1".
68
68
69
69
### Post argument
70
70
@@ -104,7 +104,7 @@ Not IP Match | IP address (space-separated)
104
104
#### Key information
105
105
106
106
- Use CIDR notation.
107
-
- To specify multiple IP addresses and IP address blocks, use a single space between the values. For example:
107
+
- To specify multiple IP addresses and IP address blocks, use a single space between the values:
108
108
-**IPv4 example**: *1.2.3.4 10.20.30.40* matches any requests that arrive from either address 1.2.3.4 or 10.20.30.40.
109
109
-**IPv6 example**: *1:2:3:4:5:6:7:8 10:20:30:40:50:60:70:8*0 matches any requests that arrive from either address 1:2:3:4:5:6:7:8 or 10:20:30:40:50:60:70:80.
110
110
- The syntax for an IP address block is the base IP address followed by a forward slash and the prefix size. For example:
@@ -133,11 +133,11 @@ String | [Standard operator list](#standard-operator-list) | String, Int | No tr
133
133
134
134
### Request method
135
135
136
-
Identifies requests based on the request method used in the request.
136
+
Identifies requests that use the specified request method.
137
137
138
138
#### Required fields
139
139
140
-
Operator | Supported value
140
+
Operator | Supported values
141
141
---------|----------------
142
142
Equals, Not equals | GET, POST, PUT, DELETE, HEAD, OPTIONS, TRACE
143
143
@@ -147,17 +147,17 @@ Equals, Not equals | GET, POST, PUT, DELETE, HEAD, OPTIONS, TRACE
147
147
148
148
### Request protocol
149
149
150
-
Identifies requests based on the protocol used to send the request.
150
+
Identifies requests that use the specified protocol used.
151
151
152
152
#### Required fields
153
153
154
-
Operator | Supported value
154
+
Operator | Supported values
155
155
---------|----------------
156
156
Equals, Not equals | HTTP, HTTPS
157
157
158
158
### Request URL
159
159
160
-
Identifies requests based on the URL used to send the request.
0 commit comments