Purgue conteúdo em cache
Remova um objeto em cache antes do fim do seu TTL, por URL, por cache key ou por wildcard, pelo Azion Console, pela Azion API ou pela Azion CLI.
Você remove um objeto em cache antes do fim do seu TTL pelo Azion Console, pela Azion API v4 ou pela Azion CLI, nomeando-o por URL, por cache key ou por uma expressão com wildcard, na camada do Cache ou na do Tiered Cache.
Depois de um purge, a requisição seguinte pelo objeto vai à origem e carrega x-cache: MISS. Para o que cada tipo de purge alcança, consulte Real-Time Purge.
Pré-requisitos
- A URL do objeto a purgar, ou a sua cache key. Para ler a key, consulte Verifique o status de cache de uma resposta.
- Um domínio que pertença à sua conta. Um purge de qualquer outro domínio é rejeitado.
- Acesso ao Azion Console, para o procedimento pelo Console. Consulte Como acessar o Azion Console.
- Um personal token, para o procedimento pela API.
- A Azion CLI instalada e autorizada, para o procedimento pela CLI.
Escolha o tipo de purge
| Para purgar | Use | Argumento |
|---|---|---|
| Um ou mais objetos exatos | Purge por URL | Até 50 URLs por requisição |
| Variações específicas de um objeto | Purge por cache key | Até 50 cache keys por requisição; o único tipo que alcança o Tiered Cache |
| Cada objeto que casa com um padrão | Purge por wildcard | Uma expressão com * por requisição |
Para remover um objeto mantido nas duas camadas, purgue primeiro o Tiered Cache e depois o Cache, para que a primeira camada não seja reabastecida por uma cópia desatualizada da segunda.
Purgue pelo Azion Console
Para enviar um purge pelo Console:
Acesse Azion Console > Products Menu > Real-Time Purge.
Selecione o tipo de purge que corresponde ao seu argumento e a camada a limpar: Cache, ou Tiered Cache para um purge por cache key.
Insira um objeto por item em um purge por URL ou por cache key, ou a expressão única em um purge por wildcard.
Uma mensagem confirma a criação. A Azion coloca o purge em fila, e ele aparece no histórico de purges quando termina.
Purgue pela API
Cada tipo de purge é um path próprio no endpoint de purge. Para enviar um:
A API responde com HTTP 201, state igual a executed e os itens que purgou:
O path cachekey é o que aceita tiered_cache como camada:
Cada requisição responde da mesma forma, com os seus próprios itens e a sua camada em data. Sem layer, a API purga o cache.
Purgue pela Azion CLI
Um comando envia cada tipo de purge. Para enviá-los:
O comando imprime uma linha:
A flag --layer aceita cache ou tiered_cache, e o padrão é cache:
Cada comando imprime a mesma linha de confirmação. Um purge rejeitado imprime a mensagem da API no lugar, então execute o comando sem --format json para lê-la.
Verifique o purge
Para confirmar que a cópia saiu:
A resposta carrega MISS, porque a Azion buscou o objeto na origem novamente:
Uma resposta que chega à origem depois de um purge confirma que a cópia saiu do cache.
Purgue um objeto que varia
Um purge por URL converte cada URL em uma cache key e ignora a variação de conteúdo, então uma cópia que varia por cookie, device group ou formato de imagem sobrevive a ele. Purgue essas variações listando cada key em um purge por cache key, ou com um wildcard terminado em @@* para as variações por cookie, dispositivo e método, ou ?* para as variações por query string.
A variação por query string é a exceção que um purge por URL alcança, desde que os argumentos estejam na ordem que a key contém, ou em ordem alfabética quando o Sort está ativo no cache setting. Para as keys que cada variação gera, consulte Cache keys e, para o que cada tipo de purge alcança, Real-Time Purge.