Règles de mise en mémoire cache

Utilisez les opérations d'API suivantes pour créer et gérer des règles de mise en mémoire cache qui peuvent être appliquées à vos configurations WAF :

• ListCachingRules
• UpdateCachingRules
• PurgeCache

Les critères de la règle de mise en mémoire cache déterminent si le contenu demandé doit être mis en mémoire cache.

• URL_IS : établit une correspondance si la concaténation du chemin d'URL demandé et de la requête est identique au contenu du champ value. Par exemple, si cette règle est définie pour mettre en mémoire cache le contenu de www.example.com/products, seules les demandes HTTP pour www.example.com/products sont mises en mémoire cache.
• URL_STARTS_WITH : établit une correspondance si la concaténation du chemin d'URL demandé et de la requête commence par le contenu du champ value. Par exemple, si cette règle est définie pour mettre en mémoire cache le contenu provenant de www.example.com/products, toutes les demandes HTTP demandant des URL qui commencent par www.example.com/products sont mises en mémoire cache et les demandes ultérieures recevront le contenu du cache, y compris les demandes pour www.example.com/products/new-product et www.example.com/products/old-product
• URL_PART_ENDS_WITH : établit une correspondance si la concaténation du chemin d'URL demandé et de la requête se termine par le contenu du champ value. Par exemple, si la règle est définie pour mettre en mémoire cache le contenu provenant d'URL qui se terminent par /product.jpg, les demandes HTTP pour les URL www.example.com/products/new-product/product-banner.jpg et www.example.com/products/old-product/product-banner.jpg sont mises en mémoire cache et les demandes ultérieures recevront le contenu du cache.
• URL_PART_CONTAINS : établit une correspondance si la concaténation du chemin d'URL demandé et de la requête contient le contenu du champ value. Si la règle est définie pour mettre en mémoire cache le contenu provenant d'URL qui contiennent /product-banner, les demandes HTTP pour les URL www.example.com/products/new-product/product-banner/blue.jpg et www.example.com/products/new-product/product-banner/red.jpg sont mises en mémoire cache et les demandes ultérieures recevront le contenu du cache.

Une règle de mise en mémoire cache peut être définie pour effectuer une action parmi deux disponibles lors de la réception d'une demande :

• CACHE : les demandes correspondant aux critères de la règle sont mises en mémoire cache et les demandes ultérieures recevront le contenu du cache.
• BYPASS_CACHE : les demandes correspondant aux critères de la règle contournent le cache et sont dirigées vers l'origine.

Le contenu peut être mis en cache pendant une période spécifiée sur les serveurs en périphérie Oracle Cloud Infrastructure, ou localement par le client. La durée est définie dans les champs cachingDuration et clientCachingDuration, au format étendu 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'ordre dans lequel les règles de mise en mémoire cache sont indiquées est important. Les règles sont traitées dans l'ordre dans lequel elles sont fournies, et la première règle correspondante est utilisée lors du traitement d'une demande. Il est préférable d'ajouter les règles qui contournent le cache en premier, puis les règles de mise en mémoire cache à la suite.

Les caches peuvent être purgés à l'aide de l'opération PurgeCache. Les caches peuvent être purgés de manière sélective en indiquant le chemin d'URL d'une ressource, ou tous les caches peuvent être purgés pour WAF en n'indiquant aucune ressource à transmettre à l'API.

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