Vanliga Microsoft Defender XDR REST API-felkoder

  • Artikel

Gäller för:

  • Microsoft Defender XDR

Obs!

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:

Felkoder

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.

Exempel

{
    "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ödtextparametrar

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.

Spårnings-ID

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.

Tips

Vill du veta mer? Engage med Microsofts säkerhetscommunity i vår Tech Community: Microsoft Defender XDR Tech Community.