Fehler

Jede Fehlerantwort hat, unabhängig vom Statuscode, denselben JSON-Body:

{
  "error": {
    "code": "not_found",
    "message": "Server not found",
    "details": {}
  }
}

code ist stabil und maschinenlesbar. Werten Sie Fehler anhand von code aus, nicht anhand von message.
message ist eine für Menschen lesbare Erklärung. Sie kann sich ändern.
details ist nur bei manchen Codes vorhanden und enthält zusätzliche Felder (siehe unten).

Häufige Codes

Status	Code	Bedeutung
400	`invalid_input`	Die Anfrage ist fehlerhaft oder ein Wert ist nicht zulässig. Die Meldung nennt das Problem.
401	`unauthorized`	Kein gültiges Token und keine gültige Sitzung.
402	`insufficient_funds`	Das Guthaben deckt die neue Ressource nicht. `details`: `balance`, `required` (EUR). Siehe Abrechnung.
403	`forbidden`	Das Token oder der Benutzer darf dies nicht (z. B. eine Änderung mit einem `read`-Token oder ein Console-Endpunkt, der mit einem Token aufgerufen wird).
403	`limit_exceeded`	Ein Limit der Organisation ist erreicht. `details`: `resource`, `limit`.
403	`account_suspended`	Das Konto ist gesperrt, z. B. weil das Guthaben negativ geblieben ist.
403	`email_not_verified`	Bestätigen Sie zuerst Ihre E-Mail-Adresse.
404	`not_found`	Die Ressource existiert in diesem Projekt nicht.
405	`method_not_allowed`	Der Endpunkt unterstützt diese HTTP-Methode nicht.
409	`resource_busy`	Auf der Ressource läuft bereits eine andere Aktion. Versuchen Sie es erneut, wenn sie abgeschlossen ist.
409	`protected`	Für die Ressource ist der Löschschutz aktiv. Deaktivieren Sie ihn zuerst.
409	`uniqueness_error`	Eine Ressource mit diesem Namen existiert bereits.
409	`resource_in_use`	Die Ressource wird noch verwendet, z. B. ein Netzwerk mit angebundenen Servern oder eine angewendete Firewall.
409	`limit_exceeded`	Bei einem Typwechsel eines Load Balancers: Die Services oder Ziele passen nicht in den kleineren Typ.
409	verschiedene	Die Ressource ist nicht im passenden Zustand, z. B. `server_not_stopped`, `server_not_running`, `volume_attached`, `not_assigned`.
429	`rate_limit_exceeded`	Zu viele Anfragen. Warten Sie `Retry-After` Sekunden. Siehe Ratenbegrenzung.
500	`internal_error`	Bei uns ist etwas schiefgelaufen. Versuchen Sie es später erneut; wenden Sie sich an den Support, wenn der Fehler bestehen bleibt.
503	`resource_unavailable`	Der Standort hat keine Kapazität oder wird gewartet, oder die Funktion ist dort gerade nicht verfügbar.

Fehler einer fehlgeschlagenen Aktion verwenden dieselben Felder code und message im error-Objekt der Aktion.

Häufige CodesLink zum Abschnitt kopieren

Auf dieser Seite

Häufige Codes