Edge Security Acceleration:Rules

Simple configuration examples

Rule configuration structure

When a request reaches an ESA node, ESA filters and processes it based on your rule configuration.

Every ESA rule configuration includes two parts:

Rule configuration = Rule expression + Action

Configure a rule expression to filter requests and an action to run on matched requests. The expression syntax is consistent across all rule-related features in ESA, so you can reuse configurations across features. Rule expression structure.

Rule Precedence

• Rule configurations take precedence over global settings: For the same feature, rule settings override global settings. Apply general configurations globally and use rules to customize behavior for specific requests.

  

  For example, if you set Edge TTL to 12 hours in Global Configuration – Edge Cache TTL and set the TTL for /content resources to 30 days in Rules – Configure Edge Cache TTL, the edge node caches /content resources for 30 days. Resources not under /content use the 12-hour global TTL.

  

• Rules higher in the list have higher priority: For the same rule type, ESA executes rules from top to bottom. If a request matches multiple rules, drag the button to reorder rules by priority.

  Note

  Available features and rule quotas vary by plan. Rule and plan quotas.

  For example, suppose you have two cache rules:

  Rule 1: Resources under the /content path expire after 30 days.

  Rule 2: Files with the .jpg suffix are cached for 60 days.

  • When Rule 1 is above Rule 2:

    

    Edge node cache TTLs:

    Sample URL	Under /content path	.jpg suffix	Cache expiration time
    https://example.com/content/static/pic.jpg			30 days
    https://example.com/content/static/book.txt		×	30 days
    https://example.com/static/pic.jpg	×		60 days
    https://example.com/static/res/book.text	×	×	Do not cache

  • When Rule 2 is above Rule 1:

    Edge node cache TTLs:

    Sample URI	Under /content path	.jpg suffix	Cache expiration time
    https://example.com/content/static/pic.jpg			60 days
    https://example.com/content/static/book.txt		×	30 days
    https://example.com/static/pic.jpg	×		60 days
    https://example.com/static/res/book.text	×	×	Do not cache

Feature availability by plan