2.21. tag

管理存储库的标签。

2.21.1. restoreTag

将存储库标签恢复到存储库中的旧镜像。

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

授权: oauth2_implicit (repo:write)

路径参数
类型Name描述模式

path

软件仓库
必需

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

字符串

path

需要 标签

标签的名称

字符串

请求正文模式(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 (repo:write)

路径参数
类型Name描述模式

path

软件仓库
必需

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

字符串

path

需要 标签

标签的名称

字符串

请求正文模式(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 (repo:write)

路径参数
类型Name描述模式

path

软件仓库
必需

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

字符串

path

需要 标签

标签的名称

字符串

响应
HTTP 代码描述模式

204

已删除

 

400

错误请求

ApiError

401

需要会话

ApiError

403

未授权访问

ApiError

404

未找到

ApiError

2.21.4. listRepoTags

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

授权: oauth2_implicit (repo:read)

路径参数
类型Name描述模式

path

软件仓库
必需

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

字符串

查询参数
类型Name描述模式

query

onlyActiveTags
optional

仅过滤到活跃的标签。

布尔值

query

Page
可选

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

整数

query

限制
可选

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

整数

query

filter_tag_name
optional

语法:<op>:<name> 根据操作过滤标签名称。<op> 可以是 'like' 或 'eq'。

字符串

query

specificTag
可选

将标签过滤到特定标签。

字符串

响应
HTTP 代码描述模式

200

成功调用

 

400

错误请求

ApiError

401

需要会话

ApiError

403

未授权访问

ApiError

404

未找到

ApiError