Håndtering af REST API-fejl

  • Artikel

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.