Behandeln von REST-API-Fehlern
HTTP-Fehlerantworten sind in zwei Kategorien unterteilt:
- Clientfehler (400-Code-Ebene): Der Client hat eine ungültige Anforderung gesendet, oder die Anforderung entspricht nicht den Definitionen.
- Serverfehler (500-Ebene): Der Server konnte die Anforderung vorübergehend nicht erfüllen, oder ein Serverfehler ist aufgetreten. Versuchen Sie erneut, die HTTP-Anforderung zu senden.
Die in der folgenden Tabelle aufgeführten Fehlercodes können von einem Vorgang für eine der Microsoft Defender for Endpoint-APIs zurückgegeben werden.
- Zusätzlich zum Fehlercode enthält jede Fehlerantwort eine Fehlermeldung, mit der das Problem behoben werden kann.
- Die Nachricht ist ein Freitext, der geändert werden kann.
- Unten auf der Seite finden Sie Antwortbeispiele.
Gilt für:
Möchten Sie Defender für Endpunkt erfahren? Registrieren Sie sich für eine kostenlose Testversion
| Fehlercode | HTTP-Statuscode | Nachricht |
|---|---|---|
| BadRequest | BadRequest (400) | Allgemeine Fehlermeldung "Ungültige Anforderung". |
| ODataError | BadRequest (400) | Ungültige OData-URI-Abfrage (der spezifische Fehler wird angegeben). |
| InvalidInput | BadRequest (400) | Ungültige Eingabe {die ungültige Eingabe}. |
| InvalidRequestBody | BadRequest (400) | Ungültiger Anforderungstext. |
| InvalidHashValue | BadRequest (400) | Der Hashwert {der ungültige Hash} ist ungültig. |
| InvalidDomainName | BadRequest (400) | Der Domänenname {die ungültige Domäne} ist ungültig. |
| InvalidIpAddress | BadRequest (400) | Die IP-Adresse {die ungültige IP}-Adresse ist ungültig. |
| InvalidUrl | BadRequest (400) | Die URL {die ungültige URL} ist ungültig. |
| MaximumBatchSizeExceeded | BadRequest (400) | Die maximale Batchgröße wurde überschritten. Empfangen: {Batchgröße empfangen}, zulässig: {Batchgröße zulässig}. |
| MissingRequiredParameter | BadRequest (400) | Der Parameter {the missing parameter} fehlt. |
| OsPlatformNotSupported | BadRequest (400) | Die 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 (ungültiger oder abgelaufener Autorisierungsheader). |
| Verboten (Forbidden) | Verboten (403) | Verboten (gültiges Token, aber unzureichende Berechtigung für die Aktion). |
| 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) | Die Ressource {die angeforderte Ressource} wurde nicht gefunden. |
| TooManyRequests | Zu viele Anforderungen (429) | Die Antwort stellt das Erreichen des Kontingentlimits entweder nach Anzahl von Anforderungen oder nach CPU dar. |
| InternalServerError | Interner Serverfehler (500) | (Keine Fehlermeldung, wiederholen Sie den Vorgang.) |
Einschränkung
Der HTTP-Client erhält möglicherweise den Fehler "Zu viele Anforderungen (429)", wenn die Anzahl der HTTP-Anforderungen in einem bestimmten Zeitrahmen die zulässige Anzahl von Aufrufen pro API überschreitet.
Der HTTP-Client sollte die erneute Übermittlung weiterer HTTPS-Anforderungen verzögern und diese dann auf eine Weise übermitteln, die den Ratenbeschränkungen entspricht. Ein Retry-After im Antwortheader, der angibt, wie lange (in Sekunden) gewartet werden soll, bevor eine neue Anforderung gestellt wird.
Wenn Sie die Antwort 429 ignorieren oder versuchen, HTTP-Anforderungen in einem kürzeren Zeitraum erneut zu übermitteln, wird der Fehlercode 429 zurückgegeben.
Bei Textparametern wird die Groß-/Kleinschreibung beachtet.
Bei den übermittelten Textparametern wird derzeit die Groß-/Kleinschreibung beachtet.
Wenn ein InvalidRequestBody - oder MissingRequiredParameter-Fehler auftritt, kann dies durch einen falschen Groß- oder Kleinbuchstaben des Parameters verursacht werden.
Überprüfen Sie die Api-Dokumentationsseite, und überprüfen Sie, ob die übermittelten Parameter mit dem entsprechenden Beispiel übereinstimmen.
Korrelationsanforderungs-ID
Jede Fehlerantwort enthält einen eindeutigen ID-Parameter für die Nachverfolgung.
Der Eigenschaftsname dieses Parameters lautet "target".
Wenn Sie uns aufgrund eines Fehlers kontaktieren, hilft ihnen das Anfügen dieser ID, die Grundursache des Problems zu finden.
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"
}
}
Tipp
Möchten Sie mehr erfahren? Wenden Sie sich an die Microsoft-Sicherheitscommunity in unserer Tech Community: Microsoft Defender for Endpoint Tech Community.