Ga naar inhoud

Een site back-uppen en herstellen

SuperSpace maakt automatisch volgens een schema een back-up van elke site, maar je kunt ook op elk moment zelf een back-up maken — bijvoorbeeld vlak voordat je een plugin of thema bijwerkt. Deze handleiding laat zien hoe je een back-up op aanvraag maakt, een site herstelt vanaf een willekeurige back-up en een back-uparchief naar je computer downloadt, allemaal vanuit het dashboard.

Elke site bestaat uit een of meer volumes (bijvoorbeeld je WordPress-bestanden en je database), en back-ups worden per volume beheerd. Je ziet een kaart voor elk volume op de pagina Backups.

Automatische versus handmatige back-ups

Geplande back-ups draaien vanzelf en zijn gemarkeerd met een kalenderpictogram (Automatic scheduled backup). Back-ups die je zelf maakt, zijn gemarkeerd met een persoonspictogram (Manual on-demand backup). Beide verschijnen in dezelfde lijst en kunnen op dezelfde manier worden hersteld of gedownload. Voor hoe planning en bewaartermijn werken, zie Back-ups.

Voordat je begint

  • Toestemming om de site te bewerken (alleen-lezen-toegang kan geen back-ups maken, herstellen, verwijderen of downloaden).
  • Je kunt worden gevraagd om je wachtwoord opnieuw in te voeren (je identiteit bevestigen) vóór een back-up-, herstel- of downloadactie — dit zijn beschermde acties.
  • Back-ups zijn niet beschikbaar op proef-accounts. Als je account nog op een proefperiode staat, word je gevraagd om eerst je account volledig in te stellen.

De pagina Backups vinden

  1. Open in de linkerzijbalk Mijn sites en selecteer de site waarvan je een back-up wilt maken.

  2. Open in de linkerzijbalk van de site de dropdown My Site en kies Backups.

  3. Je komt terecht op de pagina Backup & Volume Management. Elk volume toont een kaart met de Current Data Usage, Backup Count, Backup Usage en Backup Schedule, gevolgd door een lijst met de back-ups van dat volume.

Een back-up op aanvraag maken

  1. Klik op de kaart van het volume op Take Backup.

  2. Typ in het dialoogvenster New Backup for {volume} (bijvoorbeeld New Backup for wordpress) optioneel een label in het veld Name this backup zodat je deze later kunt herkennen (bijvoorbeeld before plugin update). Het leeg laten is prima.

  3. Klik op Take Backup om te starten.

De back-up draait op de achtergrond. Je ziet een bericht Operation In Progress, en de nieuwe back-up verschijnt in de back-uplijst van het volume zodra deze klaar is. Hij is gemarkeerd met het persoonspictogram (Manual on-demand backup) en toont de naam die je hem hebt gegeven.

Het maken van een back-up is asynchroon en retourneert 202:

curl -X PATCH \
  -H "Authorization: Bearer $SUPERSPACE_TOKEN" \
  -H "X-Auth-Account: $ACCOUNT_ID" \
  -d "name=before plugin update" \
  https://control.superspace.nl/api/sites/$SITE_ID/backups/$VOLUME_ID

Haal de volume-ID's op met GET /api/sites/$SITE_ID/backups, en poll vervolgens de taken van de site totdat de taak is voltooid. Zie Sites API voor de volledige vorm van de aanvraag en het antwoord.

Een site herstellen vanaf een back-up

Bij herstellen wordt de huidige inhoud van een volume vervangen door de inhoud van de back-up die je kiest.

Herstellen overschrijft je huidige gegevens

Wanneer je herstelt, worden alle bestaande gegevens in dat volume overschreven met de back-up. Alles wat sinds die back-up is gemaakt of gewijzigd, gaat verloren. Als je het niet zeker weet, maak dan eerst een nieuwe back-up zodat je kunt terugkeren naar de huidige staat.

  1. Zoek op de pagina Backups de back-up die je wilt in de lijst van het volume.

  2. Klik op het menu ⋮ (meer acties) aan het einde van de rij van die back-up en kies vervolgens Restore.

  3. Lees het bevestigingsdialoogvenster — het noemt de back-up en de datum ervan en waarschuwt dat het volume wordt overschreven — klik dan op Restore om te bevestigen.

