[开源夏令营][四] Docker remote API 之 镜像篇

列出镜像

列出镜像，有两个可选参数，一个是all，一个是filter，all可选值有，0/False/false，1/True/true，默认为0；filter是一个包含一个过滤对象的json，形式如‘{"dangling":["true"]}'

GET /images/json

我们可以尝试请求一下

curl -s -XGET theegg.me/docker/images/json?all=0 | python -mjson.tool

可以看到如下的返回值：

[
    {
        "Created": 1405461399,
        "Id": "88b42ffd1f7cc87c46edf70924b3e24f18da0eb69337deff4db2979d6e1032d8",
        "ParentId": "c69cab00d6ef21152755a3de928625d7a02860ebe918b8fe9d1dd6aba15229b2",
        "RepoTags": [
            "fedora:latest"
        ],
        "Size": 373742581,
        "VirtualSize": 373742581
    },
    {
        "Created": 1403128361,
        "Id": "e54ca5efa2e962582a223ca9810f7f1b62ea9b5c3975d14a5da79d3bf6020f37",
        "ParentId": "6c37f792ddacad573016e6aea7fc9fb377127b4767ce6104c9f869314a12041e",
        "RepoTags": [
            "ubuntu:latest"
        ],
        "Size": 8,
        "VirtualSize": 276100357
    }
]

返回值对应的含义：

Created：创建的时间，这是一个UNIX时间，以1970为起点，单位为秒

Id：是一个SHA256值，是该镜像的标识。

ParentId：是一个SHA256值，是该镜像的父镜像的标识。

RepoTags：是一个字符串数组，是标明在仓库中它的标签。一个镜像可能会带有多个标签。

Size：是镜像的实际的大小，即镜像占硬盘空间的大小。

VirtualSize：是镜像的虚拟大小，或者就是镜像的大小。镜像的实际大小为父镜像的虚拟大小减去该镜像的虚拟大小。

创建镜像

POST /images/create

请求参数：

-   **fromImage** – 镜像的名字
-   **fromSrc** – 镜像的来源，即标准输入
-   **repo** – 仓库
-   **tag** – 标签
-   **registry** – 从哪个registry