Regole di inserimento nella cache

Utilizzare le operazioni API riportate di seguito per creare e gestire le regole di inserimento nella cache che possono essere applicate alle configurazioni WAF.

• ListCachingRules
• UpdateCachingRules
• PurgeCache

I criteri della regola di inserimento nella cache determinano se il contenuto richiesto deve essere inserito nella cache.

• URL_IS: corrisponde se la concatenazione del percorso URL richiesto e della query è identica al contenuto del campo value. Ad esempio, se questa regola è impostata per inserire nella cache il contenuto di www.example.com/products, verranno inserite nella cache solo le richieste HTTP per www.example.com/products.
• URL_STARTS_WITH: corrisponde se la concatenazione del percorso URL richiesto e della query inizia con il contenuto del campo value. Ad esempio, se questa regola è impostata per memorizzare il contenuto nella cache da www.example.com/products, tutte le richieste HTTP che richiedono URL che iniziano con www.example.com/products verranno inserite nella cache e le richieste successive riceveranno contenuto dalla cache, incluse le richieste per www.example.com/products/new-product e www.example.com/products/old-product.
• URL_PART_ENDS_WITH: corrisponde se la concatenazione del percorso URL richiesto e della query termina con il contenuto del campo value. Ad esempio, se la regola è impostata per inserire nella cache il contenuto degli URL che terminano con /product.jpg, le richieste HTTP per gli URL www.example.com/products/new-product/product-banner.jpg e www.example.com/products/old-product/product-banner.jpg verranno inserite nella cache e le richieste successive riceveranno il contenuto dalla cache.
• URL_PART_CONTAINS: corrisponde se la concatenazione del percorso URL richiesto e della query contiene il contenuto del campo value. Se la regola è impostata per inserire nella cache il contenuto degli URL contenenti /product-banner, le richieste HTTP per gli URL www.example.com/products/new-product/product-banner/blue.jpg e www.example.com/products/new-product/product-banner/red.jpg verranno inserite nella cache e le richieste successive riceveranno il contenuto dalla cache.

Una regola di inserimento nella cache può essere impostata per eseguire una delle due azioni disponibili quando si riceve una richiesta:

• CACHE: le richieste corrispondenti ai criteri della regola verranno inserite nella CACHE e le richieste successive riceveranno contenuto dalla CACHE.
• BYPASS_CACHE: le richieste che soddisfano i criteri della regola verranno ignorate nella cache e indirizzate all'origine.

Il contenuto può essere inserito nella cache per un periodo di tempo specificato sugli edge server di Oracle Cloud Infrastructure o inserito localmente nella cache dal client. La durata viene impostata nei campi cachingDuration e clientCachingDuration nel formato esteso ISO 8601.

[
  {
    "action": "CACHE",
    "cachingDuration": "PT20M",
    "clientCachingDuration": "PT20M",
    "criteria": [
      {
        "condition": "URL_IS",
        "value": "/path/to-cache"
      }
    ],
    "isClientCachingEnabled": true,
    "name": "Caching Rule 1"
  },
  {
    "action": "BYPASS_CACHE",
    "criteria": [
      {
        "condition": "URL_PART_ENDS_WITH",
        "value": "urp-part-not-to-cache"
      }
    ],
    "isClientCachingEnabled": false,
    "name": "Do not cache"
  }
]

L'ordine in cui sono specificate le regole di inserimento nella cache è importante. Le regole vengono elaborate nell'ordine in cui sono specificate e la prima regola di corrispondenza verrà utilizzata durante l'elaborazione di una richiesta. È consigliabile aggiungere regole che ignorano la cache nella parte superiore dell'ordine e le regole di inserimento nella cache al di sotto di qualsiasi regola bypass.

È possibile rimuovere le cache utilizzando l'operazione PurgeCache. Le cache possono essere rimosse in modo selettivo specificando il percorso URL di una risorsa oppure è possibile rimuovere tutte le cache per WAF non specificando alcuna risorsa da passare all'API.

{
  "resources": [
    "/path/to-purge",
    "/multiple-paths"
  ]
}