Protobuf

CoreWeave Sandboxes API の Protobuf 定義は、Buf モジュール 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 つのホストに分散しているほか、直接接続用にサンドボックスごとのエンドポイントがあります。

ホスト	提供するサービス
`https://api.cwsandbox.com`	`SandboxService`、`DiscoveryService`、`VolumeService`、`NetworkConfigService`、`NetworkService`、`SettingsService`。
`https://api.coreweave.com`	`RunnerManagementService` と `SandboxTemplateService`。`PlacementOrgConfigService` もこのホストで提供されますが、プラットフォームオペレーター専用です。API の概要を参照してください。
サンドボックスごとのデータプレーンエンドポイント	`SandboxDataPlaneService`。`SandboxService.ConnectSandbox` は、エンドポイント URI、有効期間の短いクライアント証明書、トラストバンドルを返します。サンドボックスへの直接接続を参照してください。

NetworkService はまだ利用できず、すべての RPC が UNIMPLEMENTED を返します。また、すべての RPC がすべての組織や配置モードで有効になっているとは限りません。利用できない呼び出しは、理由 CWSANDBOX_NOT_IMPLEMENTED とともに UNIMPLEMENTED を返します。 NetworkConfigService は動的ネットワーク設定を管理します。利用条件と前提条件には、API の有効化と、ランナーによるライブ更新のサポートが含まれます。 api.cwsandbox.com および api.coreweave.com へのリクエストの認証には CoreWeave API アクセストークンを使用します。トークンの作成方法と、sandbox_user または sandbox_admin IAM action の付与方法については、認証を参照してください。サンドボックスごとのデータプレーンエンドポイントでは、ConnectSandbox が返すクライアント証明書とトラストバンドルによる相互 Transport Layer Security (TLS) を使用します。API の Bearer token は使用しません。

生成された SDK をインストールする

Buf Schema Registry は、モジュールの SDK を必要に応じてビルドします。次のコマンドで、よく使われる言語とプラグインの組み合わせの SDK をインストールできます。

Install a generated SDK

# Go: Connect クライアントとメッセージ型
go get buf.build/gen/go/coreweave/sandbox/connectrpc/go@latest
go get buf.build/gen/go/coreweave/sandbox/protocolbuffers/go@latest

# Python: メッセージ型と gRPC スタブ
pip install coreweave-sandbox-protocolbuffers-python coreweave-sandbox-grpc-python \
  --extra-index-url https://buf.build/gen/python

# TypeScript: メッセージ型（@connectrpc/connect と併用）
npm config set @buf:registry https://buf.build/gen/npm/v1/
npm install @buf/coreweave_sandbox.bufbuild_es

その他の言語とプラグインの組み合わせについては、モジュールページの SDKs タブを参照してください。ローカルでコードを生成する場合は、buf generate の対象としてモジュールを指定します: buf generate buf.build/coreweave/sandbox

サンドボックス

サンドボックスを使用する

サンドボックスの管理

リファレンス

エンドポイント

生成された SDK をインストールする

関連情報

​エンドポイント

​生成された SDK をインストールする

​関連情報

エンドポイント

生成された SDK をインストールする

関連情報