# Planos de VPS

Os planos que definem CPU, RAM e disco de cada VPS, quem os pode escolher e como se muda de plano.

Fonte: https://ardumaker.com/pt/docs/planes-vps/

- Categoria: Pagamentos e administração
- Estado: Disponível
- Requisitos: Ser admin da empresa para mudar o plano de um VPS
- Ferramentas MCP (Só leem): `listar_planes_vps`
- Ferramentas MCP (Escrevem ou modificam): `cambiar_plan_vps`

## O que permite fazer?

Cada VPS tem um plano com núcleos de CPU, GB de RAM, GB de disco e um preço mensal. Há planos públicos, planos de escolas com acordo e planos reservados à comunidade 42.

- Ver que planos cada pessoa pode escolher e porque algum não está disponível.
- Mudar o plano de um VPS existente, para cima ou para baixo.

## Quando convém usar?

Ao criar um VPS, e quando o servidor fica curto ou sobra capacidade.

## Como funciona na ArduMaker?

A disponibilidade de um plano depende do titular: um plano pode ter limite por pessoa, uma quota global ou pertencer a uma escola. A listagem devolve para cada plano um bloco `elegibilidad` com `puede` e, se não, o código do motivo.

1. A elegibilidade do novo plano é validada contra o dono do VPS, com as mesmas regras da criação.
2. Se o novo plano tiver menos disco, verifica-se que o espaço usado cabe.
3. Se o VPS tinha um benefício de escola sobre o plano anterior, termina.
4. Os novos limites de CPU, RAM e disco são aplicados ao contêiner e o VPS é arrancado.
5. O serviço passa ao preço do novo plano; se tinha um bloco pré-pago, devolve-se o não usado e abre-se outro com o novo plano.

## O que muda realmente?

- No host: os limites do contêiner do VPS.
- Na ArduMaker: o plano do VPS, uma entrada no registro de atividade e o preço do serviço.

> **PRECAUCION:** A mudança de plano reinicia o VPS. Convém fazê-la em um momento sem tráfego.

## Esquema

**Mudança de plano**

```text
Admin ou agente
  ↓
Elegibilidade (contra o dono do VPS)
  ↓
Verificação de disco (se o plano encolhe)
  ↓
Host do VPS (aplica CPU, RAM e disco)
  ↓
Faturamento (preço e pré-pago)
```

## Resultado esperado

O VPS volta a arrancar com os recursos do novo plano e a cobrança seguinte usa o seu preço. Os preços de cada plano consultam-se na plataforma.

## Erros e resolução

- **409 por disco**: o espaço usado não cabe no disco do novo plano. É preciso libertar espaço primeiro.
- **Plano não elegível**: o código de `elegibilidad` diz porquê (por exemplo, o servidor gratuito já foi usado ou a escola não tem vagas).
- **`Plan update failed`**: o host não aplicou os limites; o plano do VPS não muda.

## Relação com MCP

`listar_planes_vps` é de leitura e, com `company_id` e `vps_id`, indica para que planos esse servidor pode passar. `cambiar_plan_vps` é só para admins da empresa. Ver [/mcp/vps](https://ardumaker.com/pt/mcp/vps).

| Tipo | Ferramentas |
| --- | --- |
| Leitura | `listar_planes_vps` |
| Modifica | `cambiar_plan_vps` |

## Funcionalidades relacionadas

- [Servidores VPS](https://ardumaker.com/pt/docs/vps/)
- [Consumo de serviços](https://ardumaker.com/pt/docs/consumo-de-servicios/)
- [Escolas](https://ardumaker.com/pt/docs/escuelas/)
- [Saldo por empresa](https://ardumaker.com/pt/docs/saldo-por-empresa/)
