API do Virtualizor: estatísticas, logs, processos e serviços

Consumo de RAM, CPU, disco e banda; o histórico de monitoramento e de status; os logs e as tarefas da VPS; e os processos e serviços que rodam dentro dela.

Antes de começar, veja API do Virtualizor para revendedores: primeiros passos: lá estão a chave de API, o formato da chamada e as funções virt_api usadas nos exemplos em PHP, Python e Node.js.

Neste artigo

1. Ver o uso de RAM — act=ram
2. Ver o uso de CPU — act=cpu
3. Ver o uso de disco — act=disk
4. Ver o consumo de banda — act=bandwidth
5. Ver o histórico de uso da VPS — act=monitor
6. Ver o histórico de estado da VPS — act=statuslogs
7. Ver os logs da VPS — act=logs
8. Ver as tarefas da VPS — act=ctasks
9. Listar os processos da VPS — act=processes
10. Encerrar processos da VPS — act=processes
11. Listar os serviços da VPS — act=services
12. Iniciar serviços — act=services
13. Parar serviços — act=services
14. Reiniciar serviços — act=services

Ver o uso de RAM

Ação:act=ram · Método: GET

Mostra o uso de memória da VPS.

Parâmetros

Exemplos

curl

curl -sS "https://$VIRT_HOST:4083/index.php?act=ram&svs=101&api=json&apikey=$VIRT_KEY&apipass=$VIRT_PASS"

PHP

$r = virt_api('ram', [
    'svs' => '101',
]);
print_r($r);

Python

r = virt_api("ram", get={
    "svs": "101",
})
print(r)

Node.js

const r = await virtApi('ram', {
  svs: '101',
});
console.log(r);

Resposta

ram traz os dados de memória da VPS.

Documentação oficial: Ram.

Ver o uso de CPU

Ação:act=cpu · Método: GET

Mostra o uso de processador da VPS.

Parâmetros

Exemplos

curl

curl -sS "https://$VIRT_HOST:4083/index.php?act=cpu&svs=101&api=json&apikey=$VIRT_KEY&apipass=$VIRT_PASS"

PHP

$r = virt_api('cpu', [
    'svs' => '101',
]);
print_r($r);

Python

r = virt_api("cpu", get={
    "svs": "101",
})
print(r)

Node.js

const r = await virtApi('cpu', {
  svs: '101',
});
console.log(r);

Resposta

cpu traz os dados de processador da VPS.

Documentação oficial: CPU.

Ver o uso de disco

Ação:act=disk · Método: GET

Mostra o uso de disco da VPS, em espaço e em inodes.

Parâmetros

Exemplos

curl

curl -sS "https://$VIRT_HOST:4083/index.php?act=disk&svs=101&api=json&apikey=$VIRT_KEY&apipass=$VIRT_PASS"

PHP

$r = virt_api('disk', [
    'svs' => '101',
]);
print_r($r);

Python

r = virt_api("disk", get={
    "svs": "101",
})
print(r)

Node.js

const r = await virtApi('disk', {
  svs: '101',
});
console.log(r);

Resposta

disk traz o espaço e inodes a quantidade de arquivos.

Documentação oficial: Disk.

Ver o consumo de banda

Ação:act=bandwidth · Método: POST

Mostra o tráfego da VPS no mês, dia a dia. Sem show, vem o mês atual.

Parâmetros

Exemplos

curl

curl -sS "https://$VIRT_HOST:4083/index.php?act=bandwidth&svs=101&api=json&apikey=$VIRT_KEY&apipass=$VIRT_PASS" \
  --data-urlencode 'show=202609'

PHP

$r = virt_api('bandwidth', [
    'svs' => '101',
], [
    'show' => '202609',
]);
print_r($r);

Python

r = virt_api("bandwidth", get={
    "svs": "101",
}, post={
    "show": "202609",
})
print(r)

Node.js

const r = await virtApi('bandwidth', {
  svs: '101',
}, {
  show: '202609',
});
console.log(r);

