Metadatos de sandbox - Documentation

Los metadatos de sandbox te permiten adjuntar información personalizada de clave-valor a un sandbox. Los usos comunes incluyen:

Conectar un sandbox a una sesión de usuario.
Guardar datos personalizados relacionados con el usuario para un sandbox, como claves de API.
Vincular un sandbox a un ID de usuario para que pueda reconectarse más tarde.

Los metadatos se proporcionan cuando se crea el sandbox. Más tarde, se pueden leer al listar sandboxes activos con 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"}

Filtrado basado en metadatos

Los sandboxes también se pueden filtrar usando metadatos al listarlos.

Última modificación el 10 de agosto de 2026