DetachIsoFromVmInstance
API Request
URLs
DELETE zstack/v1/vm-instances/{vmInstanceUuid}/iso?isoUuid={isoUuid}Headers
Authorization: OAuth the-session-uuidCurl
Sample
curl -H "Content-Type: application/json;charset=UTF-8" \
-H "Authorization: OAuth 402a9d5c22174d18b54daf3b989e1c59" \
-X DELETE http://localhost:8080/zstack/v1/vm-instances/ee0d9801bd604235b2a20a87fe50c7a4/iso?isoUuid=dffgdiofgerut566jveritynrt9w4c5u4tv9Request Parameters
| Name | Type | Location | Description | Optional Value | Starting Version |
|---|---|---|---|---|---|
| vmInstanceUuid | String | url | The VM instance UUID. | 0.6 | |
| systemTags | List | body | Optional. The system tags. | 0.6 | |
| userTags | List | body | Optional. The user tags. | 0.6 | |
| isoUuid | String | body | Optional. The ISO UUID. | 2.3.1 |
API Response
Sample
Response
{
"inventory": {
"uuid": "c11b752cf9ab3c1796932b6e2d31130b",
"name": "Test-VM",
"description": "web server VM",
"zoneUuid": "38bce95d22c13e9f9b4ebbee43fb19ff",
"clusterUuid": "9f22602c966b338b822653bfac3e01a0",
"imageUuid": "7f367e399b5e3d15b077288235834a44",
"hostUuid": "a99d812afd4136b3af5cc1ced6973ed4",
"lastHostUuid": "51391439dfa437daa7915c6fba892418",
"instanceOfferingUuid": "b2cd7abbfe28364399304140235314eb",
"rootVolumeUuid": "ed654518b598324f8b2c5f2b4942ac32",
"platform": "Linux",
"defaultL3NetworkUuid": "f03ba780bfe73e45ab06aff246101170",
"type": "UserVm",
"hypervisorType": "KVM",
"memorySize": 8.589934592E9,
"cpuNum": 1.0,
"allocatorStrategy": "LastHostPreferredAllocatorStrategy",
"createDate": "Nov 14, 2017 10:20:57 PM",
"lastOpDate": "Nov 14, 2017 10:20:57 PM",
"state": "Running",
"vmNics": [
{
"uuid": "5f41aff015d63ba5b58cb9596ccbfb24",
"vmInstanceUuid": "c11b752cf9ab3c1796932b6e2d31130b",
"usedIpUuid": "0b520f1c41f33ce9a62c70c0724e26b6",
"l3NetworkUuid": "f03ba780bfe73e45ab06aff246101170",
"ip": "192.168.1.10",
"mac": "00:0c:29:bd:99:fc",
"hypervisorType": "KVM",
"netmask": "255.255.255.0",
"gateway": "192.168.1.1",
"deviceId": 0.0,
"createDate": "Nov 14, 2017 10:20:57 PM",
"lastOpDate": "Nov 14, 2017 10:20:57 PM"
}
],
"allVolumes": [
{
"uuid": "ed654518b598324f8b2c5f2b4942ac32",
"name": "Root-Volume-For-VM-c11b752cf9ab3c1796932b6e2d31130b",
"primaryStorageUuid": "db4c942c7a4c33cb9d2184c1dda9c431",
"vmInstanceUuid": "c11b752cf9ab3c1796932b6e2d31130b",
"diskOfferingUuid": "fbeca8e72bdc313c83767b3f40d1cd79",
"rootImageUuid": "7f367e399b5e3d15b077288235834a44",
"installPath": "/Cloud_ps/rootVolumes/acct-36c27e8ff05c4780bf6d2fa65700f22e/vol-ed654518b598324f8b2c5f2b4942ac32/ed654518b598324f8b2c5f2b4942ac32.qcow2",
"type": "Root",
"format": "qcow2",
"size": 1.073741824E11,
"actualSize": 2.147483648E10,
"deviceId": 0.0,
"state": "Enabled",
"status": "Ready",
"createDate": "Nov 14, 2017 10:20:57 PM",
"lastOpDate": "Nov 14, 2017 10:20:57 PM"
}
]
}
}| Name | Type | Description | Starting Version |
|---|---|---|---|
| error | ErrorCode | The error code. If not null, the operation fails, or vice versa. For more information, see error. | 0.6 |
| inventory | VmInstanceInventory | See inventory. | 0.6 |
#error
| Name | Type | Description | Starting Version |
|---|---|---|---|
| code | String | The error code, which is a numbered or alphanumeric code that specifies an error. For example, SYS.1000, HOST.1001. | 0.6 |
| description | String | The brief description of the error. | 0.6 |
| details | String | The details about the error. | 0.6 |
| elaboration | String | The reserved field. Default value: null. | 0.6 |
| opaque | LinkedHashMap | The reserved field. Default value: null. | 0.6 |
| cause | ErrorCode | The root error, which is the associated root cause of the current error. If no root error exists, this parameter is null. | 0.6 |
#inventory
| Name | Type | Description | Starting Version |
|---|---|---|---|
| uuid | String | The resource UUID. | 0.6 |
| name | String | The resource name. | 0.6 |
| description | String | The detailed description of the resource. | 0.6 |
| zoneUuid | String | The zone UUID. | 0.6 |
| clusterUuid | String | The cluster UUID. | 0.6 |
| imageUuid | String | The image UUID. | 0.6 |
| hostUuid | String | The host UUID. | 0.6 |
| lastHostUuid | String | 0.6 | |
| instanceOfferingUuid | String | The instance offering UUID. | 0.6 |
| rootVolumeUuid | String | The root volume UUID. | 0.6 |
| platform | String | 0.6 | |
| defaultL3NetworkUuid | String | 0.6 | |
| type | String | 0.6 | |
| hypervisorType | String | 0.6 | |
| memorySize | Long | 0.6 | |
| cpuNum | Integer | 0.6 | |
| cpuSpeed | Long | 0.6 | |
| allocatorStrategy | String | 0.6 | |
| createDate | Timestamp | The creation date. | 0.6 |
| lastOpDate | Timestamp | The last operation date. | 0.6 |
| state | String | 0.6 | |
| vmNics | List | See vmNics. | 0.6 |
| allVolumes | List | See allVolumes. | 0.6 |
#vmNics
| Name | Type | Description | Starting Version |
|---|---|---|---|
| uuid | String | The resource UUID. | 0.6 |
| vmInstanceUuid | String | The VM instance UUID. | 0.6 |
| l3NetworkUuid | String | The L3 network UUID. | 0.6 |
| ip | String | 0.6 | |
| mac | String | 0.6 | |
| netmask | String | 0.6 | |
| gateway | String | 0.6 | |
| metaData | String | 0.6 | |
| ipVersion | Integer | The IP version. | 3.1.0 |
| deviceId | Integer | 0.6 | |
| createDate | Timestamp | The creation date. | 0.6 |
| lastOpDate | Timestamp | The last operation date. | 0.6 |
| usedIps | List | See usedIps. | 0.6 |
#usedIps
| Name | Type | Description | Starting Version |
|---|---|---|---|
| uuid | String | The resource UUID. | 0.6 |
| ipRangeUuid | String | The IP range UUID. | 0.6 |
| l3NetworkUuid | String | The L3 network UUID. | 0.6 |
| ipVersion | Integer | The IP version. | 3.1.0 |
| ip | String | The IP address. | 0.6 |
| netmask | String | The netmask. | 0.6 |
| gateway | String | The gateway. | 0.6 |
| usedFor | String | 0.6 | |
| ipInLong | long | 0.6 | |
| vmNicUuid | String | The VM NIC UUID. | 3.1.0 |
| createDate | Timestamp | The creation date. | 0.6 |
| lastOpDate | Timestamp | The last operation date. | 0.6 |
#allVolumes
| Name | Type | Description | Starting Version |
|---|---|---|---|
| uuid | String | The resource UUID. | 0.6 |
| name | String | The resource name. | 0.6 |
| description | String | The detailed description of the resource. | 0.6 |
| primaryStorageUuid | String | The primary storage UUID. | 0.6 |
| vmInstanceUuid | String | The VM instance UUID. | 0.6 |
| diskOfferingUuid | String | The disk offering UUID. | 0.6 |
| rootImageUuid | String | 0.6 | |
| installPath | String | 0.6 | |
| type | String | 0.6 | |
| format | String | 0.6 | |
| size | Long | 0.6 | |
| actualSize | Long | 0.6 | |
| deviceId | Integer | 0.6 | |
| state | String | 0.6 | |
| status | String | 0.6 | |
| createDate | Timestamp | The creation date. | 0.6 |
| lastOpDate | Timestamp | The last operation date. | 0.6 |
| isShareable | Boolean | 0.6 |
SDK Sample
Java
SDK
DetachIsoFromVmInstanceAction action = new DetachIsoFromVmInstanceAction();
action.vmInstanceUuid = "381bac8e696b4702aae2cfa5cdf8ae04";
action.sessionId = "4796188f38784439a721f2ef35a0d0d3";
DetachIsoFromVmInstanceAction.Result res = action.call();
Python
SDK
DetachIsoFromVmInstanceAction action = DetachIsoFromVmInstanceAction()
action.vmInstanceUuid = "7cc1f3997d1745698276cbc26262f556"
action.sessionId = "1e1f179e29df418c9656aa5a006818cb"
DetachIsoFromVmInstanceAction.Result res = action.call()