docker remote api 1.1 容器查询

本篇主要为对官方说明文档的翻译和测试，可能存在纰漏，请以官方文档为准，欢迎指正。官方地址：https://docs.docker.com/engine/api/v1.29/#operation/ContainerList

• 0.前

镜像仓库已有ubuntu\centos\php三个镜像
已经创建容器两个，名字分别为test1、test2

• 1.容器操作-Containers
  示例：

curl 192.168.0.5:5210/containers/json

查询结果

• 可用参数

• all,默认值为false，默认只返回正在运行的容器
• 示例 /containers/json?all=1

• limit ,返回最近创建的n个容器，包含停止状态的容器
• 示例 /containers/json?limit=1

• size
  默认为false，为true时返回结果包含SizeRw（已创建和已修改文件的大小）和SizeRootFs（容器中所有文件大小）两个字段。
• 实例 /containers/json?size=1

• filter 对容器列表进行筛选，参数为json形式。

• ancestor=(<image-name>[:<tag>], <image id>, or <image@digest>)
  按镜像名【标签】、id等筛选镜像
• 示例 /containers/json?filters={"ancestor":["ubuntu"]}

---

• before=(<container id> or <container name>)
• since=(<container id> or <container name>)
  查询某容器之前或之后的容器
• 示例：/containers/json?filters={"before":["test2"]}

---

• expose=(<port>[/<proto>]|<startport-endport>/[<proto>])
  查询开放指定端口的容器
• 示例：/containers/json?filters={"expose":["9000"]}

---

• exited=<int>
  查询退出代码为int的容器
• 示例 /containers/json?filters={"exited":["0"]}

---

• health=(starting|healthy|unhealthy|none)
  镜像健康检查指令
• 示例 /containers/json?filters={"health":["none"]}

---

• id=<ID>
  按id查询容器
• 示例：/containers/json?filters={"id":["c0b0ec16ff7f"]}

---

• name=<name>
• 示例 /containers/json?filters={"name":["test1"]}

---

• isolation=(default|process|hyperv) (Windows daemon only)
  windows限定，暂不介绍

---

• is-task=(true|false)
  用以区分普通容器和swarm容器（false指普通容器）
• 示例 /containers/json?filters={"is-task":["false"]}

---

• label=key or label="key=value"
  按 lable查询，暂无详细

---

• network=(<network id> or <network name>)
  按网络id或网络名（模式）查询
• 示例 /containers/json?filters={"network":["bridge"]}

---

• status=(created|restarting|running|removing|paused|exited|dead)
  按容器状态查询
• 示例 /containers/json?filters={"status":["running"]}

---

• volume=(<volume name> or <mount point destination>)
  按数据卷查询