> ## Documentation Index
> Fetch the complete documentation index at: https://novita.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Limites de cota
O Agent Sandbox aplica limites de cota com base no nível da sua conta. As cotas definem os recursos e as capacidades disponíveis para cada nível.
Se você precisar de limites mais altos, entre em contato com nossa equipe de suporte.
## Níveis de conta
| Nível da conta | Descrição |
| -------------- | ----------------------------------------------------------------------------------------------- |
| Free | O nível padrão para novos usuários. |
| Paid | Disponível após adicionar saldo à conta ou habilitar uma linha de crédito. |
| Enterprise | Projetado para clientes empresariais que precisam de limites personalizados e suporte dedicado. |
## Cotas padrão
| Limite | Free | Paid | Enterprise |
| ------------------------ | --------- | --------- | ----------------------------- |
| Sandboxes simultâneos | 5 | 100 | 500 por padrão, ajustável |
| Duração máxima da sessão | 1 hora | 3 horas | 4 horas por padrão, ajustável |
| vCPU máxima | 2 vCPU | 8 vCPU | 8 vCPU por padrão, ajustável |
| Memória máxima | 4 GiB | 8 GiB | 8 GiB por padrão, ajustável |
| Espaço em disco local | 20 GB | 20 GB | 20 GB por padrão, ajustável |
| Incremento de memória | 512 MiB | 512 MiB | 512 MiB |
| Memória por vCPU | 0.5-4 GiB | 0.5-4 GiB | 0.5-4 GiB |
## Regras de configuração
Ao configurar CPU e memória, sua configuração deve atender aos seguintes requisitos:
* A vCPU não deve exceder o limite máximo de vCPU para o nível da sua conta.
* A memória não deve exceder o limite máximo de memória para o nível da sua conta.
* A vCPU deve ser configurada como um valor inteiro, como 1, 2, 4 ou 8 vCPU.
* A memória deve ser configurada em incrementos de 512 MiB.
* A memória deve estar dentro do intervalo permitido de 0.5-4 GiB por vCPU.
Por exemplo:
* 1 vCPU oferece suporte a 512 MiB a 4 GiB de memória.
* 2 vCPU oferecem suporte a 1 GiB a 8 GiB de memória.
* 4 vCPU podem oferecer suporte a até 16 GiB de memória com base no intervalo de memória por vCPU, mas a memória real disponível ainda é limitada pela cota máxima de memória do nível da sua conta.
A configuração final disponível é determinada tanto pelos limites do nível da sua conta quanto pelo intervalo permitido de memória por vCPU.
## Verificar o uso atual da cota
Use a API de cotas para verificar os limites de cota disponíveis para sua conta e os recursos atualmente em uso. Isso é útil antes de iniciar um grande lote de sandboxes ou ao solucionar falhas de inicialização relacionadas a cotas.
### Verificar o uso da cota usando os SDKs
```js JavaScript & TypeScript icon="js" theme={"system"}
import { Sandbox } from 'novita-sandbox'
const quota = await Sandbox.getQuota()
console.log('Quota limit:', quota.limit)
console.log('Current usage:', quota.usage)
// Example shape:
// {
// limit: {
// concurrentInstances: 100,
// concurrentVcpu: 200,
// concurrentRamMb: 409600,
// maxLengthHours: 4,
// diskMb: 20480,
// maxVcpu: 8,
// maxRamMb: 8192
// },
// usage: {
// concurrentInstances: 12,
// concurrentVcpu: 24,
// concurrentRamMb: 49152
// }
// }
```
```python Python icon="python" theme={"system"}
from novita_sandbox.core import Sandbox
quota = Sandbox.get_quota()
print('Quota limit:', quota.limit)
print('Current usage:', quota.usage)
# Example shape:
# {
# "limit": {
# "concurrentInstances": 100,
# "concurrentVcpu": 200,
# "concurrentRamMb": 409600,
# "maxLengthHours": 4,
# "diskMb": 20480,
# "maxVcpu": 8,
# "maxRamMb": 8192,
# },
# "usage": {
# "concurrentInstances": 12,
# "concurrentVcpu": 24,
# "concurrentRamMb": 49152,
# },
# }
```
### Campos da resposta de cota
A resposta de cota inclui os objetos `limit` e `usage`.
| Campo | Descrição |
| --------------------------- | ---------------------------------------------------------------------------------------------- |
| `limit.concurrentInstances` | Número máximo de sandboxes que podem ser executados simultaneamente. |
| `limit.concurrentVcpu` | Número máximo total de núcleos vCPU que podem ser usados simultaneamente. |
| `limit.concurrentRamMb` | RAM total máxima que pode ser usada simultaneamente, em MB. |
| `limit.maxLengthHours` | Tempo de vida máximo para um único sandbox, em horas. |
| `limit.diskMb` | Armazenamento de runtime disponível para um único sandbox, em MB. |
| `limit.maxVcpu` | Número máximo de núcleos vCPU para um único sandbox. Aplica-se depois que o template é criado. |
| `limit.maxRamMb` | Memória máxima para um único sandbox, em MB. Aplica-se depois que o template é criado. |
| `usage.concurrentInstances` | Número atual de sandboxes em execução. |
| `usage.concurrentVcpu` | Número total atual de núcleos vCPU em uso. |
| `usage.concurrentRamMb` | RAM total atual em uso, em MB. |
O uso da cota é destinado ao planejamento de capacidade e à solução de problemas. Os dados de uso podem ter um pequeno atraso, dependendo do caminho de relatório de recursos do backend.
## Observações
* Se sua configuração de recursos exceder a cota do nível da sua conta, a solicitação falhará.
* Se uma região não tiver capacidade disponível, a criação do sandbox poderá falhar com um erro relacionado a cota ou limite de taxa, mesmo quando a cota no nível da sua conta não tiver sido totalmente usada.
* Escolha CPU e memória com base nos requisitos da sua carga de trabalho para evitar erros de falta de memória ou uso desnecessário de recursos.
* As cotas Enterprise podem ser personalizadas com base nos seus requisitos. Para solicitar um aumento de cota, entre em contato com nossa equipe de suporte.