Real-Time Purge

Edite no GitHub

Se você precisa deletar um objeto das camadas de Edge Caching ou de L2 Caching antes que ele expire, você pode utilizar a API do Real-Time Purge. Se desejar, integre a API da Azion ao seu CMS para automatizar seus processos de atualização de conteúdo.

Veja, a seguir, como proceder para:

  1. Criar uma solicitação de URL Purge
  2. Criar uma solicitação de Cache Key Purge
  3. Criar uma solicitação de Wildcard Purge

1. Criar uma solicitação de URL Purge

Para deletar uma lista de objetos da camada Edge Caching da Azion por meio de suas URLs, você pode utilizar o endpoint:

POST /purge/url

Permissão necessária: Purge

Parâmetro Descrição Tipo de Parâmetro Tipo de Dado
Authorization (obrigatório) A autenticação por Token previamente criado por meio do endpoint de Criação de Token.

ex.:

Authorization: Token 583f8a9ca8d6d5ff2cb50f1d3c4d35cb8939f1bf
header string
Content-Type (obrigatório) O tipo de codificação utilizada no Body (application/json).

ex.:

Content-Type: application/json
header string
Body (obrigatório) Listagem de URLs que você deseja remover do cache dos Edge Servers da Azion.

urls (array): lista de até 50 URLs a serem expiradas do cache, por requisição.

method (choice): método de purge, utilize o valor “delete” para remoção.
body json

Exemplo de Requisição

POST /purge/url
Accept: application/json; version=3
Authorization: Token 583f8a9ca8d6d5ff2cb50f1d3c4d35cb8939f1bf

Content-Type: application/json
{
    "urls": [
       "http://www.domain.com/", 
       "http://www.domain.com/test.js", 
       "http://static.mistaken-domain.com/image1.jpg"
    ],
    "method": "delete"
 }

Exemplo de Resposta

 HTTP/1.1 207 MULTI-STATUS
[
   {
      "status": "HTTP/1.1 201 CREATED",
      "urls": [
         "http://www.domain.com/", 
         "http://www.domain.com/test.js"
      ],
      "details": "Purge request successfully created"
   },
   {
      "status": "HTTP/1.1 403 FORBIDDEN",
      "urls": ["http://static.mistaken-domain.com/image1.jpg"],
      "details": "Unauthorized domain for your account"
   }
]

2. Criar uma solicitação de Cache Key Purge

Para deletar uma lista de objetos das camadas de Edge Caching ou de L2 Caching da Azion por meio de suas Cache Keys, você pode utilizar o endpoint:

POST /purge/cachekey

Permissão necessária: Purge

Parâmetro Descrição Tipo de Parâmetro Tipo de Dado
Authorization (obrigatório) A autenticação por Token previamente criado por meio do endpoint de Criação de Token.

ex.:

Authorization: Token 583f8a9ca8d6d5ff2cb50f1d3c4d35cb8939f1bf
header string
Content-Type (obrigatório) O tipo de codificação utilizada no Body (application/json).

ex.:

Content-Type: application/json
header string
Body (obrigatório) Listagem de Cache Keys que você deseja remover do cache dos Edge Servers da Azion.

urls (array):lista de até 50 Cache Keys a serem expiradas do cache, por requisição.

method (choice): método de purge, utilize o valor “delete” para remoção.

Layer (choice):camada onde será feito o purge. Utilize o valor “edge_caching” (valor default caso não informado) para purge na camada Edge Caching e o valor “l2_caching” para purge no L2 Caching.
body json

Exemplo de Requisição

POST /purge/cachekey
Accept: application/json; version=3
Authorization: Token 583f8a9ca8d6d5ff2cb50f1d3c4d35cb8939f1bf

Content-Type: application/json
{
    "urls": [
       "http://www.domain.com/@@cookie_name=cookie_value", 
       "http://www.domain.com/test.js", 
       "http://static.domain.com/image1.jpg?ims=arguments@@variants"
    ],
    "method": "delete",
    "layer": "l2_caching"

 }

Exemplo de Resposta

 HTTP/1.1 201 CREATED
{
    "details": "Purge request successfully created"
}

3. Criar uma solicitação de Wildcard Purge

Para deletar uma lista de objetos da camada Edge Caching da Azion por meio de uma Wildcard URL ou Wildcard Cache Key, você pode utilizar o endpoint:

POST /purge/wildcard

Permissão necessária: Purge

Parâmetro Descrição Tipo de Parâmetro Tipo de Dado
Authorization (obrigatório) A autenticação por Token previamente criado por meio do endpoint de Criação de Token.

ex.:

Authorization: Token 583f8a9ca8d6d5ff2cb50f1d3c4d35cb8939f1bf
header string
Content-Type (obrigatório) O tipo de codificação utilizada no Body (application/json).

ex.:

Content-Type: application/json
header string
Body (obrigatório) A expressão Wildcard que representa a listagem de objetos que você deseja remover do cache dos Edge Servers da Azion.

urls (array):a Wildcard URL ou Wildcard Cache Key que representa a listagem de objetos que você deseja expirar. Você só pode utilizar uma expressão Wildcard por requisição.

method (choice): método de purge, utilize o valor “delete” para remoção.
body json

Exemplo de Requisição

POST /purge/wildcard
Accept: application/json; version=3
Authorization: Token 583f8a9ca8d6d5ff2cb50f1d3c4d35cb8939f1bf

Content-Type: application/json
{
    "urls": ["http://www.domain.com/path/image.jpg*"],
    "method": "delete"
 }

Exemplo de Resposta

 HTTP/1.1 201 CREATED
{
    "detail": "Purge request successfully created"
}

Não encontrou o que procurava? Abra um ticket.