Edge Security Acceleration:CreateCacheRule

Site ID. Call ListSites to obtain this ID.

Site configuration version. For sites with version management enabled, specifies which version this configuration applies to.

Rule name. Not required for global configurations.

Whether to enable the rule. Not required for global configurations. Valid values:

• on: Enables the rule.

• off: Disables the rule.

Rule content, a conditional expression that matches user requests. Not required for global configurations.

• To match all requests, set the value to true.

• To match specific requests, set the value to a custom expression, such as (http.host eq "video.example.com").

Bypass cache mode. Valid values:

• cache_all: Caches all requests.

• bypass_all: Bypasses the cache for all requests.

Browser cache mode. Valid values:

• no_cache: Disables browser caching.

• follow_origin: Follows the origin server cache policy.

• override_origin: Overrides the origin server cache policy.

Browser cache TTL in seconds.

Edge cache mode. Valid values:

• follow_origin: Follows origin cache policy if present; otherwise uses default cache policy.

• no_cache: Disables caching on the edge node.

• override_origin: Overrides the origin server cache policy.

• follow_origin_bypass: Follows origin cache policy if present; otherwise does not cache.

• follow_origin_override: Follows origin cache policy if present; otherwise uses custom edge cache TTL.

Edge cache TTL in seconds.

Status code cache TTL in seconds.

• Set cache TTL for a specific status code. Example: 404=10 caches 404 responses for 10 seconds.

• Set cache TTL for a status code series (4xx, 5xx). Example: 4xx=10 caches all 4xx responses for 10 seconds.

• Specify multiple status code TTLs separated by commas (,).

Whether to sort query strings. Disabled by default. Valid values:

• on: Enables sorting.

• off: Disables sorting.

Query string processing mode for cache key generation. Valid values:

• ignore_all: Ignores all query strings.

• exclude_query_string: Excludes specified query strings.

• reserve_all: Includes all query strings (the default).

• include_query_string: Includes only specified query strings.

Query strings to include or exclude from the cache key. Separate multiple values with spaces.

Headers to include in the cache key. Both names (case-insensitive) and values are included. Separate multiple names with spaces. Allowed characters:

• Symbols: ! # $ % & ' * + - . ^ _ | ~

• Digits: 0-9

• Letters: a-z (lowercase)

Cookies to include in the cache key. Both names (case-insensitive) and values are included. Separate multiple names with spaces. Allowed characters:

• Symbols: ! # $ % & ' * + - . ^ _ | ~

• Digits: 0-9

• Letters: a-z (lowercase)

Whether requests bypass cache reservation nodes during origin fetch. Valid values:

• bypass_cache_reserve: The request bypasses cache reservation.

• eligible_for_cache_reserve: The request is eligible for cache reservation.

Headers checked for presence in the cache key. If a listed header exists, its name (case-insensitive) is added to the key. Separate names with spaces. Allowed characters:

• Symbols: ! # $ % & ' * + - . ^ _ | ~

• Digits: 0-9

• Letters: a-z (lowercase)

Cookies checked for presence in the cache key. If a listed cookie exists, its name (case-insensitive) is added to the key. Separate names with spaces. Allowed characters:

• Symbols: ! # $ % & ' * + - . ^ _ | ~

• Digits: 0-9

• Letters: a-z (lowercase)

Whether to include client device type in the cache key. Valid values:

• on: Includes the client device type.

• off: Does not include the client device type.

Whether to include client geographic location in the cache key. Valid values:

• on: Includes the geographic location.

• off: Does not include the geographic location.

Whether to include client language in the cache key. Valid values:

• on: Includes the language.

• off: Does not include the language.

Whether to serve stale content. When enabled, edge nodes serve expired cached content if the origin is unavailable. Valid values:

• on: Enables serving stale content.

• off: Disables serving stale content.

• Specifies additional ports on which caching is enabled.

• Valid values: 8880, 2052, 2082, 2086, 2095, 2053, 2083, 2087, and 2096.

• Specify multiple ports separated by commas (,).

Whether to enable cache deception defense. When enabled, only validated content is cached. Valid values:

• on: Enables the defense.

• off: Disables the defense.

Rule execution order. Lower values indicate higher priority.

Whether to enable POST request caching.

Maximum request body size for POST caching, in KB. Valid values: 1 to 8. Default: 8 KB.

How to process the request body when generating a cache key for POST requests. Valid values:

• md5: Calculates the MD5 hash of the request body and adds the hash value to the cache key.

• ignore: Ignores the request body when the cache key is generated.