Limites e quotas
Esta página centraliza limites operacionais conhecidos da Zenifra. Alguns limites dependem do plano, da organização, do tipo de projeto ou de condições comerciais vigentes no console.
API da Zenifra
| Recurso | Limite atual |
|---|---|
| Rate limit geral da API de projeto | 100 requisições por minuto por projeto |
| Erro ao exceder limite | 429 Too Many Requests |
| Autenticação | header x-api-key |
Para automações com volume maior, entre em contato com o suporte antes de aumentar a frequência das chamadas.
Variáveis de ambiente
| Recurso | Limite atual |
|---|---|
| Variáveis por projeto via API | 50 |
| Tamanho máximo do nome | 120 caracteres |
| Tamanho máximo do valor | 32760 caracteres |
Use variáveis apenas para configuração e segredos. Arquivos grandes, certificados extensos ou listas volumosas devem ser tratados por outro mecanismo de configuração da aplicação.
Projetos HTTP
| Recurso | Limite ou regra |
|---|---|
| Instâncias HTTP padrão | até 10 instâncias por projeto |
| Escala automática | não disponível como capacidade atual |
| Porta | configurada manualmente no projeto |
| URL padrão | *.clients.zenifra.com |
| Logs | disponíveis conforme plano |
| Métricas HTTP | logs, CPU, RAM, storage e requisições HTTP conforme plano |
Para mais de 10 instâncias ou necessidades específicas de tráfego, fale com o suporte antes de dimensionar a aplicação.
Deploy e imagem
| Recurso | Regra |
|---|---|
| Origem GitHub | branch, runtime, versão do runtime e auto-deploy definidos na criação |
| Origem OCI | projeto continua sendo OCI depois da criação |
| Imagem pública | não exige autenticação |
| Imagem privada | pode usar AWS ECR ou usuário e token/senha de registry |
| Tipo de autenticação OCI | não deve ser tratado como editável depois da criação |
Use tags de imagem que identifiquem versão, commit ou release. Evite depender de latest em produção.
Bancos de dados
| Recurso | Limite ou regra |
|---|---|
| PostgreSQL | 1 a 3 instâncias totais |
| MariaDB | 3 instâncias |
| Downgrade de versão | não suportado |
| Storage | pode aumentar, mas não diminuir |
DATABASE_URL | não é injetada automaticamente em projetos HTTP |
| Métricas de banco | CPU, RAM e storage em planos Premium+ |
Upgrade de versão e aumento de storage podem causar indisponibilidade temporária. Execute essas alterações em janela de baixo uso.
Observabilidade
| Recurso | Comportamento atual |
|---|---|
| Logs HTTP | atualização em até 60 segundos |
| Métricas de recurso | atualização em até 5 minutos |
| Visualização | por instância quando aplicável |
| Métricas de requisições HTTP | volume, tráfego de rede, distribuição de status, rotas, user agents e latência P95 quando disponível conforme plano |
| Uptime por aplicação | não disponível como capacidade documentada atual |
Consulte Observabilidade para detalhes por tipo de projeto.
IA
| Recurso | Regra |
|---|---|
| API | compatível com clientes OpenAI-compatible |
| Chave de IA | criada no console com budget e modelos permitidos |
| Cobrança | por tokens, com saldo da conta usado primeiro |
| Modelos disponíveis | consultar o console |
| Limite de custo | definido por budget da chave |
Se a chave exceder o budget ou tentar usar um modelo não permitido, a aplicação deve tratar o erro retornado pela API e orientar o usuário a revisar a chave no console.
O que depende do plano ou suporte
Estes limites podem variar e devem ser confirmados no console ou com o suporte:
- CPU e RAM por plano
- storage incluído ou cobrado
- domínio personalizado
- retenção de logs
- tamanho máximo de imagem OCI
- limites de build
- timeout de request HTTP
- número máximo de projetos por organização
- número máximo de chaves por recurso
Próximos passos
FAQ
Posso pedir limites maiores?
Sim. Para limites operacionais como instâncias, tráfego, API ou uso empresarial, entre em contato com o suporte antes de depender do aumento em produção.
Esta página substitui o console?
Não. O console continua sendo a fonte para planos, recursos disponíveis e condições comerciais vigentes.
O que acontece se eu exceder rate limit?
A API retorna 429 Too Many Requests. A aplicação deve aplicar backoff, reduzir frequência ou solicitar aumento de limite.