次の方法で共有


条件付きヘッダーの指定

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)