Passer au contenu principal
POST
Restaurer un snapshot d'application
Cette route a une limite de débit de 1 requête toutes les 60 secondes.
string
requis
La clé d’API de votre compte. Vous pouvez la trouver dans les paramètres de votre compte.
Nécessite une clé API avec le scope snapshots:write. Restaurer un snapshot ramène le stockage d’une application à un snapshot précédent, en remplaçant ses fichiers actuels par ceux capturés au moment du snapshot. Utilisez cet endpoint pour récupérer après un déploiement défectueux ou une suppression accidentelle. Récupérez les valeurs snapshotId et versionId depuis Lister les snapshots : ce ne sont pas des valeurs que vous construisez vous-même. snapshotId est le name du snapshot tel que le renvoie Lister les snapshots (l’ID de l’application, éventuellement suffixé par _<runtime> et _<origin>), et versionId doit correspondre au format de clé de version S3 ; les valeurs mal formées sont rejetées avant que la restauration ne soit lancée. La restauration arrête l’application, remplace ses fichiers par ceux du snapshot et la redémarre, il n’est donc pas nécessaire de la redémarrer ensuite. Pendant son exécution (jusqu’à environ 2 minutes), démarrer, arrêter, redémarrer et supprimer répondent 403 RESTORE_IN_PROGRESS. Les snapshots (et donc les restaurations) ne sont disponibles qu’avec un plan actif. Sur les applications partagées en espace de travail, l’appelant doit disposer du rôle admin.

Paramètres

string
requis
L’ID de l’application. Vous pouvez le trouver dans l’URL du tableau de bord de votre application.
string
requis
Le name du snapshot dans la liste (l’ID de l’application, éventuellement suffixé par _<runtime> et _<origin>), transmis exactement tel que renvoyé.
string
requis
Le version_id du snapshot, tel que Lister les snapshots le renvoie.

Réponse

string
Indique si l’appel a réussi : success si c’est le cas, error sinon.

Erreurs courantes

Voir aussi