Warning: |
Attention |
|---|---|
| HTTP | Entêtes |
Syntaxe
| Warning: warn-code warn-agent warn-text [warn-date] |
Paramètres
| Nom | Description | ||
|---|---|---|---|
| warn-code | Ce paramètre permet d'indiquer un numéro d'avertissement à trois chiffres. Le premier chiffre indique si l'avertissement doit être supprimé d'une réponse entreposée après validation. Voici la signification des valeurs : | ||
| Valeur | Message | Description | |
| 110 | Response is Stale | Cette valeur permet d'indiquer une réponse fournie par un cache périmée (le délai d'expiration défini pour ce cache est passé). | |
| 111 | Revalidation Failed | Cette valeur permet d'indiquer que la tentative de validation de la réponse a échoué en raison d'une incapacité à atteindre le serveur. | |
| 112 | Disconnected Operation | Cette valeur permet d'indiquer que le cache est déconnecté du reste du réseau. | |
| 113 | Heuristic Expiration | Cette valeur permet d'indiquer qu'il faut l'envoyer si un cache a choisi heuristiquement une durée de vie de fraîcheur supérieure à 24 heures et l'âge de la réponse est supérieur à 24 heures. | |
| 199 | Miscellaneous Warning | Cette valeur permet d'indiquer un avertissement arbitraire et non spécifique. | |
| 214 | Transformation Applied | Cette valeur permet d'indiquer qu'il faut ajouter un proxy s'il applique une transformation à la représentation, telle que la modification du codage de contenu, du type de support ou similaire. | |
| 299 | Miscellaneous Persistent Warning | Cette valeur permet d'indiquer un avertissement persistante arbitraire et non spécifique. | |
| warn-agent | Ce paramètre permet d'indiquer un nom ou pseudonyme du serveur ou du logiciel ajoutant l'entête d'avertissement (peut être «-» lorsque l'agent est inconnu). | ||
| warn-text | Ce paramètre permet d'indiquer un texte d'avis décrivant l'erreur. | ||
| warn-date | Ce paramètre permet d'indiquer si plusieurs entêtes d'avertissement sont envoyés, incluant une date correspondant à l'entête Date:. | ||
Description
Ce champ d'entête permet d'indiquer des informations sur les problèmes possibles avec l'état du message. Plusieurs entêtes d'avertissement peuvent apparaître dans une réponse.
Remarques
- Le champ d'entête Warning: est utilisé pour transporter des informations supplémentaires sur l'état ou la transformation d'un message pouvant ne pas être reflétées dans le code d'état. Ces informations sont généralement utilisées pour avertir d'une éventuelle inexactitude introduite par des opérations de mise en cache ou des transformations appliquées à la charge utile du message.
- Les avertissements peuvent être utilisés à d'autres fins, liées au cache ou non. L'utilisation d'un avertissement, plutôt que d'un code d'état d'erreur, distingue ces réponses des échecs réels.
- Les champs d'entête Warning: peuvent en général être appliqués à n'importe quel message, cependant certains codes d'avertissement sont spécifiques aux caches et ne peuvent être appliqués qu'aux messages de réponse.
- Plusieurs avertissements peuvent être générés dans une réponse (soit par le serveur d'origine soit par un cache), y compris plusieurs avertissements avec le même numéro de code d'avertissement ne différant que par le texte d'avertissement.
- Un agent utilisateur recevant un ou plusieurs champs d'entête d'avertissement devrait en informer le plus grand nombre possible d'utilisateurs, dans l'ordre dans lequel ils apparaissent dans la réponse. Les expéditeurs générant plusieurs champs d'entête Warning: sont encouragés à les commander en tenant compte du comportement de cet agent utilisateur. Un expéditeur générant de nouveaux champs d'entête Warning: doit les ajouter après tout champ d'entête Warning: existant.
- Les avertissements se voient attribuer des codes d'avertissement à trois chiffres. Le premier chiffre indique si l'avertissement doit être supprimé d'une réponse entreposée après validation : les codes d'avertissement 1xx décrivent la fraîcheur ou l'état de validation de la réponse, et donc ils doivent être supprimés par un cache après validation. Ils ne peuvent être générés par un cache que lors de la validation d'une entrée en cache, et ne doivent pas être générés dans toute autre situation. Les codes d'avertissement 2xx décrivent un aspect de la représentation n'étant pas rectifié par une validation (par exemple, une compression avec perte de la représentation) et ils ne doivent pas être supprimés par un cache après validation, sauf si une réponse complète est envoyée, dans laquelle ils doivent l'être.
- Si un expéditeur génère un ou plusieurs codes d'avertissement 1xx dans un message à envoyer à un destinataire connu pour sa mise en oeuvre uniquement du HTTP/1.0, l'expéditeur doit inclure dans chaque valeur d'avertissement correspondante une date d'avertissement correspondant au champ d'entête Date: dans le champ message.
- Les avertissements sont accompagnés d'un texte d'avertissement décrivant l'erreur, par exemple pour le journal de bord. Il est uniquement consultatif et son contenu n'affecte pas l'interprétation du code d'avertissement.
- Si un destinataire utilisant, évaluant ou affichant des champs d'entête Warning: reçoit un warn-date différente de la valeur Date dans le même message, le destinataire doit exclure la valeur d'avertissement contenant cette date d'avertissement avant de l'entreposer, de transférer ou d'utiliser le message. Cette situation permet aux destinataires d'exclure des valeurs d'avertissement n'ayant pas été correctement conservées après une validation du cache. Si toutes les valeurs d'avertissement sont exclues, le destinataire doit également exclure le champ d'entête Warning:.
Exemple
L'exemple suivant permet que le réseau est inaccessible :
Warning: 112 - "network down" "Sat, 18 Jan 2020 23:34:45 GMT"
Dernière mise à jour : Vendredi, le 10 janvier 2020