Zugang anfragen

Fehler und Rate Limits

Alle Fehlercodes der Node Lodge API, ihre Bedeutung und was zu tun ist, sowie die Request-Limits pro Minute und pro Stunde.

Jeder Fehler hat dieselbe Form. Der HTTP-Status gibt die Art des Fehlers an, code den konkreten Fehler.

{
  "error": {
    "code": "RATE_LIMITED",
    "message": "Too many requests. Retry in a moment.",
    "reference": "7F3K-92QD"
  }
}
  • code: stabil, sicher für Verzweigungen im Code.
  • message: ein Satz für Menschen. Er kann sich ändern.
  • reference: Nennen Sie ihn dem Support, um den Request zu finden.
  • fields: nur bei VALIDATION_ERROR, die fehlerhaften Felder, jeweils mit path und message.

Fehlercodes

Request

Code Status Bedeutung Was zu tun ist
VALIDATION_ERROR 400 Ein Feld, die Query oder der JSON-Body ist ungültig. Korrigieren Sie die in fields genannten Felder.
AMBIGUOUS_CREDENTIALS 400 Der Request enthält sowohl ein Sitzungscookie der Konsole als auch einen API-Schlüssel. Senden Sie nur eines von beiden.
PAYLOAD_TOO_LARGE 413 Der Body ist größer als 64 KiB. Senden Sie einen kleineren Body.
IDEMPOTENCY_MISMATCH 422 Der Idempotency-Key wurde bereits mit einem anderen Body verwendet. Verwenden Sie für einen neuen Request einen neuen Schlüssel.

Authentifizierung und Zugriff

Code Status Bedeutung Was zu tun ist
UNAUTHENTICATED 401 Keine gültige Sitzung und kein gültiger API-Schlüssel. Prüfen Sie den Header Authorization: Bearer oder erstellen Sie einen neuen Schlüssel.
FORBIDDEN 403 Ihre Rolle oder der Eigentümer der Ressource erlaubt diese Aktion nicht. Wenden Sie sich an einen Owner oder Admin der Organisation.
API_KEY_NOT_ALLOWED 403 API-Schlüssel können diese Route nicht aufrufen, oder dem Schlüssel fehlt der Scope. Vergeben Sie den Scope an einen neuen Schlüssel oder nutzen Sie die Konsole. Siehe Was ein Schlüssel aufrufen kann.
EMAIL_NOT_VERIFIED 403 Die E-Mail-Adresse des Kontos ist nicht bestätigt. Öffnen Sie den Bestätigungslink aus Ihrem Posteingang.
TERMS_REQUIRED 403 Die geltenden Nutzungsbedingungen sind nicht akzeptiert. Akzeptieren Sie sie in der Konsole.
MFA_REQUIRED 403 Die Aktion erfordert aktivierte Zwei-Faktor-Authentifizierung. Aktivieren Sie sie unter Settings.
STEP_UP_REQUIRED 403 Die Aktion erfordert einen Zwei-Faktor-Code aus den letzten 10 Minuten. Geben Sie einen neuen Code ein und wiederholen Sie den Vorgang.
MFA_CODE_INVALID 400 Der Zwei-Faktor-Code ist falsch oder abgelaufen. Geben Sie den gültigen Code ein.
TOKEN_INVALID 400 Ein E-Mail-Link ist ungültig oder abgelaufen. Fordern Sie einen neuen Link an.
ACCOUNT_THROTTLED 429 Zu viele fehlgeschlagene Anmeldungen oder Zwei-Faktor-Codes innerhalb von 15 Minuten. Warten Sie 15 Minuten.

Sitzungen, Guthaben und Limits

