API do Virtualizor: ligar, desligar, reiniciar e suspender VPS

Ligar, desligar com segurança, forçar o desligamento, reiniciar, suspender a VPS ou só a rede dela, e agendar o desligamento automático.

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. Ligar uma VPS — act=start
2. Desligar uma VPS — act=stop
3. Reiniciar uma VPS — act=restart
4. Forçar o desligamento de uma VPS — act=poweroff
5. Suspender uma VPS — act=listvs
6. Reativar uma VPS suspensa — act=listvs
7. Suspender só a rede de uma VPS — act=listvs
8. Reativar a rede de uma VPS — act=listvs
9. Agendar ligar, desligar ou reiniciar — act=self_shutdown
10. Cancelar um agendamento — act=self_shutdown

Ligar uma VPS

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

Liga uma VPS que está desligada.

Parâmetros

Exemplos

curl

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

PHP

$r = virt_api('start', [
    'svs' => '101',
    'do' => '1',
]);
print_r($r);

Python

r = virt_api("start", get={
    "svs": "101",
    "do": "1",
})
print(r)

Node.js

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

Resposta

done indica sucesso e msg traz a mensagem. status e output mostram o estado da VPS depois da operação. Se der errado, vem error no lugar de done.

Cuidados

• A tabela oficial lista svs como parâmetro POST, mas diz no texto que ele vai na URL — e é assim nos exemplos.

Documentação oficial: Start VM.

Desligar uma VPS

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

Pede o desligamento da VPS.

Parâmetros

Exemplos

curl

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

PHP

$r = virt_api('stop', [
    'svs' => '101',
    'do' => '1',
]);
print_r($r);

Python

r = virt_api("stop", get={
    "svs": "101",
    "do": "1",
})
print(r)

Node.js

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

Resposta

done indica sucesso e msg traz a mensagem. status e output mostram o estado da VPS depois da operação. Se der errado, vem error no lugar de done.

Cuidados

• Se a VPS não desligar, use Forçar o desligamento.

Documentação oficial: Stop VM.

Reiniciar uma VPS

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

Reinicia a VPS.

Parâmetros

Exemplos

curl

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

PHP

$r = virt_api('restart', [
    'svs' => '101',
    'do' => '1',
]);
print_r($r);

Python

r = virt_api("restart", get={
    "svs": "101",
    "do": "1",
})
print(r)

Node.js

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

Resposta

done indica sucesso e msg traz a mensagem. status e output mostram o estado da VPS depois da operação. Se der errado, vem error no lugar de done.

Documentação oficial: Restart VM.

Forçar o desligamento de uma VPS

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

Corta a energia da VPS, sem esperar o sistema fechar: o equivalente a tirar da tomada. Para quando o desligamento normal não responde.

Parâmetros

Exemplos

curl

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

PHP

$r = virt_api('poweroff', [
    'svs' => '101',
    'do' => '1',
]);
print_r($r);

Python

r = virt_api("poweroff", get={
    "svs": "101",
    "do": "1",
})
print(r)

Node.js

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

Resposta

done indica sucesso e msg traz a mensagem. status e output mostram o estado da VPS depois da operação. Se der errado, vem error no lugar de done. A documentação oficial mostra justamente um exemplo de falha, com error em vez de done.

Cuidados

• Pode corromper arquivos que estavam sendo gravados. Tente Desligar uma VPS antes.

Documentação oficial: Poweroff VM.

Suspender uma VPS

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

Suspende a VPS: ela para e o cliente não consegue ligá-la. É o que se usa em inadimplência.

Parâmetros

Exemplos

curl

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

PHP

$r = virt_api('listvs', [
    'suspend' => '101',
]);
print_r($r);

Python

r = virt_api("listvs", get={
    "suspend": "101",
})
print(r)

Node.js

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

Resposta

vs traz a lista de VPS, já com a suspensa marcada em suspended.

Cuidados

• É a ação de listar VPS com suspend na URL. A tabela oficial lista suspend como POST; o exemplo oficial e o SDK mandam pela URL, como aqui.

Documentação oficial: Suspend VM.

Reativar uma VPS suspensa

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

Tira a suspensão de uma VPS.

Parâmetros

Exemplos

curl

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

PHP

$r = virt_api('listvs', [
    'unsuspend' => '101',
]);
print_r($r);

Python

r = virt_api("listvs", get={
    "unsuspend": "101",
})
print(r)

Node.js

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

Resposta

vs traz a lista de VPS, com a reativada já sem suspended.

Cuidados

