Protobuf

Les définitions Protobuf de l’API CoreWeave Sandboxes se trouvent dans le module Buf buf.build/coreweave/sandbox. Utilisez-les pour une intégration depuis un langage qui ne dispose d’aucun client CoreWeave officiel, ou lorsque vous avez besoin d’un RPC que le client Python ou le client TypeScript (@coreweave/cwsandbox) n’expose pas. La page du module fait référence pour l’API elle-même : chaque service et chaque champ, les règles d’encodage JSON et le contrat d’erreur. Utilisez coreweave.sandbox.v1 pour les nouvelles intégrations. L’ancien paquet coreweave.sandbox.v1beta2 reste disponible pour les clients existants et prend également en charge les modèles de profil et l’enregistrement des exécuteurs.

Points de terminaison

Chaque RPC est servi via le protocole Connect, et les mêmes points de terminaison acceptent les clients gRPC et gRPC-Web. Les services v1 sont répartis entre deux hôtes, auxquels s’ajoute un point de terminaison propre à chaque sandbox pour les connexions directes :

Hôte	Services exposés
`https://api.cwsandbox.com`	`SandboxService`, `DiscoveryService`, `VolumeService`, `NetworkService` et `SettingsService`.
`https://api.coreweave.com`	`RunnerManagementService` et `SandboxTemplateService`. `PlacementOrgConfigService` est également exposé ici, réservé aux opérateurs de la plateforme. Voir l’aperçu de l’API.
Point de terminaison du plan de données propre à chaque sandbox	`SandboxDataPlaneService`. `SandboxService.ConnectSandbox` renvoie l’URI du point de terminaison, un certificat client de courte durée et un bundle de certificats de confiance. Voir Connexions directes aux sandboxes.

NetworkService n’est pas encore disponible : tous ses RPC renvoient UNIMPLEMENTED. Plus généralement, les RPC ne sont pas tous activés pour toutes les organisations ni pour tous les modes de placement. Un appel non disponible renvoie UNIMPLEMENTED avec le motif CWSANDBOX_NOT_IMPLEMENTED. Les requêtes s’authentifient à l’aide d’un jeton d’accès à l’API CoreWeave. Pour savoir comment en créer un et accorder l’action IAM SANDBOX_USER ou SANDBOX_ADMIN, voir Authentification.

Installer un SDK généré

Le Buf Schema Registry génère à la demande des SDK pour le module. Les commandes suivantes installent les combinaisons de langages et de plugins les plus courantes :

Install a generated SDK

# Go : clients Connect et types de messages
go get buf.build/gen/go/coreweave/sandbox/connectrpc/go@latest
go get buf.build/gen/go/coreweave/sandbox/protocolbuffers/go@latest

# Python : types de messages et stubs gRPC
pip install coreweave-sandbox-protocolbuffers-python coreweave-sandbox-grpc-python \
  --extra-index-url https://buf.build/gen/python

# TypeScript : types de messages, à utiliser avec @connectrpc/connect
npm config set @buf:registry https://buf.build/gen/npm/v1/
npm install @buf/coreweave_sandbox.bufbuild_es

Pour toute autre combinaison de langage et de plugin, consultez l’onglet SDKs sur la page du module. Pour générer plutôt le code localement, indiquez le module à buf generate : buf generate buf.build/coreweave/sandbox.

Voir aussi

Architecture des sandboxes : comment la passerelle relaie les requêtes du runtime, et comment s’articule la séparation entre plan de contrôle et plan de données.
Aperçu de l’API : authentification, pagination, masques de champs et gestion des erreurs pour le plan de contrôle.
Client Python des sandboxes : le client cwsandbox de plus haut niveau, construit sur cette API.
Connexions directes aux sandboxes : comment un client accède à SandboxDataPlaneService via TLS mutuel.

Sandbox

Utiliser les Sandbox

Gérer les bacs à sable

Référence

Points de terminaison

Installer un SDK généré

Voir aussi

​Points de terminaison

​Installer un SDK généré

​Voir aussi

Points de terminaison

Installer un SDK généré

Voir aussi