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

Méthode info (objet vol)

Description

Récupérer une liste d'informations détaillées concernant un volume

Syntaxe

/api/v2/vol/info?app=application&vol=volume&vdc=controller-name 

Arguments

app

Nom de l'application

vol

Nom du volume

vdc

Nom du centre de données virtuel cible

Type de transaction

Synchrone

Type de requête

GET

Exemples

Pour récupérer une liste d'informations détaillées concernant test:vol1 :

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

Exemple de sortie

XML

<volume>
  <comment></comment>
  <filesystem>ext3</filesystem>
  <link></link>
  <mirrors>
    <mirror>
      <name>srv1.v-e9937df4-28df-4e14-9f45-31d1668e7b4a</name>
      <server>srv1</server>
      <state>ok</state>
    </mirror>
    <mirror>
      <name>srv2.v-40b44d96-7a93-4edd-a13d-c320ea3d227d</name>
      <server>srv2</server>
      <state>ok</state>
    </mirror>
  </mirrors>
  <mount_attr>rw-excl</mount_attr>
  <mount_path>none</mount_path>
  <mount_state>in_use</mount_state>
  <n_mirrors>2</n_mirrors>
  <n_users>1</n_users>
  <name>conf</name>
  <size>53477376</size>
  <state>ok</state>
  <store>local</store>
  <time_accessed>1367537796</time_accessed>
  <time_created>1367449644</time_created>
  <time_written>1367449646</time_written>
  <uuid>93298b3c-d731-43b7-b7d9-2e98393f4263</uuid>
<volume> 

JSON

{
   "link" : "",
   "time_created" : "1367449644",
   "store" : "local",
   "mount_attr" : "rw-excl",
   "mirror" : [
      {
         "name" : "srv1.v-e9937df4-28df-4e14-9f45-31d1668e7b4a",
         "server" : "srv1",
         "state" : "ok"
      },
      {
         "name" : "srv2.v-40b44d96-7a93-4edd-a13d-c320ea3d227d",
         "server" : "srv2",
         "state" : "ok"
      }
   ],
   "time_accessed" : "1367537796",
   "name" : "conf",
   "uuid" : "93298b3c-d731-43b7-b7d9-2e98393f4263",
   "mount_state" : "in_use",
   "size" : "53477376",
   "state" : "ok",
   "n_users" : "1",
   "time_written" : "1367449646",
   "mount_path" : "none",
   "comment" : "",
   "filesystem" : "ext3",
   "n_mirrors" : "2"
}

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.

404.1

Le volume test:data n'existe pas. - Une application ou un volume non valide a été spécifié dans la requête.