2.21. tag

管理存储库的标签。

2.21.1. restoreTag

将存储库标签恢复到存储库中的上一个镜像。

POST /api/v1/repository/{repository}/tag/{tag}/restore

授权: oauth2_implicit (存储库:write

路径参数
类型Name描述模式

path

需要 标签

标签的名称

字符串

path

软件仓库
必需

存储库的完整路径。例如 namespace/name

字符串

请求正文模式(application/json)

将标签恢复到特定镜像

名称描述模式

manifest_digest
optional

如果指定,应使用的清单摘要

字符串

响应
HTTP 代码描述模式

201

成功创建

 

400

错误请求

ApiError

401

需要会话

ApiError

403

未授权访问

ApiError

404

未找到

ApiError

2.21.2. changeTag

更改标签指向或创建新标签的镜像。

PUT /api/v1/repository/{repository}/tag/{tag}

授权: oauth2_implicit (存储库:write

路径参数
类型Name描述模式

path

需要 标签

标签的名称

字符串

path

软件仓库
必需

存储库的完整路径。例如 namespace/name

字符串

请求正文模式(application/json)

对特定标签进行更改

名称描述模式

manifest_digest
optional

(如果指定)标签应指向的清单摘要

 

过期
可选

(如果指定)镜像的过期时间

 
响应
HTTP 代码描述模式

200

成功调用

 

400

错误请求

ApiError

401

需要会话

ApiError

403

未授权访问

ApiError

404

未找到

ApiError

2.21.3. deleteFullTag

删除指定的存储库标签。

DELETE /api/v1/repository/{repository}/tag/{tag}

授权: oauth2_implicit (存储库:write

路径参数
类型Name描述模式

path

需要 标签

标签的名称

字符串

path

软件仓库
必需

存储库的完整路径。例如 namespace/name

字符串

响应
HTTP 代码描述模式

204

已删除

 

400

错误请求

ApiError

401

需要会话

ApiError

403

未授权访问

ApiError

404

未找到

ApiError

2.21.4. listRepoTags

GET /api/v1/repository/{repository}/tag/

授权: oauth2_implicit (存储库:read

路径参数
类型Name描述模式

path

软件仓库
必需

存储库的完整路径。例如 namespace/name

字符串

查询参数
类型Name描述模式

query

onlyActiveTags
optional

过滤到仅活跃的标签。

布尔值

query

Page
可选

结果的页面索引。默认 1.

整数

query

limit
optional

限制为每个页面返回的结果数量。最大 100 个。

整数

query

specificTag
optional

将标签过滤到特定的标签。

字符串

响应
HTTP 代码描述模式

200

成功调用

 

400

错误请求

ApiError

401

需要会话

ApiError

403

未授权访问

ApiError

404

未找到

ApiError