Documentation

Référence

Consulter les commandes de la CLI et l’API client des bacs à sable.

API client

URL de base : https://api.runzivo.dev. La référence couvre les neuf opérations publiées d’Agent Sandbox. Les commandes de la CLI pour les exécuteurs, les bacs à sable et les espaces de travail sont documentées séparément.

Envoyez un jeton d’accès client ou une clé d’API de l’espace de travail dans Authorization: Bearer <token>. Les permissions de clé pour les bacs à sable sont sandboxes:read et sandboxes:write, et non des portées héritées. Les clés restent limitées par les permissions actuelles de leur créateur dans l’espace de travail.

Définissez TENANT_ID avec l’identifiant de votre espace de travail. Fournissez RUNZIVO_TOKEN de façon sécurisée dans l’environnement de votre propre client : un jeton d’accès client ou une clé d’API de l’espace de travail. Les exemples contiennent des valeurs fictives, pas d’identifiants ni de données de compte réelles. Exécutez les requêtes dans votre propre client ; ce site ne les exécute pas.

cURL · requête authentifiée à titre d’illustration

curl "https://api.runzivo.dev/v1/customer/tenants/${TENANT_ID}/sandboxes" \
  --header "Authorization: Bearer ${RUNZIVO_TOKEN}"

Agent Sandboxes

Prochaines routes API des bacs à sableBientôt disponible. Contrat d’API prévu, sujet à changement. Ces fonctions API ne sont pas encore offertes.Hôte, ticket et relais SSHBientôt disponible. Contrat d’API prévu, sujet à changement. Ces fonctions ne sont pas encore offertes en production.Demande de jeton de dépôtBientôt disponible. Contrat d’API prévu, sujet à changement. Ces fonctions ne sont pas encore offertes en production.Cycle du serveur OpenHandsBientôt disponible. Contrat d’API prévu, sujet à changement. Ces fonctions ne sont pas encore offertes en production.Requêtes de tâches OpenHandsBientôt disponible. Contrat d’API prévu, sujet à changement. Ces fonctions ne sont pas encore offertes en production.Contrôles et événements OpenHandsBientôt disponible. Contrat d’API prévu, sujet à changement. Ces fonctions ne sont pas encore offertes en production.Référence de l’API des bacs à sableCréez, listez, lisez, démarrez, arrêtez et supprimez des bacs à sable par l’API client.Référence de l’API d’exécution et de terminalExécutez une commande avec une sortie diffusée en continu, ou ouvrez le terminal du bac à sable comme WebSocket. Les deux exigent un bac à sable en cours d’exécution et un jeton qui peut modifier les bacs à sable.GETLister les bacs à sableListe les bacs à sable de votre espace de travail, du plus récent au plus ancien, avec les tailles offertes et la limite d'exécutions simultanées.POSTCréer un bac à sableCrée un bac à sable et demande son premier démarrage.GETObtenir un bac à sableLit l'état actuel d'un bac à sable, sa durée de vie et son utilisation de calcul.DELETESupprimer un bac à sableArrête la VM et supprime définitivement le disque de l'espace de travail et ses fichiers.POSTDémarrer un bac à sableDémarre un bac à sable arrêté ou en échec sans réinitialiser son expiration d'origine.POSTArrêter un bac à sableArrête un bac à sable en cours d'exécution en conservant ses fichiers.POSTExécuter une commandeExécute bash -lc dans un bac à sable en cours d'exécution et diffuse en continu stdout, stderr et le résultat de sortie.POSTCréer un ticket de terminalÉmet un ticket à usage unique permettant à un navigateur d'ouvrir le terminal sans en-tête Authorization.GETOuvrir un terminalPasse à un WebSocket pour le terminal interactif d'un bac à sable en cours d'exécution.

Espace de travail et CLI

Référence des commandes rzvLes commandes de rzv 0.21.0, regroupées selon ce sur quoi elles agissent. Chaque commande accepte --help, et chaque commande sauf rzv sandboxes ssh accepte --json.

Outils de la page

Voir en Markdown (anglais)

Poser une question à une IA sur cette page

Ouvrir dans ChatGPT Ouvrir dans Claude Ouvrir dans Cursor

Claude affiche une bannière de mise en garde sur toute invite préremplie. C’est normal : examinez l’invite, puis envoyez-la.