虚拟机相关接口

获取虚拟机启动设备列表

GET/zstack/v1/vm-instances/{uuid}/boot-orders

获取一个虚拟机的启动设备列表。

Headers

Authorization: OAuth the-session-uuid

Curl示例

curl -H "Content-Type: application/json;charset=UTF-8" \
-H "Authorization: OAuth: 458995c072644d28b32b26f69e512c2c" \
-X GET http://localhost:8080/zstack/v1/vm-instances/426cff83f17d4a5aa7c752484d730f20/boot-orders

参数列表

名字类型位置描述可选值起始版本
uuidStringurl虚拟机UUID 0.6
systemTags (可选)Listquery系统标签 0.6
userTags (可选)Listquery用户标签 0.6

API返回

返回示例

{
  "order": [
    "HardDisk",
    "CdRom"
  ]
}
名字类型描述起始版本
successboolean 0.6
ordersList启动设备列表0.6
errorErrorCode错误码,若不为null,则表示操作失败, 操作成功时该字段为null。 详情参考error0.6

error

名字类型描述起始版本
codeString错误码号,错误的全局唯一标识,例如SYS.1000, HOST.10010.6
descriptionString错误的概要描述0.6
detailsString错误的详细信息0.6
elaborationString保留字段,默认为null0.6
opaqueLinkedHashMap保留字段,默认为null0.6
causeErrorCode根错误,引发当前错误的源错误,若无原错误,该字段为null0.6

SDK示例

Java SDK

GetVmBootOrderAction action = new GetVmBootOrderAction();
action.uuid = "914ab429715b40d59efa76c1ccfe64d8";
action.sessionId = "0472be4a6e2c4e7c9d7bcf3da2938313";
GetVmBootOrderAction.Result res = action.call();

Python SDK

GetVmBootOrderAction action = GetVmBootOrderAction()
action.uuid = "cba88e6e561049c8b7beaeccf4d46279"
action.sessionId = "bd37fd5e33e847d4bef4bb536d6410ea"
GetVmBootOrderAction.Result res = action.call()