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.