虚拟机相关接口

获取虚拟机开机时间

GET/zstack/v1/vm-instances/{uuid}/uptime

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/f02cf46cd553364bb4ccebcce7728e14/uptime

参数列表

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

API返回

返回示例

{
  "uptime": "2023-10-01 10:12:15"
}
名字类型描述起始版本
successboolean 4.2.0
uptimeString 4.2.0
errorErrorCode错误码,若不为null,则表示操作失败, 操作成功时该字段为null。 详情参考error4.2.0

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

GetVmUptimeAction action = new GetVmUptimeAction();
action.uuid = "f02cf46cd553364bb4ccebcce7728e14";
action.sessionId = "b86c9016b4f24953a9edefb53ca0678c";
GetVmUptimeAction.Result res = action.call();

Python SDK

GetVmUptimeAction action = GetVmUptimeAction()
action.uuid = "f02cf46cd553364bb4ccebcce7728e14"
action.sessionId = "b86c9016b4f24953a9edefb53ca0678c"
GetVmUptimeAction.Result res = action.call()