Resposta

bandwidth traz o consumo e month o mês consultado; vêm também os campos band e speed.

Cuidados

• A tabela oficial diz act=ram nesta página, por engano; a URL e o exemplo usam act=bandwidth, como aqui.
• O cabeçalho da página oficial põe show na URL; a tabela e o exemplo dela mandam no corpo, como aqui.

Documentação oficial: Bandwidth.

Ver o histórico de uso da VPS

Ação:act=monitor · Método: GET

Devolve o histórico de CPU, RAM e disco da VPS, para gráficos. Com show, o histórico de um mês.

Parâmetros

Exemplos

curl

curl -sS "https://$VIRT_HOST:4083/index.php?act=monitor&svs=101&show=202609&api=json&apikey=$VIRT_KEY&apipass=$VIRT_PASS"

PHP

$r = virt_api('monitor', [
    'svs' => '101',
    'show' => '202609',
]);
print_r($r);

Python

r = virt_api("monitor", get={
    "svs": "101",
    "show": "202609",
})
print(r)

Node.js

const r = await virtApi('monitor', {
  svs: '101',
  show: '202609',
});
console.log(r);

Resposta

cpu, ram e disk trazem as séries de uso.

Cuidados

• O exemplo oficial também manda do=1 na URL; a tabela não o lista.

Documentação oficial: Monitor.

Ver o histórico de estado da VPS

Ação:act=statuslogs · Método: GET

Lista os registros de estado da VPS ao longo do tempo.

Parâmetros

Exemplos

curl

curl -sS "https://$VIRT_HOST:4083/index.php?act=statuslogs&svs=101&api=json&apikey=$VIRT_KEY&apipass=$VIRT_PASS"

PHP

$r = virt_api('statuslogs', [
    'svs' => '101',
]);
print_r($r);

Python

r = virt_api("statuslogs", get={
    "svs": "101",
})
print(r)

Node.js

const r = await virtApi('statuslogs', {
  svs: '101',
});
console.log(r);

Resposta

var traz os registros e num_res a quantidade.

Cuidados

• A tabela oficial também lista o id da VPS como vid no corpo; o exemplo dela usa só svs na URL, como aqui.

Documentação oficial: Status Logs.

Ver os logs da VPS

Ação:act=logs · Método: GET

Lista os logs de ações da VPS.

Parâmetros

Exemplos

curl

curl -sS "https://$VIRT_HOST:4083/index.php?act=logs&svs=101&api=json&apikey=$VIRT_KEY&apipass=$VIRT_PASS"

PHP

$r = virt_api('logs', [
    'svs' => '101',
]);
print_r($r);

Python

r = virt_api("logs", get={
    "svs": "101",
})
print(r)

Node.js

const r = await virtApi('logs', {
  svs: '101',
});
console.log(r);

Resposta

logs traz os registros.

Cuidados

• A tabela oficial só lista a ação; a URL de exemplo dela inclui o svs, como aqui.

Documentação oficial: Logs.

Ver as tarefas da VPS

Ação:act=ctasks · Método: GET

Lista, com detalhes, as tarefas executadas na VPS. Útil para conferir se uma operação que a API só iniciou, como reinstalação ou backup, já terminou.

Parâmetros

Exemplos

curl

curl -sS "https://$VIRT_HOST:4083/index.php?act=ctasks&svs=101&api=json&apikey=$VIRT_KEY&apipass=$VIRT_PASS"

PHP

$r = virt_api('ctasks', [
    'svs' => '101',
]);
print_r($r);

Python

r = virt_api("ctasks", get={
    "svs": "101",
})
print(r)

Node.js

const r = await virtApi('ctasks', {
  svs: '101',
});
console.log(r);

Resposta

tasks traz as tarefas; page a paginação.

Cuidados

• A documentação oficial usa act=ctasks; o SDK oficial que acompanha o módulo do WHMCS usa act=tasks. Se uma não responder, teste a outra.

Documentação oficial: Tasks.

Listar os processos da VPS

