Skip to content

Commit d053e1d

Browse files
[Cache] Adds clarification for cache rules fields and purge (#19096)
* Adds clarification for cache rules fields and purge * Apply suggestions from code review Co-authored-by: Pedro Sousa <[email protected]> --------- Co-authored-by: Pedro Sousa <[email protected]>
1 parent c428459 commit d053e1d

File tree

1 file changed

+19
-17
lines changed

1 file changed

+19
-17
lines changed

src/content/docs/cache/how-to/cache-rules/settings.mdx

Lines changed: 19 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -15,26 +15,28 @@ These are the settings that you can configure when creating a cache rule.
1515

1616
## Fields
1717

18-
The fields available for Cache Rule matching expressions in the Expression Builder are:
19-
20-
* Cookie - `http.cookie`
21-
* Hostname - `http.host`
22-
* Referer - `http.referer`
23-
* SSL/HTTPS - `ssl`
24-
* URI Full - `http.request.full_uri`
25-
* URI - `http.request.uri`
26-
* URI Path - `http.request.uri.path`
27-
* URI Query String - `http.request.uri.query`
28-
* User Agent - `http.user_agent`
29-
* X-Forwarded-For - `http.x_forwarded_for`
30-
* Request Headers - `http.request.headers`
31-
* Cookie value of - `http.request.cookies`
32-
33-
For a list of all available fields refer to [Fields](/ruleset-engine/rules-language/fields/).
18+
The fields available for Cache Rule matching expressions in the **Expression Builder** are:
19+
20+
- URI Full - `http.request.full_uri`
21+
- URI - `http.request.uri`
22+
- URI Path - `http.request.uri.path`
23+
- URI Query String - `http.request.uri.query`
24+
- Cookie - `http.cookie`
25+
- Hostname - `http.host`
26+
- Referer - `http.referer`
27+
- SSL/HTTPS - `ssl`
28+
- User Agent - `http.user_agent`
29+
- X-Forwarded-For - `http.x_forwarded_for`
30+
- Request Headers - `http.request.headers`
31+
- Cookie value of - `http.request.cookies`
32+
- File extension - `http.request.uri.path.extension`
33+
34+
If you select the [**Edit expression**](/ruleset-engine/rules-language/expressions/edit-expressions/#expression-editor) option, you can enter any of the [available fields](/ruleset-engine/rules-language/fields/).
3435

3536
:::note
3637

37-
Not all fields are available as a trigger for Cache Rules due to incompatibility with [Purge](/cache/how-to/purge-cache/).
38+
The fields mentioned above support all types of purge. However, the [remaining available fields](/ruleset-engine/rules-language/fields/) support purge by tags, prefix (URL), hostname, and everything but are not compatible with [single file purge](/cache/how-to/purge-cache/purge-by-single-file/).
39+
3840
:::
3941

4042
## Operators

0 commit comments

Comments
 (0)