镜像API
镜像仓库列表
请求 header
GET /api/v1/repositories
Authorization:Token xxxxxxxxxxxxxx Content-Type:application/json
请求参数
limit=20&offset=0
| 参数说明 | 描述 | 类型 | 是否必填 |
|---|---|---|---|
| limit | 大于 0 小于等于 30,默认 20 | int | 可填 |
| offset | 偏移量,大于等于 0,默认 0 | int | 可填 |
- 成功响应
200 Ok { "total": 1, "repositories": [ { "repo_id": 399, "user_name": "user", "repo_name": "name", "open_level": 0, "base_desc": "base_desc", "detail_desc": "desc", "tag_count": 0, "created_at": "2016-03-15T02:43:01Z", "updated_at": "2016-03-15T02:43:01Z" } ] } - 失败响应 详情请参见 错误返回码。
| 参数说明 | 描述 | 类型 |
|---|---|---|
| repo_id | 镜像仓库 id | long |
| user_name | 用户名 | string |
| repo_name | 镜像仓库名 | string |
| open_level | 开放级别,0 (私有 ) / 1 (公有) | int |
| base_desc | 基本描述 | string |
| detail_desc | 详细描述 | string |
| tag_count | 版本数量 | int |
| created_at | 创建时间,使用 UTC(世界标准时间)时间,用 ISO8601 进行格式化 | string |
| updated_at | 修改时间,使用 UTC(世界标准时间)时间,用 ISO8601 进行格式化 | string |
查看镜像仓库
请求 header
GET /api/v1/repositories/{id}
Authorization:Token xxxxxxxxxxxxxx Content-Type:application/json
| 参数说明 | 描述 | 类型 | 是否必填 |
|---|---|---|---|
| id | 镜像仓库 id | long | 必填 |
- 成功响应
200 Ok { "tags": [ { "name": "430", "size": 190425418, "status": 2 }, { "name": "latest", "size": 190425418, "status": 2 } ], "repo_id": 399, "user_name": "wutaigong", "repo_name": "fafafa", "open_level": 0, "base_desc": "base_desc", "detail_desc": "desc", "tag_count": 2, "download_url": null, "created_at": "2016-03-15T02:43:01Z", "updated_at": "2016-03-24T07:05:37Z" } - 失败响应 详情请参见错误返回码。
| 参数说明 | 描述 | 类型 |
|---|---|---|
| repo_id | 镜像仓库 id | long |
| user_name | 用户名 | string |
| repo_name | 镜像仓库名 | string |
| open_level | 开放级别,0 (私有) / 1 (公有) | int |
| base_desc | 基本描述 | string |
| detail_desc | 详细描述 | string |
| tag_count | 版本数量 | int |
| created_at | 创建时间,使用 UTC(世界标准时间)时间,用 ISO8601 进行格式化 | string |
| updated_at | 修改时间,使用 UTC(世界标准时间)时间,用 ISO8601 进行格式化 | string |
| name | 镜像 tag | string |
| size | 镜像大小,单位 B | long |
| status | 镜像状态,0 (初始化) / 1 (构建中) / 2 (构建成功) / 3 (构建失败) | int |
构建镜像
请求 header
POST /api/v1/repositories/{repo_name}/tags/{tag}/actions/build
Authorization:Token xxxxxxxxxxxxxx Content-Type:multipart/form-data
请求payload
form表单 docker_file:docker file 文件
| 参数说明 | 描述 | 类型 | 是否必填 |
|---|---|---|---|
| repo_name | 镜像仓库名称 | string | 必填 |
| tag | 镜像 tag | string | 必填 |
| docker_file | docker xml 文件,大小限制在 1 M | file | 必填 |
- 成功响应
200 Ok
- 失败响应 详情请参见 错误返回码。
删除镜像
请求 header
DELETE /api/v1/repositories/{repo_name}/tags/{tag}
Authorization:Token xxxxxxxxxxxxxx Content-Type:application/json
| 参数说明 | 描述 | 类型 | 是否必填 |
|---|---|---|---|
| repo_name | 镜像仓库名称 | string | 必填 |
| tag | 镜像 tag | string | 必填 |
- 成功响应
200 Ok
- 失败响应 详情请参见 错误返回码。
最后更新:2017-01-03 10:48:53