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