Règles de mise en cache

Pour créer et gérer les règles de mise en cache pouvant être appliquées à vos configurations WAF, utilisez les opérations d'API suivantes :

• ListCachingRules
• UpdateCachingRules
• PurgeCache

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

• URL_IS - Correspondance si la concaténation du chemin d'URL et de l'interrogation demandés est identique au contenu du champ value. Par exemple, si cette règle est définie pour mettre en cache le contenu de www.example.com/products, seules les demandes HTTP pour www.example.com/products seront mises en cache.
• URL_STARTS_WITH - Correspondance si la concaténation du chemin d'URL et de l'interrogation demandés commence par le contenu du champ value. Par exemple, si cette règle est définie pour mettre en cache le contenu de www.example.com/products, toutes les demandes HTTP qui utilisent des URL commençant par www.example.com/products seront mises en cache et les demandes suivantes recevront le contenu du cache, y compris des demandes pour www.example.com/products/new-product et www.example.com/products/old-product.
• URL_PART_ENDS_WITH - Correspondance si la concaténation du chemin d'URL et de l'interrogation demandés se termine par le contenu du champ value. Par exemple, si la règle est définie pour mettre en cache le contenu des 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 seront mises en cache et les demandes suivantes recevront le contenu du cache.
• URL_PART_CONTAINS - Correspondance si la concaténation du chemin d'URL et de l'interrogation demandés contient le contenu du champ value. Si la règle est définie pour mettre en cache le contenu des 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 seront mises en cache et les demandes suivantes recevront le contenu du cache.

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

• CACHE - Les demandes correspondant aux critères de la règle seront mises en mémoire cache et les demandes suivantes recevront le contenu du cache.
• BYPASS_CACHE - Les demandes correspondant aux critères de la règle ignoreront la mémoire cache et seront dirigées vers l'origine.

Le contenu peut être mis en mémoire cache pendant une période spécifiée sur les serveurs en périphérie d'Oracle Cloud Infrastructure ou être localement par le client. La durée est définie dans les champs cachingDuration et clientCachingDuration, dans le 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 de spécification des règles de mise en cache est important. Llors du traitement d'une demande, les règles sont traitées dans l'ordre dans lequel elles sont spécifiées et la première règle pour laquelle il y a correspondance est utilisée. Il est préférable d'ajouter les règles qui ignorent la mise en cache au début, et les règles de mise en cache à leur suite.

Les caches peuvent être épurés à l'aide de l'opération PurgeCache. Pour épurer les caches de manière sélective, spécifiez le chemin d'URL d'une ressource. Pour épurer tous les caches pour le service WAF, ne spécifiez aucune ressource à transmettre à l'API.

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