• A tabela da documentação oficial chama o parâmetro de suspend — o que suspenderia a VPS. O exemplo dela e o SDK oficial usam unsuspend, como aqui.
• Se a VPS não voltar ligada, chame Ligar uma VPS.

Documentação oficial: Unsuspend VM.

Suspender só a rede de uma VPS

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

Corta a rede da VPS sem desligá-la. Útil para conter um servidor que está atacando ou mandando spam, sem desligá-lo.

Parâmetros

Exemplos

curl

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

PHP

$r = virt_api('listvs', [
    'suspend_net' => '101',
]);
print_r($r);

Python

r = virt_api("listvs", get={
    "suspend_net": "101",
})
print(r)

Node.js

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

Resposta

vs traz a lista de VPS, com a afetada marcada em nw_suspended.

Cuidados

• A tabela oficial lista suspend_net como POST; o exemplo oficial e o SDK mandam pela URL, como aqui.

Documentação oficial: Network Suspend.

Reativar a rede de uma VPS

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

Devolve a rede a uma VPS que teve a rede suspensa.

Parâmetros

Exemplos

curl

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

PHP

$r = virt_api('listvs', [
    'unsuspend_net' => '101',
]);
print_r($r);

Python

r = virt_api("listvs", get={
    "unsuspend_net": "101",
})
print(r)

Node.js

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

Resposta

vs traz a lista de VPS, com a afetada já sem nw_suspended.

Documentação oficial: Network Unsuspend.

Agendar ligar, desligar ou reiniciar

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

Agenda uma ação de energia para data e hora marcadas: ligar, desligar, reiniciar ou forçar o desligamento.

Parâmetros

Exemplos

curl

curl -sS "https://$VIRT_HOST:4083/index.php?act=self_shutdown&svs=101&api=json&apikey=$VIRT_KEY&apipass=$VIRT_PASS" \
  --data-urlencode 'selfshutdown=1' \
  --data-urlencode 'shutdown_action=2' \
  --data-urlencode 'shutdown_date=12/31/2026' \
  --data-urlencode 'shutdown_hrs=03' \
  --data-urlencode 'shutdown_min=30'

PHP

$r = virt_api('self_shutdown', [
    'svs' => '101',
], [
    'selfshutdown' => '1',
    'shutdown_action' => '2',
    'shutdown_date' => '12/31/2026',
    'shutdown_hrs' => '03',
    'shutdown_min' => '30',
]);
print_r($r);

Python

r = virt_api("self_shutdown", get={
    "svs": "101",
}, post={
    "selfshutdown": "1",
    "shutdown_action": "2",
    "shutdown_date": "12/31/2026",
    "shutdown_hrs": "03",
    "shutdown_min": "30",
})
print(r)

Node.js

const r = await virtApi('self_shutdown', {
  svs: '101',
}, {
  selfshutdown: '1',
  shutdown_action: '2',
  shutdown_date: '12/31/2026',
  shutdown_hrs: '03',
  shutdown_min: '30',
});
console.log(r);

Resposta

done e msg confirmam. self_shutdown lista os agendamentos da VPS, cada um com id, action, date, hours e minutes — o id é o que se usa para cancelar.

Cuidados

• A data é mês/dia/ano: 31 de dezembro é 12/31/2026. No formato brasileiro, a chamada agenda outra data ou falha.
• A documentação oficial não diz em que fuso a hora é lida. Confira o fuso configurado na conta (artigo da conta Cloud) e teste com um agendamento próximo.

Documentação oficial: Start Self Shutdown.

Cancelar um agendamento

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

Apaga uma ação de energia agendada.

Parâmetros

Exemplos

curl

curl -sS "https://$VIRT_HOST:4083/index.php?act=self_shutdown&svs=101&api=json&apikey=$VIRT_KEY&apipass=$VIRT_PASS" \
  --data-urlencode 'selfshutdown=1' \
  --data-urlencode 'delete_timer=9'

PHP

$r = virt_api('self_shutdown', [
    'svs' => '101',
], [
    'selfshutdown' => '1',
    'delete_timer' => '9',
]);
print_r($r);

Python

r = virt_api("self_shutdown", get={
    "svs": "101",
}, post={
    "selfshutdown": "1",
    "delete_timer": "9",
})
print(r)

Node.js

const r = await virtApi('self_shutdown', {
  svs: '101',
}, {
  selfshutdown: '1',
  delete_timer: '9',
});
console.log(r);

Resposta

done e msg confirmam; self_shutdown traz os agendamentos que sobraram.

Documentação oficial: Delete Self Shutdown.

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.