Volume aus einem Wiederherstellungspunkt wiederherstellen
Stellen Sie einen Wiederherstellungspunkt in ein neues Volume oder über das Quell-Volume wieder her – auf der Seite des Backup-Plans oder über die REST-API.
Stellen Sie jeweils nur einen Wiederherstellungspunkt eines Volumes wieder her: in ein neues Volume, wobei das Quell-Volume unverändert bleibt, oder über das Quell-Volume. Ein Plan sichert jedes seiner Volumes separat, daher bilden die Wiederherstellungspunkte verschiedener Volumes keinen über die Volumes hinweg konsistenten Satz.
Voraussetzungen
- Sie benötigen auf Abonnement- oder Projektebene die Rolle Besitzer oder Mitwirkender oder eine benutzerdefinierte Rolle mit der Zugriffsebene Verwalten für Block & Object Storage.
- Ihr Abonnement muss aktiv sein.
- Der Plan des Wiederherstellungspunkts muss noch existieren. Nachdem ein Plan gelöscht wurde, können seine Wiederherstellungspunkte weder in der Konsole noch über die REST-API wiederhergestellt werden.
- Eine Wiederherstellung in ein neues Volume erfordert eine Region, die Volumes in Block Storage anbietet, und das neue Volume wird auf das Kontingent des Abonnements und die Zuteilung des Projekts für Volumes und Volume Storage angerechnet.
In ein neues Volume wiederherstellen
Wechseln Sie in der Konsole zu SpeicherBackup-Center, und wählen Sie den Plan aus.
Wählen Sie die Registerkarte Volumes aus.
Wählen Sie in der Zeile des Volumes Wiederherstellungspunkte aus.
Suchen Sie in der Liste den Wiederherstellungspunkt anhand von Erfassungszeit, Typ, Größe, Ablauf und Status, und wählen Sie Wiederherstellen… aus.
Behalten Sie unter Wiederherstellungsziel die Option Neues Volume bei.
Behalten Sie im Feld Name des neuen Volumes den vorgeschlagenen Namen bei, also den Namen des Volumes gefolgt von -restored, oder geben Sie einen anderen Namen ein.
Wählen Sie Wiederherstellung starten aus.
Sie können die Wiederherstellungspunkte eines Volumes auch direkt öffnen: Wählen Sie im Backup Center auf der Registerkarte Schutzabdeckung im Zeilenmenü des Volumes Plan anzeigen aus, oder wählen Sie auf der Registerkarte Backups des Volumes Auf der Planseite wiederherstellen aus.
| Einstellung | Regeln |
|---|---|
| Name des neuen Volumes | 1 bis 255 Zeichen. Der Name darf nicht mit einem Leerzeichen beginnen oder enden und keine Zeilenumbrüche oder anderen Steuerzeichen oder Zeichen außerhalb der Basic Multilingual Plane enthalten. Er muss unter den Volumes des Projekts eindeutig sein. |
Ergebnis
Das neue Volume erscheint unter SpeicherVolumes mit dem Status Wird erstellt und erhält den Status Verfügbar, wenn die Wiederherstellung abgeschlossen ist. Es hat die Größe des Quell-Volumes. Das Quell-Volume ändert sich nicht und kann angehängt bleiben.
Um die Daten zu verwenden, hängen Sie das neue Volume an eine Instanz an. Siehe Volume anhängen und trennen.
Über das Quell-Volume wiederherstellen
Achtung
Eine Wiederherstellung über das Quell-Volume ersetzt alle seine Daten durch die Daten des Wiederherstellungspunkts. Alles, was nach der Erfassung des Wiederherstellungspunkts auf das Volume geschrieben wurde, geht verloren, und Sie können die Wiederherstellung nicht rückgängig machen.
Trennen Sie das Volume von seiner Instanz, und warten Sie, bis sein Status Verfügbar lautet. Siehe Volume anhängen und trennen.
Öffnen Sie die Wiederherstellungspunkte des Volumes wie oben beschrieben, und wählen Sie beim Wiederherstellungspunkt Wiederherstellen… aus.
Wählen Sie unter Wiederherstellungsziel die Option Über das Quell-Volume aus.
Wählen Sie Wiederherstellung starten aus.
Die Wiederherstellung trennt das Volume nicht für Sie: Solange das Volume nicht den Status Verfügbar hat, zeigt die Konsole eine Warnung an und startet die Wiederherstellung nicht. Das Volume behält seine ID und seinen Namen.
Das Boot-Volume einer Instanz kann nicht getrennt werden, solange die Instanz existiert; stellen Sie ein Boot-Volume daher stattdessen in ein neues Volume wieder her.
Über die API wiederherstellen
Die Seite des Plans listet Wiederherstellungspunkte nur für die Volumes auf, die dem Plan zugewiesen sind. Um einen Wiederherstellungspunkt eines Volumes wiederherzustellen, das Sie aus dem Plan entfernt haben oder das gelöscht wurde, verwenden Sie die REST-API. Sie benötigen in der Umgebungsvariablen PC_TOKEN ein API-Token mit dem Bereich storage:read, um Wiederherstellungspunkte aufzulisten, und dem Bereich storage:write, um wiederherzustellen.
Ermitteln Sie die ID des Plans unter Plan-ID auf der Seite des Plans und die ID des Volumes, die die Laufergebnisse des Plans neben dem Namen des Volumes anzeigen. Siehe Ergebnisse pro Volume.
Listen Sie die Wiederherstellungspunkte des Volumes auf:
curl "https://<api-host>/api/v1/scopes/<project-id>/storage/backup-plans/<plan-id>/volumes/<volume-id>/restore-points" \
-H "Authorization: Bearer $PC_TOKEN"Die Antwort listet die Wiederherstellungspunkte in data auf, die neuesten zuerst, jeweils mit id, kind, status, sizeGb, protectedAt und expiresAt.
Stellen Sie einen davon in ein neues Volume wieder her:
curl -X POST "https://<api-host>/api/v1/scopes/<project-id>/storage/backup-plans/<plan-id>/volumes/<volume-id>/restore-points/<restore-point-id>/actions/restore" \
-H "Authorization: Bearer $PC_TOKEN" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{"target":"new","name":"<new-volume-name>"}'<api-host>: der Hostname der API. Siehe URL-Struktur.<project-id>: die ID des Projekts. Siehe ID eines Projekts ermitteln.<plan-id>,<volume-id>,<restore-point-id>: die IDs aus den vorherigen Schritten.<new-volume-name>: der Name des neuen Volumes. Wenn Sienameweglassen, erhält das Volume den Namen des Quell-Volumes, gefolgt von-restored.
Die Anfrage gibt 202 Accepted mit einem Vorgang zurück, der die Wiederherstellung verfolgt. Die Anfrageformate finden Sie unter GET/scopes/{scopeId}/storage/backup-plans/{planId}/volumes/{volumeId}/restore-points und POST/scopes/{scopeId}/storage/backup-plans/{planId}/volumes/{volumeId}/restore-points/{restorePointId}/actions/restore. Nachdem der Plan gelöscht wurde, geben beide Anfragen 404 Not Found zurück.
Wiederherstellung verfolgen
Eine Wiederherstellung läuft im Hintergrund. Wenn die Anfrage abgelehnt wird, bevor das Kopieren beginnt, z. B. weil ein anderes Volume den Namen hat, zeigt die Registerkarte Aktivität des Plans den fehlgeschlagenen Vorgang und seinen Grund an. Wenn das Kopieren fehlschlägt, wechselt das Ziel-Volume zum Status Fehler: das neue Volume oder, bei einer Wiederherstellung über das Quell-Volume, das Quell-Volume.
Problembehandlung
| Symptom | Ursache | Lösung |
|---|---|---|
| Das Überschreiben erfordert ein getrenntes, abgeschlossenes Volume. „<volume>“ ist <status> — stellen Sie stattdessen in ein neues Volume wieder her. | Das Quell-Volume ist angehängt oder nicht in einem stabilen Zustand. | Trennen Sie das Volume, und warten Sie, bis es den Status Verfügbar hat, oder stellen Sie in ein neues Volume wieder her. |
| Die Registerkarte Aktivität des Plans zeigt „a volume named '<name>' already exists in this scope; choose another name for the restored volume“ | Ein anderes Volume im Projekt hat den Namen. | Starten Sie die Wiederherstellung mit einem anderen Namen erneut. |
| Das neue Volume oder das Quell-Volume nach einer Wiederherstellung darüber hat den Status Fehler | Das Kopieren des Wiederherstellungspunkts ist fehlgeschlagen. | Stellen Sie den Wiederherstellungspunkt in ein neues Volume wieder her, oder stellen Sie einen anderen Wiederherstellungspunkt wieder her. Löschen Sie ein fehlgeschlagenes neues Volume, wenn Sie es nicht mehr benötigen. |
| Wiederherstellung in „<name>“ konnte nicht gestartet werden oder Wiederherstellung von „<volume>“ konnte nicht gestartet werden | Die Anfrage wurde abgelehnt, z. B. weil das Abonnement pausiert ist. | Starten Sie die Wiederherstellung erneut, nachdem das Abonnement fortgesetzt wurde. |