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

Metodo list (Oggetto vol)

Description

Recupera l'elenco di volumi nell'applicazione

Sintassi

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

Argomenti

app

Nome dell'applicazione

vdc

Nome del data center virtuale di destinazione

Tipo di transazione

sincrona

Tipo di richiesta

GET

Esempi

Recupera l'elenco di volumi per test.

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

Output di esempio

XML:

<volumes>
  <volume>
    <comment></comment>
    <filesystem>ext3</filesystem>
    <mount_state>in_use</mount_state>
    <n_mirrors>2</n_mirrors>
    <name>WS_API_r271:code</name>
    <scope_name>WS_API_r271</scope_name>
    <scope_type>application</scope_type>
    <server>srv1,srv2</server>
    <size>54525952</size>
    <state>ok</state>
    <store>local</store>
    <uuid>fc746912-cc65-4e9c-9327-14c66b1741c7</uuid>
  </volume>
  .
  .
  .
  <volume>
    <comment></comment>
    <filesystem>ext3</filesystem>
    <mount_state>available</mount_state>
    <n_mirrors>2</n_mirrors>
    <name>WS_API_r271:mon</name>
    <scope_name>WS_API_r271</scope_name>
    <scope_type>application</scope_type>
    <server>srv1,srv2</server>
    <size>53477376</size>
    <state>ok</state>
    <store>local</store>
    <uuid>f4fd637c-4aa8-4111-be31-55d28a1e275d</uuid>
  </volume>
</volumes>

JSON:

{
   "volume" : [
      {
         "store" : "local",
         "scope_type" : "application",
         "name" : "WS_API_r271:code",
         "scope_name" : "WS_API_r271",
         "mount_state" : "in_use",
         "uuid" : "fc746912-cc65-4e9c-9327-14c66b1741c7",
         "size" : "54525952",
         "state" : "ok",
         "comment" : "",
         "filesystem" : "ext3",
         "n_mirrors" : "2",
         "server" : "srv1,srv2"
      },
      .
      .
      .
      {
         "store" : "local",
         "scope_type" : "application",
         "name" : "WS_API_r271:mon",
         "scope_name" : "WS_API_r271",
         "mount_state" : "available",
         "uuid" : "f4fd637c-4aa8-4111-be31-55d28a1e275d",
         "size" : "53477376",
         "state" : "ok",
         "comment" : "",
         "filesystem" : "ext3",
         "n_mirrors" : "2",
         "server" : "srv1,srv2"
      }
   ]
}

Codici di errore HTTP

404

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

400.1

L'applicazione 'test' non esiste. - Applicazione non valida specificata nella richiesta.