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

Méthode format (objet vol)

Description

Formate un volume existant.

Syntaxe

/api/v2/vol/format?app=application&vol=volume&fs=filesystem&vdc=controller-name 

Arguments

app

Nom de l'application

vol

Nom du volume

fs

Système de fichiers du volume à créer

vdc

Nom du centre de données virtuel cible

Type de transaction

Asynchrone

Type de requête

GET

Exemples

Pour formater un volume test:vol1 avec le système de fichiers fs=ext3 :

GET http://192.168.123.200/api/v2/vol/format?app=test&vol=vol1&fs=ext3&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 (fs). - La requête ne contient pas l'argument fs=système-fichiers.

Remarque : Cette opération efface toutes les données présentes sur le volume. 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.