> ## 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 quota
Agent Sandbox applique des limites de quota en fonction de votre niveau de compte. Les quotas définissent les ressources et les capacités disponibles pour chaque niveau.
Si vous avez besoin de limites plus élevées, veuillez contacter notre équipe d’assistance.
## Niveaux de compte
| Niveau de compte | Description |
| ---------------- | -------------------------------------------------------------------------------------------------------- |
| Free | Le niveau par défaut pour les nouveaux utilisateurs. |
| Paid | Disponible après l’ajout d’un solde de compte ou l’activation d’une ligne de crédit. |
| Enterprise | Conçu pour les clients d’entreprise qui ont besoin de limites personnalisées et d’une assistance dédiée. |
## Quotas par défaut
| Limite | Free | Paid | Enterprise |
| ------------------------- | --------- | --------- | ------------------------------ |
| Sandboxes simultanés | 5 | 100 | 500 par défaut, ajustable |
| Durée maximale de session | 1 heure | 3 heures | 4 heures par défaut, ajustable |
| vCPU maximal | 2 vCPU | 8 vCPU | 8 vCPU par défaut, ajustable |
| Mémoire maximale | 4 GiB | 8 GiB | 8 GiB par défaut, ajustable |
| Espace disque local | 20 GB | 20 GB | 20 GB par défaut, ajustable |
| Incrément de mémoire | 512 MiB | 512 MiB | 512 MiB |
| Mémoire par vCPU | 0.5-4 GiB | 0.5-4 GiB | 0.5-4 GiB |
## Règles de configuration
Lorsque vous configurez le CPU et la mémoire, votre configuration doit respecter les exigences suivantes :
* Le vCPU ne doit pas dépasser la limite maximale de vCPU pour votre niveau de compte.
* La mémoire ne doit pas dépasser la limite maximale de mémoire pour votre niveau de compte.
* Le vCPU doit être configuré sous forme de valeur entière, par exemple 1, 2, 4 ou 8 vCPU.
* La mémoire doit être configurée par incréments de 512 MiB.
* La mémoire doit se situer dans la plage autorisée de 0.5-4 GiB par vCPU.
Par exemple :
* 1 vCPU prend en charge de 512 MiB à 4 GiB de mémoire.
* 2 vCPU prennent en charge de 1 GiB à 8 GiB de mémoire.
* 4 vCPU peuvent prendre en charge jusqu’à 16 GiB de mémoire selon la plage de mémoire par vCPU, mais la mémoire réellement disponible reste limitée par le quota maximal de mémoire de votre niveau de compte.
La configuration finale disponible est déterminée à la fois par les limites de votre niveau de compte et par la plage de mémoire par vCPU autorisée.
## Vérifier l’utilisation actuelle des quotas
Utilisez l’API de quota pour vérifier les limites de quota disponibles pour votre compte et les ressources actuellement utilisées. Cela est utile avant de lancer un grand lot de sandboxes ou lors du dépannage d’échecs de lancement liés aux quotas.
### Vérifier l’utilisation des quotas avec les 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,
# },
# }
```
### Champs de la réponse de quota
La réponse de quota inclut les objets `limit` et `usage`.
| Champ | Description |
| --------------------------- | -------------------------------------------------------------------------------------------- |
| `limit.concurrentInstances` | Nombre maximal de sandboxes pouvant s’exécuter simultanément. |
| `limit.concurrentVcpu` | Nombre maximal total de cœurs vCPU pouvant être utilisés simultanément. |
| `limit.concurrentRamMb` | RAM totale maximale pouvant être utilisée simultanément, en MB. |
| `limit.maxLengthHours` | Durée de vie maximale pour un sandbox unique, en heures. |
| `limit.diskMb` | Stockage d’exécution disponible pour un sandbox unique, en MB. |
| `limit.maxVcpu` | Nombre maximal de cœurs vCPU pour un sandbox unique. S’applique une fois le template généré. |
| `limit.maxRamMb` | Mémoire maximale pour un sandbox unique, en MB. S’applique une fois le template généré. |
| `usage.concurrentInstances` | Nombre actuel de sandboxes en cours d’exécution. |
| `usage.concurrentVcpu` | Nombre total actuel de cœurs vCPU utilisés. |
| `usage.concurrentRamMb` | RAM totale actuelle utilisée, en MB. |
L’utilisation des quotas est destinée à la planification de capacité et au dépannage. Les données d’utilisation peuvent présenter un court délai, selon le chemin de remontée des ressources du backend.
## Remarques
* Si votre configuration de ressources dépasse le quota de votre niveau de compte, la requête échouera.
* Si une région ne dispose d’aucune capacité disponible, la création d’un sandbox peut échouer avec une erreur liée au quota ou à la limite de débit, même lorsque votre quota au niveau du compte n’a pas été entièrement utilisé.
* Choisissez le CPU et la mémoire en fonction des exigences de votre charge de travail afin d’éviter les erreurs de mémoire insuffisante ou une utilisation inutile des ressources.
* Les quotas Enterprise peuvent être personnalisés selon vos exigences. Pour demander une augmentation de quota, veuillez contacter notre équipe d’assistance.