Voorwaardelijke headers opgeven

De Batch-service volgt de HTTP/1.1-protocolspecificatie voor voorwaardelijke headers en gebruikt de onderstaande regels om aanvragen met voorwaardelijke headers te verwerken:

  • Als een aanvraag zowel de If-None-Match headers en If-Modified-Since opgeeft, wordt de aanvraag geëvalueerd op basis van de criteria die zijn opgegeven in If-None-Match.
  • Als een aanvraag zowel de If-Match headers en If-Unmodified-Since opgeeft, wordt de aanvraag geëvalueerd op basis van de criteria die zijn opgegeven in If-Match.
  • Met uitzondering van de twee combinaties van voorwaardelijke headers die hierboven worden vermeld, kan een aanvraag slechts één voorwaardelijke header opgeven. Het opgeven van meer dan één voorwaardelijke header resulteert in statuscode 400 (ongeldige aanvraag).

Als u wilt zien welke voorwaardelijke headers worden ondersteund door een bewerking, raadpleegt u de documentatie voor die bewerking (bijvoorbeeld Taak inschakelen). Niet alle bewerkingen ondersteunen alle headers.

HTTP-antwoordcodes voor bewerkingen die voorwaardelijke headers ondersteunen

Batch-service retourneert een HTTP-antwoordcode in overeenstemming met de HTTP/1.1-protocolspecificatie (RFC 2616).

Leesbewerkingen

In de volgende tabel ziet u de antwoordcodes die worden geretourneerd voor een niet-voldaan voorwaarde voor elke voorwaardelijke header wanneer de bewerking een leesbewerking is. Leesbewerkingen gebruiken de werkwoorden GET of HEAD.

Voorwaardelijke header Antwoordcode als niet aan de voorwaarde is voldaan
If-Match Voorwaarde mislukt (412)
If-None-Match Niet gewijzigd (304)
If-Modified-Since Niet gewijzigd (304)
If-Unmodified-Since Voorwaarde mislukt (412)

Schrijfbewerkingen

De volgende tabel geeft de antwoordcodes weer die worden geretourneerd voor een niet-voldaan voorwaarde voor elke voorwaardelijke header wanneer de bewerking een schrijfbewerking is. Schrijfbewerkingen maken gebruik van de werkwoorden POST, PUT, PATCH of DELETE.

Voorwaardelijke header Antwoordcode als niet aan de voorwaarde is voldaan
If-Match Voorwaarde mislukt (412)
If-None-Match Voorwaarde mislukt (412)
If-Modified-Since Voorwaarde mislukt (412)
If-Unmodified-Since Voorwaarde mislukt (412)