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

# Lister les sandboxes

export const SandboxCliConfigHint = () => {
  if (typeof document === "undefined") {
    return null;
  } else {
    return <Note>Before running the command-line related example code in this document, please refer to the <Link href="/docs/fr/guides/sandbox-cli">tutorial</Link> to install the CLI and complete <Link href="/docs/fr/guides/sandbox-cli-auth">authentication</Link>.</Note>;
  }
};

<SandboxCliConfigHint />

### Lister toutes les sandboxes en cours d’exécution

Pour lister toutes les sandboxes en cours d’exécution, utilisez la commande suivante :

```bash Bash icon="terminal" theme={"system"}
novita-sandbox-cli sandbox list
```

### Filtrer par état

Utilisez l’option `--state` pour filtrer les sandboxes par état. Les valeurs prises en charge sont "**running**", "**paused**", ou les deux.
Par exemple, pour obtenir à la fois les sandboxes en cours d’exécution et en pause :

```bash Bash icon="terminal" theme={"system"}
novita-sandbox-cli sandbox list --state running,paused
```

### Filtrer par métadonnées

Utilisez l’option `--metadata` pour filtrer les sandboxes par métadonnées.

```bash Bash icon="terminal" theme={"system"}
novita-sandbox-cli sandbox list --metadata key1=value1,key2=value2
```

### Limite de liste

Utilisez l’option `--limit` pour limiter le nombre de sandboxes renvoyées par la commande.
Si l’option `--limit` n’est pas spécifiée, la commande renvoie toutes les sandboxes.

```bash Bash icon="terminal" theme={"system"}
novita-sandbox-cli sandbox list --limit 10
```