Freigeben über


Angeben von bedingten Headern

Der Batch-Dienst folgt der HTTP/1.1-Protokollspezifikation für bedingte Header und verwendet die folgenden Regeln, um Anforderungen zu verarbeiten, die bedingte Header angeben:

  • Wenn in einer Anforderung sowohl der If-None-Match-Header als auch der If-Modified-Since-Header angegeben sind, wird die Anforderung auf Grundlage der in If-None-Match angegebenen Kriterien ausgewertet.
  • Wenn in einer Anforderung sowohl der If-Match-Header als auch der If-Unmodified-Since-Header angegeben sind, wird die Anforderung auf Grundlage der in If-Match angegebenen Kriterien ausgewertet.
  • Mit Ausnahme der beiden oben angegebenen Kombinationen bedingter Header darf in einer Anforderung nur ein einzelner bedingter Header angegeben werden. Wenn mehrere bedingte Header angegeben werden, wird der Statuscode 400 (Ungültige Anforderung) erzeugt.

Informationen dazu, welche bedingten Header von einem Vorgang unterstützt werden, finden Sie in der Dokumentation für diesen Vorgang (z. B. Auftragsaktivierung). Nicht alle Vorgänge unterstützen alle Header.

HTTP-Antwortcodes für Vorgänge, die bedingte Header unterstützen

Der Batch-Dienst gibt einen HTTP-Antwortcode in Übereinstimmung mit der HTTP/1.1-Protokollspezifikation (RFC 2616) zurück.

Lesevorgänge

In der folgenden Tabelle sind die Antwortcodes angegeben, die bei einem Lesevorgang für die einzelnen bedingten Header zurückgegeben werden, wenn eine Bedingung nicht erfüllt ist. In Lesevorgängen werden die Verben GET und HEAD verwendet.

Bedingter Header Antwortcode, wenn Bedingung nicht erfüllt wurde
If-Match Vorbedingung nicht erfüllt (412)
If-None-Match Nicht geändert (304)
If-Modified-Since Nicht geändert (304)
If-Unmodified-Since Vorbedingung nicht erfüllt (412)

Schreibvorgänge

In der folgenden Tabelle sind die Antwortcodes angegeben, die bei einem Schreibvorgang für die einzelnen bedingten Header zurückgegeben werden, wenn eine Bedingung nicht erfüllt ist. In Schreibvorgängen werden die Verben POST, PUT, PATCH und DELETE verwendet.

Bedingter Header Antwortcode, wenn Bedingung nicht erfüllt wurde
If-Match Vorbedingung nicht erfüllt (412)
If-None-Match Vorbedingung nicht erfüllt (412)
If-Modified-Since Vorbedingung nicht erfüllt (412)
If-Unmodified-Since Vorbedingung nicht erfüllt (412)