Skip to main content
POST
Snapshot einer Anwendung wiederherstellen
Diese Route hat ein Rate-Limit von 1 Anfrage alle 60 Sekunden.
string
erforderlich
Der API-Schlüssel für dein Konto. Du findest ihn in deinen Kontoeinstellungen.
Erfordert einen API-Schlüssel mit dem Scope snapshots:write. Snapshot wiederherstellen setzt den Speicher einer Anwendung auf einen früheren Snapshot zurück und ersetzt die aktuellen Dateien durch die zum Zeitpunkt des Snapshots erfassten. Nutze es, um dich von einem fehlgeschlagenen Deploy oder einer versehentlichen Löschung zu erholen. Die Werte für snapshotId und versionId erhältst du über Snapshots auflisten, sie sind nicht etwas, das du selbst zusammensetzt. snapshotId ist der name des Snapshots genau so, wie Snapshots auflisten ihn zurückgibt (die Anwendungs-ID, optional mit den Suffixen _<runtime> und _<origin>), und versionId muss dem S3-Versionsschlüssel-Format entsprechen; fehlerhafte Werte werden abgelehnt, bevor die Wiederherstellung ausgelöst wird. Das Wiederherstellen startet die Anwendung nicht selbst neu, führe danach Anwendung neu starten aus, falls der laufende Prozess die wiederhergestellten Dateien übernehmen soll. Snapshots (und damit auch Wiederherstellungen) sind nur mit einem aktiven Plan verfügbar. Bei Workspace-geteilten Anwendungen benötigt der Aufrufer die Rolle admin.

Parameter

string
erforderlich
Die ID der Anwendung. Du findest sie in der URL des Dashboards deiner Anwendung.
string
erforderlich
Der name des Snapshots aus der Auflistung (die Anwendungs-ID, optional mit den Suffixen _<runtime> und _<origin>), genau so übergeben, wie er zurückgegeben wurde.
string
erforderlich
Die version_id des Snapshots, wie Snapshots auflisten sie zurückgibt.

Antwort

string
Gibt an, ob der Aufruf erfolgreich war: success, wenn ja, error, wenn nicht.

Häufige Fehler

Siehe auch