The Warning response-header general-header field is used to carry additional information about the status or transformation of a response which may might not be reflected by the response status code in the message. This information is typically, though not exclusively, used to warn about a possible lack of semantic transparency from caching operations or transformations applied to the entity body of the message.

Warning 一般頭欄は、応答状態符号にメッセージ中に反映されていないかもしれない応答の状態や変形についての追加情報を伝達するために使います。 この情報は、典型的にはキャッシュ操作の意味的透過性の欠如の可能性があることやメッセージの実体本体に変形が行われたことを警告するために使います。

Warning headers are sent with responses using:

Warning 頭は、応答で次を使って送信します。

• Warning = "Warning" ":" 1#warning-value
• warning-value = warn-code SP warn-agent SP warn-text [SP warn-date]
• warn-code = 2DIGIT
• warn-code = 3DIGIT
• warn-agent = ( host [ ":" port ] ) | pseudonym

  ; the name or pseudonym of the server adding
  ; the Warning header, for use in debugging

• warn-text = quoted-string
• warn-date = <"> HTTP-date <">

A response may MAY carry more than one Warning header.

応答は1つ以上の Warning 頭を運んで構いません。

The warn-text should SHOULD be in a natural language and character set that is most likely to be intelligible to the human user receiving the response. This decision may MAY be based on any available knowledge, such as the location of the cache or user, the Accept-Language field in a request, the Content-Language field in a response, etc. The default language is English and the default character set is ISO-8859-1.

warn-text は応答を受け取る人間利用者が理解可能と最も思われる 自然言語と文字集合を使うべきです。この決定はいかなる利用可能な知識、 例えばキャッシュや利用者の位置, 要求の Accept-Language 欄, 要求の Content-Language 欄, などなどを基にして構いません。 既定言語は英語で既定文字集合は ISO-8859-1 です。

If a character set other than ISO-8859-1 is used, it MUST be encoded in the warn-text using the method described in RFC 1522 2047 [14].

ISO-8859-1 以外の文字集合が使われる場合は、 RFC 2047 で説明されている方法を使って warn-text を符号化しなければなりません。

Warning headers can in general be applied to any message, however some specific warn-codes are specific to caches and can only be applied to response messages. Any server or cache may add Warning headers to a response. New Warning headers should SHOULD be added after any existing Warning headers. A cache MUST NOT delete any Warning header that it received with a response message. However, if a cache successfully validates a cache entry, it SHOULD remove any Warning headers previously attached to that entry except as specified for specific Warning codes. It MUST then add any Warning headers received in the validating response. In other words, Warning headers are those that would be attached to the most recent relevant response.

Warning 頭は、一般に任意のメッセージに適用できます。 しかし、幾つかの特定の warn-code はキャッシュに特有のものであり、 応答メッセージにのみ適用できます。 新しい Warning 頭は既存の Warning 頭群の後に追加するべきです、キャッシュは、 その受信したメッセージ内の Warning 頭を削除してはなりません。 しかし、キャッシュがキャッシュ項目を成功裏に妥当性検証したのなら、 特定の Warning 符号について指定されたものを除いて、 その項目に以前に付された Warning 頭群んは削除するべきです。 キャッシュは、その際に検証応答で受信した Warning 頭欄をすべて追加しなければなりません。言い換えれば、 Warning 頭は最近の関係する応答に付されたものとします。

When multiple Warning headers are attached to a response, the user agent SHOULD display ought to inform the user of as many of them as possible, in the order that they appear in the response. If it is not possible to display inform the user of all of the warnings, the user agent should SHOULD follow these heuristics:

複数の Warning 頭群が応答に付されている時は、 利用者エージェントはそのうちのできるだけ多くを、 応答に出現した順で利用者に示すべきです。 警告のすべてを利用者に示すことが不可能である時は、 利用者エージェントは次の発見的方法に従うべきです。

• o - Warnings that appear early in the response take priority over those appearing later in the response.
• o - Warnings in the user's preferred character set take priority over warnings in other character sets but with identical warn-codes and warn-agents.

• 応答の先のほうで現れた Warning は、 応答の後のほうで現れたものよりも優先させる
• 利用者の優先させている文字集合で書かれた Warning は、 warn-code と warn-agent が同じでありながらも他の文字集合で書かれたものよりも優先させる。

Systems that generate multiple Warning headers should SHOULD order them with this user agent behavior in mind.

複数の Warning 頭を生成するシステムは、この利用者エージェントの振る舞いを念頭に置いて順序を決めるべきです。

This is a list of the currently-defined warn-codes, each with a recommended warn-text in English, and a description of its meaning.

これは、現在定義されている warn-code と、それぞれについての推奨する英語での warn-text とその意味の説明の一覧です。

110 Response is stale

MUST be included whenever the returned response is stale. A cache may add this warning to any response, but may never remove it until the response is known to be fresh.

110 応答は腐っています

返される応答が腐敗しているときには必ず含めなければなりません。キャッシュはこの警告を任意の応答に追加して構いませんが、応答が新鮮と分かるまでは決して削除してはなりません。

111 Revalidation failed

MUST be included if a cache returns a stale response because an attempt to revalidate the response failed, due to an inability to reach the server. A cache may add this warning to any response, but may never remove it until the response is successfully revalidated.

111 再検証失敗

キャッシュが、鯖に到達する能力がなかったために応答の妥当性を再検証する試行に失敗したため、腐った応答を返すときに含めなければなりません。キャッシュはこの警告を任意の応答に追加して構いませんが、応答を成功裏に再検証するまでは決して削除してはなりません。

112 Disconnected operation

SHOULD be included if the cache is intentionally disconnected from the rest of the network for a period of time.

112 未接続操作

キャッシュがある時間中ネットワークの他の部分と意図的に接続されていないときに含めるべきです。

113 Heuristic expiration

MUST be included if the cache heuristically chose a freshness lifetime greater than 24 hours and the response's age is greater than 24 hours.

113 発見的満期

キャッシュが発見的に24時間よりも大きな新鮮寿命を選び、 応答の齢が24時間よりも大きいときに含めなければなりません。

199 Miscellaneous warning

The warning text may MAY include arbitrary information to be presented to a human user, or logged. A system receiving this warning MUST NOT take any automated action, besides presenting the warning to the user.

119 その他の警告

警告文は、人間利用者に示される、または記録される、任意の情報を含めて構いません。 この警告を受信したシステムは、利用者に警告を示す他に、自動の動作を行ってはなりません。

214 Transformation applied

MUST be added by an intermediate cache or proxy if it applies any transformation changing the content-coding (as specified in the Content-Encoding header) or media-type (as specified in the Content-Type header) of the response, or the entity-body of the response, unless this Warning code already appears in the response. MUST NOT be deleted from a response even after revalidation.

214 変形適用済み

中間キャッシュまたは串が、応答の content-coding (Content-Encoding 頭で指定されます。) または media-type (Content-Type で指定されます。) または応答の entity-body を変更する何らかの変形を適用した場合に、 この Warning 符号が既に応答に現れている場合を除き、 追加しなければなりません。再検証の後であっても応答から削除してはなりません。

廃止予定フェーズの間、 Warning ヘッダを付けましょう。 (RFC 7234 - Warning header をみてください)。 Warning が付いていたら、 warn-code は 299 を指定し、 warn-text は "The path/operation/parameter/…​ {name} is deprecated and will be removed by {date}. Please see {link} for details." の形式にしましょう。 link先は、なぜAPIがもはやサポートされないかと、クライアントがすべきことを記述した ドキュメントにします。 `Warning`ヘッダを付加しても、クライアントに対しAPI停止の同意を得たとはいえません。