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

查询虚拟机设备地址组

查询虚拟机设备地址组

调试可用性

在线调试

使用当前认证信息和示例参数提交 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必填

    错误码,若不为null,则表示操作失败, 操作成功时该字段为null。 详情参考error

    • codeString必填

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

    • descriptionString必填

      错误的概要描述

    • detailsString必填

      错误的详细信息

    • elaborationString必填

      保留字段,默认为null

    • opaqueLinkedHashMap必填

      保留字段,默认为null

    • causeErrorCode必填

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

请求地址

GET/zstack/v1/vmInstance/device/address/group

/zstack/v1/vmInstance/device/address/group

操作 ID

QueryVmInstanceDeviceAddressGroup

永久链接

请求示例

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

响应示例

200
{ "inventories": [ { "uuid": "77cc648bcbda321f9b5982627618b57f", "resourceUuid": "b28bd07303de3b8bb88ecc45778ebc10", "createDate": "Nov 14, 2017 2:20:57 PM", "lastOpDate": "Nov 14, 2017 2:20:57 PM", "addressList": [ { "id": 1, "resourceUuid": "664783c1fb2432b6944602836377d61f", "vmInstanceUuid": "7f29c11b15b3348a95bc368b4ab60efb", "deviceAddress": "{\"bus\":\"00\",\"domain\":\"0000\",\"slot\":\"0d\",\"function\":\"0\"}", "addressGroupUuid": "77cc648bcbda321f9b5982627618b57f", "metadata": "{\"uuid\":\"726104d38c423fecac45c39a258b1338\",\"name\":\"Root-Volume-For-VM-70f0a99c825d3bed98c95932e5cd6d0b\",\"primaryStorageUuid\":\"0a2c36ffd5ff39d6a4ffd3d6a2a60ea8\",\"vmInstanceUuid\":\"70f0a99c825d3bed98c95932e5cd6d0b\",\"diskOfferingUuid\":\"a0c51ff80bba366d8350d63d02d56346\",\"rootImageUuid\":\"8473469c3e833afbb02db9ed227787bd\",\"installPath\":\"/zstack_ps/rootVolumes/acct-36c27e8ff05c4780bf6d2fa65700f22e/vol-726104d38c423fecac45c39a258b1338/726104d38c423fecac45c39a258b1338.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.VmInstanceDeviceAddressGroupInventory", "createDate": "Nov 14, 2017 2:20:57 PM", "lastOpDate": "Nov 14, 2017 2:20:57 PM" } ] } ] }

变更历史

此 API 暂无变更历史记录。

查看全部变更历史