Het herstellen draait op de achtergrond en toont een bericht Operation In Progress. Je site weerspiegelt de herstelde gegevens zodra het klaar is.

Herstellen is asynchroon en retourneert 202:

curl -X PATCH \
  -H "Authorization: Bearer $SUPERSPACE_TOKEN" \
  -H "X-Auth-Account: $ACCOUNT_ID" \
  -d "backup_id=$BACKUP_ID" \
  https://control.superspace.nl/api/sites/$SITE_ID/restores/$VOLUME_ID

Poll vervolgens de taken van de site totdat het herstellen is voltooid. Zie Sites API.

Een back-uparchief downloaden

Je kunt een kopie van elke back-up downloaden om buiten het platform te bewaren. SuperSpace bereidt het archief op de achtergrond voor en geeft je een tijdelijke, in tijd beperkte downloadlink.

  1. Zoek op de pagina Backups de back-up die je wilt en klik op Request download in zijn rij (er staat Request again als je die back-up eerder hebt gedownload).

  2. De knop verandert in Preparing… terwijl SuperSpace het archief bouwt. Er wordt per volume slechts één download tegelijk voorbereid, dus andere back-ups op hetzelfde volume zijn kort niet beschikbaar totdat het klaar is.

  3. Wanneer het archief klaar is, stuurt SuperSpace je een e-mail, en de rij toont een Download-link (met de bestandsgrootte ernaast). Klik erop om te downloaden. De link is tijdelijk — als deze verloopt, klik dan op Request again om een nieuwe te genereren.

Tip

Als het voorbereiden lijkt vast te lopen, verschijnt na een korte wachttijd een optie Still preparing — refresh zodat je de pagina opnieuw kunt laden en nog eens kunt controleren. Als het voorbereiden mislukt, toont de rij Download failed met een knop Try again.

Het voorbereiden van een export is asynchroon. Vraag het aan met POST, wat 202 retourneert:

curl -X POST \
  -H "Authorization: Bearer $SUPERSPACE_TOKEN" \
  -H "X-Auth-Account: $ACCOUNT_ID" \
  -d "backup_id=$BACKUP_ID" \
  https://control.superspace.nl/api/sites/$SITE_ID/backups/$VOLUME_ID/export

Poll vervolgens het status-endpoint totdat de export klaar is:

curl \
  -H "Authorization: Bearer $SUPERSPACE_TOKEN" \
  -H "X-Auth-Account: $ACCOUNT_ID" \
  "https://control.superspace.nl/api/sites/$SITE_ID/backups/$VOLUME_ID/export?backup_id=$BACKUP_ID"

Het antwoord bevat een status (none, in_progress, ready, expired of failed). Wanneer de status ready is, bevat de body ook een kortlevende, presigned download-url, een expires_at-timestamp en de archief-size in bytes. Beide endpoints vereisen de scope sites:write. Zie Sites API voor de volledige vorm van de aanvraag en het antwoord.

Een back-up verwijderen

  1. Open op de pagina Backups het menu ⋮ (meer acties) voor de back-up die je wilt verwijderen en kies vervolgens Delete.

  2. Bevestig in het dialoogvenster door op Delete Backup te klikken. De back-up wordt op de achtergrond verwijderd.

Warning

Het verwijderen van een back-up is permanent — zodra deze weg is, kun je er niet meer van herstellen of downloaden.

Volgende stappen

  • Leer hoe planning en bewaartermijn werken in Back-ups
  • Maak een handmatige back-up vóór een grote plugin-, thema- of core-update
  • Bewaar een kopie buiten het platform van belangrijke back-ups door het archief te downloaden