Manuels d'intégration › Manuel de référence de l'API de service Web › Objets valides › Objet vol › Méthode export (objet vol)

Méthode export (objet vol)

Description

Exporte un volume vers un fichier de conteneur sur /vol/_impex/.

Syntaxe

/api/v2/vol/export?app=application&vol=volume&target=filename.img.gz&vdc=controller-name 

Arguments

app

Nom de l'application ou du domaine hébergeant le volume

vol

Nom du volume

target

Nom du fichier de conteneur vers lequel exporter le volume.

Crée le fichier à la racine du volume d'importation/d'exportation de la grille : /vol/_impex/. Compresse également le fichier à l'aide de gzip, si vous spécifiez .gz comme extension de nom de fichier.

vdc

Nom du centre de données virtuel cible

Type de transaction

Asynchrone

Type de requête

GET

Exemples

Exportation du volume test1:vol1 vers le fichier de conteneur compressé /vol/_impex/test.img.gz.

GET http://192.168.123.200/api/v2/vol/export?app=test1&vol=vol1&target=test.img.gz&vdc=mygrid

Exemple de sortie

XML

<job>bdc176a5-c069-4b23-89d2-d933127a9765</job> 

JSON

{
   "job" : "bdc176a5-c069-4b23-89d2-d933127a9765"
} 

Codes d'erreur HTTP

404

Entity vdc mygrid not found - A VDC name was specified that is not configured in the WS_API application (l'entité vdc mygrid est introuvable. Le nom de VDC spécifié n'est pas configuré dans l'application WS_API).

400.4

Missing required arguments (app). - La requête ne contient pas l'argument app=application.

400.4

Missing required arguments (vol). - La requête ne contient pas l'argument vol=volume.

400.4

Missing required arguments (acl). - Argument target=filename missing in the request (la demande ne contient pas l'argument target=nom_fichier).

Remarque : Pour obtenir le statut du job, exécutez une requête /api/v2/job/info? avec comme argument le job_id renvoyé plus haut. Pour plus d'informations sur la manière d'obtenir le statut du job, reportez-vous à l'objet job.