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.

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? Engage mit der Microsoft-Sicherheitscommunity in unserer Tech Community: Microsoft Defender for Endpoint Tech Community.