> ## 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.
# Kontingentlimits
Agent Sandbox wendet Kontingentlimits basierend auf Ihrer Kontostufe an. Kontingente definieren die Ressourcen und Funktionen, die jeder Stufe zur Verfügung stehen.
Wenn Sie höhere Limits benötigen, wenden Sie sich bitte an unser Support-Team.
## Kontostufen
| Kontostufe | Beschreibung |
| --------------- | -------------------------------------------------------------------------------------------------- |
| Kostenlos | Die Standardstufe für neue Benutzer. |
| Kostenpflichtig | Verfügbar, nachdem ein Kontoguthaben hinzugefügt oder eine Kreditlinie aktiviert wurde. |
| Enterprise | Für Enterprise-Kunden konzipiert, die benutzerdefinierte Limits und dedizierten Support benötigen. |
## Standardkontingente
| Limit | Kostenlos | Kostenpflichtig | Enterprise |
| ---------------------------- | --------- | --------------- | ---------------------------------- |
| Gleichzeitige Sandboxes | 5 | 100 | Standardmäßig 500, anpassbar |
| Maximale Sitzungsdauer | 1 Stunde | 3 Stunden | Standardmäßig 4 Stunden, anpassbar |
| Maximale vCPU | 2 vCPU | 8 vCPU | Standardmäßig 8 vCPU, anpassbar |
| Maximaler Arbeitsspeicher | 4 GiB | 8 GiB | Standardmäßig 8 GiB, anpassbar |
| Lokaler Festplattenspeicher | 20 GB | 20 GB | Standardmäßig 20 GB, anpassbar |
| Arbeitsspeicher-Schrittweite | 512 MiB | 512 MiB | 512 MiB |
| Arbeitsspeicher pro vCPU | 0.5-4 GiB | 0.5-4 GiB | 0.5-4 GiB |
## Konfigurationsregeln
Beim Konfigurieren von CPU und Arbeitsspeicher muss Ihre Konfiguration die folgenden Anforderungen erfüllen:
* vCPU darf das maximale vCPU-Limit für Ihre Kontostufe nicht überschreiten.
* Der Arbeitsspeicher darf das maximale Arbeitsspeicherlimit für Ihre Kontostufe nicht überschreiten.
* vCPU muss als ganzzahliger Wert konfiguriert werden, z. B. 1, 2, 4 oder 8 vCPU.
* Arbeitsspeicher muss in Schritten von 512 MiB konfiguriert werden.
* Arbeitsspeicher muss innerhalb des zulässigen Bereichs von 0.5-4 GiB pro vCPU liegen.
Zum Beispiel:
* 1 vCPU unterstützt 512 MiB bis 4 GiB Arbeitsspeicher.
* 2 vCPU unterstützt 1 GiB bis 8 GiB Arbeitsspeicher.
* 4 vCPU kann basierend auf dem Bereich für Arbeitsspeicher pro vCPU bis zu 16 GiB Arbeitsspeicher unterstützen, der tatsächlich verfügbare Arbeitsspeicher ist jedoch weiterhin durch das maximale Arbeitsspeicherkontingent Ihrer Kontostufe begrenzt.
Die endgültig verfügbare Konfiguration wird sowohl durch die Limits Ihrer Kontostufe als auch durch den zulässigen Bereich für Arbeitsspeicher pro vCPU bestimmt.
## Aktuelle Kontingentnutzung prüfen
Verwenden Sie die Quota API, um die für Ihr Konto verfügbaren Kontingentlimits und die aktuell verwendeten Ressourcen zu prüfen. Dies ist nützlich, bevor Sie eine große Anzahl von Sandboxes starten oder wenn Sie kontingentbezogene Startfehler beheben.
### Kontingentnutzung mit den SDKs prüfen
```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,
# },
# }
```
### Felder der Kontingentantwort
Die Kontingentantwort enthält `limit`- und `usage`-Objekte.
| Feld | Beschreibung |
| --------------------------- | ------------------------------------------------------------------------------------------------------ |
| `limit.concurrentInstances` | Maximale Anzahl von Sandboxes, die gleichzeitig ausgeführt werden können. |
| `limit.concurrentVcpu` | Maximale Gesamtzahl an vCPU-Kernen, die gleichzeitig verwendet werden können. |
| `limit.concurrentRamMb` | Maximaler Gesamt-RAM, der gleichzeitig verwendet werden kann, in MB. |
| `limit.maxLengthHours` | Maximale Lebensdauer für eine einzelne Sandbox, in Stunden. |
| `limit.diskMb` | Verfügbarer Runtime-Speicher für eine einzelne Sandbox, in MB. |
| `limit.maxVcpu` | Maximale vCPU-Kerne für eine einzelne Sandbox. Gilt, nachdem das Template erstellt wurde. |
| `limit.maxRamMb` | Maximaler Arbeitsspeicher für eine einzelne Sandbox, in MB. Gilt, nachdem das Template erstellt wurde. |
| `usage.concurrentInstances` | Aktuelle Anzahl laufender Sandboxes. |
| `usage.concurrentVcpu` | Aktuelle Gesamtzahl der verwendeten vCPU-Kerne. |
| `usage.concurrentRamMb` | Aktueller insgesamt verwendeter RAM, in MB. |
Die Kontingentnutzung ist für Kapazitätsplanung und Fehlerbehebung vorgesehen. Nutzungsdaten können je nach Backend-Pfad für die Ressourcenberichterstattung eine kurze Verzögerung aufweisen.
## Hinweise
* Wenn Ihre Ressourcenkonfiguration das Kontingent für Ihre Kontostufe überschreitet, schlägt die Anfrage fehl.
* Wenn in einer Region keine Kapazität verfügbar ist, kann die Sandbox-Erstellung mit einem kontingent- oder ratenlimitbezogenen Fehler fehlschlagen, selbst wenn Ihr Kontingent auf Kontoebene noch nicht vollständig ausgeschöpft wurde.
* Wählen Sie CPU und Arbeitsspeicher entsprechend den Anforderungen Ihrer Workload, um Out-of-Memory-Fehler oder unnötige Ressourcennutzung zu vermeiden.
* Enterprise-Kontingente können basierend auf Ihren Anforderungen angepasst werden. Um eine Erhöhung des Kontingents anzufordern, wenden Sie sich bitte an unser Support-Team.