API do Virtualizor: VNC, modo de resgate e ISO

O que usar quando a VPS não responde pela rede: o console VNC, o modo de resgate e as imagens ISO para dar boot.

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

Ver os dados de acesso ao VNC — act=vnc
Trocar a senha do VNC — act=vncpass
Ligar o modo de resgate — act=rescue
Desligar o modo de resgate — act=rescue
Listar as ISOs — act=euiso
Adicionar uma ISO por URL — act=addiso
Apagar uma ISO — act=euiso

Ver os dados de acesso ao VNC

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

Devolve o endereço, a porta e a senha do console VNC da VPS: a tela dela, acessível mesmo quando a rede ou o SSH caíram.

Parâmetros

Parâmetro	Onde	Tipo	Obrigatório	Descrição
`svs`	URL	número	sim	Id da VPS.
`novnc`	URL	número	sim	Id da VPS, de novo. A documentação oficial pede o id nos dois campos.

Exemplos

curl

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

PHP

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

Python

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

Node.js

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

Resposta

ip, port e password são os dados de acesso ao VNC. A resposta traz também o campo novnc.

Cuidados

A resposta traz a senha do VNC: não a exiba nem guarde fora de um ambiente controlado.
A URL de exemplo da documentação oficial carrega também do=add, sobra de outra página. Não é necessário.

Documentação oficial: VNC Info.

Trocar a senha do VNC

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

Define uma senha nova para o console VNC da VPS. Só KVM.

Parâmetros

Parâmetro	Onde	Tipo	Obrigatório	Descrição
`svs`	URL	número	sim	Id da VPS.
`vncpass`	corpo (POST)	1	sim	Confirma a troca.
`newpass`	corpo (POST)	texto	sim	Senha nova do VNC.
`conf`	corpo (POST)	texto	sim	A mesma senha, para confirmar.

Exemplos

curl

curl -sS "https://$VIRT_HOST:4083/index.php?act=vncpass&svs=101&api=json&apikey=$VIRT_KEY&apipass=$VIRT_PASS" \
  --data-urlencode 'vncpass=1' \
  --data-urlencode 'newpass=Vnc-Senha-2026' \
  --data-urlencode 'conf=Vnc-Senha-2026'

PHP

$r = virt_api('vncpass', [
    'svs' => '101',
], [
    'vncpass' => '1',
    'newpass' => 'Vnc-Senha-2026',
    'conf' => 'Vnc-Senha-2026',
]);
print_r($r);

Python

r = virt_api("vncpass", get={
    "svs": "101",
}, post={
    "vncpass": "1",
    "newpass": "Vnc-Senha-2026",
    "conf": "Vnc-Senha-2026",
})
print(r)

Node.js

const r = await virtApi('vncpass', {
  svs: '101',
}, {
  vncpass: '1',
  newpass: 'Vnc-Senha-2026',
  conf: 'Vnc-Senha-2026',
});
console.log(r);

Resposta

done confirma a troca.

Cuidados

A tabela da documentação oficial diz que a senha nova vai em vncpass; o exemplo dela usa vncpass=1 como confirmação e a senha em newpass. Este artigo segue o exemplo.
O protocolo VNC só considera os 8 primeiros caracteres da senha.

Documentação oficial: VNC Password.

Ligar o modo de resgate

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

Dá boot na VPS por um sistema de resgate, com o disco dela disponível para consertar: senha perdida, fstab errado, sistema que não sobe.

Parâmetros

Parâmetro	Onde	Tipo	Obrigatório	Descrição
`svs`	URL	número	sim	Id da VPS.
`enablerescue`	corpo (POST)	1	sim	Confirma.
`password`	corpo (POST)	texto	sim	Senha do root do sistema de resgate.
`conf_password`	corpo (POST)	texto	sim	A mesma senha, para confirmar.

Exemplos

curl

curl -sS "https://$VIRT_HOST:4083/index.php?act=rescue&svs=101&api=json&apikey=$VIRT_KEY&apipass=$VIRT_PASS" \
  --data-urlencode 'enablerescue=1' \
  --data-urlencode 'password=Senha-Resgate-2026' \
  --data-urlencode 'conf_password=Senha-Resgate-2026'

PHP

$r = virt_api('rescue', [
    'svs' => '101',
], [
    'enablerescue' => '1',
    'password' => 'Senha-Resgate-2026',
    'conf_password' => 'Senha-Resgate-2026',
]);
print_r($r);

Python

r = virt_api("rescue", get={
    "svs": "101",
}, post={
    "enablerescue": "1",
    "password": "Senha-Resgate-2026",
    "conf_password": "Senha-Resgate-2026",
})
print(r)

Node.js

const r = await virtApi('rescue', {
  svs: '101',
}, {
  enablerescue: '1',
  password: 'Senha-Resgate-2026',
  conf_password: 'Senha-Resgate-2026',
});
console.log(r);

Resposta

done confirma; rescue_enabled diz se o resgate está ativo, e cant_rescue aparece quando a VPS não pode entrar em resgate. status e output trazem o estado da VPS.

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.
Desligue o modo de resgate quando terminar, ou a VPS continua dando boot por ele.

Documentação oficial: Enable Rescue.

Desligar o modo de resgate

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

