Rubrique précédente: Méthode migrate_status (objet vol)Rubrique suivante: Méthode fscheck (objet vol)


Méthode move (objet vol)
Description

Déplace un volume vers un emplacement alternatif.

Syntaxe

/api/v2/vol/move?app=application&vol=volume&volnew=new-volume-location&vdc=controller-name

Arguments
app

Nom de l'application source.

vol

Nom du volume

volnew

Nouvel emplacement du volume, au format <application>:<nom_volume>

vdc

Nom du centre de données virtuel cible

Type de transaction

Asynchrone

Type de requête

GET

Exemples

Copie d'un volume atest :vol1 vers btest :vol2

GET http://192.168.123.200/api/v2/vol/move?app=atest&vol=vol1&volnew=btest: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

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 (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 page 308.

Méthode relocate (objet vol)
Description

Déplace des volumes vers un référentiel de volumes différent (local ou san) ou vers des serveurs activés.

Syntaxe
/api/v2/vol/relocate?app=application&name=app-or-volume&vdc=controller-name
Arguments
name

Nom du volume à déplacer

vdc

Nom du centre de données virtuel cible

Options
store

Spécifie le référentiel de volumes vers lequel le volume doit être déplacé. La valeur peut être san ou local.

n

Spécifie le nombre de volumes à déplacer simultanément. Valeur par défaut : un volume à la fois

&all

Déplace tous les volumes qui doivent être déplacés.

&status

Répertorie les volumes qui doivent être déplacés ou renvoie le statut de déplacement d'un volume.

&suspend

Suspend les déplacements de volume en cours.

Type de transaction

Asynchrone

Type de requête

GET

Exemples

Déplacement d'un volume virtuel d'application MYAPP:data vers un référentiel local :

GET http://aux/api/v2/vol/relocate?name=MYAPP:data&store=local&vdc=mygrid

Déplacement de tous les volumes de l'application MYAPP vers un SAN :

GET http://aux/api/v2/vol/relocate?name=MYAPP&store=san&vdc=mygrid

Déplacement de tous les volumes des serveurs désactivés, trois par trois :

GET http://aux/api/v2/vol/relocate?&all&n=3&vdc=mygrid

Exemple de sortie
XML
 <job>b88969ea-9264-40b2-ba08-29b7ecbcc150</job>
JSON
{
   "job" : "b88969ea-9264-40b2-ba08-29b7ecbcc150"
}
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.

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.

Méthode relocate status (objet vol)
Description

Renvoie l'état des déplacements de volume en cours sur une grille.

Syntaxe
/api/v2/vol/relocate_status?&vdc=controller-name 
Arguments
vdc

Nom du centre de données virtuel cible

Type de transaction

Asynchrone

Type de requête

GET

Exemples

Vérification de la progression des déplacements de volume sur la grille mygrid :

GET http://aux/api/v2/vol/relocate_status?&vdc=mygrid 
Exemple de sortie
XML
<opt></opt>

JSON
{
   "message" : ""
}

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.