Limites e cotas

• 25 MB por arquivo; imagens também limitadas a 40 megapixels.
• Cota por time: 5 GB e 10 000 arquivos no bucket compartilhado.
• Nomes de arquivo (name): até 4 segmentos separados por / (3 barras), cada um em [a-z0-9._-], até 200 caracteres, sem .., sem segmento começando com ., e o primeiro segmento não pode ter exatamente 12 caracteres hexadecimais (colidiria com o hash da URL imutável). Únicos dentro da galeria. Nome inválido ⇒ 400 invalid_request.
• Rate-limit por token e por IP. Ao receber 429, espere o número de segundos do cabeçalho Retry-After.

Limites de deploy, serviços e recursos

Os valores exatos do seu plano e do seu time estão em GET /v1/limits (escopo: qualquer token válido); o que o token pode fazer está em GET /v1/me.

curl -sS "$NEBULAR_API/v1/limits" \
  -H "Authorization: Bearer $NEBULAR_TOKEN"

{"plan": "hobby", "services": {"used": 1, "max": 10}, "memory_mb": {"used": 512, "max": 4096}, "volumes_gb": {"used": 0, "max": 20}, "databases": {"used": 0, "max": 3}, "deploys_per_hour": {"used": 0, "max": 30}}

Cada dimensão traz used e max. Passar de max em serviços, memória, volume ou bancos responde quota_exceeded (422 ao criar banco); deploys_per_hour limita o disparo de deploys por time (janela deslizante de 1 h, somando todos os projetos): ao atingir, deploy, rollback e deploy de grupo respondem 429 rate_limited com Retry-After (segundos até abrir vaga). Aguarde; não é erro de cota permanente. O número máximo de projetos por time (project_quota_exceeded, 409) é conferido na criação do projeto.

Regras fixas do modelo:

• Nome de serviço: ^[a-z][a-z0-9-]{0,30}$, único no projeto.
• Recursos por serviço: memory_mb padrão 512 e cpus padrão 0.5, até o máximo do plano (Escala e recursos).
• Volume: 1 por serviço, de 1 a 50 GB (Volumes).
• Variáveis: valor expandido até 64 KiB e ambiente resolvido até 256 KiB (value_too_large); referências aninhadas até 16 níveis.
• Banco: cota em MB por instância; acima do limite o banco fica somente leitura (Bancos).
• Estourar uma cota responde quota_exceeded; excesso de requisições, 429 com Retry-After.