跳转到主要内容
计算管理/虚拟机相关接口
GETVM Related Interfaces起始版本 4.10.16同步需要认证

查询虚拟机设备地址组

查询虚拟机设备地址组

调试可用性

在线调试

使用当前认证信息和示例参数提交 Mock 请求。

请求参数

此接口无需请求参数。

响应状态

200 OK

该 API 成功时返回以下响应结构。

  • successboolean必填

    请求是否成功

  • inventoriesList必填

    详情参考inventories

    • uuidString必填

      资源的UUID,唯一标示该资源

    • resourceUuidString必填

      资源 UUID

    • vmInstanceUuidString必填

      虚拟机 UUID

    • createDateTimestamp必填

      创建时间

    • lastOpDateTimestamp必填

      最后一次修改时间

    • addressListList必填

      详情参考addressList

      • idlong必填

        资源ID。

      • resourceUuidString必填

        资源 UUID

      • vmInstanceUuidString必填

        虚拟机 UUID

      • deviceAddressString必填

        设备地址

      • addressGroupUuidString必填

        地址组UUID。

      • metadataString必填

        附加元数据。

      • metadataClassString必填

        元数据类。

      • createDateTimestamp必填

        创建时间

      • lastOpDateTimestamp必填

        最后一次修改时间

  • errorErrorCode必填

    详情参考error

    • codeString必填

      错误码号,错误的全局唯一标识,例如SYS.1000, HOST.1001

    • descriptionString必填

      错误的概要描述

    • detailsString必填

      错误的详细信息

    • elaborationString必填

      保留字段,默认为null

    • opaqueLinkedHashMap必填

      保留字段,默认为null

    • causeErrorCode必填

      根错误,引发当前错误的源错误,若无原错误,该字段为null

请求地址

GET/zstack/v1/vmInstance/resource/metadata/group

/zstack/v1/vmInstance/resource/metadata/group

操作 ID

QueryVmInstanceResourceMetadataGroup

永久链接

请求示例

curl -X GET 'http://{host}/zstack/v1/vmInstance/resource/metadata/group' -H 'Authorization: OAuth {sessionUuid}'

响应示例

200
{ "inventories": [ { "uuid": "54cf17e0b4be38b59b43abb778c56379", "resourceUuid": "688ee3ed522d33d9a4ec9d3740938972", "createDate": "Nov 14, 2017 2:20:57 PM", "lastOpDate": "Nov 14, 2017 2:20:57 PM", "addressList": [ { "id": 1, "resourceUuid": "fe925ba7d1a4342a8d86bd57dafe09ef", "vmInstanceUuid": "7534a094abe63aa08ddf8b6d43ed451b", "deviceAddress": "{\"bus\":\"00\",\"domain\":\"0000\",\"slot\":\"0d\",\"function\":\"0\"}", "addressGroupUuid": "54cf17e0b4be38b59b43abb778c56379", "metadata": "{\"uuid\":\"6b493e7c870d362d8dd75bf3cd3a26eb\",\"name\":\"Root-Volume-For-VM-7da78e9e53d9339fb2f034e19cc2e160\",\"primaryStorageUuid\":\"cc2e2c3954233a489648e9df8f90825c\",\"vmInstanceUuid\":\"7da78e9e53d9339fb2f034e19cc2e160\",\"diskOfferingUuid\":\"53a9fea90a9c38899367b0a2c338bc4a\",\"rootImageUuid\":\"6bf5558add1d3f6481940fb0575ce806\",\"installPath\":\"/zstack_ps/rootVolumes/acct-36c27e8ff05c4780bf6d2fa65700f22e/vol-6b493e7c870d362d8dd75bf3cd3a26eb/6b493e7c870d362d8dd75bf3cd3a26eb.qcow2\",\"type\":\"Root\",\"format\":\"qcow2\",\"size\":107374182400,\"actualSize\":21474836480,\"deviceId\":0,\"state\":\"Enabled\",\"status\":\"Ready\",\"createDate\":\"Nov 14, 2017 2:20:57 PM\",\"lastOpDate\":\"Nov 14, 2017 2:20:57 PM\"}", "metadataClass": "org.zstack.header.vm.devices.VmInstanceResourceMetadataGroupInventory", "createDate": "Nov 14, 2017 2:20:57 PM", "lastOpDate": "Nov 14, 2017 2:20:57 PM" } ] } ] }

变更历史

此 API 暂无变更历史记录。

查看全部变更历史