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 veraltet, da er nicht weit verbreitet erzeugt oder den Nutzern angezeigt wird (siehe RFC9111).
Einige Informationen können aus anderen Headern wie Age abgeleitet werden.
Der HTTP Warning Anfrage und Antwort-Header enthält Informationen über mögliche Probleme mit dem Status der Nachricht.
Mehr als ein Warning-Header kann in einer Antwort erscheinen.
Warning-Header-Felder können im Allgemeinen auf jede Nachricht angewendet werden.
Einige Warn-Codes sind jedoch spezifisch für Caches und können nur auf Antwortnachrichten angewendet werden.
| Header-Typ | Anfrage-Header, Antwort-Header |
|---|---|
| Verbotener Anfrage-Header | Nein |
Syntax
Warning: <warn-code> <warn-agent> <warn-text> [<warn-date>]
Direktiven
<warn-code>-
Eine dreistellige Warnnummer. Die erste Ziffer gibt an, ob das
Warningnach einer Validierung aus einer gespeicherten Antwort gelöscht werden muss.1xxWarn-Codes beschreiben die Aktualität oder den Validierungsstatus der Antwort und werden nach erfolgreicher Validierung von einem Cache gelöscht.2xxWarn-Codes beschreiben einen Aspekt der Darstellung, der durch eine Validierung nicht behoben wird und werden nicht von einem Cache gelöscht, es sei denn, es wird eine vollständige Antwort gesendet.
<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, fügen Sie ein Datum hinzu, das mit demDate-Header übereinstimmt.
Warncodes
Der HTTP Warn Codes Registry bei iana.org definiert den Namensraum für Warncodes.
| Code | Text | Beschreibung |
|---|---|---|
| 110 | Response is Stale | Die von einem Cache bereitgestellte Antwort ist veraltet (die für die Antwort gesetzte Ablaufzeit ist abgelaufen). |
| 111 | Revalidation Failed | Ein Versuch, die veraltete Antwort zu validieren, ist fehlgeschlagen, da 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 Frische Lebensdauer gewählt, die länger als 24 Stunden ist, und das Alter der Antwort ist größer als 24 Stunden. |
| 199 | Miscellaneous Warning | Beliebige Informationen, die einem Benutzer präsentiert oder protokolliert werden sollten. |
| 214 | Transformation Applied | Von einem Proxy hinzugefügt, wenn es eine Transformation an der Darstellung vornimmt, wie z.B. das Ändern der Inhaltskodierung, des Medientyps oder ähnlichem. |
| 299 | Miscellaneous Persistent Warning | Beliebige Informationen, die einem Benutzer präsentiert oder protokolliert werden sollten. Dieser Warn-Code ist dem Warn-Code 199 ähnlich und zeigt zusätzlich eine anhaltende Warnung an. |
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 |