The If-Match request-header field is used with a method to make it conditional. A client that has one or more entities previously obtained from the resource can verify that one of those entities is current by including a list of their associated entity tags in the If-Match header field. Entity tags are defined in section 3.11. The purpose of this feature is to allow efficient updates of cached information with a minimum amount of transaction overhead. It is also used, on updating requests, to prevent inadvertent modification of the wrong version of a resource. As a special case, the value "*" matches any current entity of the resource.

If-Match 要求頭欄は、それを条件付とする方式と共に使います。 以前に資源から得た1個か複数個の実体を持っているクライアントは、 その実体群の1つが現行のものであることを、 If-Match 頭欄にそれらの実体と関連付けられた実体札の並びを含めることで検証できます。実体札は3.11節で定義しています。 この機能の目的は、キャッシュした情報の効果的な更新最小限のやり取り overhead で実現することです。この機能は、資源の誤った版を不注意に修正してしまうことを防ぐためにも使えます。 特別な場合として、値 * は資源の現在の実体に一致します。

• If-Match = "If-Match" ":" ( "*" | 1#entity-tag )

If any of the entity tags match the entity tag of the entity that would have been returned in the response to a similar GET request (without the If-Match header) on that resource, or if "*" is given and any current entity exists for that resource, then the server MAY perform the requested method as if the If-Match header field did not exist.

実体札のいずれかが同様の (If-Match 頭なしの) GET 要求への応答で返されるであろう実体の実体札と一致するか、 または * が与えられ、その資源に現在の実体が存在するなら、 サーバーは If-Match 頭欄が存在しないかのように要求された方式を処理して構いません。

A server MUST use the strong comparison function (see section 3.11 13.3.3) to compare the entity tags in If-Match.

サーバーは、 If-Match 中の実体札を比較するのに強い比較関数を使わなければなりません。

If none of the entity tags match, or if "*" is given and no current entity exists, the server MUST NOT perform the requested method, and MUST return a 412 (Precondition Failed) response. This behavior is most useful when the client wants to prevent an updating method, such as PUT, from modifying a resource that has changed since the client last retrieved it.

実体札のどれもが一致しなかったか、または * が与えられたものの現在実体が存在しない場合は、サーバーは要求された方式を実行してはならず、 412 (前条件失敗) 応答を返さなければなりません。 この振る舞いは、 PUT のような更新する方式で、 クライアントが最後にそれを取り出してから変更されている資源を修正してしまうことを防ぎたい時に有用です。

If the request would, without the If-Match header field, result in anything other than a 2xx or 412 status, then the If-Match header MUST be ignored.

If-Match 頭欄がなければ要求の結果が 2xx 状態または 412 状態以外のものになるとしたら、 If-Match 頭は無視しなければなりません。

The meaning of "If-Match: *" is that the method SHOULD be performed if the representation selected by the origin server (or by a cache, possibly using the Vary mechanism, see section 14.43 14.44) exists, and MUST NOT be performed if the representation does not exist.

If-Match: * の意味は、その方式は起源サーバーによって (またはキャッシュによって、もしかすると Vary 機構を使って) 選択された表現が存在するときに実行されるべきであり、 表現が存在しないときには実行してはならないということです。

A request intended to update a resource (e.g., a PUT) MAY include an If-Match header field to signal that the request method MUST NOT be applied if the entity corresponding to the If-Match value (a single entity tag) is no longer a representation of that resource. This allows the user to indicate that they do not wish the request to be successful if the resource has been changed without their knowledge.

資源を更新する意図の要求 (例えば PUT) は、 If-Match 値 (1つの実体札) の対応する実体がもはやその資源の表現ではないときにその要求方式を適用してはならないことを通知するために If-Match 頭欄を含めても構いません。 これにより、利用者が、彼らの知識なしに資源が変更されているとしたら要求が成功することを望まないことを示すことができます。

Examples:

• If-Match: "xyzzy"
• If-Match: "xyzzy", "r2d2xxxx", "c3piozzzz"
• If-Match: *

The If-None-Match request-header field is used with a method to make it conditional. A client that has one or more entities previously obtained from the resource can verify that none of those entities is current by including a list of their associated entity tags in the If-None-Match header field. The purpose of this feature is to allow efficient updates of cached information with a minimum amount of transaction overhead. It is also used, on updating requests, to prevent a method (e.g. PUT) inadvertent modification of a resource which was not known to from inadvertently modifying an existing resource when the client believes that the resource does not exist.

If-None-Match 要求頭欄は、それを条件付とする方式とともに使います。 以前に資源から得た1個か複数個の実体を持っているクライアントは、その実体群のどれもが現行のものではないことを、 If-None-Match 頭欄にそれらの実体と関連付けられた実体札の並びを含めることで検証できます。 この機能の目的は、キャッシュした情報の効果的な更新を最小限のやり取り overhead で実現することです。この機能は、更新する要求で、クライアントがその資源は存在しないと信じている時に既存の資源を不注意に修正してしまうことを防ぐためにも使えます。

As a special case, the value "*" matches any current entity of the resource.

特別な場合として、値 * は資源の現在の実体に一致します。

• If-None-Match = "If-None-Match" ":" ( "*" | 1#entity-tag )

If any of the entity tags match the entity tag of the entity that would have been returned in the response to a similar GET request (without the If-None-Match header) on that resource, or if "*" is given and any current entity exists for that resource, then the server MUST NOT perform the requested method, unless required to do so because the resource's modification date fails to match that supplied in an If-Modified-Since header field in the request. Instead, if the request method was GET or HEAD, the server SHOULD respond with a 304 (Not Modified) response, including the cache-related entity-header fields (particularly ETag) of one of the entities that matched. For all other request methods, the server MUST respond with a status of 412 (Precondition Failed).

実体札のいずれかが同様の (If-None-Match 頭なしの) GET 要求への応答で返されるであろう実体の実体札と一致するか、 または * が与えられ、その資源に現在の実体が存在するなら、資源の修正日付が要求の If-Modified-Since 頭欄で供給されたものと一致しなかったためにそうする必要がある場合を除き、 サーバーは要求された方式を処理してはなりません。 代わりに、要求方式が GET または HEAD であるなら、サーバーは、その一致する実体の一つのキャッシュ関連の頭欄 (特に ETag) を含めた 304 (未修正) 応答で応答するべきです。 他のすべての要求方式では、サーバーは 412 (前条件失敗) の状態で応答しなければなりません。

See section 13.3.3 for rules on how to determine if two entity entities tags match. The weak comparison function can only be used with GET or HEAD requests.

二つの実体札の一致をどう決定するかの規則は13.3.3節を参照。 弱い比較関数は GET または HEAD の要求でのみ使うことができます。

If none of the entity tags match, or if "*" is given and no current entity exists, then the server MAY perform the requested method as if the If-None-Match header field did not exist, but MUST also ignore any If-Modified-Since header field(s) in the request. That is, if no entity tags match, then the server MUST NOT return a 304 (Not Modified) response.

実体札のいずれもが一致しなかったか、* が与えられ現在の実体が存在しないなら、 サーバーは要求された方式を If-None-Match 頭欄(群)が要求に存在しなかったものとしてその要求された方式を実行して構いませんが、要求にある If-Modified-Since 頭欄(群)も無視しなければなりません。つまり、実体札がどれも一致しなければ、サーバーは 304 (未修正) 応答を返さなければなりません。

If the request would, without the If-None-Match header field, result in anything other than a 2xx or 304 status, then the If-None-Match header MUST be ignored. (See section 13.3.4 for a discussion of server behavior when both If-Modified-Since and If-None-Match appear in the same request.)

If-None-Match 頭欄がなければ要求の結果が 2xx 状態または 304 状態以外のものになるとしたら、 If-None-Match 頭は無視しなければなりません。(If-Modified-Since と If-None-Match の両方が同じ要求に現れる時のサーバーの振る舞いについての議論は13.3.4節を参照。)

The meaning of "If-None-Match: *" is that the method MUST NOT be performed if the representation selected by the origin server (or by a cache, possibly using the Vary mechanism, see section 14.43 14.44) exists, and SHOULD be performed if the representation does not exist. This feature may is intended to be useful in preventing races between PUT operations.

If-None-Match: * の意味は、その方式は起源サーバーによって (またはキャッシュによって、もしかすると Vary 機構を使って) 選択された表現が存在しないときに実行してはならず、表現が存在しないときには実行するべきだということです。 この機能は PUT 操作間の競合を防ぐのに有用であることを意図しています。

Examples:

• If-None-Match: "xyzzy"
• If-None-Match: W/"xyzzy"
• If-None-Match: "xyzzy", "r2d2xxxx", "c3piozzzz"
• If-None-Match: W/"xyzzy", W/"r2d2xxxx", W/"c3piozzzz"
• If-None-Match: *

See [H14.25].

This field is especially useful for ensuring the integrity of the presentation description, in both the case where it is fetched via means external to RTSP (such as HTTP), or in the case where the server implementation is guaranteeing the integrity of the description between the time of the DESCRIBE message and the SETUP message.

[1] この欄は、表現記述の完全性を確認するのに、これが RTSP 以外の手段 (例えば HTTP) で入手した場合においても或いはサーバー実装が DESCRIBE メッセージの時刻及び SETUP メッセージ間の記述の正当性を保証する場合においても、特に有用です。

The identifier is an opaque identifier, and thus is not specific to any particular session description language.

[2] 識別子は不透明opaque識別子で、従ってどの特定の session 記述言語にも依存しません。

Conditional headers can be used to specify a pre-condition that determines whether the patch operation happens. The If-Match header specifies that the patch operation will succeed if and only if the ref value matches current stored ref. A failed If-Match patch-merge request will return a 412 Error "item_version_mismatch".

If the If-Match: "<timestamp>" request header is provided as described in the section about timestamps, and if the list has changed meanwhile, a 412 Precondition Failed error is returned.

For cache and concurrency control, an ETag response header gives the value that consumers can provide in subsequent requests using If-Match and If-None-Match headers (see section about timestamps).