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 | 如果指定,应使用的清单摘要 | 字符串 |
响应
2.21.2. changeTag
更改标签指向或创建新标签的镜像。
PUT /api/v1/repository/{repository}/tag/{tag}
授权: oauth2_implicit (repo:write)
路径参数
| 类型 | Name | 描述 | 模式 |
|---|---|---|---|
| path |
软件仓库 | 存储库的完整路径。例如 namespace/name | 字符串 |
| path |
需要 标签 | 标签的名称 | 字符串 |
请求正文模式(application/json)
更改特定标签
| 名称 | 描述 | 模式 |
|---|---|---|
|
manifest_digest | (如果指定)标签应指向的清单摘要 | |
|
过期 | (如果指定)镜像的过期时间 |
响应
2.21.3. deleteFullTag
删除指定的存储库标签。
DELETE /api/v1/repository/{repository}/tag/{tag}
授权: oauth2_implicit (repo:write)
路径参数
| 类型 | Name | 描述 | 模式 |
|---|---|---|---|
| path |
软件仓库 | 存储库的完整路径。例如 namespace/name | 字符串 |
| path |
需要 标签 | 标签的名称 | 字符串 |
响应
2.21.4. listRepoTags
GET /api/v1/repository/{repository}/tag/
授权: oauth2_implicit (repo:read)
路径参数
| 类型 | Name | 描述 | 模式 |
|---|---|---|---|
| path |
软件仓库 | 存储库的完整路径。例如 namespace/name | 字符串 |
查询参数
| 类型 | Name | 描述 | 模式 |
|---|---|---|---|
| query |
onlyActiveTags | 仅过滤到活跃的标签。 | 布尔值 |
| query |
Page | 结果的页面索引。默认 1。 | 整数 |
| query |
限制 | 限制为每个页面返回的结果数。最大 100。 | 整数 |
| query |
filter_tag_name | 语法:<op>:<name> 根据操作过滤标签名称。<op> 可以是 'like' 或 'eq'。 | 字符串 |
| query |
specificTag | 将标签过滤到特定标签。 | 字符串 |