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

# 获取与列出 Volume

使用 `ppio.volume` 查询单个 Volume，或列出账户下的所有 Volume。两者都会返回 Volume 的元数据，如 ID、名称、配额和用量。

## 获取 Volume

`ppio.volume.get_info()`（Python）/ `ppio.volume.getInfo()`（JS）按 ID 返回单个 Volume 的信息。如果 Volume 不存在，会抛出 not-found 错误。

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

  ppio = PPIO()

  info = ppio.volume.get_info("vol_123")
  print(info.volume_id, info.name)
  ```

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

  const ppio = new PPIO()

  const info = await ppio.volume.getInfo('vol_123')
  console.log(info.volumeId, info.name)
  ```

  ```bash CLI theme={null}
  # 获取单个 Volume 的详细信息（别名：volume info）
  ppio volume get <volume_id>

  # JSON 格式输出
  ppio volume get <volume_id> --output json
  ```
</CodeGroup>

## 列出 Volume

`ppio.volume.list()` 以 Volume 信息列表的形式返回账户下的所有 Volume。

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

  ppio = PPIO()

  volumes = ppio.volume.list()
  for vol in volumes:
      print(f"{vol.volume_id}  {vol.name}  {vol.quota_size_gib} GiB")
  ```

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

  const ppio = new PPIO()

  const volumes = await ppio.volume.list()
  for (const vol of volumes) {
    console.log(`${vol.volumeId}  ${vol.name}  ${vol.quotaSizeGiB} GiB`)
  }
  ```

  ```bash CLI theme={null}
  # 列出所有 Volume（别名：volume ls）
  ppio volume list

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

## Volume 字段

| 字段（Python / JS）                   | 类型     | 说明        |
| --------------------------------- | ------ | --------- |
| `volume_id` / `volumeId`          | string | Volume ID |
| `name`                            | string | Volume 名称 |
| `quota_size_gib` / `quotaSizeGiB` | number | 容量配额（GiB） |