Udostępnij przez

Określanie nagłówków warunkowych

Usługa Batch jest zgodna ze specyfikacją protokołu HTTP/1.1 dla nagłówków warunkowych i używa poniższych reguł do przetwarzania żądań określających nagłówki warunkowe:

  • Jeśli żądanie określa zarówno If-None-Match nagłówki , jak i If-Modified-Since , żądanie jest oceniane na podstawie kryteriów określonych w If-None-Match.
  • Jeśli żądanie określa zarówno If-Match nagłówki , jak i If-Unmodified-Since , żądanie jest oceniane na podstawie kryteriów określonych w If-Match.
  • Z wyjątkiem dwóch kombinacji nagłówków warunkowych wymienionych powyżej żądanie może określać tylko jeden nagłówek warunkowy. Określenie więcej niż jednego nagłówka warunkowego powoduje wyświetlenie kodu stanu 400 (nieprawidłowe żądanie).

Aby sprawdzić, które nagłówki warunkowe są obsługiwane przez operację, zobacz dokumentację dla tej operacji (na przykład Włączanie zadania). Nie wszystkie operacje obsługują wszystkie nagłówki.

Kody odpowiedzi HTTP dla operacji obsługujących nagłówki warunkowe

Usługa Batch zwraca kod odpowiedzi HTTP zgodnie ze specyfikacją protokołu HTTP/1.1 (RFC 2616).

Operacje odczytu

W poniższej tabeli przedstawiono kody odpowiedzi zwrócone dla warunku niezaspokojonego dla każdego nagłówka warunkowego, gdy operacja jest operacją odczytu. Operacje odczytu używają czasowników GET lub HEAD.

Nagłówek warunkowy Kod odpowiedzi, jeśli warunek nie został spełniony
If-Match Warunek wstępny nie powiódł się (412)
If-None-Match Nie zmodyfikowano (304)
If-Modified-Since Nie zmodyfikowano (304)
If-Unmodified-Since Warunek wstępny nie powiódł się (412)

Operacje zapisu

W poniższej tabeli przedstawiono kody odpowiedzi zwrócone dla warunku niezaspokojonego dla każdego nagłówka warunkowego, gdy operacja jest operacją zapisu. Operacje zapisu używają czasowników POST, PUT, PATCH lub DELETE.

Nagłówek warunkowy Kod odpowiedzi, jeśli warunek nie został spełniony
If-Match Warunek wstępny nie powiódł się (412)
If-None-Match Warunek wstępny nie powiódł się (412)
If-Modified-Since Warunek wstępny nie powiódł się (412)
If-Unmodified-Since Warunek wstępny nie powiódł się (412)
  • Last updated on