> 文章列表 > 【Docker】Docker Registry HTTP API

【Docker】Docker Registry HTTP API

【Docker】Docker Registry HTTP API

目标

归纳列出 Docker Registry Http API 。

Docker Registry HTTP API 是面向 Docker Registry v2 的 API,用于与 Registry 进行通信以管理 Docker 镜像。常用的 API 如下:

  1. 检查 API 版本

    请求路径: GET /v2/

    参数列表: 无

    返回值: 如果成功,返回 200 OK,表示正在使用 Docker Registry v2 API。

  2. 获取镜像仓库的所有标签

    请求路径: GET /v2/<name>/tags/list

    参数列表:

    • name: 镜像仓库名称

    返回值: 成功时返回一个 JSON 对象,包含仓库的所有标签。

    示例:

    {"name": "repository","tags": ["tag1", "tag2"]
    }
    ```
  3. 拉取镜像的 manifest

    请求路径: GET /v2/<name>/manifests/<reference>

    参数列表:

    • name: 镜像仓库名称
    • reference: 镜像标签或摘要

    返回值: 成功时返回镜像的 manifest,它是一个 JSON 对象。

  4. 推送镜像的 manifest

    请求路径: PUT /v2/<name>/manifests/<reference>

    参数列表:

    • name: 镜像仓库名称
    • reference: 镜像标签或摘要

    返回值: 成功时返回 201 Created,表示已成功推送镜像的 manifest。

  5. 删除镜像

    请求路径: DELETE /v2/<name>/manifests/<reference>

    参数列表:

    • name: 镜像仓库名称
    • reference: 镜像摘要

    返回值: 成功时返回 202 Accepted,表示已成功删除镜像。

  6. 拉取镜像的 blob

    请求路径: GET /v2/<name>/blobs/<digest>

    参数列表:

    • name: 镜像仓库名称
    • digest: blob 的摘要

    返回值: 成功时返回镜像的 blob(二进制数据)。

  7. 推送镜像的 blob

    请求路径: PUT /v2/<name>/blobs/uploads/<uuid>?digest=<digest>

    参数列表:

    • name: 镜像仓库名称
    • uuid: 上传的 UUID
    • digest: blob 的摘要

    返回值: 成功时返回 201 Created,表示已成功推送镜像的 blob。

更多详细信息,请参阅 Docker Registry HTTP API V2 文档。