Vanliga Microsoft Defender XDR REST API-felkoder
Gäller för:
- Microsoft Defender XDR
Anteckning
Prova våra nya API:er med ms Graph-säkerhets-API. Läs mer på: Använda Säkerhets-API:et för Microsoft Graph – Microsoft Graph | Microsoft Learn.
Viktigt
En del information gäller förinstallerad produkt som kan ha ändrats mycket innan den släpps kommersiellt. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, med avseende på den information som anges här.
Felkoder kan returneras av en åtgärd på någon av de Microsoft Defender XDR API:erna. Varje felsvar innehåller ett felmeddelande som kan hjälpa dig att lösa problemet. Felmeddelandekolumnen i tabellavsnittet innehåller några exempelmeddelanden. Innehållet i faktiska meddelanden varierar beroende på de faktorer som utlöste svaret. Variabelinnehåll anges med vinkelparenteser (< >
) i följande tabell:
Felkod | HTTP-statuskod | Meddelande |
---|---|---|
BadRequest | BadRequest (400) | Allmänt felmeddelande om felaktig begäran. |
ODataError | BadRequest (400) | Ogiltig OData-URI-fråga <det specifika felet har angetts>. |
InvalidInput | BadRequest (400) | Ogiltig inmatning <av ogiltiga indata>. |
InvalidRequestBody | BadRequest (400) | Ogiltig begärandetext. |
InvalidHashValue | BadRequest (400) | Hashvärdet <den ogiltiga hashen> är ogiltig. |
InvalidDomainName | BadRequest (400) | Domännamnet <den ogiltiga domänen> är ogiltig. |
InvalidIpAddress | BadRequest (400) | IP-adressen <som den ogiltiga IP-adressen> är ogiltig. |
InvalidUrl | BadRequest (400) | URL: en <ogiltig URL> är ogiltig. |
MaximumBatchSizeExceeded | BadRequest (400) | Maximal batchstorlek har överskridits. Mottaget: <batchstorlek mottagen>, tillåten: {batchstorlek tillåten}. |
MissingRequiredParameter | BadRequest (400) | Parametern <parametern> som saknas saknas. |
OsPlatformNotSupported | BadRequest (400) | OS Platform <klienten OS Platform> stöds inte för den här åtgärden. |
ClientVersionNotSupported | BadRequest (400) | <Den begärda åtgärden> stöds i klientversionen <> som stöds och senare. |
Obehörig | Obehörig (401) | Obehörig Det här felet orsakas vanligtvis av ett ogiltigt eller utgånget auktoriseringshuvud. |
Ej tillåtet | Förbjudet (403) | Ej tillåtet Det här felet kan inträffa med en giltig token men otillräcklig behörighet för åtgärden. |
DisabledFeature | Förbjudet (403) | Klientfunktionen är inte aktiverad. |
Otillåtenåtgärd | Förbjudet (403) | <den otillåtna åtgärden och orsaken>. |
NotFound | Hittades inte (404) | Allmänt felmeddelande hittades inte. |
ResourceNotFound | Hittades inte (404) | Resursen <som den begärda resursen> hittades inte. |
InternalServerError | Internt serverfel (500) | Om det inte finns något felmeddelande försöker du utföra åtgärden igen. Kontakta Microsoft om det inte löses. |
{
"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"
}
}
Viktigt
Brödtextparametrar är skiftlägeskänsliga.
Om du får felet InvalidRequestBody eller MissingRequiredParameter kan det bero på ett skrivfel. Granska API-dokumentationen och kontrollera att de inskickade parametrarna matchar det relevanta exemplet.
Varje felsvar innehåller en unik ID-parameter för spårning. Egenskapsnamnet för den här parametern är mål. Om du kontaktar Microsoft om ett fel hjälper det Microsoft att hitta rotorsaken till problemet genom att koppla ditt spårnings-ID.
- Använda Säkerhets-API:et för Microsoft Graph – Microsoft Graph | Microsoft Learn
- översikt över Microsoft Defender XDR API:er
- Microsoft Defender XDR-API:er som stöds
- Få åtkomst till Microsoft Defender XDR-API:er
- Läs mer om API-gränser och licensiering
Tips
Vill du veta mer? Engage med Microsofts säkerhetscommunity i vår Tech Community: Microsoft Defender XDR Tech Community.