Regras de Armazenamento em Cache

Use as seguintes operações de API para criar e gerenciar regras de armazenamento em cache que possam ser aplicadas às suas configurações de WAF:

• ListCachingRules
• UpdateCachingRules
• PurgeCache

Os critérios da regra de armazenamento em cache determinam se o conteúdo solicitado deve ser armazenado em cache.

• URL_IS - Verifica se a concatenação do caminho do URL solicitado e da consulta é idêntica ao conteúdo do campo value. Por exemplo, se esta regra for definida para armazenar em cache o conteúdo de www.example.com/products, somente solicitações HTTP para www.example.com/products serão armazenadas em cache.
• URL_STARTS_WITH - Verifica se a concatenação do caminho do URL solicitado e da consulta começa com o conteúdo do campo value. Por exemplo, se esta regra for definida para armazenar em cache o conteúdo de www.example.com/products, todas as solicitações HTTP que solicitarem URLs que comecem com www.example.com/products serão armazenadas em cache e as solicitações subsequentes receberão conteúdo do cache, incluindo solicitações para www.example.com/products/new-product e www.example.com/products/old-product.
• URL_PART_ENDS_WITH - Verifica se a concatenação do caminho do URL solicitado e da consulta termina com o conteúdo do campo value. Por exemplo, se a regra for definida para armazenar em cache o conteúdo dos URLs que terminem com /product.jpg, as solicitações HTTP dos URLs www.example.com/products/new-product/product-banner.jpg e www.example.com/products/old-product/product-banner.jpg serão armazenadas no cache e as solicitações subsequentes receberão conteúdo do cache.
• URL_PART_CONTAINS - Verifica se a concatenação do caminho do URL solicitado e da consulta contém o conteúdo do campo value. Se a regra for definida para armazenar em cache o conteúdo dos URLs que contenham /product-banner, as solicitações HTTP dos URLs www.example.com/products/new-product/product-banner/blue.jpg e www.example.com/products/new-product/product-banner/red.jpg serão armazenadas no cache e as solicitações subsequentes receberão conteúdo do cache.

Uma regra de armazenamento em cache pode ser definida para executar uma das duas ações disponíveis ao receber uma solicitação:

• CACHE - As solicitações correspondentes aos critérios da regra serão armazenadas em cache e as solicitações subsequentes receberão conteúdo do cache.
• BYPASS_CACHE - As solicitações correspondentes aos critérios da regra ignorarão o cache e serão direcionadas para a origem.

O conteúdo pode ser armazenado em cache durante um período especificado nos servidores de borda do Oracle Cloud Infrastructure ou armazenado em cache localmente pelo cliente. A duração é definida nos campos cachingDuration e clientCachingDuration, no formato estendido 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"
  }
]

A ordem em que as regras de armazenamento no cache são especificadas é importante. As regras são processadas na ordem em que são especificadas e a primeira regra de correspondência será usada durante o processamento de uma solicitação. É melhor adicionar regras que desviem o cache para a parte superior da ordem e as regras de armazenamento em cache para baixo de quaisquer regras de desvio.

Os caches podem ser expurgados usando a operação PurgeCache. Os caches podem ser seletivamente expurgados especificando o caminho do URL de um recurso ou todos os caches podem ser expurgados para o WAF, não especificando nenhum recurso a ser especificado para a API.

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