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 servicesv1 sont répartis entre deux hôtes, auxquels s’ajoute un point de terminaison propre à chaque sandbox pour les connexions directes :
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.
NetworkConfigService gère les configurations réseau dynamiques. Ses prérequis de disponibilité comprennent l’activation de l’API et la prise en charge des mises à jour à chaud par l’exécuteur.
Les requêtes vers api.cwsandbox.com et api.coreweave.com 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.
Le point de terminaison du plan de données propre à chaque sandbox utilise le protocole TLS (Transport Layer Security) mutuel, avec le certificat client et le bundle de certificats de confiance renvoyés par ConnectSandbox. Il n’utilise pas le jeton Bearer de l’API.
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
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
cwsandboxde plus haut niveau, construit sur cette API. - Connexions directes aux sandboxes : comment un client accède à
SandboxDataPlaneServicevia TLS mutuel.