查询镜像列表
更新时间：2026-06-09
接口描述
查询指定镜像仓库的Tag列表。
API Explorer
去调试
您可以在 API Explorer 中直接运行该接口，免去您计算签名的困扰。运行成功后，API Explorer 可以自动生成 SDK 代码示例。
请求结构
Plain Text
1GET /v1/instances/{instanceId}/projects/{projectName}/repositories/{repositoryName}/tags?tagName={tagName}&pageNo={pageNo}&pageSize={pageSize} HTTP/1.1
2Host: ccr.bd.baidubce.com
3Authorization: authorization string请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| instanceId | String | 是 | URL参数 | CCR实例ID |
| projectName | String | 是 | URL参数 | 命名空间名称 |
| repositoryName | String | 是 | URL参数 | 镜像仓库名称 |
| tagName | String | 否 | Query参数 | Tag名称，可用于模糊查询 |
| pageNo | Integer | 否 | Query参数 | 当前页，默认为1 |
| pageSize | Integer | 否 | Query参数 | 每页记录数，默认为10，最大100 |
响应头域
除公共头域外，无其它特殊头域。
响应参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| total | Integer | 镜像仓库Tag总数 |
| pageNo | Integer | 当前页 |
| pageSize | Integer | 每页记录数 |
| items | List<Tag> | Tag结果列表 |
请求示例
Plain Text
1GET /v1/instances/instances-test/projects/ns-test/repositories/ubuntu/tags?tagName=18.051&pageNo=1&pageSize=10 HTTP/1.1
2Host: ccr.bd.baidubce.com
3Authorization: bce-auth-v1/123456/2022-08-01T08:26:41Z/1800/host/0a859ce949951fe15a4eb6874a9765f9e8a6f7147f206cf47e270c34c862b8c6响应示例
Plain Text
1HTTP/1.1 200 OK
2Content-Type: application/json; charset=utf-8
3Date: Mon, 01 Aug 2022 08:26:41 GMT
4X-Bce-Gateway-Region: BJ
5X-Bce-Request-Id: 6cee2df3-0505-4044-9f12-65db07ebbcd7
6
7{
8 "total": 1,
9 "pageNo": 1,
10 "pageSize": 10,
11 "items": [
12 {
13 "tagName": "18.051",
14 "digest": "sha256:ed8e0d11fdf57ec2d2c7bef1bb38b117c1e757a0b5e853f67047c1c0bd8f0e5b",
15 "projectId": 8,
16 "pullTime": "0001-01-01T00:00:00.000Z",
17 "pushTime": "2022-08-01T02:51:42.007Z",
18 "repositoryId": 4,
19 "architecture": "amd64",
20 "os": "linux",
21 "author": "",
22 "type": "IMAGE",
23 "size": 36001590,
24 "scanOverview": {
25 "scanStatus": "None",
26 "startTime": "",
27 "endTime": "",
28 "reportId": "",
29 "severity": "None"
30 }
31 }
32 ]
33}评价此篇文章