镜像仓库接口
更新时间：2024-02-27
使用前提
查询镜像仓库列表
接口描述
查询镜像仓库列表。
请求结构
GET /v1/instances/{instanceId}/projects/{projectName}/repositories?repositoryName={repositoryName}&pageNo={pageNo}&pageSize={pageSize} HTTP/1.1
Host: ccr.bd.baidubce.com
Authorization: authorization string请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必选 | 参数位置 | 描述 |
|---|---|---|---|---|
| instanceId | String | 是 | Path参数 | 实例ID |
| projectName | String | 是 | Path参数 | 命名空间名称 |
| repositoryName | String | 否 | Query参数 | 镜像仓库名称 |
| pageNo | Integer | 否 | Query参数 | 当前页 |
| pageSize | Integer | 否 | Query参数 | 每页记录数，默认10，最大100 |
响应头域
除公共头域外，无其它特殊头域。
响应参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| total | Integer | 记录总数 |
| pageNo | Integer | 当前页 |
| pageSize | Integer | 每页记录数 |
| items | List<Repository> | 结果列表 |
请求示例
GET /v1/instances/ccr-4k74gw7d/projects/ns-test/repositories HTTP/1.1
Host: ccr.bd.baidubce.com
Authorization: bce-auth-v1/687882a4ec614bf788766895ecebb7f5/2022-07-29T06:01:42Z/1800/content-type;host/119caf7a75eae7423aebefca3648374053a0fe3817ae11a1664b33af7d57dfa5响应示例
Content-Type: application/json; charset=utf-8
Date: Thu, 28 Jul 2022 03:25:43 GMT
X-Bce-Gateway-Region: BJ
X-Bce-Request-Id: b42840ec-a200-49c9-86bd-58687b7009bb
{
"total": 2,
"pageNo": 1,
"pageSize": 10,
"items": [
{
"tagCount": 1,
"creationTime": "2022-07-29T02:55:57.041Z",
"description": "",
"repositoryName": "python2",
"pullCount": 0,
"updateTime": "2022-07-29T02:55:57.041Z",
"repositoryPath": "ccr-4k74gw7d-pub.cnc.bd.baidubce.com/ns-test/python2",
"projectName": "ns-test"
},
{
"tagCount": 2,
"creationTime": "2022-07-29T02:53:34.289Z",
"description": "",
"repositoryName": "ubuntu",
"pullCount": 0,
"updateTime": "2022-07-29T02:53:34.289Z",
"repositoryPath": "ccr-4k74gw7d-pub.cnc.bd.baidubce.com/ns-test/ubuntu",
"projectName": "ns-test"
}
]
}通过镜像仓库名称查询镜像仓库
接口描述
通过镜像仓库名称查询镜像仓库。
请求结构
GET /v1/instances/{instanceId}/projects/{projectName}/repositories/{repositoryName} HTTP/1.1
Host: ccr.bd.baidubce.com
Authorization: authorization string请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必选 | 参数位置 | 描述 |
|---|---|---|---|---|
| instanceId | String | 是 | Path参数 | 实例ID |
| projectName | String | 是 | Path参数 | 命名空间名称 |
| repositoryName | String | 是 | Path参数 | 镜像仓库名称 |
响应头域
除公共头域外，无其它特殊头域。
响应参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| projectName | String | 命名空间名称 |
| repositoryName | String | 镜像仓库名称 |
| description | String | 镜像仓库描述 |
| repositoryPath | String | 镜像路径 |
| tagCount | Integer | 镜像的Tag个数 |
| pullCount | Integer | 镜像拉取次数 |
| creationTime | String | 创建时间 |
| updateTime | String | 更新时间 |
请求示例
GET /v1/instances/ccr-4k74gw7d/projects/ns-test/repositories/ubuntu HTTP/1.1
Host: ccr.bd.baidubce.com
Authorization: bce-auth-v1/687882a4ec614bf788766895ecebb7f5/2022-07-29T06:01:42Z/1800/content-type;host/119caf7a75eae7423aebefca3648374053a0fe3817ae11a1664b33af7d57dfa5响应示例
Content-Type: application/json; charset=utf-8
Date: Thu, 28 Jul 2022 03:25:43 GMT
X-Bce-Gateway-Region: BJ
X-Bce-Request-Id: b42840ec-a200-49c9-86bd-58687b7009bb
{
"tagCount": 2,
"creationTime": "2022-07-29T02:53:34.289Z",
"description": "",
"repositoryName": "ubuntu",
"pullCount": 0,
"updateTime": "2022-07-29T02:53:34.289Z",
"repositoryPath": "ccr-4k74gw7d-pub.cnc.bd.baidubce.com/ns-test/ubuntu",
"projectName": "ns-test"
}修改单个镜像仓库
接口描述
修改单个镜像仓库。
请求结构
PUT /v1/instances/{instanceId}/projects/{projectName}/repositories/{repositoryName} HTTP/1.1
Host: ccr.bd.baidubce.com
Authorization: authorization string
{
"description":"${description}"
}请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必选 | 参数位置 | 描述 |
|---|---|---|---|---|
| instanceId | String | 是 | Path参数 | 实例ID |
| projectName | String | 是 | Path参数 | 命名空间名称 |
| repositoryName | String | 是 | Path参数 | 镜像仓库名称 |
| description | String | 是 | Body参数 | 镜像仓库描述信息 |
响应头域
除公共头域外，无其它特殊头域。
响应参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| projectName | String | 命名空间名称 |
| repositoryName | String | 镜像仓库名称 |
| description | String | 镜像仓库描述 |
| repositoryPath | String | 镜像路径 |
| tagCount | Integer | 镜像的Tag个数 |
| pullCount | Integer | 镜像拉取次数 |
| creationTime | String | 创建时间 |
| updateTime | String | 更新时间 |
请求示例
PUT /v1/instances/ccr-4k74gw7d/projects/ns-test/repositories/ubuntu HTTP/1.1
Host: ccr.bd.baidubce.com
Authorization: bce-auth-v1/687882a4ec614bf788766895ecebb7f5/2022-07-29T06:01:42Z/1800/content-type;host/119caf7a75eae7423aebefca3648374053a0fe3817ae11a1664b33af7d57dfa5
{
"description":"update desc"
}响应示例
Content-Type: application/json; charset=utf-8
Date: Thu, 28 Jul 2022 03:25:43 GMT
X-Bce-Gateway-Region: BJ
X-Bce-Request-Id: b42840ec-a200-49c9-86bd-58687b7009bb
{
"tagCount": 2,
"creationTime": "2022-07-29T02:53:34.289Z",
"description": "update desc",
"repositoryName": "ubuntu",
"pullCount": 0,
"updateTime": "2022-07-29T05:09:09.899Z",
"repositoryPath": "ccr-4k74gw7d-pub.cnc.bd.baidubce.com/ns-test/ubuntu",
"projectName": "ns-test"
}删除单个镜像仓库
接口描述
删除单个镜像仓库。
请求结构
DELETE /v1/instances/{instanceId}/projects/{projectName}/repositories/{repositoryName} HTTP/1.1
Host: ccr.bd.baidubce.com
Authorization: authorization string请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必选 | 参数位置 | 描述 |
|---|---|---|---|---|
| instanceId | String | 是 | Path参数 | 实例ID |
| projectName | String | 是 | Path参数 | 命名空间名称 |
| repositoryName | String | 是 | Path参数 | 镜像仓库名称 |
响应头域
除公共头域外，无其它特殊头域。
响应参数
无响应参数
请求示例
DELETE /v1/instances/ccr-4k74gw7d/projects/ns-test/repositories/ubuntu-1 HTTP/1.1
Host: ccr.bd.baidubce.com
Authorization: authorization string
响应示例
Content-Type: application/json; charset=utf-8
Date: Thu, 28 Jul 2022 03:25:43 GMT
X-Bce-Gateway-Region: BJ
X-Bce-Request-Id: b42840ec-a200-49c9-86bd-58687b7009bb批量删除镜像仓库
接口描述
批量删除镜像仓库。
请求结构
DELETE /v1/instances/{instanceId}/projects/{projectName}/repositories HTTP/1.1
Host: ccr.bd.baidubce.com
Authorization: authorization string
{
"items":["{repositoryName}","{repositoryName}"]
}
请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必选 | 参数位置 | 描述 |
|---|---|---|---|---|
| instanceId | String | 是 | Path参数 | 实例ID |
| projectName | String | 是 | Path参数 | 命名空间名称 |
| items | List<String> | 是 | Body参数 | 镜像仓库名称数组 |
响应参数
无响应参数。
请求示例
DELETE /v1/instances/ccr-4k74gw7d/projects/ns-test/repositories HTTP/1.1
Host: ccr.baidubce.com
Authorization: authorization string
{
"items":["ubuntu-4","ubuntu-3"]
}响应示例
Content-Type: application/json; charset=utf-8
Date: Thu, 28 Jul 2022 03:25:43 GMT
X-Bce-Gateway-Region: BJ
X-Bce-Request-Id: b42840ec-a200-49c9-86bd-58687b7009bb