Flux7 Docker 系列教程（七）：Docker API

本系列教程翻译自 Flux7 Docker Tutorial Series，系列共有九篇，本文译自第七篇 Part 7: Ultimate Guide for Docker APIs。
该系列所有文章将参考其他学习资料翻译，也会加入自己的学习作为部分注解。如有错误，欢迎指正。

在以前的系列教程中，我们已经探讨了 Docker 中很多很重要的组件，本篇文章我们深入 Docker：探讨 Docker API。

值得注意的是，Docker 为了方便使用，提供了如下四种 API：

本篇文章专门用来探讨 Docker Registry API、Docker Hub API 和 OAuth API。

Docker Registry API

Docker Registry API 为了简化镜像和仓库的存储而设计的 REST API。这些 API 并不涉及用户账户和用户认证。

取出镜像层：

GET /v1/images/(image_id)/layer

插入镜像层：

PUT /v1/images/(image_id)/layer

检索镜像：

GET /v1/images/(image_id)/json

检索镜像的根镜像：

GET /v1/images/(image_id)/ancestry

获取指定库的所有标签：

GET /v1/repositories/(namespace)/(repository)/tags

获取指定库的指定标签：

GET /v1/repositories/(namespace)/(repository)/tags/(tag*)

删除标签：

DELETE /v1/repositories/(namespace)/(repository)/tags/(tag*)

registry 状态检查：

GET /v1/_ping

Docker Hub API 是为 Docker Hub 设计的 REST API。Docker Hub（也就是 Index）是使用校验和公共 namespaces 的方式来存储账户信息、认证账户、进行账户授权。API同时也允许操作相关的用户仓库和 library 仓库。

创建新的仓库

PUT /v1/repositories/(repo_name)/

删除现有仓库

DELETE /v1/repositories/(repo_name)/

更新仓库镜像

PUT /v1/repositories/(repo_name)/images

获取仓库镜像

GET /v1/repositories/(repo_name)/images

认证

PUT /v1/repositories/(repo_name)/auth

以上都是特殊仓库的操作，下面是对普通用户开放的 API。

特殊的 library 仓库和用户仓库的区别在于 library 仓库是官方仓库，可以直接使用 ubuntu 这种名字做 repo 的名字，而译者就只能使用 qiuker521/ubuntu 作为 repo 的名字。

创建新的用户仓库

PUT /v1/repositories/(namespace)/(repo_name)/

删除现有仓库

DELETE /v1/repositories/(namespace)/(repo_name)/

更新镜像

PUT /v1/repositories/(namespace)/(repo_name)/images

获取镜像

GET /v1/repositories/(namespace)/(repo_name)/images

用户认证

GET /v1/users

创建新用户

POST /v1/users

更新用户信息

PUT /v1/users/(username)/

Docker API 已经讲了三个，而且都是 Docker Hub 架构相关的 API。下面两篇文章将专门讲 Docker Remote API，操作宿主机 Docker 服务端的 API。