Volta a VPS a dar boot pelo próprio disco.

Parâmetros

Parâmetro	Onde	Tipo	Obrigatório	Descrição
`svs`	URL	número	sim	Id da VPS.
`disablerescue`	corpo (POST)	1	sim	Confirma.

Exemplos

curl

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

PHP

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

Python

r = virt_api("rescue", get={
    "svs": "101",
}, post={
    "disablerescue": "1",
})
print(r)

Node.js

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

Resposta

done confirma; rescue_enabled mostra o estado final.

Cuidados

A primeira URL da página oficial tem os nomes trocados (vpsid=svs); o exemplo dela usa svs, como aqui.

Documentação oficial: Disable Rescue.

Listar as ISOs

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

Lista as imagens ISO que o usuário enviou e que podem ser montadas na VPS.

Parâmetros

Parâmetro	Onde	Tipo	Obrigatório	Descrição
`svs`	URL	número	sim	Id da VPS.

Exemplos

curl

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

PHP

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

Python

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

Node.js

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

Resposta

isos traz as ISOs, com o id de cada uma, e enable_eu_iso diz se o envio de ISO pelo usuário está liberado.

Cuidados

A URL de exemplo da documentação oficial carrega também do=add. Não é necessário para listar.

Documentação oficial: List ISO.

Adicionar uma ISO por URL

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

Baixa uma imagem ISO de uma URL para o servidor, para depois montá-la na VPS.

Parâmetros

Parâmetro	Onde	Tipo	Obrigatório	Descrição
`svs`	URL	número	sim	Id da VPS.
`addiso`	corpo (POST)	1	sim	Confirma.
`filename`	corpo (POST)	texto	sim	Nome do arquivo da ISO.
`iso_url`	corpo (POST)	texto	sim	Endereço de onde baixar a ISO.

Exemplos

curl

curl -sS "https://$VIRT_HOST:4083/index.php?act=addiso&svs=101&api=json&apikey=$VIRT_KEY&apipass=$VIRT_PASS" \
  --data-urlencode 'addiso=1' \
  --data-urlencode 'filename=debian-netinst.iso' \
  --data-urlencode 'iso_url=https://exemplo.com.br/imagens/debian-netinst.iso'

PHP

$r = virt_api('addiso', [
    'svs' => '101',
], [
    'addiso' => '1',
    'filename' => 'debian-netinst.iso',
    'iso_url' => 'https://exemplo.com.br/imagens/debian-netinst.iso',
]);
print_r($r);

Python

r = virt_api("addiso", get={
    "svs": "101",
}, post={
    "addiso": "1",
    "filename": "debian-netinst.iso",
    "iso_url": "https://exemplo.com.br/imagens/debian-netinst.iso",
})
print(r)

Node.js

const r = await virtApi('addiso', {
  svs: '101',
}, {
  addiso: '1',
  filename: 'debian-netinst.iso',
  iso_url: 'https://exemplo.com.br/imagens/debian-netinst.iso',
});
console.log(r);

Resposta

done confirma; addiso traz os dados da ISO.

Cuidados

O campo addiso não está na tabela da documentação oficial, só no exemplo dela.
Use a URL oficial da distribuição. ISO de origem desconhecida pode trazer malware para dentro da VPS.
Para dar boot pela ISO, monte-a e mude a ordem de boot em Alterar ordem de boot, placa de rede e opções da VM.

Documentação oficial: Add ISO.

Apagar uma ISO

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

Remove uma ISO enviada pelo usuário.

Parâmetros

Parâmetro	Onde	Tipo	Obrigatório	Descrição
`svs`	URL	número	sim	Id da VPS.
`del`	corpo (POST)	texto	sim	Id da ISO, da lista em Listar as ISOs.

Exemplos

curl

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

PHP

$r = virt_api('euiso', [
    'svs' => '101',
], [
    'del' => 'ID_DA_ISO',
]);
print_r($r);

Python

r = virt_api("euiso", get={
    "svs": "101",
}, post={
    "del": "ID_DA_ISO",
})
print(r)

Node.js

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

Resposta

done confirma; isos traz as que sobraram.

Cuidados

O cabeçalho da página oficial mostra act=addiso, mas a tabela e o exemplo usam act=euiso, como aqui.

Documentação oficial: Delete ISO.

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.

Neste artigo

Ver os dados de acesso ao VNC

Parâmetros

Exemplos

curl

PHP

Python

Node.js

Resposta

Cuidados

Trocar a senha do VNC

Parâmetros

Exemplos

curl

PHP

Python

Node.js

Resposta

Cuidados

Ligar o modo de resgate

Parâmetros

Exemplos

curl

PHP

Python

Node.js

Resposta

Cuidados

Desligar o modo de resgate

Parâmetros

Exemplos

curl

PHP

Python

Node.js

Resposta

Cuidados

Listar as ISOs

Parâmetros

Exemplos

curl

PHP

Python

Node.js

Resposta

Cuidados

Adicionar uma ISO por URL

Parâmetros

Exemplos

curl

PHP

Python

Node.js

Resposta

Cuidados

Apagar uma ISO

Parâmetros

Exemplos

curl

PHP

Python

Node.js

Resposta

Cuidados

Hosting

Empresa

Outras páginas