> ## 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.

# Modèle d’instantané Sandbox hérité

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/fr/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>
  Cette page héritée est conservée pour les utilisateurs qui utilisent encore la gamme SDK 1.x ou bêta. Les nouvelles intégrations SDK 2.x doivent suivre la documentation Sandbox actuelle.
</Warning>

<SandboxBetaVersionWarning />

## Terminologie

* **Commit** : Une opération de commit enregistre l’état actuel d’un sandbox en tant que modèle, ce qui génère un nouveau modèle de type modèle d’instantané.
* **Sandbox d’origine** : L’instance sandbox faisant l’objet du commit.
* **Modèle d’instantané** : Le modèle généré après une opération de commit.

## Description de la fonctionnalité

### Commit d’un sandbox en cours d’exécution

**Pendant le processus de commit :**

* Le sandbox d’origine sera brièvement suspendu pendant le commit ;
* L’instance sandbox est indisponible pendant la suspension ;
* La durée de suspension est proche du temps requis pour une seule opération de pause.

**Une fois le commit terminé :**

**Sandbox d’origine :**

* L’enregistrement de pause existant sera actualisé en un nouvel enregistrement de pause, basé sur l’état actuel du sandbox ;
* Le sandbox d’origine continue de s’exécuter ;
* Un nouvel enregistrement de modèle est généré.

### Commit d’un sandbox en pause

**Pendant le processus de commit :**

* Le processus de commit ne déclenchera pas le démarrage du sandbox d’origine ;
* Le sandbox d’origine reste en état de pause.

**Une fois le commit terminé :**

**Sandbox d’origine :**

* L’enregistrement de pause existant n’est pas effacé ;
* Un nouvel enregistrement de modèle est généré.

## Description des paramètres

| Paramètre    | Type     | Obligatoire | Description                            |
| ------------ | -------- | ----------- | -------------------------------------- |
| `sandbox_id` | `string` | Oui         | L’ID de l’instance sandbox à commit    |
| `alias`      | `string` | Non         | Définir un alias pour le modèle généré |

## Valeur de retour

Après une opération de commit réussie, un objet `Template` est retourné.

## Exemples de code

<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>

De plus, vous pouvez également utiliser Novita Sandbox CLI pour commit une instance sandbox spécifiée :

```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

```