集成指南 › Web 服务 API 参考指南 › 有效对象 › srv 对象 › list 方法（srv 对象）

list 方法（srv 对象）

说明

检索服务器列表

语法

/api/v2/srv/list?vdc=controller-name 

参数

vdc

目标虚拟数据中心的名称

事务类型

同步

请求类型

GET

示例

列出服务器。

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

样例输出

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"
      },
      。
      。
      。
   ]
} 

HTTP 错误代码

404

未找到实体 vdc mygrid－WS_API 应用中没有配置指定的 VDC 名称。