虚拟机相关接口

获取虚拟机第一启动项

GET/zstack/v1/vm-instances/{uuid}/first-boot-device

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/50d8c8ed7d4737fd99a2e323cefeac81/first-boot-device

参数列表

名字类型位置描述可选值起始版本
uuidStringurl资源的UUID,唯一标示该资源 3.7.0
systemTags (可选)Listquery系统标签 3.7.0
userTags (可选)Listquery用户标签 3.7.0

API返回

返回示例

{
  "firstBootDevice": "CdRom"
}
名字类型描述起始版本
firstBootDeviceString虚拟机第一启动项3.7.0
errorErrorCode错误码,若不为null,则表示操作失败, 操作成功时该字段为null。 详情参考error3.7.0

error

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

SDK示例

Java SDK

GetVmInstanceFirstBootDeviceAction action = new GetVmInstanceFirstBootDeviceAction();
action.uuid = "50d8c8ed7d4737fd99a2e323cefeac81";
action.sessionId = "b86c9016b4f24953a9edefb53ca0678c";
GetVmInstanceFirstBootDeviceAction.Result res = action.call();

Python SDK

GetVmInstanceFirstBootDeviceAction action = GetVmInstanceFirstBootDeviceAction()
action.uuid = "50d8c8ed7d4737fd99a2e323cefeac81"
action.sessionId = "b86c9016b4f24953a9edefb53ca0678c"
GetVmInstanceFirstBootDeviceAction.Result res = action.call()