Share via


REST API-fouten verwerken

HTTP-foutantwoorden zijn onderverdeeld in twee categorie├źn:

  • Clientfout (codeniveau 400): de client heeft een ongeldige aanvraag verzonden of de aanvraag is niet in overeenstemming met definities.
  • Serverfout (niveau 500): de server kan tijdelijk niet aan de aanvraag voldoen of er is een serverfout opgetreden. Probeer de HTTP-aanvraag opnieuw te verzenden.

De foutcodes in de volgende tabel kunnen worden geretourneerd door een bewerking op een van Microsoft Defender voor Eindpunt API's.

  • Naast de foutcode bevat elk foutbericht een foutbericht, dat kan helpen het probleem op te lossen.
  • Het bericht is een vrije tekst die kan worden gewijzigd.
  • Onder aan de pagina vindt u antwoordvoorbeelden.

Van toepassing op:

Wilt u Defender voor Eindpunt ervaren? Meld u aan voor een gratis proefversie.

Foutcode HTTP-statuscode Bericht
BadRequest BadRequest (400) Algemeen foutbericht ongeldige aanvraag.
ODataError BadRequest (400) Ongeldige OData URI-query (de specifieke fout is opgegeven).
InvalidInput BadRequest (400) Ongeldige invoer {de ongeldige invoer}.
InvalidRequestBody BadRequest (400) Ongeldige aanvraagtekst.
InvalidHashValue BadRequest (400) Hashwaarde {de ongeldige hash} is ongeldig.
InvalidDomainName BadRequest (400) Domeinnaam {het ongeldige domein} is ongeldig.
InvalidIpAddress BadRequest (400) IP-adres {het ongeldige IP} is ongeldig.
InvalidUrl BadRequest (400) URL {de ongeldige URL} is ongeldig.
MaximumBatchSizeExceeded BadRequest (400) De maximale batchgrootte is overschreden. Ontvangen: {batchgrootte ontvangen}, toegestaan: {batchgrootte is toegestaan}.
MissingRequiredParameter BadRequest (400) Parameter {de ontbrekende parameter} ontbreekt.
OsPlatformNotSupported BadRequest (400) OS Platform {het client OS Platform} wordt niet ondersteund voor deze actie.
ClientVersionNotSupported BadRequest (400) {De aangevraagde actie} wordt ondersteund op clientversie {ondersteunde clientversie} en hoger.
Onbevoegde Niet gemachtigd (401) Niet geautoriseerd (ongeldige of verlopen autorisatieheader).
Verboden Verboden (403) Verboden (geldig token, maar onvoldoende toestemming voor de actie).
DisabledFeature Verboden (403) De tenantfunctie is niet ingeschakeld.
DisallowedOperation Verboden (403) {de niet-toegestane bewerking en de reden}.
NotFound Niet gevonden (404) Algemeen foutbericht niet gevonden.
ResourceNotFound Niet gevonden (404) De resource {de aangevraagde resource} is niet gevonden.
TooManyRequests Te veel aanvragen (429) Antwoord vertegenwoordigt het bereiken van de quotumlimiet op basis van het aantal aanvragen of per CPU.
InternalServerError Interne serverfout (500) (Geen foutbericht, voer de bewerking opnieuw uit.)

Throttling

De HTTP-client kan de fout 'Te veel aanvragen (429)' ontvangen wanneer het aantal HTTP-aanvragen in een bepaalde periode het toegestane aantal aanroepen per API overschrijdt.

De HTTP-client moet het opnieuw indienen van verdere HTTPS-aanvragen vertragen en deze vervolgens verzenden op een manier die voldoet aan de snelheidsbeperkingen. Een Retry-After in de antwoordheader die aangeeft hoe lang moet worden gewacht (in seconden) voordat een nieuwe aanvraag wordt ingediend

Het negeren van het 429-antwoord of het opnieuw indienen van HTTP-aanvragen in een korter tijdsbestek geeft een resultaat van de 429-foutcode.

Hoofdtekstparameters zijn hoofdlettergevoelig

De ingediende hoofdtekstparameters zijn momenteel hoofdlettergevoelig.

Als u een InvalidRequestBody- of MissingRequiredParameter-fout ondervindt, kan dit worden veroorzaakt door een verkeerde parameterhoofdletter of kleine letter.

Bekijk de pagina api-documentatie en controleer of de ingediende parameters overeenkomen met het relevante voorbeeld.

Correlatieaanvraag-id

Elk foutantwoord bevat een unieke id-parameter voor het bijhouden.

De eigenschapsnaam van deze parameter is 'target'.

Wanneer u contact met ons opneemt over een fout, helpt het bijvoegen van deze id om de hoofdoorzaak van het probleem te vinden.

Voorbeelden

{
    "error": {
        "code": "ResourceNotFound",
        "message": "Machine 123123123 was not found",
        "target": "43f4cb08-8fac-4b65-9db1-745c2ae65f3a"
    }
}
{
    "error": {
        "code": "InvalidRequestBody",
        "message": "Request body is incorrect",
        "target": "1fa66c0f-18bd-4133-b378-36d76f3a2ba0"
    }
}

Tip

Wil je meer weten? Engage met de Microsoft Security-community in onze Tech Community: Microsoft Defender voor Eindpunt Tech Community.