Apache CloudStack 4.18.0.0 Root Admin API Reference

prepareHostForMaintenance

Prepares a host for maintenance.

Request parameters

Parameter NameDescriptionRequired
idthe host IDtrue

Response Tags

Response NameDescription
idthe ID of the host
annotationthe last annotation set on this host by an admin
capabilitiescapabilities of the host
clusteridthe cluster ID of the host
clusternamethe cluster name of the host
clustertypethe cluster type of the cluster that host belongs to
cpuallocatedthe amount of the host's CPU currently allocated
cpuallocatedpercentagethe amount of the host's CPU currently allocated in percentage
cpuallocatedvaluethe amount of the host's CPU currently allocated in MHz
cpuallocatedwithoverprovisioningthe amount of the host's CPU currently allocated after applying the cpu.overprovisioning.factor
cpuloadaveragethe cpu average load on the host
cpunumberthe CPU number of the host
cpusocketsthe number of CPU sockets on the host
cpuspeedthe CPU speed of the host
cpuusedthe amount of the host's CPU currently used
cpuwithoverprovisioningthe amount of the host's CPU after applying the cpu.overprovisioning.factor
createdthe date and time the host was created
detailsHost details in key/value pairs.
disconnectedtrue if the host is disconnected. False otherwise.
disksizeallocatedthe host's currently allocated disk size
disksizetotalthe total disk size of the host
encryptionsupportedtrue if the host supports encryption
eventsevents available for the host
hahosttrue if the host is Ha host (dedicated to vms started by HA process; false otherwise
hasenoughcapacitytrue if this host has enough CPU and RAM capacity to migrate a VM to it, false otherwise
hosthathe host HA information information
hosttagscomma-separated list of tags for the host
hypervisorthe host hypervisor
hypervisorversionthe hypervisor version
ipaddressthe IP address of the host
islocalstorageactivetrue if local storage is active, false otherwise
lastannotatedthe last time this host was annotated
lastpingedthe date and time the host was last pinged
managementserveridthe management server ID of the host
memoryallocatedthe amount of the host's memory currently allocated
memoryallocatedbytesthe amount of the host's memory currently allocated in bytes
memoryallocatedpercentagethe amount of the host's memory currently allocated in percentage
memorytotalthe memory total of the host, this parameter is deprecated use memorywithoverprovisioning
memoryusedthe amount of the host's memory currently used
memorywithoverprovisioningthe amount of the host's memory after applying the mem.overprovisioning.factor
namethe name of the host
networkkbsreadthe incoming network traffic on the host
networkkbswritethe outgoing network traffic on the host
oscategoryidthe OS category ID of the host
oscategorynamethe OS category name of the host
outofbandmanagementthe host out-of-band management information
podidthe Pod ID of the host
podnamethe Pod name of the host
removedthe date and time the host was removed
resourcestatethe resource state of the host
statethe state of the host
suitableformigrationtrue 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
typethe host type
ueficapabilitytrue if the host has capability to support UEFI boot
usernamethe admin that annotated this host
versionthe host version
zoneidthe Zone ID of the host
zonenamethe Zone name of the host
gpugroup(*)GPU cards present in the host
gpugroupnameGPU cards present in the host
vgpu(*)the list of enabled vGPUs
maxcapacityMaximum vgpu can be created with this vgpu type on the given gpu group
maxheadsMaximum displays per user
maxresolutionxMaximum X resolution per display
maxresolutionyMaximum Y resolution per display
maxvgpuperpgpuMaximum no. of vgpu per gpu card (pgpu)
remainingcapacityRemaining capacity in terms of no. of more VMs that can be deployped with this vGPU type
vgputypeModel Name of vGPU
videoramVideo RAM for this vGPU type
jobidthe ID of the latest async job acting on this object
jobstatusthe current status of the latest async job acting on this object