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

<SandboxCliConfigHint />

### Listar todos os sandboxes em execução

Para listar todos os sandboxes em execução, use o seguinte comando:

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

### Filtrar por estado

Use a flag `--state` para filtrar sandboxes por estado. Os valores compatíveis são "**running**", "**paused**" ou ambos.
Por exemplo, para obter sandboxes em execução e pausados:

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

### Filtrar por metadados

Use a flag `--metadata` para filtrar sandboxes por metadados.

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

### Limite da lista

Use a flag `--limit` para limitar o número de sandboxes retornados pelo comando.
Se a flag `--limit` não for especificada, o comando retornará todos os sandboxes.

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