Batch サービスは、条件付きヘッダーの HTTP/1.1 プロトコル仕様 に従い、次の規則を使用して、条件付きヘッダーを指定する要求を処理します。
-
If-None-MatchヘッダーとIf-Modified-Sinceヘッダーが両方とも指定されている要求は、If-None-Matchに指定されている条件に基づいて評価されます。 -
If-MatchヘッダーとIf-Unmodified-Sinceヘッダーが両方とも指定されている要求は、If-Matchに指定されている条件に基づいて評価されます。 - 前に示した 2 とおりの条件ヘッダーの組み合わせは例外として、要求には条件ヘッダーを 1 つのみ指定できます。 複数の条件ヘッダーを指定すると、ステータス コード 400 (Bad Request) が返されます。
操作でサポートされている条件付きヘッダーを確認するには、その操作のドキュメント ( ジョブの有効化など) を参照してください。 すべての操作ですべてのヘッダーがサポートされているわけではありません。
条件ヘッダーをサポートする操作の HTTP 応答コード
Batch Service は、HTTP/1.1 プロトコル仕様 (RFC 2616) に従って HTTP 応答コードを返します。
読み取り操作
読み取り操作に指定される各条件ヘッダーについて、条件が満たされなかった場合に返される応答コードを次の表に示します。 読み取り操作では、GET 動詞または HEAD 動詞が使用されます。
| 条件ヘッダー | 条件が満たされなかった場合の応答コード |
|---|---|
If-Match |
Precondition Failed (412) |
If-None-Match |
Not Modified (304) |
If-Modified-Since |
Not Modified (304) |
If-Unmodified-Since |
Precondition Failed (412) |
書き込み操作
書き込み操作に指定される各条件ヘッダーについて、条件が満たされなかった場合に返される応答コードを次の表に示します。 書き込み操作では、POST、PUT、PATCH、または DELETE 動詞が使用されます。
| 条件ヘッダー | 条件が満たされなかった場合の応答コード |
|---|---|
If-Match |
Precondition Failed (412) |
If-None-Match |
Precondition Failed (412) |
If-Modified-Since |
Precondition Failed (412) |
If-Unmodified-Since |
Precondition Failed (412) |