We manage our bare-metal servers via an out-of-band IPMI module. oVirt VMs are managed via standard API.
Server power actions:
| Resource | Action | Description |
|---|
| eq.php | status | get power status |
| eq.php | sensors | Get sensors data (bare-metal only) |
| eq.php | on | Turn power on |
| eq.php | off | Turn power off |
| eq.php | reboot | Reboot server |
Eq/Status
HTTP Method - POST
| Parameter | Required | Type | Value/default | Description |
|---|
| action | * | string | status | Main action - Get power status |
| token | * | string | | Your session token |
| id | * | int | | Your server ID |
curl -s "https://invapi.hostkey.com/eq.php" -X POST \
--data "action=status" \
--data "token=" \
--data "id="
{
"result": "OK",
"action": "status",
"callback": "f685eaa0f06e47faa2e6bb5002828b00"
}
{
"result": "OK",
"scope": "VM is up now",
"context": {
"action": "status",
"id": "SERVER_ID",
"location": "NL"
},
"debug": null,
"key": "f685eaa0f06e47faa2e6bb5002828b00"
}
{
"result": "OK",
"scope": "Chassis Power is on",
"context": {
"action": "status",
"id": "your server ID",
"location": "your server location"
},
"debug": "Chassis Power is on",
"key": "f685eaa0f06e47faa2e6bb5002828b00"
}
HTTP Method - POST
| Parameter | Required | Type | Value/default | Description |
|---|
| action | * | string | sensors | Main action - Get sensors data |
| token | * | string | | Your session token |
| id | * | int | | Your server ID |
curl -s "https://invapi.hostkey.com/eq.php" -X POST \
--data "action=sensors" \
--data "token=" \
--data "id="
{
"result": "OK",
"action": "sensors",
"callback": "f685eaa0f06e47faa2e6bb5002828b00"
}
{
"result": "OK",
"scope": "CPU Temp | 36 degrees C | ok\nPCH Temp | 37 degrees C | ok\nSystem Temp | 25 degrees C | ok\nPeripheral Temp | 33 degrees C | ok\nVcpuVRM Temp | 34 degrees C | ok\nVmemABVRM Temp | 31 degrees C | ok\nVmemCDVRM Temp | 30 degrees C | ok\nP1-DIMMA1 Temp | 26 degrees C | ok\nP1-DIMMB1 Temp | 26 degrees C | ok\nP1-DIMMC1 Temp | no reading | ns\nP1-DIMMD1 Temp | no reading | ns\nFAN | 3100 RPM | ok\n12V | 12.06 Volts | ok\n5VCC | 5.08 Volts | ok\n3.3VCC | 3.33 Volts | ok\nVBAT | 3.00 Volts | ok\nVcpu | 1.84 Volts | ok\nVDIMMAB | 1.22 Volts | ok\nVDIMMCD | 1.22 Volts | ok\n5VSB | 5.10 Volts | ok\n3.3VSB | 3.27 Volts | ok\n1.5V PCH | 1.53 Volts | ok\n1.2V BMC | 1.23 Volts | ok\n1.05V PCH | 1.06 Volts | ok\nPS Status | 0x01 | ok\n",
"context": {
"action": "get_sensors",
"id": "SERVER_ID",
"location":"NL"
},
"debug":"CPU Temp | 36 degrees C | okPCH Temp | 37 degrees C | okSystem Temp | 25 degrees C | okPeripheral Temp | 33 degrees C | okVcpuVRM Temp | 34 degrees C | okVmemABVRM Temp | 31 degrees C | okVmemCDVRM Temp | 30 degrees C | okP1-DIMMA1 Temp | 26 degrees C | okP1-DIMMB1 Temp | 26 degrees C | okP1-DIMMC1 Temp | no reading | nsP1-DIMMD1 Temp | no reading | nsFAN | 3100 RPM | ok12V | 12.06 Volts | ok5VCC | 5.08 Volts | ok3.3VCC | 3.33 Volts | okVBAT | 3.00 Volts | okVcpu | 1.84 Volts | okVDIMMAB | 1.22 Volts | okVDIMMCD | 1.22 Volts | ok5VSB | 5.10 Volts | ok3.3VSB | 3.27 Volts | ok1.5V PCH | 1.53 Volts | ok1.2V BMC | 1.23 Volts | ok1.05V PCH | 1.06 Volts | okPS Status | 0x01 | ok",
"key":"f685eaa0f06e47faa2e6bb5002828b00"
}
Eq/On
HTTP Method - POST
| Parameter | Required | Type | Value/default | Description |
|---|
| action | * | string | on | Main action - Turn power on |
| token | * | string | | Your session token |
| id | * | int | | Your server ID |
| pin | * | int | | Your PIN code |
curl -s "https://invapi.hostkey.com/eq.php" -X POST \
--data "action=on" \
--data "token=" \
--data "id=" \
--data "pin="
{
"result": "OK",
"action": "on",
"callback": "f685eaa0f06e47faa2e6bb5002828b00"
}
{
"result": "OK",
"scope": "Host is on",
"context": {
"action": "on",
"id": "your server ID",
"location": "your server location"
},
"debug": "Chassis Power Control: Up/On",
"key": "f685eaa0f06e47faa2e6bb5002828b00"
}
Eq/Off
HTTP Method - POST
| Parameter | Required | Type | Value/default | Description |
|---|
| action | * | string | off | Main action - Turn power off |
| token | * | string | | Your session token |
| id | * | int | | Your server ID |
| pin | * | int | | Your PIN code |
curl -s "https://invapi.hostkey.com/eq.php" -X POST \
--data "action=off" \
--data "token=" \
--data "id=" \
--data "pin="
{
"result": "OK",
"action": "off",
"callback": "f685eaa0f06e47faa2e6bb5002828b00"
}
{
"result": "OK",
"scope": "Host is off",
"context": {
"action": "off",
"id": "your server ID",
"location": "your server location"
},
"debug": "Chassis Power Control: Down/Off",
"key": "f685eaa0f06e47faa2e6bb5002828b00"
}
Eq/Reboot
HTTP Method - POST
| Parameter | Required | Type | Value/default | Description |
|---|
| action | * | string | reboot | Main action - Reboot server |
| token | * | string | | Your session token |
| id | * | int | | Your server ID |
| pin | * | int | | Your PIN code |
| Resource | Action | HTTP Method | Description |
|---|
| eq | on | POST | Reboot server |
curl -s "https://invapi.hostkey.com/eq.php" -X POST \
--data "action=reboot" \
--data "token=" \
--data "id=" \
--data "pin="
{
"result": "OK",
"action": "reboot",
"callback": "f685eaa0f06e47faa2e6bb5002828b00"
}
{
"result": "OK",
"scope": "Host is rebooted",
"context": {
"action": "reboot",
"id": ""your server ID",
"location": "your server location"
},
"debug": "Chassis Power Control: Reset",
"key": "f685eaa0f06e47faa2e6bb5002828b00"
}