Caching-Regeln

Verwenden Sie die folgenden API-Vorgänge, um Caching-Regeln zu erstellen und zu verwalten, die auf die WAF-Konfigurationen angewendet werden können:

• ListCachingRules
• UpdateCachingRules
• PurgeCache

Die Kriterien der Caching-Regel bestimmen, ob der angeforderte Inhalt gecacht werden soll.

• URL_IS: Stimmt überein, wenn die Verkettung des angeforderten URL-Pfads und der Abfrage mit dem Inhalt des Feldes value identisch ist. Beispiel: Wenn die Regel so eingerichtet ist, dass der Inhalt von www.example.com/products gecacht wird, werden nur HTTP-Anforderungen für www.example.com/products gecacht.
• URL_STARTS_WITH: Stimmt überein, wenn die Verkettung des angeforderten URL-Pfads und der Abfrage mit dem Inhalt des Feldes value beginnt. Beispiel: Wenn die Regel so eingerichtet ist, dass der Inhalt von www.example.com/products gecacht wird, werden alle HTTP-Anforderungen von URLs, die mit www.example.com/products beginnen, gecacht, und für nachfolgende Anforderungen werden Inhalte aus dem Cache zurückgegeben. Dies gilt auch für Anforderungen von www.example.com/products/new-product und www.example.com/products/old-product.
• URL_PART_ENDS_WITH: Stimmt überein, wenn die Verkettung des angeforderten URL-Pfads und der Abfrage mit dem Inhalt des Feldes value endet. Beispiel: Wenn die Regel so eingerichtet ist, dass der Inhalt von URLs gecacht wird, die mit /product.jpg enden, werden HTTP-Anforderungen für die URLs www.example.com/products/new-product/product-banner.jpg und www.example.com/products/old-product/product-banner.jpg gecacht, und für nachfolgende Anforderungen werden Inhalte aus dem Cache zurückgegeben.
• URL_PART_CONTAINS: Stimmt überein, wenn die Verkettung des angeforderten URL-Pfads und der Abfrage den Inhalt des Feldes value enthält. Wenn die Regel so eingerichtet ist, dass der Inhalt von URLs mit /product-banner gecacht wird, werden HTTP-Anforderungen für die URLs www.example.com/products/new-product/product-banner/blue.jpg und www.example.com/products/new-product/product-banner/red.jpg gecacht, und für nachfolgende Anforderungen werden Inhalte aus dem Cache zurückgegeben.

Für Caching-Regeln kann eine der beiden folgenden verfügbaren Aktionen festgelegt werden, wenn eine Anforderung empfangen wird:

• CACHE: Anforderungen, die den Kriterien der Regel entsprechen, werden gecacht, und für nachfolgende Anforderungen werden Inhalte aus dem Cache zurückgegeben.
• BYPASS_CACHE: Anforderungen, die den Kriterien der Regel entsprechen, umgehen den Cache und werden zum Ursprung weitergeleitet.

Inhalte können für einen bestimmten Zeitraum auf den Oracle Cloud Infrastructure-Edge-Servern oder lokal vom Client gespeichert werden. Die Dauer wird in den Feldern cachingDuration und clientCachingDuration im erweiterten ISO-8601-Format festgelegt.

[
  {
    "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"
  }
]

Die Reihenfolge, in der die Caching-Regeln angegeben werden, ist wichtig. Die Regeln werden in der Reihenfolge verarbeitet, in der sie angegeben sind. Die erste übereinstimmende Regel wird beim Verarbeiten einer Anforderung verwendet. Am besten werden Regeln zum Umgehen des Cache vor den Caching-Regeln hinzugefügt.

Caches können mit dem Vorgang PurgeCache gelöscht werden. Sie können selektiv gelöscht werden, indem der URL-Pfad einer Ressource angegeben wird. Alternativ können alle Caches für die Web Application Firewall gelöscht werden, indem keine Ressourcen angegeben werden, die an die API übergeben werden sollen.

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