> ## 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.
# クォータ制限
Agent Sandbox は、アカウントティアに基づいてクォータ制限を適用します。クォータは、各ティアで利用できるリソースと機能を定義します。
より高い制限が必要な場合は、サポートチームにお問い合わせください。
## アカウントティア
| アカウントティア | 説明 |
| ---------- | --------------------------------------- |
| Free | 新規ユーザー向けのデフォルトティアです。 |
| Paid | アカウント残高を追加するか、クレジットラインを有効にすると利用できます。 |
| Enterprise | カスタム制限と専用サポートが必要なエンタープライズ顧客向けに設計されています。 |
## デフォルトクォータ
| 制限 | Free | Paid | Enterprise |
| ------------ | --------- | --------- | ------------------ |
| 同時実行サンドボックス数 | 5 | 100 | デフォルトで 500、調整可能 |
| 最大セッション時間 | 1 時間 | 3 時間 | デフォルトで 4 時間、調整可能 |
| 最大 vCPU | 2 vCPU | 8 vCPU | デフォルトで 8 vCPU、調整可能 |
| 最大メモリ | 4 GiB | 8 GiB | デフォルトで 8 GiB、調整可能 |
| ローカルディスク容量 | 20 GB | 20 GB | デフォルトで 20 GB、調整可能 |
| メモリ増分 | 512 MiB | 512 MiB | 512 MiB |
| vCPU あたりのメモリ | 0.5-4 GiB | 0.5-4 GiB | 0.5-4 GiB |
## 設定ルール
CPU とメモリを設定する場合、設定は次の要件を満たす必要があります。
* vCPU は、アカウントティアの最大 vCPU 制限を超えてはいけません。
* メモリは、アカウントティアの最大メモリ制限を超えてはいけません。
* vCPU は、1、2、4、または 8 vCPU などの整数値で設定する必要があります。
* メモリは 512 MiB 単位で設定する必要があります。
* メモリは、vCPU あたり 0.5-4 GiB の許容範囲内である必要があります。
例:
* 1 vCPU は 512 MiB から 4 GiB のメモリをサポートします。
* 2 vCPU は 1 GiB から 8 GiB のメモリをサポートします。
* 4 vCPU は、vCPU あたりのメモリ範囲に基づくと最大 16 GiB のメモリをサポートできますが、実際に利用可能なメモリは引き続きアカウントティアの最大メモリクォータによって制限されます。
最終的に利用可能な設定は、アカウントティアの制限と、許可された vCPU あたりのメモリ範囲の両方によって決まります。
## 現在のクォータ使用量を確認する
クォータ API を使用して、アカウントで利用可能なクォータ制限と、現在使用中のリソースを確認します。これは、大量のサンドボックスを起動する前や、クォータ関連の起動失敗をトラブルシューティングする場合に役立ちます。
### SDK を使用してクォータ使用量を確認する
```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,
# },
# }
```
### クォータレスポンスのフィールド
クォータレスポンスには、`limit` オブジェクトと `usage` オブジェクトが含まれます。
| フィールド | 説明 |
| --------------------------- | ----------------------------------------- |
| `limit.concurrentInstances` | 同時に実行できるサンドボックスの最大数。 |
| `limit.concurrentVcpu` | 同時に使用できる vCPU コアの最大合計数。 |
| `limit.concurrentRamMb` | 同時に使用できる RAM の最大合計量（MB）。 |
| `limit.maxLengthHours` | 単一サンドボックスの最大有効期間（時間）。 |
| `limit.diskMb` | 単一サンドボックスで利用可能なランタイムストレージ（MB）。 |
| `limit.maxVcpu` | 単一サンドボックスの最大 vCPU コア数。テンプレートのビルド後に適用されます。 |
| `limit.maxRamMb` | 単一サンドボックスの最大メモリ（MB）。テンプレートのビルド後に適用されます。 |
| `usage.concurrentInstances` | 現在実行中のサンドボックス数。 |
| `usage.concurrentVcpu` | 現在使用中の vCPU コアの合計数。 |
| `usage.concurrentRamMb` | 現在使用中の RAM の合計量（MB）。 |
クォータ使用量は、容量計画とトラブルシューティングを目的としています。使用量データには、バックエンドのリソースレポート経路によって短い遅延が発生する場合があります。
## 注意事項
* リソース設定がアカウントティアのクォータを超える場合、リクエストは失敗します。
* リージョンに利用可能なキャパシティがない場合、アカウントレベルのクォータが完全に使用されていなくても、サンドボックスの作成がクォータまたはレート制限関連のエラーで失敗することがあります。
* メモリ不足エラーや不要なリソース使用を避けるため、ワークロード要件に基づいて CPU とメモリを選択してください。
* Enterprise クォータは、要件に基づいてカスタマイズできます。クォータ増加をリクエストするには、サポートチームにお問い合わせください。