Alle Cache-Einstellungen einer Subdomain auflisten¶
Senden einer GET-Anfrage an den Endpunkt /domain/{domainId}/{vHostName}/cache-settings.
Beschreibung¶
Mit der List-Cache-Settings-Anfrage rufen Sie eine Liste aller Cache-Einstellungen einer Subdomain der Organisation ab.
Voraussetzungen¶
Werte der Anfrage: Domain-ID {domainId}, Subdomain name {vHostName}
Objekte: keine
Anfrage¶
Um eine Liste aller Cache-Einstellungen einer Subdomain abzurufen, fügen Sie die Domain-ID {domainId} und den Subdomain name {vHostName} dem Pfad der Anfrage hinzu.
Als Ergebnis erhalten Sie ein oder mehrere Objekte CacheSettingVO mit den angefragten Informationen.
Das Objekt liefert die folgenden Informationen:
| Attribut | Beschreibung | Werte |
|---|---|---|
path |
Der Pfad, der auf die Cache-Antwort zutreffen muss. Eine Anfrage wird mit dem Pfad abgeglichen, um zu entscheiden, ob die Anfrage cachebar ist oder nicht. Im Attribut kann ein regulärer Ausdruck angegeben werden. Die Regex-Zeichen für Anfang ˆ oder Ende $ dürfen nicht verwendet werden, da sie abhängig vom angegebenen Typ erzeugt werden. |
string |
ttl |
Die Time to Live in Sekunden. |
|
noFoundttl |
Die Dauer, für die ein Objekt zwischengespeichert wird. Origin-Antworten mit dem HTTP-Code 404 werden zwischengespeichert. |
|
Type |
Die Bedingung für den Abgleich. |
|
enforce |
Die Verfügbarkeit des Erzwingens der Cache-TTL. Das Erzwingen der Cache-TTL ermöglicht es, die Cache-TTL (Cache-Control: max-age) im Backend unabhängig von der Antwort Ihrer Kundeninfrastruktur festzulegen. |
|
sort |
Die aufsteigende Reihenfolge des Eintrags. | integer |
comment |
Ein individueller Kommentar für den Eintrag. | string |
enabled |
Die Verfügbarkeit des Eintrags. |
|
id |
Die ID des Eintrags. | integer |
modified |
Das Datum der letzten Änderung im ISO-8601-Format. | string($date-time) |
created |
Das Erstellungsdatum im ISO-8601-Format. | string($date-time) |
Beispiel¶
Beispiel-Antwort:
[
{
"objectType": "string",
"path": "string",
"ttl": 0,
"notFoundTtl": 0,
"type": "string",
"enforce": true,
"sort": 0,
"id": 0,
"modified": "string",
"created": "string",
"comment": "string",
"enabled": true
}
]
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. |