Almindelige Microsoft Defender XDR REST API-fejlkoder

  • Artikel

Gælder for:

  • Microsoft Defender XDR

Bemærk!

Prøv vores nye API'er ved hjælp af MS Graph-sikkerheds-API'en. Få mere at vide på: Brug Microsoft Graph-sikkerheds-API'en – Microsoft Graph | Microsoft Learn.

Vigtigt!

Nogle oplysninger er relateret til et forhåndsudgivet produkt, som kan blive ændret væsentligt, før det udgives kommercielt. Microsoft giver ingen garantier, hverken udtrykkelige eller underforståede, med hensyn til de oplysninger, der gives her.

Fejlkoder kan returneres af en handling på en hvilken som helst af de Microsoft Defender XDR API'er. Alle fejlsvar indeholder en fejlmeddelelse, der kan hjælpe med at løse problemet. Fejlmeddelelsekolonnen i tabelafsnittet indeholder nogle eksempelmeddelelser. Indholdet af de faktiske meddelelser varierer afhængigt af de faktorer, der udløste svaret. Variabelt indhold angives med vinkelparenteser (< >) i følgende tabel:

Fejlkoder

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-adresse> er ugyldig.
Ugyldig url-adresse BadRequest (400) URL-adressen <, hvor den ugyldige URL-adresse> er ugyldig.
MaximumBatchSizeExceeded BadRequest (400) Den maksimale batchstørrelse er overskredet. Modtaget: <Batchstørrelsen er modtaget>, tilladt: {batchstørrelse tilladt}.
MissingRequiredParameter BadRequest (400) Parameteren <, som den manglende parameter> mangler.
OsPlatformNotSupported BadRequest (400) OS-platformen <klientens OS-platform> understøttes ikke for denne handling.
ClientVersionNotSupported BadRequest (400) <Den anmodede handling> understøttes på klientversionen <, der understøttes af klientversionen> og nyere.
Uautoriseret Uautoriseret (401) Uautoriseret

Normalt skyldes denne fejl en ugyldig eller udløbet godkendelsesheader.
Forbudt Forbudt (403) Forbudt

Denne fejl kan opstå med et gyldigt token, men der er ikke tilstrækkelig tilladelse til handlingen.
Deaktiveret funktion Forbudt (403) Lejerfunktionen er ikke aktiveret.
DisallowedOperation Forbudt (403) <den ikke-tilladte handling og årsagen>.
Ikke fundet Ikke fundet (404) Fejlmeddelelsen Generel blev ikke fundet.
Ressourcen blev ikke fundet Ikke fundet (404) Den <ressource, der blev anmodet om,> blev ikke fundet.
InternalServerError Intern serverfejl (500) Hvis der ikke er nogen fejlmeddelelse, skal du prøve at udføre handlingen igen. Kontakt Microsoft , hvis det ikke bliver løst.

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"
    }
}

Brødtekstparametre

Vigtigt!

Der skelnes mellem store og små bogstaver i bodyparametre.

Hvis du oplever fejlen InvalidRequestBody eller MissingRequiredParameter , kan det skyldes en tastefejl. Gennemse API-dokumentationen, og kontrollér, at de sendte parametre stemmer overens med det relevante eksempel.

Sporings-id

Hvert fejlsvar indeholder en entydig id-parameter til sporing. Egenskabsnavnet for denne parameter er destination. Hvis du kontakter Microsoft om en fejl, hjælper vedhæftning af dit sporings-id Microsoft med at finde den egentlige årsag til problemet.

Tip

Vil du vide mere? Kontakt Microsoft Security-community'et i vores Tech Community: Microsoft Defender XDR Tech Community.