22. tag


管理存储库的标签。

22.1. restoreTag

将存储库标签恢复回存储库中以前的镜像。

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

授权: oauth2_implicit (存储库:写)

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

path

需要 仓库

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

字符串

path

需要 标签

标签的名称

string

请求正文模式(application/json)

将标签恢复到特定镜像

Expand
名称描述模式

manifest_digest
required

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

字符串

响应
Expand
HTTP 代码描述模式

201

成功创建

 

400

错误请求

ApiError

401

需要会话

ApiError

403

未授权访问

ApiError

404

未找到

ApiError

22.2. changeTag

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

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

授权: oauth2_implicit (存储库:写)

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

path

需要 仓库

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

字符串

path

需要 标签

标签的名称

string

请求正文模式(application/json)

更改特定标签

Expand
名称描述模式

manifest_digest
optional

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

 

过期
可选

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

 
响应
Expand
HTTP 代码描述模式

201

成功调用

 

400

错误请求

ApiError

401

需要会话

ApiError

403

未授权访问

ApiError

404

未找到

ApiError

22.3. deleteFullTag

删除指定的存储库标签。

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

授权: oauth2_implicit (存储库:写)

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

path

需要 仓库

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

字符串

path

需要 标签

标签的名称

string

响应
Expand
HTTP 代码描述模式

204

已删除

 

400

错误请求

ApiError

401

需要会话

ApiError

403

未授权访问

ApiError

404

未找到

ApiError

22.4. listRepoTags

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

授权: oauth2_implicit (存储库:read)

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

path

需要 仓库

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

字符串

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

query

onlyActiveTags
optional

仅过滤为活动的标签。

布尔值

query


可选

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

整数

query

限制
可选

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

整数

query

filter_tag_name
optional

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

字符串

query

specificTag
可选

过滤标签到特定标签。

字符串

响应
Expand
HTTP 代码描述模式

200

成功调用

 

400

错误请求

ApiError

401

需要会话

ApiError

403

未授权访问

ApiError

404

未找到

ApiError

返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

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

让开源更具包容性

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

關於紅帽

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

Theme

© 2025 Red Hat