关于API的概念你一定不陌生,其实就是一个接口,一种方法,方便其他的应用程序调用该方法从而获得需要的结果;
而对于我们最常使用的浏览器访问,用户的http请求包括GET, PUT, POST, DELETE方法,我们可以针对不同的用户请求,用不同的URL结果来响应;http API 也不过是通过上述的GET, PUT, POST,DELETE方法来获得需要的数据;
但是问题来了,每次使用上述方法的时候,相应的URL的结构居然没有统一的标准,这给使用http API的人造成了很大的困扰,为了解决这个URL结构不统一的问题,慢慢有了一个标准,这个标准叫做REST URL; 利用REST URL实现的http API, 也就叫做REST API了;
不同的返回码, 代表着不同的意义,以下是简要信息,仅作参考:
2xx = Success(成功)
3xx = Redirect(重定向)
4xx = User error(客户端错误)
5xx = Server error(服务器端错误)
以下是v2版本的registry对应的REST API的访问方法(在本节会比较常用的REST API, 完整版可以参见URL: https://docs.docker.com/registry/spec/api/
):
GET 方法支持的URI:
/v2/_catalog #显示所有的image.
/v2/[REPOSITORY]/<IMAGE>/tags/list #显示特定image的tags.
/v2/[REPOSITORY]/<IMAGE>/manifests/<reference> #显示manifests文件的内容;reference 可以是tag, 也可以是digest.
扩展的GET方法:
/v2/_catalog?n=<Integer> #列出特定数量的image
DELETE 方法支持的URI:
/v2/[REPOSITORY]/<IMAGE>/manifests/<reference> #删除manifests文件,DELETE API支持的reference只有digest.
关于registry v2的REST API, 还有许多的API接口可以被调用,因为目前用不到,所以没有在这里提及.
本文原创,转载请注明出处.
网友评论