22. tag
管理存储库的标签。
22.1. restoreTag 复制链接链接已复制到粘贴板!
将存储库标签恢复回存储库中以前的镜像。
POST /api/v1/repository/{repository}/tag/{tag}/restore
授权: oauth2_implicit (存储库:写)
路径参数
类型 | Name | 描述 | 模式 |
---|---|---|---|
path |
需要 仓库 | 存储库的完整路径。例如 namespace/name | 字符串 |
path |
需要 标签 | 标签的名称 | string |
请求正文模式(application/json)
将标签恢复到特定镜像
名称 | 描述 | 模式 |
---|---|---|
manifest_digest | 如果指定,应使用的清单摘要 | 字符串 |
响应
22.2. changeTag 复制链接链接已复制到粘贴板!
更改标签指向或创建新标签的镜像。
PUT /api/v1/repository/{repository}/tag/{tag}
授权: oauth2_implicit (存储库:写)
路径参数
类型 | Name | 描述 | 模式 |
---|---|---|---|
path |
需要 仓库 | 存储库的完整路径。例如 namespace/name | 字符串 |
path |
需要 标签 | 标签的名称 | string |
请求正文模式(application/json)
更改特定标签
名称 | 描述 | 模式 |
---|---|---|
manifest_digest | (如果指定)标签应指向的清单摘要 | |
过期 | (如果指定)镜像的过期时间 |
响应
22.3. deleteFullTag 复制链接链接已复制到粘贴板!
删除指定的存储库标签。
DELETE /api/v1/repository/{repository}/tag/{tag}
授权: oauth2_implicit (存储库:写)
路径参数
类型 | Name | 描述 | 模式 |
---|---|---|---|
path |
需要 仓库 | 存储库的完整路径。例如 namespace/name | 字符串 |
path |
需要 标签 | 标签的名称 | string |
响应
22.4. listRepoTags 复制链接链接已复制到粘贴板!
GET /api/v1/repository/{repository}/tag/
授权: oauth2_implicit (存储库:read)
路径参数
类型 | Name | 描述 | 模式 |
---|---|---|---|
path |
需要 仓库 | 存储库的完整路径。例如 namespace/name | 字符串 |
查询参数
类型 | Name | 描述 | 模式 |
---|---|---|---|
query |
onlyActiveTags | 仅过滤为活动的标签。 | 布尔值 |
query |
页 | 结果的页面索引。默认 1。 | 整数 |
query |
限制 | 限制为每个页面要返回的结果数。最大 100。 | 整数 |
query |
filter_tag_name | 语法:<op>:<name> 根据操作过滤标签名称。<op> 可以是 'like' 或 'eq'。 | 字符串 |
query |
specificTag | 过滤标签到特定标签。 | 字符串 |