Vanliga REST API-felkoder

  • Felkoderna som visas i följande tabell kan returneras av en åtgärd på någon av Microsoft Defender för slutpunkts-API:er.
  • Utöver felkoden innehåller varje felsvar ett felmeddelande, som kan hjälpa dig att lösa problemet.
  • Meddelandet är en kostnadsfri text som kan ändras.
  • Längst ned på sidan finns svarsexempel.

Gäller för:

Vill du uppleva Microsoft Defender för Endpoint? Registrera dig för en kostnadsfri utvärderingsversion.

Felkod HTTP-statuskod Meddelande
BadRequest BadRequest (400) Felmeddelande för allmän felbegäran.
ODataError BadRequest (400) Ogiltig OData-URI-fråga (det specifika felet har angetts).
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: {batchstorlek mottaget}, tillåtet: {batchstorlek tillåten}.
MissingRequiredParameter BadRequest (400) Parametern {the missing parameter} saknas.
OsPlatformNotSupported BadRequest (400) OS-plattformen {the client OS Platform} stöds inte för den här åtgärden.
ClientVersionNotSupported BadRequest (400) {The requested action} stöds i klientversionen {supported client version} eller senare.
Obehörig Obehörig (401) Obehörig (ogiltig eller utgången auktoriseringsrubrik).
Förbjudet Förbjudet (403) Åtkomst nekas (giltig token men otillräcklig behörighet för åtgärden).
Inaktiveradfeature Förbjudet (403) Klientorganisationsfunktionen är inte aktiverad.
OtillåtenOperation Förbjudet (403) {den otillåtna åtgärden och orsaken}.
NotFound Hittades inte (404) Felmeddelandet Allmänt hittades inte.
ResourceNotFound Hittades inte (404) Resurs {den begärda resursen} hittades inte.
InternalServerError Internt serverfel (500) (Inget felmeddelande, försök igen)
TooManyRequests För många begäranden (429) Svar representerar att nå kvotgränsen antingen genom antal begäranden eller av CPU.

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

Parametrarna för inskickade brödtext är för närvarande ärendekänsliga.

Om du får ett InvalidRequest Gemener- eller MissingRequiredParameter-fel kan det bero på fel versaler eller gemener.

Granska dokumentationssidan för API och kontrollera att de skickade parametrarna matchar det relevanta exemplet.

Id för korrelationsbegäran

Varje felsvar innehåller en unik ID-parameter för spårning.

Egenskapsnamnet för den här parametern är "target".

När du kontaktar oss om ett fel kan du bifoga det här ID:t för att hitta orsaken till problemet.

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