Die Cache-Einstellungen eines Tags ändern¶

Note

Der Body muss die Attribute id und modified enthalten, um den entsprechenden Eintrag zu identifizieren.

Note

Die ID des Eintrags im Pfad der Anfrage muss mit dem Wert des Attributs id im Body übereinstimmen.

Senden einer PUT-Anfrage an den Endpunkt /tag/{tagId}/cache-settings/{id}.

Beschreibung¶

Mit der Change-Cache-Settings-Anfrage aktualisieren Sie die Cache-Einstellungen eines Tags der Organisation.

Voraussetzungen¶

Werte der Anfrage: Tag-ID {tagId}, Cache-Setting-ID {id}

Objekte: CacheSettingVO

Anfrage¶

Um die Cache-Einstellungen eines Tags zu ändern, fügen Sie die Tag-ID {tagId} und die Cache-Setting-ID {id} dem Pfad der Anfrage hinzu.

Für eine detaillierte Spezifikation, welche Informationen zum Ändern eines Eintrags der Cache-Einstellungen erforderlich sind, muss im Body das Objekt 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
`Type`	Die Bedingung für den Abgleich.	`exact` `prefix` `suffix`
`id`	Die ID des Eintrags.	`integer`
`modified`	Das Datum der letzten Änderung im ISO-8601-Format.	`string($date-time)`

Die folgenden Attribute sind optional:

Attribut	Beschreibung	Werte
`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
`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`
`enabled`	Die Verfügbarkeit des Eintrags.	`true` `false`
`comment`	Ein individueller Kommentar für den Eintrag.	`string`

Das System gibt das Objekt CacheSettingVO mit den geänderten Informationen 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
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.