API の概要

​

ベース URL とバージョニング

https://api.coreweave.com/v1/sandbox

​

認証

Authorization: Bearer [API-ACCESS-TOKEN]

• sandbox_admin: ランナーの作成、読み取り、更新、削除、およびランナーに設定するポリシーの指定ができます。マネージドランナーのエンドポイントは、読み取り系も含めてすべてこの action が必要です。sandbox_user を含みます。 レガシーの v1beta2 プロフィールを使用するランナーでは、この action により特権プロフィール設定も許可されます。これには、特権コンテナー、ホストの namespace、ホストファイルシステムのマウントが含まれます。これらの設定により、サンドボックスがクラスター管理者に匹敵するノードへのアクセス権を得る可能性があります。v1 ポリシーの allow_privileged 設定は、サンドボックスの分離境界内におけるゲスト内の特権を制御します。
• sandbox_user: サンドボックス (ネットワーク設定を含む) の作成と操作ができます。マネージドランナーの管理へのアクセス権は付与されません。

​

コンテンツタイプ

Content-Type: application/json

​

リソースファミリー

​

ページネーション

• pageSize: ページサイズ。デフォルトは 50、最大は 100 です。
• pageToken: 前のページで nextPageToken として返されたカーソル。空文字列の場合、それ以上のページはありません。

curl -H "Authorization: Bearer $TOKEN" \
  'https://api.coreweave.com/v1/sandbox/managedRunners?pageSize=50'

# カーソルをたどります
curl -H "Authorization: Bearer $TOKEN" \
  'https://api.coreweave.com/v1/sandbox/managedRunners?pageSize=50&pageToken=[NEXT-PAGE-TOKEN]'

​

更新時のフィールドマスク

curl -X PATCH "https://api.coreweave.com/v1/sandbox/managedRunners/[RUNNER-ID]?updateMask=spec.releaseChannel,spec.maintenancePolicy" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "spec": { "releaseChannel": "RELEASE_CHANNEL_RAPID" } }'

​

ランナーのアフィニティ

​

エラー

{
  "code":    3,
  "message": "runner.identity.zone is required",
  "details": []
}

​

冪等性

• Delete* エンドポイントは冪等です。すでに削除済みのリソースに対して DELETE を呼び出した場合、副作用なしに 404 が返されます。
• Create* エンドポイントは冪等ではありません。同じ runnerId または displayName を2回指定すると 409 Conflict が返されます。安全に再試行するには、GET でリソースがすでに存在するかどうかを確認してください。
• Update* エンドポイントは、フィールドマスクを使用し、変更したいフィールドのみを設定していれば、安全に再試行できます。

​

ハートビート

​

関連情報

• Terraform でランナーを管理する: CoreWeave Terraform プロバイダーを使用して、ランナーの設定、インポート、更新を行う方法を説明します。
• サンドボックスのアーキテクチャ: 4 種類のリソースの分類と、ゲートウェイが実行時リクエストを仲介する仕組みを説明します。
• ポリシーの概要: サンドボックスにポリシーが適用される仕組みを説明します。
• サンドボックスポリシーを設定する: CoreWeave Intelligent CLI のワークフローと、プロフィールの spec の各フィールドを順に説明します。
• ランナーのデプロイと管理: CoreWeave Intelligent CLI と REST を使用したランナーのライフサイクル管理を順に説明します。
• ポリシーリファレンス: プロフィールで設定できるすべてのフィールドを説明します。
• Protobuf: 公開されている Protobuf モジュールの入手先、各サービスを提供するホスト、生成された SDK のインストール方法を説明します。