キャッシュ・ルール

WAF構成に適用可能なキャッシュ・ルールを作成および管理するには、次のAPI操作を使用します:

• ListCachingRules
• UpdateCachingRules
• PurgeCache

キャッシュ・ルールの基準によって、リクエストされたコンテンツをキャッシュするかどうかが決定されます。

• URL_IS - リクエストされたURLパスと問合せを連結したものがvalueフィールドのコンテンツと同じである場合は、一致します。たとえば、このルールがwww.example.com/productsのコンテンツをキャッシュするように設定されている場合、www.example.com/productsに対するHTTPリクエストのみがキャッシュされます。
• URL_STARTS_WITH - リクエストされたURLパスと問合せを連結したものがvalueフィールドのコンテンツで始まる場合は、一致します。たとえば、このルールがwww.example.com/productsのコンテンツをキャッシュするように設定されている場合、www.example.com/productsで始まるURLをリクエストするすべてのHTTPリクエストはキャッシュされ、後続のリクエスト(www.example.com/products/new-productや www.example.com/products/old-productに対するリクエストを含む)は、キャッシュからコンテンツを受け取ります。
• URL_PART_ENDS_WITH - リクエストされたURLパスと問合せを連結したものがvalueフィールドのコンテンツで終わる場合は、一致します。たとえば、ルールが/product.jpgで終わるURLからのコンテンツをキャッシュするように設定されている場合、URL www.example.com/products/new-product/product-banner.jpgおよびwww.example.com/products/old-product/product-banner.jpgに対するHTTPリクエストはキャッシュされ、後続のリクエストはキャッシュからコンテンツを受け取ります。
• URL_PART_CONTAINS - リクエストされたURLパスと問合せを連結したものにvalueフィールドのコンテンツが含まれる場合は、一致します。ルールが/product-bannerを含むURLからのコンテンツをキャッシュするように設定されている場合、URL www.example.com/products/new-product/product-banner/blue.jpgおよびwww.example.com/products/new-product/product-banner/red.jpgに対するHTTPリクエストはキャッシュされ、後続のリクエストはキャッシュからコンテンツを受け取ります。

キャッシュ・ルールは、リクエストの受信時に使用可能な2つのアクションのいずれかを実行するように設定できます:

• CACHE - ルールの基準と一致するリクエストはキャッシュされ、後続のリクエストはキャッシュからコンテンツを受け取ります。
• BYPASS_CACHE - ルールの基準と一致するリクエストは、キャッシュをバイパスしてオリジンに送信されます。

コンテンツは、指定された期間Oracle Cloud Infrastructureのエッジ・サーバーにキャッシュすることも、クライアントがローカルにキャッシュすることもできます。期間は、cachingDurationおよびclientCachingDurationフィールドに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"
  }
]

キャッシュ・ルールを指定する順序は重要です。ルールは指定した順序で処理され、リクエストの処理中には最初に一致するルールが使用されます。キャッシュをバイパスするルールを順序の最上位に追加し、キャッシュ・ルールをバイパス・ルールより下位に追加することをお薦めします。

キャッシュは、PurgeCache操作を使用してパージできます。リソースのURLパスを指定してキャッシュを選択的にパージすることも、APIに渡すリソースを指定しないでWAFのすべてのキャッシュをパージすることもできます。

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