获取资源虚拟化软件信息(GetVirtualizerInfo)

API请求

URLs

GET zstack/v1/vm-instances/virtualizer-info

Headers

Authorization: OAuth the-session-uuid

Curl示例

curl -H "Content-Type: application/json;charset=UTF-8" \
-H "Authorization: OAuth b86c9016b4f24953a9edefb53ca0678c" \
-X GET http://localhost:8080/zstack/v1/vm-instances/virtualizer-info? uuids=b5432fcc423434e7a5f5876f1fe1e910&uuids=67e54311bbef3b43b9c523b349b08ca9&uuids=d64aeea721f7331aa15e7fb95eee7390

参数列表

名字	类型	位置	描述	起始版本
uuids	List	query	资源的 uuid，可以为云主机或物理机的 uuid	4.6.21
systemTags (可选)	List	query	系统标签	4.6.21
userTags (可选)	List	query	用户标签	4.6.21

API返回

返回示例

{
  "inventories": [
    {
      "uuid": "3ce46fb7eb2e369c88d5fd671d1c1694",
      "resourceType": "HostVO",
      "infoList": [
        {
          "hypervisor": "qemu-kvm",
          "currentVersion": "4.2.0-632.g6a6222b.el7",
          "expectVersion": "4.2.0-632.g6a6222b.el7",
          "matchState": "Matched"
        }
      ]
    },
    {
      "uuid": "5c10fab3f649380e9dce16bb22ffd572",
      "resourceType": "VmInstanceVO",
      "infoList": [
        {
          "hypervisor": "qemu-kvm",
          "currentVersion": "4.2.0-632.g6a6222b.el7",
          "expectVersion": "4.2.0-632.g6a6222b.el7",
          "matchState": "Matched"
        }
      ]
    },
    {
      "uuid": "78a8b78906233d57bce710e89b24ebc0",
      "resourceType": "VmInstanceVO",
      "infoList": [
        {
          "hypervisor": "qemu-kvm",
          "currentVersion": "4.2.0-632.g6a6222b.el7",
          "expectVersion": "4.2.0-632.g6a6222b.el7",
          "matchState": "Matched"
        }
      ]
    }
  ]
}

名字	类型	描述	起始版本
success	boolean	操作是否成功	4.6.21
error	ErrorCode	错误码，若不为null，则表示操作失败, 操作成功时该字段为null。详情参考error	4.6.21
inventories	List	详情参考inventories	4.6.21

#error

名字	类型	描述	起始版本
code	String	错误码号，错误的全局唯一标识，例如SYS.1000, HOST.1001	4.6.21
description	String	错误的概要描述	4.6.21
details	String	错误的详细信息	4.6.21
elaboration	String	保留字段，默认为null	4.6.21
opaque	LinkedHashMap	保留字段，默认为null	4.6.21
cause	ErrorCode	根错误，引发当前错误的源错误，若无原错误，该字段为null	4.6.21

#inventories

名字	类型	描述	起始版本
uuid	String	资源的UUID，唯一标示该资源	4.6.21
resourceType	String	资源类型	4.6.21
error	List	出现的查询错误，可能为 null	4.6.21
infoList	List	详情参考infoList	4.6.21

#infoList

名字	类型	描述	起始版本
hypervisor	String	虚拟化软件，一般qemu-kvm	4.6.21
currentVersion	String	云主机当前使用的虚拟化软件版本 / 物理机当前安装的虚拟化软件版本	4.6.21
expectVersion	String	期望的虚拟化软件版本。如果待查询的是 VM，则期望的虚拟化软件版本来自物理机；如果待查询的是物理机，则期望的虚拟化软件版本来自管理节点	4.6.21
matchState	String	当前虚拟化软件版本和期望是否匹配。如果当前版本或期望有一方没有查到，则返回Unknown	4.6.21

SDK示例

Java SDK

GetVirtualizerInfoAction action = new GetVirtualizerInfoAction();
action.uuids = asList("b5432fcc423434e7a5f5876f1fe1e910","67e54311bbef3b43b9c523b349b08ca9","d64aeea721f7331aa15e7fb95eee7390");
action.sessionId = "b86c9016b4f24953a9edefb53ca0678c";
GetVirtualizerInfoAction.Result res = action.call();

Python SDK

GetVirtualizerInfoAction action = GetVirtualizerInfoAction()
action.uuids = [b5432fcc423434e7a5f5876f1fe1e910, 67e54311bbef3b43b9c523b349b08ca9, d64aeea721f7331aa15e7fb95eee7390]
action.sessionId = "b86c9016b4f24953a9edefb53ca0678c"
GetVirtualizerInfoAction.Result res = action.call()

上一篇获取云主机可加载L3网络列表(GetVmAttachableL3Network)下一篇加载L3网络到云主机(AttachL3NetworkToVm)