Warning header
Deprecated
Avoid using this feature in new projects. This feature may be a candidate for removal from web standards or browsers.
Hinweis:
Der Header wurde als veraltet eingestuft, da er nicht häufig erzeugt oder Nutzern angezeigt wird (siehe RFC9111).
Einige der Informationen können aus anderen Headern wie Age abgeleitet werden.
Der HTTP-Warning-Request- und Response-Header enthält Informationen über mögliche Probleme mit dem Status der Nachricht.
In einer Response können mehrere Warning-Header vorkommen.
Warning-Headerfelder können im Allgemeinen auf jede Nachricht angewendet werden.
Einige Warn-Codes sind jedoch spezifisch für Caches und können nur auf Response-Nachrichten angewendet werden.
| Header-Typ | Request-Header, Response-Header |
|---|---|
| Verbotener Request-Header | Nein |
Syntax
Warning: <warn-code> <warn-agent> <warn-text> [<warn-date>]
Direktiven
<warn-code>-
Eine dreistellige Warnnummer. Die erste Ziffer gibt an, ob die
Warningnach der Validierung aus einer gespeicherten Response gelöscht werden muss.1xx-Warn-Codes beschreiben den Aktualitäts- oder Validierungsstatus der Response und werden von einem Cache nach erfolgreicher Validierung gelöscht.2xx-Warn-Codes beschreiben einen Aspekt der Repräsentation, der durch eine Validierung nicht behoben wird, und werden von einem Cache nach der Validierung nicht gelöscht, sofern keine vollständige Response gesendet wird.
<warn-agent>-
Der Name oder das Pseudonym des Servers oder der Software, die den
Warning-Header hinzufügt (kann-sein, wenn der Agent unbekannt ist). <warn-text>-
Ein Hinweistext, der den Fehler beschreibt.
<warn-date>Optional-
Ein Datum. Wenn mehr als ein
Warning-Header gesendet wird, schließen Sie ein Datum ein, das demDate-Header entspricht.
Warning-Codes
Die HTTP Warn Codes Registry auf iana.org definiert den Namensraum für Warning-Codes.
| Code | Text | Beschreibung |
|---|---|---|
| 110 | Response is Stale | Die von einem Cache bereitgestellte Response ist veraltet (die für die Response festgelegte Ablaufzeit ist überschritten). |
| 111 | Revalidation Failed | Ein Versuch, die veraltete Response zu validieren, schlug fehl, weil der Server nicht erreicht werden konnte. |
| 112 | Disconnected Operation | Der Cache ist absichtlich vom Rest des Netzwerks getrennt. |
| 113 | Heuristic Expiration | Ein Cache hat heuristisch eine Gültigkeitsdauer von mehr als 24 Stunden gewählt, und das Alter der Response beträgt mehr als 24 Stunden. |
| 199 | Miscellaneous Warning | Beliebige Informationen, die einem Nutzer präsentiert oder protokolliert werden sollten. |
| 214 | Transformation Applied | Wird von einem Proxy hinzugefügt, wenn er eine Transformation auf die Repräsentation anwendet, etwa eine Änderung der Content-Codierung, des Medientyps oder Ähnlichem. |
| 299 | Miscellaneous Persistent Warning | Beliebige Informationen, die einem Nutzer präsentiert oder protokolliert werden sollten. Dieser Warn-Code ähnelt dem Warn-Code 199 und weist zusätzlich auf eine dauerhafte Warnung hin. |
Beispiele
Warning: 110 anderson/1.3.37 "Response is stale"
Date: Wed, 21 Oct 2015 07:28:00 GMT
Warning: 112 - "cache down" "Wed, 21 Oct 2015 07:28:00 GMT"
Spezifikationen
| Spezifikation |
|---|
| HTTP Caching # field.warning |