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

Méthode copy (objet vol)

Description

Copie un volume.

Syntaxe

/api/v2/vol/copy?app=application&vol=volume&volnew=nouveau_volume&vdc=nom_contrôleur 

Arguments

app

Nom de l'application

vol

Nom du volume

volnew

Nom du nouveau volume

vdc

Nom du centre de données virtuel cible

Options

appnew

Nom de l'autre application sur laquelle copier le volume. Par défaut, le volume est copié sur l'application d'origine.

Type de transaction

Asynchrone

Type de requête

GET

Exemples

Pour copiez un volume test:vol1 vers test:vol2 :

GET http://192.168.123.200/api/v2/vol/copy?app=test&vol=vol1&volnew=vol2&vdc=mygrid 

Copiez un volume atest :vol1 vers btest :vol2.

http://192.168.123.200/api/v2/vol/copy?app=atest&vol=vol1&appnew=btest&volnew=vol2&vdc=mygrid 

Exemple de sortie

XML

<job>be805915-76b2-48c8-b8a0-b881cca66da6</job> 

JSON

{
   "job" : "be805915-76b2-48c8-b8a0-b881cca66da6"
} 

Codes d'erreur HTTP

404

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 (volnew). - La requête ne contient pas l'argument volnew=nouveau-volume.

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.