Einen Cache-Einstellungseintrag für eine Subdomain hinzufügen¶

Note

Wenn die optionalen Attribute nicht gesetzt sind, setzt das System einen Standardwert ein.

Note

Der Body enthält die Attribute id, created und modified nicht. Die Werte dieser Attribute werden vom System nach dem Erstellen des Eintrags gesetzt.

Senden einer POST-Anfrage an den Endpunkt /domain/{domainId}/{vHostName}/cache-settings.

Beschreibung¶

Mit der Add-Cache-Settings-Anfrage fügen Sie einen oder mehrere Cache-Einstellungseinträge für eine Subdomain der Organisation hinzu.

Voraussetzungen¶

Werte der Anfrage: Domain-ID {domainId}, Subdomain name {vHostName}

Objekte: CacheSettingVO

Anfrage¶

Um einen oder mehrere Cache-Einstellungseinträge für eine Subdomain hinzuzufügen, fügen Sie die Domain-ID {domainId} und den Subdomain name {vHostName} dem Pfad der Anfrage hinzu.

Für eine detaillierte Spezifikation, welche Informationen zum Hinzufügen eines Cache-Einstellungseintrags für eine Subdomain erforderlich sind, müssen im Body ein oder mehrere Objekte CacheSettingVO mit den folgenden Attributen definiert werden:

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.	`-1` -> kein Cache `0` -> wie Origin `1` -> 1 Sek. `5` -> 5 Sek. `10` -> 10 Sek. `30` -> 30 Sek. `60` -> 1 Min. `120` -> 2 Min. `300` -> 5 Min. `900` -> 15 Min. `1800` -> 30 Min. `3600` -> 1 Std. `10800` -> 3 Std. `21600` - > 6 Std. `43200` -> 12 Std. `86400` -> 1 Tag `604800` -> 1 Woche `1209600` -> 2 Wochen `2678400` -> 31 Wochen `31536000` -> 1 Jahr
`noFoundttl`	Die Dauer, für die ein Objekt zwischengespeichert wird. Origin-Antworten mit dem HTTP-Code 404 werden zwischengespeichert.	`-1` -> kein Cache `0` -> wie Origin `1` -> 1 Sek. `5` -> 5 Sek. `10` -> 10 Sek. `30` -> 30 Sek. `60` -> 1 Min. `120` -> 2 Min. `300` -> 5 Min. `900` -> 15 Min. `1800` -> 30 Min. `3600` -> 1 Std. `10800` -> 3 Std. `21600` - > 6 Std. `43200` -> 12 Std. `86400` -> 1 Tag `604800` -> 1 Woche `1209600` -> 2 Wochen `2678400` -> 31 Wochen `31536000` -> 1 Jahr
`Type`	Die Bedingung für den Abgleich.	`exact` `prefix` `suffix`
`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.	`true` `false`
`sort`	Die aufsteigende Reihenfolge des Eintrags.	`integer`

Die folgenden Attribute sind optional:

Attribut	Beschreibung	Werte
`enabled`	Die Verfügbarkeit des Eintrags.	`true` `false`
`comment`	Ein individueller Kommentar für den Eintrag.	`string`

Das System gibt als Antwort das Objekt CacheSettingVO mit den Informationen zum neuen Eintrag zurück.

Beispiel¶

Beispiel-Request-Body:

{
  "objectType": "string",
  "path": "string",
  "ttl": 0,
  "notFoundTtl": 0,
  "type": "string",
  "enforce": true,
  "sort": 0,
  "comment": "string",
  "enabled": true
}

Antworten¶

Die folgenden Antworten sind möglich:

STATUSCODE	BESCHREIBUNG
201	Die Anfrage war erfolgreich und ein neues Objekt wurde erstellt.
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.