鏡像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