请求地址：
| 请求地址 | 请求方法 |
| /api/vm/info | POST |
请求参数
| 参数 | 类型 | 是否必填 | 最大长度 | 描述 | 示例值 |
| vmid | String | 是 | 32 | 虚拟机ID | 66 |
| filter | String | 否 | N | 筛选字段，多个","隔开，默认全部字段 datastore:存储和文件 runstate:运行状态 diskinfo:磁盘信息 networks:网络信息 toolsInfo:VMware Tools信息 | datastore,runstate |
| mode | Int | 否 | 1 | 响应模式：0同步、1异步，默认为1，各差异如下： 同步：服务器不会立即响应客户端，一直等待超时或者任务已被执行(不管成功与失败) 异步：服务器会立即响应客户端，通过任务ID获得任务执行结果 | 0 |
| clientid | String | 是 | 32 | 代理客户端ID |
异步返回示例
{
"errcode": "200",
"errmsg": "ok",
"data": {
"vmid": "32",
"taskid": "121e6a4682502fb8ad89a12444c40008"
}
}异步返回参数说明
| 参数 | 描述 |
| vmid | 虚拟机ID |
| taskid | 任务ID，可用于获取任务执行信息 |
同步返回示例
{
"TaskID": "8db7a857372deae0771c6a2893e5c0ca",
"Describe": "虚拟机详情信息",
"Content": {
"task": {
"event_name": "EVENT_VM_INFO",
"task_errcode": "200",
"task_errmsg": "success"
},
"vm": {
"createDate": "2023-08-06T14:10:10.44205Z",
"datastore": {
"name": "data_1t",
"path": "/vmfs/volumes/5e5b23b2-a4e7fb00-8d08-c4834f165c2c/"
},
"diskinfo": [
{
"fileName": "[data_1t] tpl-win7x64-88/tpl-win7x64-88.vmdk",
"key": "2000",
"label": "Hard disk 1",
"summary": "50 GB",
"unitNumber": "0",
"uuid": "6000C29e-9782-9fb2-1f6c-50a0b80df10c"
},
{
"fileName": "[data_1t] tpl-win7x64-88/tpl-win7x64-88_1.vmdk",
"key": "2001",
"label": "Hard disk 2",
"summary": "15 MB",
"unitNumber": "1",
"uuid": "6000C297-eb98-ef4b-45a8-2338c23e5036"
}
],
"fileinfo": {
"logDirectory": "/vmfs/volumes/5e5b23b2-a4e7fb00-8d08-c4834f165c2c/tpl-win7x64-88",
"snapshotDirectory": "/vmfs/volumes/5e5b23b2-a4e7fb00-8d08-c4834f165c2c/tpl-win7x64-88",
"suspendDirectory": "/vmfs/volumes/5e5b23b2-a4e7fb00-8d08-c4834f165c2c/tpl-win7x64-88",
"vmPath": "/vmfs/volumes/5e5b23b2-a4e7fb00-8d08-c4834f165c2c/tpl-win7x64-88",
"vmPathName": "/vmfs/volumes/5e5b23b2-a4e7fb00-8d08-c4834f165c2c/tpl-win7x64-88/tpl-win7x64-88.vmx"
},
"guestFullName": "Microsoft Windows 7 (64-bit)",
"hostName": "",
"memoryMB": "2096",
"name": "tpl-win7x64-88",
"networks": {
"accessible": "true",
"ipAddress": "",
"ipPoolName": "",
"macAddress": "",
"name": "VM Network",
"network": "vim.Network:HaNetwork-VM Network"
},
"runstate": "2",
"toolsInfo": {
"afterPowerOn": "true",
"afterResume": "true",
"toolsInstallType": "guestToolsTypeMSI",
"toolsVersion": "10304"
},
"uuid": "564df331-6897-7764-4dab-7c24f53e8313",
"vcpu": {
"numCPU": "2",
"numCoresPerSocket": "1",
"numberSlots": "2"
},
"version": "vmx-14",
"vmUsedSize": "14.6G",
"vmid": "111"
}
},
"InsertTime": 1696343934,
"UpdateTime": 1696343937,
"ExpireTime": 1696430334
}同步返回参数说明
| 参数 | 描述 |
| TaskID | 任务ID |
| Describe | 任务描述 |
| Clientid | 代理客户端ID |
| Content | 任务详情 |
| task | 任务执行信息 |
| event_name | 事件名称 |
| task_errcode | 错误代码 |
| task_errmsg | 错误提示 |
| vm | 虚拟机信息 |
| vmid | 虚拟机ID |
| createDate | 创建时间 |
| guestFullName | 客户机操作系统 |
| hostName | 主机名 |
| memoryMB | 内存大小，MB单位 |
| name | 虚拟机名称 |
| runstate | 虚拟机运行状态:0错误、1电源已打开、2电源已关闭、3暂停 |
| uuid | 虚拟机唯一ID |
| version | 版本号 |
| vmUsedSize | 虚拟机占用空间大小 |
| datastore | 数据存储信息 |
| name | 存储名称 |
| path | 所绑定路径 |
| diskinfo | 磁盘信息 |
| fileName | 磁盘文件名 |
| label | 磁盘标签 |
| summary | 磁盘容量 |
| controllerKey | 磁盘SCSI 控制器ID |
| scsiNumber | 磁盘SCSI控制器编号 |
| unitNumber | 磁盘SCSI 控制器单元号 |
| uuid | 磁盘唯一ID |
| fileinfo | 文件信息 |
| logDirectory | 日志存放目录 |
| snapshotDirectory | 快照存放目录 |
| suspendDirectory | 挂起目录 |
| vmPathName | 虚拟机配置文件 |
| vmPath | 虚拟机所在目录 |
| networks | 网络信息 |
| name | 网络名称 |
| accessible | 是否已连接 |
| ipPoolName | IP池名称 |
| ipAddress | IP地址 |
| macAddress | MAC地址 |
| vcpu | cpu信息 |
| numCPU | CPU 内核数 |
| numCoresPerSocket | 每个插槽内核数 |
| numberSlots | 插槽数 |
| toolsInfo | VMware Tools信息 |
| toolsVersion | 版本号 |
| toolsInstallType | 安装类型 |
| afterPowerOn | 电源打开 |
| InsertTime | 任务创建时间 |
| UpdateTime | 任务更新时间 |
| ExpireTime | 任务有效时间 |
异常示例
{"errcode":"500","errmsg":"内部错误"}