Português
English
A resposta curta: pela API vê o estado dos seus servidores VPS e liga, desliga, reinicia, faz cópias, muda o DNS reverso e o fuso horário, gera uma senha de root nova, reinstala e restaura. Lê com vps:read e age com vps:write; senha, reinstalação e restauro têm permissões próprias, desligadas por omissão.
Que servidores aparecem
Só os servidores activos ou suspensos da conta geridos pelo painel do Meu Interweb. Um servidor por criar, terminado ou cancelado responde 404. O id de um servidor é o mesmo do seu serviço em GET /v1/services. Com o serviço suspenso, os dados lêem-se, mas as acções respondem 409 com service_not_active.
| Operação | O que mostra |
| GET /v1/servers, GET /v1/servers/{id} | IP, sistema, recursos e power_state. |
| GET .../traffic | O tráfego do mês. |
| GET .../backups | As cópias. |
| GET .../reverse-dns, GET .../timezone | O DNS reverso e o fuso horário. |
| GET .../operating-systems | Os sistemas disponíveis para reinstalar. |
O estado vem de uma cópia recente: state_checked_at diz quando foi lido. O detalhe usa uma cópia com até 60 segundos; a lista só actualiza 2 servidores de cada vez. Se não for possível ler agora, vem state_stale a true com o último estado conhecido.
Ligar, desligar e reiniciar
curl https://api.interweb.co.mz/v1/servers/123/restart -X POST -H "Authorization: Bearer $RLX_API_KEY"
POST .../start, .../stop e .../restart entram em fila e respondem 202 com um action_id. Ligar costuma demorar cerca de 2 minutos e desligar cerca de 6. Acompanhe com GET /v1/actions/{id}, como explicamos em operações longas.
Um de cada vez, e os limites
| Regra | Valor |
| Acções em simultâneo no mesmo servidor | Uma. Com outra em curso: 409 action_in_progress. |
| Entre acções no mesmo servidor | 15 segundos |
| Acções em toda a conta | 10 por minuto |
| Senhas novas | 5 por hora, em toda a conta |
| Reinstalações ou restauros | 3 por hora, em toda a conta |
O excesso responde 429 com Retry-After. As chaves sandbox_ têm estes limites à parte.
Senha de root, reinstalação e restauro
| Operação | Permissão | Cuidado |
| POST .../password | vps:password | Precisa do nome do servidor em confirm. O servidor reinicia para aplicar a senha, que funciona ao fim de 1 a 2 minutos. A senha aparece só nessa resposta. |
| POST .../reinstall | vps:reinstall | Apaga tudo e instala o sistema em operating_system. Com backup_first a true, a reinstalação começa sozinha quando a cópia aparecer, o que pode demorar até uma hora. A nova senha de root aparece só nessa resposta. |
| POST .../restore | vps:restore | Volta ao estado da cópia indicada em backup. Tudo o que mudou depois dela perde-se. |
A reinstalação e o restauro precisam também do cabeçalho Idempotency-Key e do nome do servidor em confirm.
| Guarde a senha de root logo que a receber. Repetir o pedido com a mesma Idempotency-Key não gera outra e devolve password a null. Em Sandbox, a senha não é verdadeira. Melhor ainda: entre por chave SSH, como explicamos em como criar uma chave SSH. |
Cópias, DNS reverso e fuso horário
POST .../backups faz uma cópia, que pode demorar até 50 minutos a aparecer. Cada servidor tem no máximo 4 cópias, contando as automáticas; com 4, a resposta é 409 com backup_limit_reached. Descarregar e apagar cópias faz-se no Meu Interweb. PUT .../reverse-dns muda o nome de cada IP do servidor e PUT .../timezone muda o fuso, escolhido da lista.
| O que fica no Meu Interweb: comprar IP ou disco extra, a consola e o CD virtual. Os planos estão na página de servidores VPS. |
|
Quer controlar o seu VPS a partir de scripts? Veja a página da API e teste com uma chave Sandbox, que não toca no servidor. Ver a página da API |
PRODUTO RECOMENDADO Servidor VPS com acesso root Recursos só seus, o sistema que escolher, reinstalação quando quiser. desde 456,30 MT/mês (plano de 3 anos, com cupão) Ver planos |
