If-Match ヘッダー

HTTP の If-Match リクエストヘッダーは、リクエストを条件付きにします。 サーバーは、GET および HEAD メソッドに対してはリソースを返し、PUT などの安全でないメソッドに対してはリソースをアップロードしますが、これらは、リソースが If-Match リクエストヘッダー内の ETag 値のいずれかと一致する場合にのみ行われます。 条件が満たされない場合、代わりに 412 Precondition Failed レスポンスが返されます。

格納された ETag との比較では、強い比較アルゴリズムを使用、つまり 2 つのファイルがバイト単位で同一である場合のみ同一とみなします。列挙された ETag に W/ 接頭辞がついている場合は、弱いエンティティタグであることを示し、この比較アルゴリズムでの比較は行われません。

一般的な使用例は 2 つあります。

• GET および HEAD メソッドの場合は、 Range ヘッダーと組み合わせて使用され、リクエストされた新しい範囲が以前のものと同じリソースからのものであることを保証することができます。
• 他のメソッド、特に PUT の場合は、 If-Match を使用して更新プログラムが失われる問題を防ぐことができます。 ユーザーがアップロードしたいリソースの変更が、元のリソースがフェッチされた後に行われた別の変更を上書きしないかどうかを確認できます。