Almindelige Microsoft Defender XDR REST API-fejlkoder
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.
Relaterede artikler
- Brug Microsoft Graph-sikkerheds-API'en – Microsoft Graph | Microsoft Learn
- Oversigt over API'er Microsoft Defender XDR
- Understøttede Microsoft Defender XDR API'er
- Få adgang til de Microsoft Defender XDR API'er
- Få mere at vide om API-grænser og -licenser
Tip
Vil du vide mere? Kontakt Microsoft Security-community'et i vores Tech Community: Microsoft Defender XDR Tech Community.