buf.build/coreweave/sandbox で確認できます。CoreWeave の公式クライアントがない言語から統合する場合や、Python クライアントまたは TypeScript クライアント (@coreweave/cwsandbox) で公開されていない RPC が必要な場合に使用してください。
モジュールページは API 自体のリファレンスです。すべてのサービスとフィールド、JSON エンコードのルール、エラーの仕様が記載されています。新規のインテグレーションには coreweave.sandbox.v1 を使用してください。以前の coreweave.sandbox.v1beta2 パッケージも既存のクライアント向けに引き続き提供されており、プロフィールテンプレートとランナー登録の機能も含まれています。
エンドポイント
すべての RPC は Connect protocol で提供されており、同じエンドポイントで gRPC クライアントと gRPC-Web クライアントも利用できます。v1 のサービスは 2 つのホストに分散しているほか、直接接続用にサンドボックスごとのエンドポイントがあります。
NetworkService はまだ利用できず、すべての RPC が UNIMPLEMENTED を返します。また、すべての RPC がすべての組織や配置モードで有効になっているとは限りません。利用できない呼び出しは、理由 CWSANDBOX_NOT_IMPLEMENTED とともに UNIMPLEMENTED を返します。
リクエストの認証には CoreWeave API アクセストークンを使用します。トークンの作成方法と、SANDBOX_USER または SANDBOX_ADMIN IAM action の付与方法については、認証を参照してください。
生成された SDK をインストールする
Buf Schema Registry は、モジュールの SDK を必要に応じてビルドします。次のコマンドで、よく使われる言語とプラグインの組み合わせの SDK をインストールできます。Install a generated SDK
buf generate の対象としてモジュールを指定します: buf generate buf.build/coreweave/sandbox
関連情報
- サンドボックスのアーキテクチャ: ゲートウェイがランタイムのリクエストを仲介する仕組みと、コントロールプレーンとデータプレーンの分割について説明します。
- API の概要: コントロールプレーンにおける認証、ページネーション、フィールドマスク、エラー処理について説明します。
- サンドボックスの Python クライアント: この API 上に構築された、より高レベルな
cwsandboxクライアントです。 - サンドボックスへの直接接続: クライアントが相互 TLS 経由で
SandboxDataPlaneServiceに接続する方法について説明します。