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

# Listar 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/es/guides/sandbox-cli">tutorial</Link> to install the CLI and complete <Link href="/docs/es/guides/sandbox-cli-auth">authentication</Link>.</Note>;
  }
};

<SandboxCliConfigHint />

### Listar todos los sandboxes en ejecución

Para listar todos los sandboxes en ejecución, usa el siguiente comando:

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

### Filtrar por estado

Usa la marca `--state` para filtrar sandboxes por estado. Los valores admitidos son "**running**", "**paused**" o ambos.
Por ejemplo, para obtener sandboxes tanto en ejecución como en pausa:

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

### Filtrar por metadatos

Usa la marca `--metadata` para filtrar sandboxes por metadatos.

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

### Límite de lista

Usa la marca `--limit` para limitar el número de sandboxes devueltos por el comando.
Si no se especifica la marca `--limit`, el comando devuelve todos los sandboxes.

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