2.21. tag


管理存储库的标签。

2.21.1. restoreTag

将存储库标签还原回存储库中的以前的镜像。

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

Authorizations: oauth2_implicit(存储库:write

路径参数
Expand
类型Name描述模式

path

需要 标签

标签的名称

字符串

path

软件仓库
必需

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

字符串

请求正文模式(application/json)

将标签恢复到特定镜像

Expand
名称描述模式

manifest_digest
optional

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

字符串

响应
Expand
HTTP 代码描述模式

201

成功创建

 

400

错误请求

ApiError

401

必需的会话

ApiError

403

未授权访问

ApiError

404

未找到

ApiError

2.21.2. deleteFullTag

删除指定的存储库标签。

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

Authorizations: oauth2_implicit(存储库:write

路径参数
Expand
类型Name描述模式

path

需要 标签

标签的名称

字符串

path

软件仓库
必需

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

字符串

响应
Expand
HTTP 代码描述模式

204

已删除

 

400

错误请求

ApiError

401

必需的会话

ApiError

403

未授权访问

ApiError

404

未找到

ApiError

2.21.3. changeTag

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

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

Authorizations: oauth2_implicit(存储库:write

路径参数
Expand
类型Name描述模式

path

需要 标签

标签的名称

字符串

path

软件仓库
必需

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

字符串

请求正文模式(application/json)

更改特定标签

Expand
名称描述模式

manifest_digest
optional

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

 

过期
可选

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

 
响应
Expand
HTTP 代码描述模式

200

成功调用

 

400

错误请求

ApiError

401

必需的会话

ApiError

403

未授权访问

ApiError

404

未找到

ApiError

2.21.4. listRepoTags

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

Authorizations: oauth2_implicit(存储库:read

路径参数
Expand
类型Name描述模式

path

软件仓库
必需

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

字符串

查询参数
Expand
类型Name描述模式

query

onlyActiveTags
optional

将 过滤为仅活跃的标签。

布尔值

query

Page
可选

结果页面索引。默认 1。

整数

query

limit
optional

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

整数

query

specificTag
optional

过滤标签到特定标签。

字符串

响应
Expand
HTTP 代码描述模式

200

成功调用

 

400

错误请求

ApiError

401

必需的会话

ApiError

403

未授权访问

ApiError

404

未找到

ApiError

返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

Theme

© 2025 Red Hat