镜像接口
更新时间：2025-05-26
使用前提
查询镜像仓库Tag列表
接口描述
查询目标镜像仓库的Tag列表。
请求结构
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 | 是 | Path参数 | CCR实例ID |
| projectName | String | 是 | Path参数 | 命名空间名称 |
| repositoryName | String | 是 | Path参数 | 镜像仓库名称 |
| 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}查询镜像Tag详情
接口描述
查询单个镜像Tag详细信息。
请求结构
Plain Text
1GET /v1/instances/{instanceId}/projects/{projectName}/repositories/{repositoryName}/tags/{tagName} HTTP/1.1
2Host: ccr.bd.baidubce.com
3Authorization: authorization string请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必选 | 参数位置 | 描述 |
|---|---|---|---|---|
| instanceId | String | 是 | Path参数 | CCR实例ID |
| projectName | String | 是 | Path参数 | 命名空间名称 |
| repositoryName | String | 是 | Path参数 | 镜像仓库名称 |
| tagName | String | 是 | Path参数 | Tag名称 |
响应头域
除公共头域外，无其它特殊头域。
响应参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| architecture | String | 镜像仓库(repository)架构 |
| author | String | 发布者 |
| digest | String | 制品hash值 |
| os | String | 操作系统类型 |
| projectId | Integer | 制品所属的命名空间ID |
| pullTime | String | Tag最新的拉取时间，格式为date-time |
| pushTime | String | Tag推送时间，格式为date-time |
| repositoryId | Integer | 制品所属的镜像仓库ID |
| scanOverview | Tag.ScanOverview | 漏洞扫描信息 |
| size | Integer | 制品大小 |
| tagName | String | Tag名称 |
| type | String | 制品类别，例如：image，chart |
请求示例
Plain Text
1GET /v1/instances/ccr-4k74gw7d/projects/ns-test/repositories/ubuntu/tags/18.051 HTTP/1.1
2Host: ccr.bd.baidubce.com
3Authorization: bce-auth-v1/123456/2022-08-01T13:07:36Z/1800/host/0a859ce949951fe15a4eb6874a9765f9e8a6f7147f206cf47e270c34c862b8c6响应示例
Plain Text
1HTTP/1.1 200 OK
2Content-Type: application/json; charset=utf-8
3Date: Mon, 01 Aug 2022 13:07:37 GMT
4X-Bce-Gateway-Region: BJ
5X-Bce-Request-Id: d8bb93db-9e4e-436e-b67c-91847b161c43
6
7{
8 "tagName": "18.051",
9 "digest": "sha256:ed8e0d11fdf57ec2d2c7bef1bb38b117c1e757a0b5e853f67047c1c0bd8f0e5b",
10 "projectId": 8,
11 "pullTime": "0001-01-01T00:00:00.000Z",
12 "pushTime": "2022-08-01T02:51:42.007Z",
13 "repositoryId": 4,
14 "architecture": "",
15 "os": "",
16 "author": "",
17 "type": "IMAGE",
18 "size": 36001590,
19 "scanOverview": {
20 "scanStatus": "None",
21 "startTime": "",
22 "endTime": "",
23 "reportId": "",
24 "severity": "None"
25 }
26}删除单个镜像Tag
接口描述
删除单个镜像Tag。
请求结构
Plain Text
1DELETE /v1/instances/{instanceId}/projects/{projectName}/repositories/{repositoryName}/tags/{tagName} HTTP/1.1
2Host: ccr.bd.baidubce.com
3Authorization: authorization string请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必选 | 参数位置 | 描述 |
|---|---|---|---|---|
| instanceId | String | 是 | Path参数 | CCR实例ID |
| projectName | String | 是 | Path参数 | 命名空间名称 |
| repositoryName | String | 是 | Path参数 | 镜像仓库名称 |
| tagName | String | 是 | Path参数 | Tag名称 |
响应头域
除公共头域外，无其它特殊头域。
响应参数
如果请求成功无响应参数。如果请求失败则返回标准错误结构。
请求示例
Plain Text
1DELETE /v1/instances/instances-test/projects/ns-test/repositories/ubuntu/tags/18.051 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 12:30:44 GMT
4X-Bce-Gateway-Region: BJ
5X-Bce-Request-Id: fed4cbbf-fc67-46ed-a3f5-2dcdc30a08ed批量删除镜像Tag
接口描述
批量删除镜像Tag。
请求结构
Plain Text
1DELETE /v1/instances/{instanceId}/projects/{projectName}/repositories/{repositoryName}/tags HTTP/1.1
2Host: ccr.bd.baidubce.com
3Authorization: authorization string
4
5{
6 "items": {items}
7}请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必选 | 参数位置 | 描述 |
|---|---|---|---|---|
| instanceId | String | 是 | Path参数 | CCR实例ID |
| projectName | String | 是 | Path参数 | 命名空间名称 |
| repositoryName | String | 是 | Path参数 | 镜像仓库名称 |
| items | List<String> | 是 | Body参数 | Tag名称数组 |
响应头域
除公共头域外，无其它特殊头域。
响应参数
如果请求成功无响应参数。如果请求失败则返回标准错误结构。
请求示例
Plain Text
1DELETE /v1/instances/instances-test/projects/ns-test/repositories/ubuntu/tags HTTP/1.1
2Host: ccr.bd.baidubce.com
3Authorization: bce-auth-v1/123456/2022-08-01T08:26:41Z/1800/host/0a859ce949951fe15a4eb6874a9765f9e8a6f7147f206cf47e270c34c862b8c6
4
5{
6 "items": [
7 "18.053",
8 "18.054"
9 ]
10}响应示例
Plain Text
1HTTP/1.1 200 OK
2Content-Type: application/json; charset=utf-8
3Date: Mon, 01 Aug 2022 12:30:44 GMT
4X-Bce-Gateway-Region: BJ
5X-Bce-Request-Id: fed4cbbf-fc67-46ed-a3f5-2dcdc30a08ed查询构建历史
接口描述
查询指定镜像tag的构建历史。
请求结构
Plain Text
1GET /v1/instances/{instanceId}/projects/{projectName}/repositories/{repositoryName}/tags/{tagName}/buildhistory HTTP/1.1
2Host: ccr.bd.baidubce.com
3Authorization: authorization string请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必选 | 参数位置 | 描述 |
|---|---|---|---|---|
| instanceId | String | 是 | Path参数 | CCR实例ID |
| projectName | String | 是 | Path参数 | 命名空间名称 |
| repositoryName | String | 是 | Path参数 | 镜像仓库名称 |
| tagName | String | 是 | Path参数 | Tag名称 |
响应头域
除公共头域外，无其它特殊头域。
响应参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| items | List<BuildHistory> | 目标Tag构建历史集合 |
请求示例
Plain Text
1GET /v1/instances/ccr-4k74gw7d/projects/ns-test/repositories/ubuntu/tags/18.051/buildhistory HTTP/1.1
2Host: ccr.bd.baidubce.com
3Authorization: bce-auth-v1/123456/2022-08-01T13:07:36Z/1800/host/0a859ce949951fe15a4eb6874a9765f9e8a6f7147f206cf47e270c34c862b8c6响应示例
Plain Text
1HTTP/1.1 200 OK
2Content-Type: application/json; charset=utf-8
3Date: Mon, 01 Aug 2022 13:59:42 GMT
4X-Bce-Gateway-Region: BJ
5X-Bce-Request-Id: 330eb4d3-1ad9-4a3d-ac12-e5c6f447f4a1
6
7{
8 "items": [
9 {
10 "created": "2020-07-24T14:38:19.482Z",
11 "comment": "",
12 "createdBy": "/bin/sh -c #(nop) ADD file:7d9bbf45a5b2510d44d3206a028cf6502757884d49e46d3d2e6356c3a92c4309 in / ",
13 "emptyLayer": false
14 },
15 {
16 "created": "2020-07-24T14:38:20.335Z",
17 "comment": "",
18 "createdBy": "/bin/sh -c [ -z \"$(apt-get indextargets)\" ]",
19 "emptyLayer": false
20 }
21 ]
22}触发镜像扫描
接口描述
对目标Tag进行镜像安全扫描。
请求结构
Plain Text
1POST /v1/instances/{instanceId}/projects/{projectName}/repositories/{repositoryName}/tags/{tagName}/scan HTTP/1.1
2Host: ccr.bd.baidubce.com
3Authorization: authorization string请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必选 | 参数位置 | 描述 |
|---|---|---|---|---|
| instanceId | String | 是 | Path参数 | CCR实例ID |
| projectName | String | 是 | Path参数 | 命名空间名称 |
| repositoryName | String | 是 | Path参数 | 镜像仓库名称 |
| tagName | String | 是 | Path参数 | Tag名称 |
响应头域
除公共头域外，无其它特殊头域。
响应参数
如果请求成功无响应参数。如果请求失败则返回标准错误结构。
请求示例
Plain Text
1POST /v1/instances/ccr-4k74gw7d/projects/ns-test/repositories/ubuntu/tags/18.051/scan HTTP/1.1
2Host: ccr.bd.baidubce.com
3Authorization: bce-auth-v1/123456/2022-08-01T13:07:36Z/1800/host/0a859ce949951fe15a4eb6874a9765f9e8a6f7147f206cf47e270c34c862b8c6响应示例
Plain Text
1HTTP/1.1 200 OK
2Content-Type: application/json; charset=utf-8
3Date: Mon, 01 Aug 2022 14:15:13 GMT
4X-Bce-Gateway-Region: BJ
5X-Bce-Request-Id: 3eff2bc8-2310-4f95-874c-e65ed3a68a7b查询镜像漏洞结果
接口描述
查询针对指定镜像Tag的扫描包含的漏洞结果。
请求结构
Plain Text
1GET /v1/instances/{instanceId}/projects/{projectName}/repositories/{repositoryName}/tags/{tagName}/scanoverview?pageNo={pageNo}&pageSize={pageSize} HTTP/1.1
2Host: ccr.bd.baidubce.com
3Authorization: authorization string请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必选 | 参数位置 | 描述 |
|---|---|---|---|---|
| instanceId | String | 是 | Path参数 | CCR实例ID |
| projectName | String | 是 | Path参数 | 命名空间名称 |
| repositoryName | String | 是 | Path参数 | 镜像仓库名称 |
| tagName | String | 是 | Path参数 | Tag名称 |
| pageNo | Integer | 否 | Query参数 | 当前页 |
| pageSize | Integer | 否 | Query参数 | 每页记录数 |
响应头域
除公共头域外，无其它特殊头域。
响应参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| items | List<Artifact.ScanOverview> | 漏洞扫描结果列表 |
| lastScanTime | String | 最近一次扫描时间 |
| pageNo | Integer | 当前页，默认为1 |
| pageSize | Integer | 每页记录数，默认为10 |
| summary | Object | 不同严重程度的漏洞数量 |
| total | Integer | 漏洞总数 |
请求示例
Plain Text
1GET /v1/instances/ccr-4k74gw7d/projects/ns-test/repositories/ubuntu/tags/18.051/scanoverview HTTP/1.1
2Host: ccr.bd.baidubce.com
3Authorization: bce-auth-v1/123456/2022-08-01T13:07:36Z/1800/host/0a859ce949951fe15a4eb6874a9765f9e8a6f7147f206cf47e270c34c862b8c6响应示例
Plain Text
1HTTP/1.1 200 OK
2Content-Type: application/json; charset=utf-8
3Date: Mon, 01 Aug 2022 13:07:37 GMT
4X-Bce-Gateway-Region: BJ
5X-Bce-Request-Id: 0dba647a-57ae-496d-b409-b9a25e2613c2
6
7{
8 "total": 209,
9 "pageNo": 1,
10 "pageSize": 10,
11 "summary": {
12 "High": 8,
13 "Low": 103,
14 "Medium": 98
15 },
16 "items": [
17 {
18 "id": "CVE-2019-17567",
19 "package": "apache2-utils",
20 "version": "2.4.29-1ubuntu4.13",
21 "fixVersion": "",
22 "severity": "Medium",
23 "description": "Apache HTTP Server versions 2.4.6 to 2.4.46 mod_proxy_wstunnel configured on an URL that is not necessarily Upgraded by the origin server was tunneling the whole connection regardless, thus allowing for subsequent requests on the same connection to pass through with no HTTP validation, authentication or authorization possibly configured.",
24 "links": [
25 "https://avd.aquasec.com/nvd/cve-2019-17567"
26 ]
27 },
28 {
29 "id": "CVE-2021-26691",
30 "package": "apache2-utils",
31 "version": "2.4.29-1ubuntu4.13",
32 "fixVersion": "2.4.29-1ubuntu4.16",
33 "severity": "Medium",
34 "description": "In Apache HTTP Server versions 2.4.0 to 2.4.46 a specially crafted SessionHeader sent by an origin server could cause a heap overflow",
35 "links": [
36 "https://avd.aquasec.com/nvd/cve-2021-26691"
37 ]
38 },
39 {
40 "id": "CVE-2021-30641",
41 "package": "apache2-utils",
42 "version": "2.4.29-1ubuntu4.13",
43 "fixVersion": "2.4.29-1ubuntu4.16",
44 "severity": "Medium",
45 "description": "Apache HTTP Server versions 2.4.39 to 2.4.46 Unexpected matching behavior with 'MergeSlashes OFF'",
46 "links": [
47 "https://avd.aquasec.com/nvd/cve-2021-30641"
48 ]
49 },
50 {
51 "id": "CVE-2021-40438",
52 "package": "apache2-utils",
53 "version": "2.4.29-1ubuntu4.13",
54 "fixVersion": "2.4.29-1ubuntu4.18",
55 "severity": "Medium",
56 "description": "A crafted request uri-path can cause mod_proxy to forward the request to an origin server choosen by the remote user. This issue affects Apache HTTP Server 2.4.48 and earlier.",
57 "links": [
58 "https://avd.aquasec.com/nvd/cve-2021-40438"
59 ]
60 }
61 ],
62 "lastScanTime": "2022-08-01T14:15:17.329Z"
63}