Metadados do Sandbox - Documentation

Os metadados de sandbox permitem anexar informações personalizadas de chave-valor a um sandbox. Usos comuns incluem:

Conectar um sandbox a uma sessão de usuário.
Salvar dados personalizados relacionados ao usuário para um sandbox, como chaves de API.
Vincular um sandbox a um ID de usuário para que ele possa ser reconectado posteriormente.

Os metadados são fornecidos quando o sandbox é criado. Posteriormente, eles podem ser lidos ao listar sandboxes ativos com 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"}

Filtragem baseada em metadados

Sandboxes também podem ser filtrados usando metadados ao serem listados.

Última modificação em 4 de setembro de 2026