CloudStack v2.2.13 - 2.2.14 Root Admin API Reference
prepareHostForMaintenance
Prepares a host for maintenance.
Request parameters
| Parameter Name | Description | Required |
| id | the host ID | true |
Response Tags
| Response Name | Description |
| id | the ID of the host |
| averageload | the cpu average load on the host |
| capabilities | capabilities of the host |
| clusterid | the cluster ID of the host |
| clustername | the cluster name of the host |
| clustertype | the cluster type of the cluster that host belongs to |
| cpuallocated | the amount of the host's CPU currently allocated |
| cpunumber | the CPU number of the host |
| cpuspeed | the CPU speed of the host |
| cpuused | the amount of the host's CPU currently used |
| cpuwithoverprovisioning | the amount of the host's CPU after applying the cpu.overprovisioning.factor |
| created | the date and time the host was created |
| disconnected | true if the host is disconnected. False otherwise. |
| disksizeallocated | the host's currently allocated disk size |
| disksizetotal | the total disk size of the host |
| events | events available for the host |
| hasenoughcapacity | true if this host has enough CPU and RAM capacity to migrate a VM to it, false otherwise |
| hosttags | comma-separated list of tags for the host |
| hypervisor | the host hypervisor |
| hypervisorversion | the hypervisor version |
| ipaddress | the IP address of the host |
| islocalstorageactive | true if local storage is active, false otherwise |
| lastpinged | the date and time the host was last pinged |
| managementserverid | the management server ID of the host |
| memoryallocated | the amount of the host's memory currently allocated |
| memorytotal | the memory total of the host |
| memoryused | the amount of the host's memory currently used |
| name | the name of the host |
| networkkbsread | the incoming network traffic on the host |
| networkkbswrite | the outgoing network traffic on the host |
| oscategoryid | the OS category ID of the host |
| oscategoryname | the OS category name of the host |
| podid | the Pod ID of the host |
| podname | the Pod name of the host |
| removed | the date and time the host was removed |
| resourcestate | the resource state of the host |
| state | the state of the host |
| suitableformigration | true if this host is suitable(has enough capacity and satisfies all conditions like hosttags, max guests vm limit etc) to migrate a VM to it , false otherwise |
| type | the host type |
| version | the host version |
| zoneid | the Zone ID of the host |
| zonename | the Zone name of the host |