> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coreweave.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 制限とクォータ

> サンドボックスの同時実行数とリソースを計画し、有効期間の制限を把握して、クォータエラーに対処します。

CoreWeave のサンドボックスには、同時使用数、作成リクエスト、リソース、有効期間に関する制限があります。このページを参考にワークロードを計画し、リクエストが制限に達した場合の対処方法を確認してください。同時実行サンドボックスのクォータは、サーバーレス配置に適用されます。お客様自身の CoreWeave Kubernetes Service (CKS) クラスター上で実行されるサンドボックスは、このクォータにカウントされません。

<h2 id="concurrent-sandbox-quota">
  同時実行サンドボックスのクォータ
</h2>

同時実行サンドボックスのクォータは、組織内で実行中のサーバーレスサンドボックスの数を制限するもので、ユーザーとAPIキー全体で共有されます。実行中の使用量には、コードを実行中のサンドボックスだけでなく、起動中またはシャットダウン中のサンドボックスも含まれます。

同時実行クォータの適用が有効な場合、以下のデフォルト値が適用されます。組織のクォータと適用ステータスについては、サポートまたはアカウント担当チームにお問い合わせください。

| アカウントタイプ | デフォルトの同時実行サンドボックス数 |
| :- | -: |
| Forge Free、Academic、または Free Trial | 20 |
| Forge Pro | 2,000 |
| Forge Enterprise | 5,000 |
| その他の Forge アカウント | 10 |
| CoreWeave | 5,000 |

