Path: 宝塔面板 API 参考 › Docker

`GET /btdocker/container/get_list`

获取 Docker 宿主机上所有容器的列表及系统资源信息。

## Query parameters

- `opGetBtdockerContainerGetList.query.request_time` (string, required) — Unix 时间戳。
- `opGetBtdockerContainerGetList.query.request_token` (string, required) — 按 API 概览中的双重 MD5 签名算法生成。

## Code samples

### cURL（填写面板地址与签名）

```curl
curl --request GET \
  --url "https://your-panel.example.com:8888/btdocker/container/get_list" \
  --get \
  --data-urlencode "request_time=<Unix时间戳>" \
  --data-urlencode "request_token=<按 API 概览生成的签名>"
```

## Responses

### default

接口响应，业务状态见下方详细说明。

#### Example

```json
{
  "online_cpus": 2,
  "mem_total": 4090929152,
  "container_list": [
    {
      "container_id": "ead805da4545",
      "name": "allinssl_m3xm-allinssl_M3xm-1",
      "status": "running",
      "image": "allinssl/allinssl:latest"
    }
  ],
  "gpu": 0
}
```

- `opGetBtdockerContainerGetList.response.default.online_cpus` (integer, optional) — CPU 核心数
- `opGetBtdockerContainerGetList.response.default.mem_total` (integer, optional) — 总内存（字节）
- `opGetBtdockerContainerGetList.response.default.container_list` (array<unknown>, optional) — 容器列表，每项含 `container_id`、`name`、`status`、`image`、`ports`


## get_list (容器)

获取 Docker 宿主机上所有容器的列表及系统资源信息。

- **路由**：`GET /btdocker/container/get_list`

## 输出参数

| 参数名称 | 类型 | 描述 |
|----------|------|------|
| online_cpus | Integer | CPU 核心数 |
| mem_total | Integer | 总内存（字节） |
| container_list | Array | 容器列表，每项含 `container_id`、`name`、`status`、`image`、`ports` |

## 示例

```json
{"online_cpus": 2, "mem_total": 4090929152, "container_list": [{"container_id": "ead805da4545", "name": "allinssl_m3xm-allinssl_M3xm-1", "status": "running", "image": "allinssl/allinssl:latest"}], "gpu": 0}
```