Datenbank – Snapshots
Snapshot erstellen
Erstellt einen Snapshot deiner Datenbank. Es gilt ein Rate-Limit von 1 Anfrage alle 5 Sekunden.
POST
Snapshot erstellen
Der API-Schlüssel für Ihr Konto. Sie finden ihn in Ihren Kontoeinstellungen.
Parameter
Die ID der Datenbank.
Verhalten der Soft Deadline
Diese Route folgt einem Soft-Deadline-Modell — sie antwortet nicht mehr immer synchron.- Wenn der Snapshot innerhalb von ~90 Sekunden fertiggestellt wird, antwortet die Route wie bisher mit
200 successund einer signierten Download-URL (30 Tage gültig). - Wenn die Erstellung des Snapshots länger als ~90 Sekunden dauert, antwortet die Route sofort mit
202und dem CodeSNAPSHOT_PROCESSING. Das ist kein Fehler. Der Snapshot wird im Hintergrund weiter erstellt und erscheint von selbst in der Snapshot-Auflistung, in der Regel innerhalb von ~2 Minuten. Bei großen Datenbanken ist das erwartetes Verhalten.
| Antwort | Bedeutung | Was zu tun ist |
|---|---|---|
status === "success" | Snapshot ist bereit. | Verwende die url, um ihn herunterzuladen. |
status === "error" und code === "SNAPSHOT_PROCESSING" | Snapshot wird noch erstellt. | Warte ~2 Minuten und bestätige dann über List Snapshots (GET). Führe kein erneutes POST aus. |
status === "error" mit einem anderen code | Tatsächlicher Fehler. | Behandle den Fehler (siehe unten). |
Antwort
Gibt an, ob der Aufruf erfolgreich war.
success bei Erfolg, error andernfalls.Der Inhalt der Antwort. Nur vorhanden, wenn
status gleich success ist.Wird zurückgegeben, wenn der Snapshot die Soft Deadline von ~90 Sekunden überschreitet. Der Snapshot wird im Hintergrund weiter erstellt und erscheint von selbst in der Snapshot-Auflistung, in der Regel innerhalb von ~2 Minuten. Kein Fehler — warte und bestätige über den
GET-Auflistungs-Endpoint.Fehler
Eine Snapshot-Anfrage kann mit429 Too Many Requests abgelehnt werden. Verwende das Feld code, um die beiden Fälle zu unterscheiden:
Kurzfristige Abkühlphase — du hast das Limit pro Benutzer (1 Anfrage / 5s) oder pro Datenbank (1 Anfrage / 180s) erreicht. Warte kurz und versuche es erneut.
Tageskontingent erreicht — der Account hat sein tägliches Snapshot-Kontingent des Plans aufgebraucht ((RAM / 256) × 2 pro 24h). Das Kontingent wird frei, während das gleitende 24-Stunden-Fenster fortschreitet; für ein höheres Tageskontingent aktualisiere den Plan.
Snapshot erstellen

