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

# サンドボックスを一覧表示

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

<SandboxCliConfigHint />

### 実行中のすべてのサンドボックスを一覧表示

実行中のすべてのサンドボックスを一覧表示するには、次のコマンドを使用します。

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

### 状態でフィルタリング

状態でサンドボックスをフィルタリングするには、`--state` フラグを使用します。サポートされている値は「**running**」、「**paused**」、またはその両方です。
たとえば、実行中および一時停止中のサンドボックスの両方を取得するには、次のようにします。

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

### メタデータでフィルタリング

メタデータでサンドボックスをフィルタリングするには、`--metadata` フラグを使用します。

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

### 一覧表示の上限

コマンドによって返されるサンドボックスの数を制限するには、`--limit` フラグを使用します。
`--limit` フラグが指定されていない場合、コマンドはすべてのサンドボックスを返します。

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