Méthode import (objet vol)

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

Méthode import (objet vol)

Description

Importe un volume à partir d'un fichier de conteneur sur /vol/_impex/.

Syntaxe

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

Arguments

app

Nom de l'application ou du domaine sur lequel héberger le nouveau volume.

vol

Nom du nouveau volume

target

Nom du fichier de conteneur à partir duquel importer le volume.

Récupère les données de volume du fichier situé à la racine du volume d'importation/d'exportation sur la grille spécifiée : /vol/_impex/. Attend des données compressées au format gzip si l'extension de nom de fichier .gz est spécifiée.

vdc

Nom du centre de données virtuel cible

Type de transaction

Asynchrone

Type de requête

GET

Exemples

Importation du volume test2:vol2 à partir du fichier de conteneur compressé

/vol/_impex/test.img.gz.

GET

http://192.168.123.200/api/v2/vol/import?app=test2&vol=vol2&target=test.img.gz&vdc=mygrid

Exemple de sortie

XML


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

JSON


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

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

Méthode migrate (objet vol)

Description

Migre les volumes entre des grilles aux architectures différentes.

Syntaxe

/api/v2/vol/migrate?remote_grid=grid_name&name=volume&local_ip=ip_address &remote_ip=ip_address&vdc=controller-name

Arguments

remote grid

Nom de la grille vers laquelle importer le volume, ou l'exporter lorsque l'indicateur d'option &export est spécifié.

name

Nom du volume à migrer Format de la valeur :

<application>:<volume>,_GLOBAL:<volume> ou _GLOBAL_RO:<volume>

local_ip

Adresse IP libre sur la grille locale utilisée par l'application de migration.

Format de la valeur :

[_vlan.][<vlan id>.]<ip address>
net.<networkName>.<ip_address>

remote_ip

Adresse IP libre sur la grille distante utilisée par l'application de migration.

Format de la valeur :

[_vlan.][<vlan id>.]<ip address>
net.<networkName>.<ip_address>

vdc

Nom du centre de données virtuel cible

Options

nom_contrôleur

Nouveau nom du volume. Format de la valeur :

<application>:<volume>,_GLOBAL:<volume> ou _GLOBAL_RO:<volume>

migrating_class

Classe à utiliser pour la création de l'application de migrateur. Cette classe doit résider dans un catalogue global. La valeur par défaut est /filer:Filer_Linux_ADMI.

encr_key

Spécifie le nom d'un volume contenant des clés de chiffrement fixes à fournir aux applications effectuant la migration de volume.

<prop>=<val>

Paramètres de volume

Les attributs de volume sont récupérés à partir du volume en cours de migration. Les paramètres suivants peuvent être utilisés pour remplacer les valeurs actuelles à partir des volumes en cours de migration. Soyez très prudent lorsque vous réduisez les tailles de volumes ou de partitions.

Paramètre de volume	Description
- fs	Type de système de fichiers. Par exemple : ext3
- size	Taille de volume. Vous pouvez spécifier les unités. Par exemple : 128 M[o], 2 G[o]. Par défaut, la valeur est interprétée en nombre de mégaoctets.
- comment	Commentaire sur le volume
- fs options	Options de système de fichiers supplémentaires utilisées pour formater le volume.
- mirrored	Le volume est mis en miroir.
- parN.	Paramètres de partitionnement (facultatifs). Pour plus d'informations, reportez-vous aux remarques.

&export: Migre le volume vers la grille distante (par défaut), et requiert une relation d'approbation bidirectionnelle entre les deux grilles.
&import: Migre le volume à partir de la grille distante (par défaut).