Gyakori Microsoft Defender XDR REST API-hibakódok
Érintett szolgáltatás:
- Microsoft Defender XDR
Megjegyzés
Próbálja ki az új API-kat az MS Graph security API használatával. További információ: A Microsoft Graph biztonsági API használata – Microsoft Graph | Microsoft Learn.
Fontos
Bizonyos információk az előzetesen forgalomba hozott termékre vonatkoznak, amely a kereskedelmi forgalomba kerülés előtt lényegesen módosulhat. A Microsoft nem vállal semmilyen, kifejezett vagy vélelmezett jótállást az itt megadott információkra vonatkozóan.
A hibakódokat egy művelet bármely Microsoft Defender XDR API-n visszaadhatja. Minden hibaválasz tartalmaz egy hibaüzenetet, amely segíthet a probléma megoldásában. A táblázat szakasz hibaüzenet oszlopa néhány mintaüzenetet tartalmaz. A tényleges üzenetek tartalma a válasz kiváltó tényezőitől függően változik. A változó tartalmát szögletes zárójelek (< >
) jelzik a következő táblázatban:
Hibakód | HTTP-állapotkód | Üzenet |
---|---|---|
BadRequest | BadRequest (400) | Általános hibás kérelem hibaüzenet. |
ODataError | BadRequest (400) | Érvénytelen OData URI-lekérdezés <van megadva> az adott hibához. |
InvalidInput | BadRequest (400) | Érvénytelen bemenet <az érvénytelen bemenet>. |
InvalidRequestBody | BadRequest (400) | Érvénytelen kérelemtörzs. |
InvalidHashValue | BadRequest (400) | Kivonatérték <: Az érvénytelen kivonat> érvénytelen. |
InvalidDomainName | BadRequest (400) | Az érvénytelen tartománynév <> érvénytelen. |
InvalidIpAddress | BadRequest (400) | Az érvénytelen IP-cím <> érvénytelen. |
InvalidUrl | BadRequest (400) | Az érvénytelen URL-cím <> érvénytelen. |
MaximumBatchSizeExceeded | BadRequest (400) | Túllépte a köteg maximális méretét. Érkezett: <fogadott> kötegméret, engedélyezett: {kötegméret engedélyezve}. |
MissingRequiredParameter | BadRequest (400) | A <hiányzó paraméter> paramétere hiányzik. |
OsPlatformNotSupported | BadRequest (400) | <Az ügyfél operációsrendszer-platformja> nem támogatott ehhez a művelethez. |
ClientVersionNotSupported | BadRequest (400) | <A kért művelet> a támogatott ügyfélverziókon <> és újabb verziókon támogatott. |
Jogosulatlan | Nem engedélyezett (401) | Jogosulatlan Ezt a hibát általában egy érvénytelen vagy lejárt engedélyezési fejléc okozza. |
Tiltott | Tiltott (403) | Tiltott Ez a hiba érvényes jogkivonat esetén fordulhat elő, de nincs megfelelő engedélye a művelethez. |
DisabledFeature | Tiltott (403) | A bérlői funkció nincs engedélyezve. |
DisallowedOperation | Tiltott (403) | <a nem engedélyezett művelet és az ok>. |
Nem megoldás | Nem található (404) | Általános nem található hibaüzenet. |
ResourceNotFound | Nem található (404) | A <kért erőforrás> nem található. |
InternalServerError | Belső kiszolgálóhiba (500) | Ha nem jelenik meg hibaüzenet, próbálkozzon újra a művelettel. Ha a probléma nem oldódott meg, forduljon a Microsofthoz. |
{
"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"
}
}
Fontos
A törzsparaméterek megkülönböztetik a kis- és nagybetűket.
Ha InvalidRequestBody vagy MissingRequiredParameter hibát tapasztal, azt elírás okozhatja. Tekintse át az API dokumentációját, és ellenőrizze, hogy az elküldött paraméterek megfelelnek-e a megfelelő példának.
Minden hibaválasz egyedi azonosítóparamétert tartalmaz a nyomon követéshez. Ennek a paraméternek a tulajdonságneve a target. Ha hiba miatt kapcsolatba lép a Microsofttal, a nyomkövetési azonosító csatolásával a Microsoft megtalálhatja a probléma kiváltó okát.
- A Microsoft Graph biztonsági API használata – Microsoft Graph | Microsoft Learn
- Microsoft Defender XDR API-k áttekintése
- Támogatott Microsoft Defender XDR API-k
- Az Microsoft Defender XDR API-k elérése
- További információ az API-korlátokról és a licencelésről
Tipp.
Szeretne többet megtudni? Lépjen kapcsolatba a Microsoft biztonsági közösségével a technikai közösségünkben: Microsoft Defender XDR Tech Community.