Cosmic Admin API Reference

addHost

Adds a new host.

Request parameters

Parameter NameDescriptionRequired
hypervisorhypervisor type of the hosttrue
passwordthe password for the hosttrue
podidthe Pod ID for the hosttrue
urlthe host URLtrue
usernamethe username for the hosttrue
zoneidthe Zone ID for the hosttrue
allocationstateAllocation state of this Host for allocation of new resourcesfalse
clusteridthe cluster ID for the hostfalse
clusternamethe cluster name for the hostfalse
hosttagslist of tags to be added to the hostfalse

Response Tags

Response NameDescription
idthe ID of the host
accountidAccount ID to which the host is dedicated
accountnameAccount name to which the host is dedicated
affinitygroupidAffinity group ID to which the host is dedicated
affinitygroupnameAffinity group name to which the host is dedicated
averageloadthe cpu average load on the host
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
cpunumberthe CPU number of the host
cpusocketsthe number of CPU sockets on 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
dedicatedIs the host dedicated?
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
domainidDomain ID to which the host is dedicated
domainnameDomain name to which the host is dedicated
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
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
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
memorytotalthe memory total of the host
memoryusedthe amount of the host's memory currently used
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
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
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