查询Dockerhub镜像tag列表
更新时间：2025-08-05
接口描述
本接口用于获取DockerHub镜像的tag列表。
请求结构
Plain Text
1GET /v1/image/dockerhub/{name}/tags?pageNo={pageNo}&pageSize={pageSize} HTTP/1.1
2Host: bec.baidubce.com
3Content-Type: application/json; charset=utf-8
4Authorization: authorization string请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必须 | 参数位置 | 描述 |
|---|---|---|---|---|
| name | string | 是 | URL参数 | 镜像名称 |
| pageNo | Integer | 否 | Query参数 | 页数，缺省值为1 |
| pageSize | Integer | 否 | Query参数 | 每页镜像个数，取值范围1～100，缺省值为100 |
响应头域
除公共头域外，无其它特殊头域。
响应参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| result | List<String> | 列表数据 |
| orderBy | String | 排序字段 |
| order | String | 排序顺序，取值为：DESC、ASC，分别表示降序、升序 |
| pageNo | Integer | 页码 |
| pageSize | Integer | 每页结果数 |
| totalCount | Integer | 结果总数 |
错误码
请参照错误返回章节的内容。
请求示例
Plain Text
1GET /v1/image/dockerhub/busybox/tags HTTP/1.1
2Host: bec.baidubce.com
3Content-Type: application/json; charset=utf-8
4Authorization: bce-auth-v1/318857a8f08b11e9845ca7e54775a0c2/2025-08-05T03:07:21Z/1800/host/212eef8cfe1ac94be56c4afedb9360bba621ef646c3c8288971d36801d70501a响应示例
Plain Text
1HTTP/1.1 200 OK
2Content-Type: application/json;charset=UTF-8
3Date: Wed, 08 Jul 2019 03:28:11 GMT
4x-bce-request-id: d8752367-38e8-45e4-b4c7-e53be3137ce5
5X-Bce-Gateway-Region: BJ
6{
7 "result": [
8 "musl"
9 ],
10 "orders": null,
11 "orderBy": "",
12 "order": "",
13 "pageNo": 1,
14 "pageSize": 1,
15 "totalCount": 139
16}