> ## 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.

# Protobuf

> CoreWeave Sandboxes の Protobuf 定義、各サービスを提供するホスト、生成された SDK を確認できます。

CoreWeave Sandboxes API の Protobuf 定義は、Buf モジュール [`buf.build/coreweave/sandbox`](https://buf.build/coreweave/sandbox) で確認できます。CoreWeave の公式クライアントがない言語から統合する場合や、[Python クライアント](/ja/products/sandboxes/client)または TypeScript クライアント (`@coreweave/cwsandbox`) で公開されていない RPC が必要な場合に使用してください。

[モジュールページ](https://buf.build/coreweave/sandbox)は API 自体のリファレンスです。すべてのサービスとフィールド、JSON エンコードのルール、エラーの仕様が記載されています。新規のインテグレーションには `coreweave.sandbox.v1` を使用してください。以前の `coreweave.sandbox.v1beta2` パッケージも既存のクライアント向けに引き続き提供されており、プロフィールテンプレートとランナー登録の機能も含まれています。

<h2 id="endpoints">
  エンドポイント
</h2>

すべての RPC は [Connect protocol](https://connectrpc.com/) で提供されており、同じエンドポイントで gRPC クライアントと gRPC-Web クライアントも利用できます。`v1` のサービスは 2 つのホストに分散しているほか、直接接続用にサンドボックスごとのエンドポイントがあります。

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

`NetworkService` はまだ利用できず、すべての RPC が `UNIMPLEMENTED` を返します。また、すべての RPC がすべての組織や[配置モード](/ja/products/sandboxes/placement#compare-placement-modes)で有効になっているとは限りません。利用できない呼び出しは、理由 `CWSANDBOX_NOT_IMPLEMENTED` とともに `UNIMPLEMENTED` を返します。

リクエストの認証には CoreWeave API アクセストークンを使用します。トークンの作成方法と、`SANDBOX_USER` または `SANDBOX_ADMIN` IAM action の付与方法については、[認証](/ja/products/sandboxes/reference/control-plane-api#authentication)を参照してください。

<h2 id="install-a-generated-sdk">
  生成された SDK をインストールする
</h2>

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

```bash title="Install a generated SDK" theme={"system"}
# 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 タブ](https://buf.build/coreweave/sandbox/sdks)を参照してください。ローカルでコードを生成する場合は、`buf generate` の対象としてモジュールを指定します: `buf generate buf.build/coreweave/sandbox`

<h2 id="see-also">
  関連情報
</h2>

* [サンドボックスのアーキテクチャ](/ja/products/sandboxes/architecture): ゲートウェイがランタイムのリクエストを仲介する仕組みと、コントロールプレーンとデータプレーンの分割について説明します。
* [API の概要](/ja/products/sandboxes/reference/control-plane-api): コントロールプレーンにおける認証、ページネーション、フィールドマスク、エラー処理について説明します。
* [サンドボックスの Python クライアント](/ja/products/sandboxes/client): この API 上に構築された、より高レベルな `cwsandbox` クライアントです。
* [サンドボックスへの直接接続](/ja/products/sandboxes/client/guides/direct-connections): クライアントが相互 TLS 経由で `SandboxDataPlaneService` に接続する方法について説明します。