Métadonnées de sandbox - Documentation

Les métadonnées de sandbox vous permettent d’associer des informations personnalisées sous forme de paires clé-valeur à une sandbox. Les utilisations courantes incluent :

Associer une sandbox à une session utilisateur.
Enregistrer des données personnalisées liées à l’utilisateur pour une sandbox, comme des clés API.
Lier une sandbox à un ID utilisateur afin de pouvoir s’y reconnecter plus tard.

Les métadonnées sont fournies lors de la création de la sandbox. Elles peuvent ensuite être lues lors de la récupération de la liste des sandboxes actives avec Sandbox.list().

import { Sandbox } from 'novita-sandbox'

// Start a sandbox and attach custom metadata.
const sbx = await Sandbox.create({
  metadata: {
    userId: '123',
  },
})

// Retrieve active sandboxes and inspect their metadata.
const page = await Sandbox.list()
const active = await page.nextItems()

console.log(active[0].metadata)
// Example output:
// { userId: '123' }

from novita_sandbox.core import Sandbox

# Start a sandbox and attach custom metadata.
sbx = Sandbox.create(
    metadata={
        "userId": "123",
    },
)

# Retrieve active sandboxes and inspect their metadata.
page = Sandbox.list()
active = page.next_items()

print(active[0].metadata)
# Example output:
# {"userId": "123"}

Filtrage basé sur les métadonnées

Les sandboxes peuvent également être filtrées à l’aide de métadonnées lors de la récupération de la liste.

Dernière modification le 10 août 2026

⌘I