Häufige Microsoft Defender XDR REST-API-Fehlercodes

  • Artikel

Gilt für:

  • Microsoft Defender XDR

Hinweis

Testen Sie unsere neuen APIs mithilfe der MS Graph-Sicherheits-API. Weitere Informationen finden Sie unter : Verwenden der Microsoft Graph-Sicherheits-API – Microsoft Graph | Microsoft Learn.

Wichtig

Einige Informationen beziehen sich auf Vorabversionen von Produkten, die vor der kommerziellen Veröffentlichung noch erheblich geändert werden können. Microsoft übernimmt mit diesen Informationen keinerlei Gewährleistung, sei sie ausdrücklich oder konkludent.

Fehlercodes können von einem Vorgang für eine der Microsoft Defender XDR-APIs zurückgegeben werden. Jede Fehlerantwort enthält eine Fehlermeldung, mit der das Problem behoben werden kann. Die Spalte "Fehlermeldung" im Tabellenabschnitt enthält einige Beispielmeldungen. Der Inhalt der tatsächlichen Nachrichten variiert basierend auf den Faktoren, die die Antwort ausgelöst haben. Variableninhalt wird in der folgenden Tabelle durch spitze Klammern (< >) angegeben:

Fehlercodes

Fehlercode HTTP-Statuscode Nachricht
BadRequest BadRequest (400) Allgemeine Fehlermeldung "Ungültige Anforderung".
ODataError BadRequest (400) Ungültige OData-URI-Abfrage <, der spezifische Fehler angegeben> wird.
InvalidInput BadRequest (400) Ungültige Eingabe <die ungültige Eingabe>.
InvalidRequestBody BadRequest (400) Ungültiger Anforderungstext.
InvalidHashValue BadRequest (400) Als Hashwert <ist der ungültige Hash> ungültig.
InvalidDomainName BadRequest (400) Der Domänenname <der ungültigen Domäne> ist ungültig.
InvalidIpAddress BadRequest (400) DIE UNGÜLTIGE IP-Adresse <> ist ungültig.
InvalidUrl BadRequest (400) URL <: Ungültige URL> .
MaximumBatchSizeExceeded BadRequest (400) Die maximale Batchgröße wurde überschritten. Empfangen: <Batchgröße empfangen>, zulässig: {Batchgröße zulässig}.
MissingRequiredParameter BadRequest (400) Parameter <, der fehlende Parameter> fehlt.
OsPlatformNotSupported BadRequest (400) Betriebssystemplattform <Die Clientbetriebssystemplattform> wird für diese Aktion nicht unterstützt.
ClientVersionNotSupported BadRequest (400) <Die angeforderte Aktion> wird für die clientversion <unterstützte Clientversion> und höher unterstützt.
Nicht autorisiert (Unauthorized) Nicht autorisiert (401) Nicht autorisiert (Unauthorized)

Dieser Fehler wird in der Regel durch einen ungültigen oder abgelaufenen Autorisierungsheader verursacht.
Verboten (Forbidden) Verboten (403) Verboten (Forbidden)

Dieser Fehler kann auftreten, wenn ein gültiges Token, aber die Berechtigung für die Aktion nicht ausreicht.
DisabledFeature Verboten (403) Die Mandantenfunktion ist nicht aktiviert.
DisallowedOperation Verboten (403) <der unzulässige Vorgang und der Grund>.
NotFound Nicht gefunden (404) Fehlermeldung "Allgemein nicht gefunden".
ResourceNotFound Nicht gefunden (404) Ressource <, die die angeforderte Ressource> nicht gefunden wurde.
InternalServerError Interner Serverfehler (500) Wenn keine Fehlermeldung angezeigt wird, wiederholen Sie den Vorgang. Wenden Sie sich an Microsoft , wenn dies nicht behoben wird.

Beispiele

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

Body parameters

Wichtig

Bei Textparametern wird die Groß-/Kleinschreibung beachtet.

Wenn ein InvalidRequestBody - oder MissingRequiredParameter-Fehler auftritt, kann dies durch einen Tippfehler verursacht werden. Überprüfen Sie die API-Dokumentation, und überprüfen Sie, ob die übermittelten Parameter mit dem relevanten Beispiel übereinstimmen.

Nachverfolgungs-ID

Jede Fehlerantwort enthält einen eindeutigen ID-Parameter für die Nachverfolgung. Der Eigenschaftsname dieses Parameters ist target. Wenn Sie sich aufgrund eines Fehlers an Microsoft wenden, hilft Das Anfügen Ihrer Nachverfolgungs-ID Microsoft dabei, die Grundursache des Problems zu ermitteln.

Tipp

Möchten Sie mehr erfahren? Engage mit der Microsoft-Sicherheitscommunity in unserer Tech Community: Microsoft Defender XDR Tech Community.