Häufige Microsoft Defender XDR REST-API-Fehlercodes
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:
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. |
{
"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"
}
}
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.
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.
- Verwenden der Microsoft Graph-Sicherheits-API – Microsoft Graph | Microsoft Learn
- Übersicht über Microsoft Defender XDR-APIs
- Unterstützte Microsoft Defender XDR-APIs
- Zugreifen auf die Microsoft Defender XDR-APIs
- Informationen zu API-Grenzwerten und -Lizenzierung
Tipp
Möchten Sie mehr erfahren? Engage mit der Microsoft-Sicherheitscommunity in unserer Tech Community: Microsoft Defender XDR Tech Community.