Megosztás a következőn keresztül:

Gyakori Microsoft Defender XDR REST API-hibakódok

  • Cikk

É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ódok

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.

Példák

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

Törzsparaméterek

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.

Nyomkövetési azonosító

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.

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.