Ação:act=processes · Método: GET

Lista os processos que rodam dentro da VPS.

Parâmetros

Exemplos

curl

curl -sS "https://$VIRT_HOST:4083/index.php?act=processes&svs=101&api=json&apikey=$VIRT_KEY&apipass=$VIRT_PASS"

PHP

$r = virt_api('processes', [
    'svs' => '101',
]);
print_r($r);

Python

r = virt_api("processes", get={
    "svs": "101",
})
print(r)

Node.js

const r = await virtApi('processes', {
  svs: '101',
});
console.log(r);

Resposta

processes traz os processos, com o PID de cada um — o número que se usa para encerrar. Vem também processes_head.

Cuidados

• A documentação oficial não diz em quais virtualizações esta chamada funciona. Ver processos e serviços de dentro da VPS depende de o painel enxergar o sistema dela, o que em máquina virtual completa (KVM) nem sempre acontece. Teste na sua VPS antes de depender desta chamada.

Documentação oficial: List Processes.

Encerrar processos da VPS

Ação:act=processes · Método: POST

Encerra um ou mais processos dentro da VPS, pelo PID.

Parâmetros

Exemplos

curl

curl -sS "https://$VIRT_HOST:4083/index.php?act=processes&svs=101&api=json&apikey=$VIRT_KEY&apipass=$VIRT_PASS" \
  --data-urlencode 'sel_proc[]=144' \
  --data-urlencode 'sel_proc[]=7270'

PHP

$r = virt_api('processes', [
    'svs' => '101',
], [
    'sel_proc' => ['144', '7270'],
]);
print_r($r);

Python

r = virt_api("processes", get={
    "svs": "101",
}, post={
    "sel_proc[]": ["144", "7270"],
})
print(r)

Node.js

const r = await virtApi('processes', {
  svs: '101',
}, {
  sel_proc: ['144', '7270'],
});
console.log(r);

Resposta

processes traz a lista de processos depois do encerramento.

Cuidados

• A documentação oficial não diz em quais virtualizações esta chamada funciona. Ver processos e serviços de dentro da VPS depende de o painel enxergar o sistema dela, o que em máquina virtual completa (KVM) nem sempre acontece. Teste na sua VPS antes de depender desta chamada.
• Encerrar um processo de sistema pode derrubar a VPS ou o serviço que o cliente usa.

Documentação oficial: Kill Processes.

Listar os serviços da VPS

Ação:act=services · Método: GET

Lista os serviços da VPS e diz quais estão rodando e quais sobem no boot.

Parâmetros

Exemplos

curl

curl -sS "https://$VIRT_HOST:4083/index.php?act=services&svs=101&api=json&apikey=$VIRT_KEY&apipass=$VIRT_PASS"

PHP

$r = virt_api('services', [
    'svs' => '101',
]);
print_r($r);

Python

r = virt_api("services", get={
    "svs": "101",
})
print(r)

Node.js

const r = await virtApi('services', {
  svs: '101',
});
console.log(r);

Resposta

services traz os serviços da VPS, running os que estão rodando e autostart os que sobem no boot.

Cuidados

• A documentação oficial não diz em quais virtualizações esta chamada funciona. Ver processos e serviços de dentro da VPS depende de o painel enxergar o sistema dela, o que em máquina virtual completa (KVM) nem sempre acontece. Teste na sua VPS antes de depender desta chamada.

Documentação oficial: List Services.

Iniciar serviços

Ação:act=services · Método: POST

Inicia um ou mais serviços dentro da VPS.

Parâmetros

Exemplos

curl

curl -sS "https://$VIRT_HOST:4083/index.php?act=services&svs=101&api=json&apikey=$VIRT_KEY&apipass=$VIRT_PASS" \
  --data-urlencode 'start_x=1' \
  --data-urlencode 'sel_serv[]=nginx'

PHP

$r = virt_api('services', [
    'svs' => '101',
], [
    'start_x' => '1',
    'sel_serv' => ['nginx'],
]);
print_r($r);

