REST API-fouten verwerken

Artikel
05/02/2024

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.

Delen via