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

info 方法（srv 对象）

说明

检索服务器信息

语法

/api/v2/srv/info?srv=srv&vdc=controller-name 

参数

srv

服务器的名称

vdc

目标虚拟数据中心的名称

事务类型

同步

请求类型

GET

示例

检索服务器信息。

GET http://192.168.123.200/api/v2/srv/info?srv=srv1&vdc=mygrid 

样例输出

XML：

<server> 
   <name>srv1</name> 
   <bw_alloc>720000000</bw_alloc> 
   <bw_free>1280000000</bw_free> 
   <bw_reserved>0</bw_reserved> 
   <bw_total>2000000000</bw_total> 
   <cpu_alloc>1.69</cpu_alloc> 
   <cpu_bogomips>3991</cpu_bogomips> 
   <cpu_free>2.21</cpu_free> 
   <cpu_freq>1995</cpu_freq> 
   <cpu_load>0.06</cpu_load> 
   <cpu_phy_total>2</cpu_phy_total> 
    <cpu_reserved>0.10</cpu_reserved>
   <cpu_total>4</cpu_total> 
   <cpu_type>Intel(R) Xeon(R) CPU 5130 @ 2.00GHz </cpu_type> 
   <disk_free>1143356945142</disk_free> 
   <disk_reserved>10737418240</disk_reserved> 
    <disk_total>1493697126400</disk_total>
   <enabled>1</enabled> 
   <ha_role>primary</ha_role> 
   <hvm_support>1</hvm_support> 
   <mem_alloc>1610612736</mem_alloc> 
   <mem_free>1246756864</mem_free> 
   <mem_reserved>1435500544</mem_reserved> 
   <mem_service>0</mem_service> 
   <mem_total>4292870144</mem_total> 
   <n_disks>1</n_disks> 
   <state>up</state> 
</server>

JSON：

{ 
   "cpu_freq" : "1995", 
   "cpu_type" : "Intel(R) Xeon(R) CPU 5130 @ 2.00GHz ", 
   "cpu_bogomips" : "3991", 
   "state" : "up", 
   "cpu_total" : "4", 
   "cpu_alloc" : "1.69", 
   "mem_alloc" : "1610612736", 
   "hvm_support" : "1", 
   "enabled" : "1", 
   "bw_total" : "2000000000", 
   "cpu_reserved" : "0.10", 
   "mem_total" : "4292870144", 
   "name" : "srv1", 
   "disk_reserved" : "10737418240", 
   "disk_total" : "1493697126400", 
   "cpu_phy_total" : "2", 
   "cpu_free" : "2.21", 
   "ha_role" : "primary", 
   "mem_reserved" : "1435500544", 
   "mem_service" : "0", 
   "bw_free" : "1280000000", 
   "disk_free" : "1143356945142", 
   "bw_reserved" : "0", 
   "mem_free" : "1246756864", 
   "cpu_load" : "0.30", 
   "bw_alloc" : "720000000", 
   "n_disks" : "1" 
} 

HTTP 错误代码

404

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

400.4

缺少必需参数 (srv)－未指定参数 srv=srv-name。

404.1

未找到实体－无法显示服务器 srv 的信息－它不存在。 请求中指定的服务器名称无效。