Håndtering af REST API-fejl
HTTP-fejlsvar er opdelt i to kategorier:
- Klientfejl (400-kodeniveau) – klienten sendte en ugyldig anmodning, eller anmodningen er ikke i overensstemmelse med definitioner.
- Serverfejl (500-niveau) – serveren kunne midlertidigt ikke opfylde anmodningen, eller der opstod en serverfejl. Prøv at sende HTTP-anmodningen igen.
De fejlkoder, der er angivet i følgende tabel, kan returneres af en handling på en af Microsoft Defender for Endpoint API'er.
- Ud over fejlkoden indeholder alle fejlsvar en fejlmeddelelse, som kan hjælpe med at løse problemet.
- Meddelelsen er en fritekst, der kan ændres.
- Nederst på siden kan du finde svareksempler.
Gælder for:
Vil du opleve Defender for Endpoint? Tilmeld dig en gratis prøveversion.
Fejlkode | HTTP-statuskode | Meddelelse |
---|---|---|
BadRequest | BadRequest (400) | Fejlmeddelelsen Generel forkert anmodning. |
ODataError | BadRequest (400) | Ugyldig OData URI-forespørgsel (den specifikke fejl er angivet). |
Ugyldiginput | BadRequest (400) | Ugyldigt input {det ugyldige input}. |
Ugyldig anmodningsbod | BadRequest (400) | Anmodningens brødtekst er ugyldig. |
UgyldigHashValue | BadRequest (400) | Hashværdien {den ugyldige hash} er ugyldig. |
Ugyldigtdomænenavn | BadRequest (400) | Domænenavnet {det ugyldige domæne} er ugyldigt. |
UgyldigIpAddress | BadRequest (400) | IP-adressen {den ugyldige IP} er ugyldig. |
Ugyldig url-adresse | BadRequest (400) | URL-adressen {den ugyldige URL-adresse} er ugyldig. |
MaximumBatchSizeExceeded | BadRequest (400) | Den maksimale batchstørrelse er overskredet. Modtaget: {batchstørrelse modtaget}, tilladt: {batchstørrelse tilladt}. |
MissingRequiredParameter | BadRequest (400) | Parameteren {den manglende parameter} mangler. |
OsPlatformNotSupported | BadRequest (400) | OS-platformen {klient-OS-platformen} understøttes ikke for denne handling. |
ClientVersionNotSupported | BadRequest (400) | {Den anmodede handling} understøttes på klientversionen {understøttet klientversion} og nyere. |
Uautoriseret | Uautoriseret (401) | Uautoriseret (ugyldig eller udløbet godkendelsesheader). |
Forbudt | Forbudt (403) | Forbudt (gyldigt token, men utilstrækkelig tilladelse til handlingen). |
Deaktiveret funktion | Forbudt (403) | Lejerfunktionen er ikke aktiveret. |
DisallowedOperation | Forbudt (403) | {den handling, der ikke er tilladt, og årsagen}. |
Ikke fundet | Ikke fundet (404) | Fejlmeddelelsen Generel blev ikke fundet. |
Ressourcen blev ikke fundet | Ikke fundet (404) | Ressourcen {den ønskede ressource} blev ikke fundet. |
TooManyRequests | For mange anmodninger (429) | Svar repræsenterer nået kvotegrænse enten efter antal anmodninger eller efter CPU. |
InternalServerError | Intern serverfejl (500) | (Ingen fejlmeddelelse. Prøv at udføre handlingen igen). |
Kvæle
HTTP-klienten kan modtage fejlen 'For mange anmodninger (429)', når antallet af HTTP-anmodninger i en given tidsramme overskrider det tilladte antal kald pr. API.
HTTP-klienten skal forsinke indsendelsen af yderligere HTTPS-anmodninger og derefter sende dem på en måde, der overholder hastighedsbegrænsningerne. Et Retry-After i svarheaderen, der angiver, hvor længe der skal ventes (i sekunder), før der foretages en ny anmodning
Hvis du ignorerer 429-svaret eller forsøger at sende HTTP-anmodninger igen inden for en kortere tidsramme, returneres 429-fejlkoden.
Der skelnes mellem store og små bogstaver i parametre for brødtekst
Der skelnes i øjeblikket mellem store og små bogstaver i de sendte brødtekstparametre.
Hvis du oplever fejl af typen InvalidRequestBody eller MissingRequiredParameter , kan det skyldes en forkert parameter med stort eller småt bogstav.
Gennemse siden med API-dokumentationen, og kontrollér, at de sendte parametre stemmer overens med det relevante eksempel.
Korrelationsanmodnings-id
Hvert fejlsvar indeholder en entydig id-parameter til sporing.
Egenskabsnavnet for denne parameter er "target".
Når du kontakter os om en fejl, hjælper vedhæftning af dette id med at finde den egentlige årsag til problemet.
Eksempler
{
"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
Vil du vide mere? Engage med Microsoft Security-community'et i vores tech-community: Microsoft Defender for Endpoint Tech Community.
Feedback
https://aka.ms/ContentUserFeedback.
Kommer snart: I hele 2024 udfaser vi GitHub-problemer som feedbackmekanisme for indhold og erstatter det med et nyt feedbacksystem. Du kan få flere oplysninger under:Indsend og få vist feedback om