Vanliga Microsoft 365 Defender REST API-felkoder

Viktigt

Den förbättrade Microsoft 365 Defender-portalen är nu tillgänglig. Med den här nya upplevelsen kommer Defender för Endpoint, Defender för Office 365, 365 Microsoft 365 Defender och annat till Microsoft Defender for Cloud Apps. Läs om de senaste.

Gäller för:

  • Microsoft 365 Defender

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ågot av Microsoft 365 Defender API:er. Alla felsvar kommer att innehålla ett felmeddelande, som kan hjälpa dig att lösa problemet. Kolumnen med felmeddelanden i tabellavsnittet innehåller några exempelmeddelanden. Innehållet i faktiska meddelanden varierar beroende på de faktorer som utlöste svaret. Variabelt innehåll anges i tabellen med vinkelparenteser.

Felkoder

Felkod HTTP-statuskod Meddelande
BadRequest BadRequest (400) Felmeddelande för allmän felbegäran.
ODataError BadRequest (400) Ogiltig OData-URI-fråga. <the specific error is specified>
InvalidInput BadRequest (400) Ogiltiga indata <the invalid input> .
InvalidRequest Det här är ett måste BadRequest (400) Ogiltig begärans brödtext.
InvalidHashValue BadRequest (400) Hashvärdet <the invalid hash> är ogiltigt.
InvalidDomainName BadRequest (400) Domännamnet <the invalid domain> är ogiltigt.
InvalidIpAddress BadRequest (400) IP-adressen <the invalid IP> är ogiltig.
InvalidUrl BadRequest (400) URL <the invalid URL> är ogiltig.
MaximumBatchSizeExceededed BadRequest (400) Maximal överskriden batchstorlek. Mottaget: <batch size received> , tillåtet: {batchstorlek tillåten}.
MissingRequiredParameter BadRequest (400) Parametern <the missing parameter> saknas.
OsPlatformNotSupported BadRequest (400) <the client OS Platform>OS-plattformen stöds inte för den här åtgärden.
ClientVersionNotSupported BadRequest (400) <The requested action> stöds i både <supported client version> klientversion och högre.
Obehörig Obehörig (401) Obehörig

Obs! Detta orsakas vanligtvis av ett ogiltigt eller utgånget auktoriseringshuvud.
Förbjudet Förbjudet (403) Förbjudet

Obs! Giltig token men otillräcklig behörighet för åtgärden.
Inaktiveradfeature Förbjudet (403) Klientorganisationsfunktionen är inte aktiverad.
OtillåtenOperation Förbjudet (403) <the disallowed operation and the reason>.
NotFound Hittades inte (404) Felmeddelandet Allmänt hittades inte.
ResourceNotFound Hittades inte (404) Resursen <the requested resource> hittades inte.
InternalServerError Internt serverfel (500) Obs! Inget felmeddelande, försök igen eller kontakta Microsoft om problemet inte åtgärdas

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

Parametrar för brödtext

Viktigt

Parametrar för brödtext är case-sensitive.

Om du får ett fel av typ InvalidRequest Det här felet eller felet MissingRequiredParameter kan det bero på ett stavfel. Granska API-dokumentationen och kontrollera att de skickade 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. När du kontaktar oss om ett fel kan du bifoga det här ID:t för att hitta orsaken till problemet.