Apache CloudStack 4.15.0.0 Root Admin API Reference
findHostsForMigration
Find hosts suitable for migrating a virtual machine.
Request parameters
| Parameter Name | Description | Required |
| virtualmachineid | find hosts to which this VM can be migrated and flag the hosts with enough CPU/RAM to host the VM | true |
| keyword | List by keyword | false |
| page | false | |
| pagesize | false |
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 |
| cpuallocatedpercentage | the amount of the host's CPU currently allocated in percentage |
| cpuallocatedvalue | the amount of the host's CPU currently allocated in MHz |
| cpuallocatedwithoverprovisioning | the amount of the host's CPU currently allocated after applying the cpu.overprovisioning.factor |
| 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 |
| hahost | true if the host is Ha host (dedicated to vms started by HA process; false otherwise |
| 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 |
| memoryallocatedbytes | the amount of the host's memory currently allocated in bytes |
| memoryallocatedpercentage | the amount of the host's memory currently allocated in percentage |
| memorytotal | the memory total of the host, this parameter is deprecated use memorywithoverprovisioning |
| memoryused | the amount of the host's memory currently used |
| memorywithoverprovisioning | the amount of the host's memory after applying the mem.overprovisioning.factor |
| 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 |
| requiresStorageMotion | true if migrating a vm to this host requires storage motion, false otherwise |
| 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 |