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

# 列出 Secret

`ppio.secret.list()` 返回当前已认证团队所有活跃 Secret 的元数据。它不返回真实值、已退役的版本或未完成的待定版本。可在从沙箱引用某个 Secret 之前，用它查看有哪些可用的 Secret。

## 示例

该示例确保 Secret 存在，使用 `ppio.secret.list()` 列出团队的活跃 Secret，启动一个引用其中之一的沙箱，在沙箱内使用占位符，并在完成后销毁沙箱。

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

  ppio = PPIO()

  # 操作 Secret：列出当前团队所有活跃的 Secret（不含真实值）。
  secrets = ppio.secret.list()
  for binding in secrets:
      print(binding)
  ```

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

  const ppio = new PPIO()

  const secrets = await ppio.secret.list()
  for (const binding of secrets) {
    console.log(binding)
  }
  ```

  ```bash CLI theme={null}
  # 直接获取 Secret 列表
  ppio secret list

  # JSON 格式输出
  ppio secret list --output json
  ```
</CodeGroup>

<Note>
  `ppio.secret.list()` 不接受业务参数，返回 `SecretBinding` 元数据列表。空列表表示当前团队没有活跃的 Secret。真实值、已退役版本和待定版本绝不会被返回。
</Note>