サンドボックスを所有するアカウントは、サンドボックスの認証情報によって決まります。[認証情報を選択して取得する](/ja/products/sandboxes/placement#choose-and-get-credentials)を参照してください。これらのクォータは、サンドボックスへのアクセス権を持つアカウントに適用されます。クォータの引き上げが承認されると、組織の上限が引き上げられます。Forge のアカウントタイプが取得できない場合や認識されない場合は、表のフォールバック値よりも、以前に認識されたティアが優先されます。

クォータのチェックは、v1 API を介した新規のサーバーレス作成リクエストに適用されます。非推奨の v1beta2 API による使用量もカウントされますが、v1beta2 の作成リクエストはこのチェックの対象外です。クォータの処理を統合する際は、現行の v1 API を使用してください。

クォータの集計は非同期で更新されます。そのため、使用量が一時的にクォータを超えることがあり、終了直後のサンドボックスがカウントから外れるまでに時間がかかることもあります。同時実行クォータは、厳密な支出の上限でも、空き容量を保証するものでもありません。

<h3 id="usage-counted-toward-the-quota">
  クォータの対象となる使用量
</h3>

クォータには、次の使用量が計上されます。

* 準備中、配置待ち、起動中、実行中、またはシャットダウン中のサンドボックス。
* 結果が不確定な作成リクエストに対する予約 (配置開始後にタイムアウトした場合など) 。

通常のシャットダウンでは、サンドボックスが終端状態に達し、クォータの集計が更新された後にスロットが利用可能になります。停止または削除のリクエストを送信しても、スロットはすぐには解放されません。

結果が不確定な作成リクエストは、エラーが返された場合でもスロットを予約することがあります。この予約は、失敗が記録された時点から、リクエストで指定された有効期間に 60 秒の猶予を加えた期間にわたって保持されます。有効期間が不明な場合、予約期間は 30 日にこの猶予を加えた期間になります。サンドボックスを停止または削除しても、この予約は早期に解放されません。予約が原因でこれ以上サンドボックスを作成できない場合は、サポートまたはアカウント担当チームにお問い合わせください。

<h3 id="handle-a-quota-error">
  クォータエラーを処理する
</h3>

適用が有効になっている場合、クォータチェックによって組織が上限に達しているかどうかが判断されます。上限に達している場合、プラットフォームは新しい v1 サーバーレスの作成リクエストを拒否し、次の詳細を含むエラーを返します。

| フィールド | 値 |
| :- | :- |
| HTTP ステータス | `429 Too Many Requests` |
| gRPC コード | `RESOURCE_EXHAUSTED` |
| エラー理由 | `CWSANDBOX_OCCUPANCY_QUOTA_EXCEEDED` |
| エラーメタデータ | `scope`: `tenant`、`limit`: 実際に適用されるクォータ、`current`: クォータチェックでカウントされた使用量 |
| 再試行のヒント | 遅延 5 秒の `RetryInfo` |

プラットフォームは次のエラーメッセージを返します。

> concurrent sandbox quota exceeded; request an increase from [support@wandb.ai](mailto:support@wandb.ai) or your account team

メッセージのテキストを照合するのではなく、構造化されたエラー理由に基づいて処理してください。クォータに空きキャパシティができるまで待ち、再試行のヒントに従ってバックオフ付きで再試行してください。5 秒というヒントは、5 秒後にスロットが空くことを保証するものではありません。

同時実行クォータが適用されても、すでに実行中のサンドボックスは停止されません。料金ティアの変更によってクォータが引き下げられた場合も同様です。サンドボックスのライフタイムなど、その他の制御は引き続き適用されます。

<h3 id="request-a-quota-increase">
  クォータの引き上げをリクエストする
</h3>

同時実行クォータの引き上げをリクエストするには、ご利用のアカウントの担当チームにお問い合わせください。

* CoreWeave のお客様: アカウント担当チームにお問い合わせください。
* Forge のお客様: [forge-support@coreweave.com](mailto:forge-support@coreweave.com) までメールでご連絡いただくか、アカウント担当チームにお問い合わせください。

リクエストには、組織、現在のクォータ、希望するクォータ、想定されるピーク時の同時実行数を記載してください。承認された引き上げは組織単位で適用され、その組織のすべてのユーザーと APIキーが対象となります。

<h2 id="rate-limits">
  レート制限
</h2>

v1 サーバーレス API では、組織が作成リクエストを送信する速度と、同時に処理中の作成リクエストの数も制限されます。これらの制限は、実行中のサンドボックスの数とは別に適用されます。

スロットリングされた作成リクエストは、HTTP `429` とエラー理由 `CWSANDBOX_SERVERLESS_CREATE_THROTTLED` を返します。どの制限に該当したかは、`limit_kind` メタデータで確認できます。

| 制限の種類 | 対処 |
| :- | :- |
| `rate` | 作成リクエストの送信頻度を下げてください。 |
| `concurrency` | 同時に処理中の作成リクエストの数を減らしてください。 |

バックオフを適用して再試行し、応答に再試行のヒントが含まれている場合はそれに従ってください。同時実行サンドボックスのクォータを引き上げても、それだけで作成リクエストのレート制限が緩和されるわけではありません。

<h2 id="sandbox-lifetime">
  サンドボックスのライフタイム
</h2>

サンドボックスの実行時間を制限するには、作成時に [`max_lifetime_seconds` パラメータ](/ja/products/sandboxes/client/guides/sandbox-configuration#max_lifetime_seconds) を設定します。有効期間の制限は、サーバーレス配置と CKS 配置の両方に適用されます。

有効期間を省略した場合は、適用されるポリシーでデフォルト値が指定されることがあります。ポリシーにデフォルト値が設定されていない場合、プラットフォームは 10 分を使用します。

| 設定 | 値 |
| :- | -: |
| リクエストとそのポリシーのどちらにも有効期間が指定されていない場合のプラットフォームのフォールバック値 | 600 秒 (10 分) |
| 最大値 | 2,592,000 秒 (30 日) |

最大ライフタイムを超える値を指定した作成リクエストは、プラットフォームによって拒否されます。有効期間が切れると、プラットフォームはサンドボックスを停止します。実行する作業に十分な有効期間を選択し、作業が終了したらサンドボックスを停止してください。

<h2 id="per-sandbox-resources">
  サンドボックスごとのリソース
</h2>

リソースの制限は、サンドボックスの配置に適用されるポリシーによって決まります。サーバーレスキャパシティのポリシーは CoreWeave が管理し、CKS への配置のポリシーは組織の管理者が設定します。ポリシーでは、コンテナーごとおよびサンドボックス全体の CPU とメモリに加え、GPU リクエストも制限できます。リクエストは、適用されるポリシーを満たし、かつ空き容量の範囲内に収まる必要があります。リソースの制約については、[ポリシーリファレンス](/ja/products/sandboxes/reference/profile)を参照してください。

GPU を使用するには、組織が許可リストに登録されている必要があります。同時実行サンドボックスのクォータがあっても、GPU へのアクセス権は付与されません。アクセス要件とサポートされる設定については、[GPU サンドボックスを実行する](/ja/products/sandboxes/gpu-sandboxes)を参照してください。

配置モード、認証情報、リソースリクエストの例については、[CoreWeave Sandboxes を使い始める](/ja/products/sandboxes/get-started)を参照してください。
