> ## Documentation Index
> Fetch the complete documentation index at: https://novita.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Plantilla de instantánea de Sandbox heredada

export const SandboxBetaVersionWarning = () => {
  if (typeof document === "undefined") {
    return null;
  } else {
    return <Warning>The following legacy features require the legacy SDK and CLI versions listed in <Link href="/docs/es/guides/sandbox-legacy-e2b-compatible" target="self">Legacy SDKs & CLI</Link>. Please note that legacy features may be less stable than production releases. If you encounter any issues while using these features, please <Link href="https://meetings-na2.hubspot.com/junyu" target="_blank">contact us</Link>.</Warning>;
  }
};

<Warning>
  Esta página heredada se conserva para los usuarios que aún usan la línea 1.x o beta del SDK. Las nuevas integraciones con el SDK 2.x deben seguir la documentación actual de Sandbox.
</Warning>

<SandboxBetaVersionWarning />

## Terminología

* **Commit**: Una operación de commit guarda el estado actual de un sandbox como una plantilla, lo que da como resultado una nueva plantilla de tipo plantilla de instantánea.
* **Sandbox de origen**: La instancia de sandbox sobre la que se realiza el commit.
* **Plantilla de instantánea**: La plantilla generada después de una operación de commit.

## Descripción de la funcionalidad

### Realizar commit de un sandbox en ejecución

**Durante el proceso de commit:**

* El sandbox de origen se suspenderá brevemente durante el commit;
* La instancia de sandbox no estará disponible durante la suspensión;
* La duración de la suspensión es cercana al tiempo requerido para una sola operación de pausa.

**Después de que se complete el commit:**

**Sandbox de origen:**

* El registro de pausa existente se actualizará a un nuevo registro de pausa, basado en el estado actual del sandbox;
* El sandbox de origen continúa ejecutándose;
* Se genera un nuevo registro de plantilla.

### Realizar commit de un sandbox pausado

**Durante el proceso de commit:**

* El proceso de commit no hará que el sandbox de origen se inicie;
* El sandbox de origen permanece en estado pausado.

**Después de que se complete el commit:**

**Sandbox de origen:**

* El registro de pausa existente no se borra;
* Se genera un nuevo registro de plantilla.

## Descripción de parámetros

| Parámetro    | Tipo     | Obligatorio | Descripción                                                  |
| ------------ | -------- | ----------- | ------------------------------------------------------------ |
| `sandbox_id` | `string` | Sí          | El ID de la instancia de sandbox sobre la que se hará commit |
| `alias`      | `string` | No          | Establece un alias para la plantilla generada                |

## Valor de retorno

Después de una operación de commit correcta, se devuelve un objeto `Template`.

## Ejemplos de código

<CodeGroup>
  ```python Python icon="python" theme={"system"}
  from novita_sandbox.core import Sandbox

  # Commit an existing sandbox by ID to create a template snapshot
  # sandbox_id: str - Required. The ID of the sandbox to commit
  # alias: Optional[str] - Optional alias name for the created template
  # Note: Default timeout is 10 minutes for commit operation
  template = Sandbox.commit(
      sandbox_id="existing-sandbox-id",
      alias="my-template-alias"
  )
  print(f"Template ID: {template.template_id}")
  print(f"Build ID: {template.build_id}")
  ```

  ```js TypeScript icon="js" theme={"system"}
  import { Sandbox } from '@novita-sandbox/core'

  // Commit an existing sandbox by ID to create a template snapshot
  // sandboxId: string - Required. The ID of the sandbox to commit
  // opts?: { alias?: string } - Optional commit options
  const template = await Sandbox.commit('existing-sandbox-id', {
    alias: 'my-template-alias'
  })
  console.log(`Template ID: ${template.templateId}`)
  console.log(`Build ID: ${template.buildId}`)
  ```
</CodeGroup>

Además, también puedes usar la CLI de Novita Sandbox para hacer commit de una instancia de sandbox especificada:

```bash Bash icon="terminal" theme={"system"}
# Basic commit - creates a template snapshot from a sandbox
novita-sandbox-cli sandbox commit <sandboxID>

# Commit with alias - assign a friendly name to the template
novita-sandbox-cli sandbox commit <sandboxID> --alias my-template-alias

```