Den Cache einer Domain oder Subdomain leeren¶

Senden einer PUT-Anfrage an den Endpunkt /domain/{domainId}/cache-clear.

Beschreibung¶

Mit der Clear-Cache-Anfrage löschen Sie alle zwischengespeicherten Dateien oder bestimmte zwischengespeicherte Dateien auf allen Myra-Nodes für alle oder ausgewählte Domains und Subdomains.

Voraussetzungen¶

Werte der Anfrage: Domain-ID {domainId}

Objekte: CacheClearVO

Anfrage¶

Um den Cache einer Domain oder Subdomain zu leeren, fügen Sie die Domain-ID {domainId} dem Pfad der Anfrage hinzu.

Für eine detaillierte Spezifikation, welche Informationen zum Leeren des Caches erforderlich sind, muss im Body das Objekt CacheClearVO mit den folgenden Attributen definiert werden:

Attribut	Beschreibung	Werte
`fqdn`	Der Name der Domain oder Subdomain.HinweisWenn das Attribut nicht gesetzt ist, wird der gesamte Cache der Domain geleert.	`string`
`recursive`	Die Einstellung, das Muster auch gegen Unterverzeichnisse abzugleichen.	`true` `false`
`resource`	Die aus dem Cache zu leerenden Ressourcen.HinweisWenn das Attribut nicht gesetzt ist, wird der gesamte Cache der definierten Domain oder Subdomain geleert.	`string`
`bulk`	Eine Liste der zu leerenden Ressourcen.HinweisWenn gesetzt, wird das Attribut resources ignoriert.

Zum Leeren des Caches stehen die folgenden Optionen zur Verfügung:

Einen Dateityp aus dem Cache löschen:
- fqdn: Der Name der Domain oder Subdomain.
- recursive: true
- resource: Das zu suchende Muster (zum Beispiel: /*js).
- Löschen Sie das Attribut bulk.
Alle Dateien einer Domain oder Subdomain aus dem Cache löschen:
- fqdn: Der Name der Domain oder Subdomain.
- recursive: true
- Löschen Sie das Attribut resource.
- Löschen Sie das Attribut bulk.
Alle Dateien aller Domains und Subdomains aus dem Cache löschen:
- Löschen Sie das Attribut Fqdn.
- recursive: true
- Löschen Sie das Attribut resource.
- Löschen Sie das Attribut bulk.
Zwischengespeicherte Dateien aller Domains und Subdomains aus dem Cache löschen:
- Löschen Sie das Attribut Fqdn.
- recursive: true
- resource: Das zu suchende Muster (zum Beispiel: /*js).
- Löschen Sie das Attribut bulk.
Eine Liste definierter Dateien einer Domain oder Subdomain löschen:
- fqdn: Der Name der Domain oder Subdomain.
- recursive: true oder false
- Löschen Sie das Attribut resource.
- bulk: Array aller zwischengespeicherten Dateitypen (zum Beispiel: "bulk": ["/*.css", "/*.txt"])

Beispiele für das Pattern-Matching mit recursive

Muster	Rekursiv	Ressource	Ergebnis
/*.js	Nein	/main.js	Treffer
/*.js	Nein	/folder/main.js	kein Treffer
/*.js	Nein	/testmain.css	kein Treffer
.js	Ja	/assets/script.js	Treffer
.js	Ja	/assets/jquery/jquery.js	Treffer
.js	Ja	/main.js	Treffer
.js	Ja	/main.css	kein Treffer
.js	Ja	/assets/js/source.map	kein Treffer
/assets/*.js	Nein	/assets/script.js	Treffer
/assets/*.js	Nein	/asset/script.js	kein Treffer
/assets/*.js	Nein	/main.js	kein Treffer
/assets/*.js	Nein	/folder/js/script.js	kein Treffer
/assets/*.js	Ja	/assets/script.js	Treffer
/assets/*.js	Ja	/assets/jquery/jquery.js	Treffer
/assets/*.js	Ja	/main.js	kein Treffer
/assets/*.js	Ja	/js/angular.js	kein Treffer
/.	Ja	/main.js	Treffer
/*	Ja	/main.js	Treffer

Bei einer erfolgreichen Anfrage gibt das System ausschließlich den HTTP-Code 200 zurück.

Beispiel¶

Beispiel-Request-Body:

{
  "objectType": "string",
  "fqdn": "string",
  "resource": "string",
  "recursive": true,
  "bulk": "string"
}

Antworten¶

Die folgenden Antworten sind möglich:

STATUSCODE	BESCHREIBUNG
200	Die Anfrage war erfolgreich.
400	Die Anfrage war nicht erfolgreich. Die Anfrage war fehlerhaft oder es fehlen Informationen.
401	Die Anfrage war nicht erfolgreich, da die Authentifizierung fehlerhaft war.
403	Die Anfrage war nicht erfolgreich, da die erforderlichen Berechtigungen fehlen.