删除云主机(DestroyVmInstance)
删除一个云主机。
API请求
URLs
DELETE zstack/v1/vm-instances/{uuid}?deleteMode={deleteMode}Headers
Authorization: OAuth the-session-uuidCurl示例
curl -H "Content-Type: application/json" \
-H "Authorization: OAuth: 8d618c25ba3b4eb7bc6dda7e47d1b6b4" \
-X DELETE http://localhost:8080/zstack/v1/vm-instances/5e22e2b1c4ab40739cd0b7717368dfa7?deleteMode=Permissive参数列表
| 名字 | 类型 | 位置 | 描述 | 可选值 | 起始版本 |
|---|---|---|---|---|---|
| uuid | String | url | 云主机UUID | 0.6 | |
| deleteMode(可选) | String | body | 0.6 | ||
| systemTags (可选) | List | body | 系统标签 | 0.6 | |
| userTags (可选) | List | body | 用户标签 | 0.6 |
API返回
该API成功时返回一个空的JSON结构{},出错时返回的JSON结构包含一个error字段,例如:
{
"error": {
"code": "SYS.1001",
"description": "A message or a operation timeout",
"details": "Create VM on KVM timeout after 300s"
}
}SDK示例
Java
SDK
DestroyVmInstanceAction action = new DestroyVmInstanceAction();
action.uuid = "c0b82973fbed42a09f3a30ce142fb168";
action.deleteMode = "Permissive";
action.sessionId = "97ddb4b10e34452c90d8591927cf3de5";
DestroyVmInstanceAction.Result res = action.call();Python
SDK
DestroyVmInstanceAction action = DestroyVmInstanceAction()
action.uuid = "0de3629902f1449d86256934552d5b3d"
action.deleteMode = "Permissive"
action.sessionId = "931c9e7e586c4b5fa44ed1155985ac1a"
DestroyVmInstanceAction.Result res = action.call()