Skip to main content

Host

Hosts are the hypervisor machines that run instances (typically an administrator-scoped read).

Resource base path: /restapi/host

MethodPathDescription
GET/restapi/host/hostListHost List
note

apikey and secretkey are required HTTP headers on every request and are omitted from the parameter tables below. See Authentication.


Host List

Host List.

GET /restapi/host/hostList

Parameters

ParameterInTypeRequiredDescription
uuidquerystringNoUUID of the resource.

Example request

curl -X GET \
"https://portal.your-domain.com/restapi/host/hostList" \
-H "apikey: YOUR_API_KEY" \
-H "secretkey: YOUR_SECRET_KEY"

Responses

CodeDescription
200Successful operation.
401Invalid authentication credentials.
550Permission denied.
{
"count": 1,
"listHostResponse": [
{
"cpuAllocated": "string",
"memoryUsedPercentage": "string",
"cpuUsed": "string",
"memoryAllocatedPercentage": "string",
"isActive": true,
"uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"cpuCores": "string",
"memoryTotal": "string",
"hypervisor": "string",
"name": "example-name",
"podName": "example-name",
"vmCount": "string",
"status": "Active"
}
]
}