Code Status Bedeutung Was zu tun ist
CREDIT_INSUFFICIENT 402 Das Budget ist höher als das verfügbare Guthaben. Laden Sie Guthaben auf oder senken Sie das Budget.
FUNDS_INSUFFICIENT 402 Die verfügbaren Mittel decken die Buchung nicht. Laden Sie Guthaben auf oder buchen Sie eine kürzere Dauer.
ACCOUNT_BLOCKED 402 Eine Zahlung ist fehlgeschlagen oder wurde rückgebucht, daher sind neue Sitzungen gesperrt. Siehe Zahlung abgelehnt.
TRUST_LIMIT 403 Die Sitzung überschreitet Ihre Kontolimits. Stoppen Sie eine Sitzung, wählen Sie eine andere GPU-Klasse oder beantragen Sie ein höheres Limit.
API_KEY_LIMIT 409 Das Budget der Sitzung, seine Erhöhung oder die Buchung überschreitet ein Ausgabenlimit des API-Schlüssels. Senken Sie das Budget oder erhöhen Sie die Limits des Schlüssels mit Edit limits. Siehe Ausgabenlimits.
API_KEY_INVALID 409 Der Schlüssel, der die Sitzung gebucht hat, ist nicht mehr gültig. Verwenden Sie einen gültigen Schlüssel.
MAX_COST_EXCEEDED 409 Die Buchung kostet mehr als das von Ihnen gesendete Maximum. Erhöhen Sie das Maximum oder buchen Sie weniger Zeit.
BUDGET_EXCEEDED 409 Die Sitzung überschreitet das Ausgabenlimit, das für dieses Angebot gilt. Senken Sie das Budget oder wählen Sie ein anderes Angebot.
RESOURCE_UNAVAILABLE 409 Die Maschine ist offline gegangen oder wurde gerade vermietet. Wählen Sie ein anderes Angebot.
PARTNER_UNAVAILABLE 409 Das Angebot hat sich geändert oder existiert nicht mehr. Laden Sie den Katalog neu und wählen Sie erneut.
SESSION_REQUIRED 409 Rechenzentrumsmaschinen starten als Sitzungen, mit einem Budget. Starten Sie sie mit POST /v1/sessions.
RESERVATION_REQUIRED 409 Rechenzentrumsmaschinen werden auf diesem Konto als Buchungen gebucht. Buchen Sie sie mit POST /v1/reservations und starten Sie sie dann.
INVALID_STATE 409 Die Sitzung ist in einem Zustand, der dies nicht erlaubt, zum Beispiel bereits beendet. Lesen Sie die Sitzung und handeln Sie gemäß ihrem Status.
CONFLICT 409 Die Ressource existiert bereits, oder derselbe Request läuft noch. Lesen Sie die Ressource, oder warten Sie und wiederholen Sie den Request.
NOT_FOUND 404 Die Ressource existiert nicht oder gehört nicht Ihnen. Prüfen Sie die ID.

Limits und Server

Code Status Bedeutung Was zu tun ist
RATE_LIMITED 429 Zu viele Requests. Warten Sie die in retry-after genannten Sekunden ab und wiederholen Sie dann.
INTERNAL_ERROR 500 Der Request ist auf dem Server fehlgeschlagen. Wiederholen Sie ihn. Bleibt der Fehler bestehen, senden Sie die reference an den Support.

Rate Limits

Limits zählen Requests pro Zeitfenster. Mit API-Schlüssel zählt das allgemeine Limit pro Schlüssel, ohne Schlüssel pro IP-Adresse.

Requests Limit
Jede API-Route, sofern unten nicht aufgeführt 300 je Minute
Registrierung und Anmeldung 10 je Minute
Zwei-Faktor-Codes 10 je Minute
Anfrage zum Zurücksetzen des Passworts 5 in 15 Minuten
API-Schlüssel: Erstellen oder Limits ändern 30 je Stunde
SSH-Schlüssel: Hinzufügen 30 je Stunde
Änderungen an Karte, Guthaben und automatischem Aufladen 20 je Stunde und Aktion
Support: neue Anfrage 10 je Stunde
Support: Antworten, wieder öffnen, als gelöst markieren 30 je Stunde und Aktion
Öffentliche GPU-Verfügbarkeit 60 je Minute

Jede Antwort enthält den Stand ihres Limits:

  • x-ratelimit-limit: im Zeitfenster erlaubte Requests.
  • x-ratelimit-remaining: verbleibende Requests.
  • x-ratelimit-reset: Sekunden bis zum Zurücksetzen des Zeitfensters.

Oberhalb des Limits lautet die Antwort 429 RATE_LIMITED mit einem retry-after-Header in Sekunden. Warten Sie so lange und wiederholen Sie dann. Verlängern Sie den Backoff bei wiederholten 429-Antworten.

Sicher wiederholen

  • Wiederholen Sie bei 429, 500 und Netzwerkfehlern, nie bei 4xx-Fehlern, die ein Feld oder einen Zustand nennen.
  • Senden Sie beim Buchen oder Starten einen Idempotency-Key-Header (8 bis 128 Buchstaben, Ziffern, - oder _): Eine Wiederholung mit demselben Schlüssel und Body liefert das erste Ergebnis, statt doppelt zu buchen.

Zuletzt aktualisiert