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

Méthode list (objet srv)

Description

Récupère une liste de serveurs.

Syntaxe

/api/v2/srv/list?vdc=nom_contrôleur 

Arguments

vdc

Nom du centre de données virtuel cible

Type de transaction

Synchrone

Type de requête

GET

Exemples

Pour afficher une liste des serveurs :

GET http://192.168.123.200/api/v2/srv/list?vdc=mygrid 

Exemple de sortie

XML

<servers>
   <server>
      <name>srv1</name>
      <bw_alloc>350000000</bw_alloc>
      <bw_free>1650000000</bw_free>
      <cpu_alloc>0,55</cpu_alloc>
      <cpu_free>1.35</cpu_free>
      <enabled>1</enabled>
      <mem_alloc>738197504</mem_alloc>
      <mem_free>11534336</mem_free>
      <role>primary</role>
      <state>up</state> 
   </server>
   <server>
      <name>srv2</name>
      <bw_alloc>900000000</bw_alloc>
      <bw_free>1100000000</bw_free>
      <cpu_alloc>1.10</cpu_alloc>
      <cpu_free>0.90</cpu_free>
      <enabled>1</enabled>
      <mem_alloc>1476395008</mem_alloc>
      <mem_free>78643200</mem_free>
      <role>secondary</role>
      <state>up</state>
   </server>
   .
   .
   .

</servers>

JSON

{
   "server" : [
      {
         "name" : "srv1", 
         "cpu_free" : "1.35",
         "state" : "up",
         "bw_free" : "1650000000",
         "cpu_alloc" : "0.55",
         "mem_alloc" : "738197504",
         "mem_free" : "11534336",
         "role" : "primary",
         "bw_alloc" : "350000000",
         "enabled" : "1"
      },
       {
         "name" : "srv2",
         "cpu_free" : "0.90",
         "state" : "up",
         "bw_free" : "1100000000",
         "cpu_alloc" : "1.10",
         "mem_free" : "78643200",
         "mem_alloc" : "1476395008",
         "role" : "secondary",
         "bw_alloc" : "900000000",
         "enabled" : "1"
      },
      .
      .
      .
   ]
} 

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.