> ## Documentation Index
> Fetch the complete documentation index at: https://ppio.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 终止 Sandbox

终止(kill)Sandbox 会将其关闭并永久删除。已终止的 Sandbox 无法恢复或重新连接。你可以通过 CLI 或 SDK 编程方式终止 Sandbox。

## 终止已连接的 Sandbox

<CodeGroup>
  ```python Python theme={null}
  from ppio_sandbox import PPIO

  ppio = PPIO()

  sandbox = ppio.sandbox.create()

  # ... 使用 Sandbox ...

  sandbox.kill()
  ```

  ```typescript JavaScript & TypeScript theme={null}
  import { PPIO } from 'ppio-sandbox'

  const ppio = new PPIO()

  const sandbox = await ppio.sandbox.create()

  // ... 使用 Sandbox ...

  await sandbox.kill()
  ```
</CodeGroup>

## 按 Sandbox ID 终止

当你只有 Sandbox ID 时,可以使用命名空间的 `kill` 方法。如果找到并终止了该 Sandbox,它返回 `true`;如果不存在该 ID 对应的 Sandbox,则返回 `false`。

<CodeGroup>
  ```python Python theme={null}
  from ppio_sandbox import PPIO

  ppio = PPIO()

  killed = ppio.sandbox.kill("sbx-123")
  if not killed:
      print("Sandbox not found")
  ```

  ```typescript JavaScript & TypeScript theme={null}
  import { PPIO } from 'ppio-sandbox'

  const ppio = new PPIO()

  const killed = await ppio.sandbox.kill('sbx-123')
  if (!killed) {
    console.log('Sandbox not found')
  }
  ```

  ```bash CLI theme={null}
  # 按 ID 终止 Sandbox（别名：sandbox kl）
  ppio sandbox kill <sandboxID>
  ```
</CodeGroup>

## 终止所有 Sandbox

CLI 可以使用 `-a` / `--all` 一次性终止所有正在运行的 Sandbox,并可选地按状态或元数据进行筛选。

```bash theme={null}
# 终止所有运行中的 Sandbox
ppio sandbox kill -a

# 按状态或元数据筛选要终止的 Sandbox
ppio sandbox kill -a --state running
ppio sandbox kill -a --metadata env=test
```

## 在 Sandbox 内部调用终止