Python

r = virt_api("services", get={
    "svs": "101",
}, post={
    "start_x": "1",
    "sel_serv[]": ["nginx"],
})
print(r)

Node.js

const r = await virtApi('services', {
  svs: '101',
}, {
  start_x: '1',
  sel_serv: ['nginx'],
});
console.log(r);

Resposta

services traz os serviços da VPS, running os que estão rodando e autostart os que sobem no boot.

Cuidados

• A documentação oficial não diz em quais virtualizações esta chamada funciona. Ver processos e serviços de dentro da VPS depende de o painel enxergar o sistema dela, o que em máquina virtual completa (KVM) nem sempre acontece. Teste na sua VPS antes de depender desta chamada.

Documentação oficial: Start Service.

Parar serviços

Ação:act=services · Método: POST

Para um ou mais serviços dentro da VPS.

Parâmetros

Exemplos

curl

curl -sS "https://$VIRT_HOST:4083/index.php?act=services&svs=101&api=json&apikey=$VIRT_KEY&apipass=$VIRT_PASS" \
  --data-urlencode 'stop_x=1' \
  --data-urlencode 'sel_serv[]=nginx'

PHP

$r = virt_api('services', [
    'svs' => '101',
], [
    'stop_x' => '1',
    'sel_serv' => ['nginx'],
]);
print_r($r);

Python

r = virt_api("services", get={
    "svs": "101",
}, post={
    "stop_x": "1",
    "sel_serv[]": ["nginx"],
})
print(r)

Node.js

const r = await virtApi('services', {
  svs: '101',
}, {
  stop_x: '1',
  sel_serv: ['nginx'],
});
console.log(r);

Resposta

services traz os serviços da VPS, running os que estão rodando e autostart os que sobem no boot.

Cuidados

• A documentação oficial não diz em quais virtualizações esta chamada funciona. Ver processos e serviços de dentro da VPS depende de o painel enxergar o sistema dela, o que em máquina virtual completa (KVM) nem sempre acontece. Teste na sua VPS antes de depender desta chamada.
• Parar o sshd derruba o acesso SSH à VPS; daí só pelo console VNC. O exemplo oficial usa justamente esse serviço.

Documentação oficial: Stop Services.

Reiniciar serviços

Ação:act=services · Método: POST

Reinicia um ou mais serviços dentro da VPS.

Parâmetros

Exemplos

curl

curl -sS "https://$VIRT_HOST:4083/index.php?act=services&svs=101&api=json&apikey=$VIRT_KEY&apipass=$VIRT_PASS" \
  --data-urlencode 'restart_x=1' \
  --data-urlencode 'sel_serv[]=nginx'

PHP

$r = virt_api('services', [
    'svs' => '101',
], [
    'restart_x' => '1',
    'sel_serv' => ['nginx'],
]);
print_r($r);

Python

r = virt_api("services", get={
    "svs": "101",
}, post={
    "restart_x": "1",
    "sel_serv[]": ["nginx"],
})
print(r)

Node.js

const r = await virtApi('services', {
  svs: '101',
}, {
  restart_x: '1',
  sel_serv: ['nginx'],
});
console.log(r);

Resposta

services traz os serviços da VPS, running os que estão rodando e autostart os que sobem no boot.

Cuidados

• A documentação oficial não diz em quais virtualizações esta chamada funciona. Ver processos e serviços de dentro da VPS depende de o painel enxergar o sistema dela, o que em máquina virtual completa (KVM) nem sempre acontece. Teste na sua VPS antes de depender desta chamada.
• O exemplo em curl da documentação oficial manda sel_serv sem colchetes nesta página, e com colchetes nas de iniciar e parar. Este artigo usa a lista nas três.

Documentação oficial: Restart Services.

Texto da Vitt Host, escrito a partir da documentação oficial da Virtualizor, lida em 07/10/2026. Onde a documentação oficial se contradiz, o artigo segue os exemplos dela e aponta a diferença em Cuidados.