Guide di integrazione › Guida di riferimento API del servizio Web › Oggetti validi › Oggetto vol › Metodo info (oggetto vol)

Metodo info (oggetto vol)

Description

Recupera l'elenco di informazioni dettagliate per un volume

Sintassi

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

Argomenti

app

Nome dell'applicazione

vol

Nome del volume.

vdc

Nome del data center virtuale di destinazione

Tipo di transazione

sincrona

Tipo di richiesta

GET

Esempi

Recupera l'elenco di informazioni dettagliate per test:vol1.

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

Output di esempio

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"
}

Codici di errore HTTP

404

Entità vdc mygrid non trovata - È stato specificato un nome di VDC non configurato nell'applicazione WS_API.

400.4

Argomenti necessari mancanti (app). - Argomento app=app mancante nella richiesta.

400.4

Argomenti necessari mancanti (vol). - Argomento vol=vol mancante nella richiesta.

404.1

Il volume 'test:data' non esiste. - Applicazione o volume non validi specificati nella richiesta.