Ga naar inhoud

De CDN leegmaken vanuit je site

Met de knop Cache legen op de CDN-pagina van een site maak je de hele CDN-cache met de hand leeg (zie CDN en Shield). Wil je dat automatisch laten gebeuren — aan het eind van een deployscript, of na een grote import van content — dan kun je de purge vanuit de site zelf aanvragen, met één HTTP-verzoek en zonder API-sleutel.

Voordat je begint

  • Een site waarvan de CDN actief is.
  • Een shell op de site: een SSH-verbinding of Cloud Shell (zie Toegang tot je bestanden), of code die in de site zelf draait.

Wat je site al heeft

Elke site krijgt twee omgevingsvariabelen die het verzoek autoriseren. Je hoeft zelf geen inloggegevens aan te maken of te kopiëren.

Variabele Wat erin staat
METADATA_SERVICE Het adres waar je het purge-verzoek naartoe stuurt.
METADATA_AUTH Een token dat je site identificeert, zodat het verzoek alleen deze site leegmaakt.

Beide zijn ingesteld in een SSH- of Cloud Shell-sessie, dus de voorbeelden hieronder werken daar zoals ze er staan. PHP-code die in de site draait, zoals een plug-in, kan ze uitlezen met getenv().

Cronjobs krijgen deze variabelen niet

Een job in het crontab-bestand van de site draait met een vrijwel lege omgeving, dus $METADATA_SERVICE en $METADATA_AUTH zijn daar leeg en het verzoek mislukt.

De hele site leegmaken

curl -sS -X POST "$METADATA_SERVICE/v1/actions" \
  -H "Authorization: Bearer $METADATA_AUTH" \
  -H "Content-Type: application/json" \
  -d '{"action_type":"cdn_purge","params":{"mode":"all"}}'

Specifieke paden leegmaken

Stuur "mode": "paths" mee met een lijst van maximaal 100 paden:

curl -sS -X POST "$METADATA_SERVICE/v1/actions" \
  -H "Authorization: Bearer $METADATA_AUTH" \
  -H "Content-Type: application/json" \
  -d '{
    "action_type": "cdn_purge",
    "params": {
      "mode": "paths",
      "paths": ["/blog/hello-world", "/wp-content/uploads/*", "/shop/"]
    }
  }'

Elk pad wordt achter de CDN-hostnaam van de site geplakt:

  • Een pad dat eindigt op / of een * bevat, maakt alles daaronder leeg — in het voorbeeld heel /wp-content/uploads/ en heel /shop/.
  • Elk ander pad maakt precies die ene URL leeg.
  • Ontbreekt de / aan het begin, dan wordt die voor je toegevoegd.

Staat Aanvraag-hostnaam aan onder Vary Cache op de CDN-pagina van de site, of heeft de site geen CDN-hostnaam, dan maakt een pad-verzoek de hele cache leeg.

Wat je terugkrijgt

Een geslaagd verzoek geeft 202 Accepted terug:

{"id":"3f0c9a1e-5b7d-4c2a-9e61-0d8f2b4a7c13","status":"pending"}
Status Betekenis
202 Het verzoek is geaccepteerd.
400 De body is geen geldige JSON, of action_type ontbreekt.
401 De Authorization-header ontbreekt, of het token wordt niet herkend.
429 Te veel verzoeken. Elke site kan er 20 kort achter elkaar sturen, daarna 2 per seconde.

Fouten komen terug als {"error": "…"}.

Controleren of het is uitgevoerd

Een 202 betekent dat het verzoek is geaccepteerd, niet dat de purge al is uitgevoerd. Die gebeurt kort daarna, en een verzoek met ongeldige waarden, of voor een site zonder actieve CDN, wordt overgeslagen zonder foutmelding. Open om dit te controleren de pagina Activiteit van de site: een purge die is uitgevoerd verschijnt als CDN-cache legen, met Systeem in de kolom Uitgevoerd door, en de status laat zien of die is afgerond (OK) of mislukt. Zie Site-activiteit.

Volgende stappen