File Storage Service - Gestion des snapshots de partage

Base de connaissances

KB0075370

File Storage Service - Gestion des snapshots de partage


Icons/System/eye-open Created with Sketch. 11 vues 31.03.2026 File Storage

Objectif

Les snapshots permettent de sauvegarder l'état d'un partage de fichiers NFS à un instant précis. Ce guide explique comment répertorier, créer et supprimer des snapshots à l'aide de l'API OVHcloud (v1 /cloud routes), en garantissant la cohérence et la fiabilité opérationnelle.

Astuce : Reportez-vous à la console d'API OVHcloud pour obtenir des informations précises sur les opérations, les méthodes HTTP et les schémas de requête.

Prérequis

  • Un projet Public Cloud avec le service File Storage activé.
  • Un partage existant dans un état available.
  • Des identifiants API disposant des autorisations suffisantes pour gérer les partages et les snapshots.
  • Une compréhension des concepts clés de l'API : serviceName (ID de projet), regionName, shareId et snapshotId facultatif.

En pratique

Étape 1 : Identifier votre partage

Répertoriez tous les partages dans votre région cible pour trouver l'ID du partage :

GET /cloud/project/{serviceName}/region/{regionName}/share

Vérifiez que le partage est dans l'état available avant de créer des snapshots.

Étape 2 : Répertorier les snapshots existants

Récupérez tous les snapshots d'un partage donné :

GET /cloud/project/{serviceName}/region/{regionName}/share/{shareId}/snapshot

Utilisez la réponse pour obtenir les identifiants et les états des snapshots avant de les supprimer ou d'automatiser ces opérations.

Étape 3 : Créer un snapshot

Créez un snapshot avec une charge utile JSON spécifiant un nom lisible (et une description facultative) :

POST /cloud/project/{serviceName}/region/{regionName}/share/{shareId}/snapshot

  • Interrogez les points de terminaison list/detail jusqu'à ce que le snapshot atteigne l'état available.
  • Le temps de création d'un snapshot dépend de la capacité allouée, de l'activité d'E/S et de la charge de la plateforme.
  • Planifiez les snapshots pendant les périodes d'activité d'E/S faible pour garantir la cohérence.

Remarque : Les snapshots sont cohérents en cas de plantage sauf si votre application met explicitement en veille les écritures.

Étape 4 : Récupérer les détails d'un snapshot (facultatif)

Récupérez un seul snapshot par ID :

GET /cloud/project/{serviceName}/region/{regionName}/share/{shareId}/snapshot/{snapshotId}

Utilisez cet appel pour des vérifications automatisées après sauvegardes ou pour consulter les métadonnées du snapshot.

Étape 5 : Supprimer un snapshot

Libérez l'espace de stockage occupé par un snapshot :

DELETE /cloud/project/{serviceName}/region/{regionName}/share/{shareId}/snapshot/{snapshotId}

La suppression est irréversible. Assurez-vous que le snapshot n'est plus nécessaire.

Aller plus loin

Échangez avec notre communauté d'utilisateurs.

Articles associés