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) Das Mandantenfeature 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 bezüglich eines Fehlers kontaktieren, hilft Ihnen das Anfügen dieser ID dabei, 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"
    }
}