2.22. tag
管理存储库的标签。
2.22.1. restoreTag 复制链接链接已复制到粘贴板!
将存储库标签恢复回存储库中以前的镜像。
POST /api/v1/repository/{repository}/tag/{tag}/restore
授权: oauth2_implicit (存储库:写)
路径参数
| 类型 | 名称 | 描述 | 模式 |
|---|---|---|---|
| path |
需要 仓库 | 存储库的完整路径。例如 namespace/name | string |
| path |
需要 标签 | 标签的名称 | string |
请求正文模式(application/json)
将标签恢复到特定镜像
| Name | 描述 | 模式 |
|---|---|---|
|
manifest_digest | 如果指定,应使用的清单摘要 | string |
响应
示例命令
2.22.2. changeTag 复制链接链接已复制到粘贴板!
更改标签指向或创建新标签的镜像。
PUT /api/v1/repository/{repository}/tag/{tag}
授权: oauth2_implicit (存储库:写)
路径参数
| 类型 | Name | 描述 | 模式 |
|---|---|---|---|
| path |
需要 仓库 | 存储库的完整路径。例如 namespace/name | 字符串 |
| path |
需要 标签 | 标签的名称 | 字符串 |
请求正文模式(application/json)
更改特定标签
| Name | 描述 | 模式 |
|---|---|---|
|
manifest_digest | (如果指定)标签应指向的清单摘要 | |
|
过期 | (如果指定)镜像的过期时间 |
响应
示例命令
2.22.3. deleteFullTag 复制链接链接已复制到粘贴板!
删除指定的存储库标签。
DELETE /api/v1/repository/{repository}/tag/{tag}
授权: oauth2_implicit (存储库:写)
路径参数
| 类型 | Name | 描述 | 模式 |
|---|---|---|---|
| path |
需要 仓库 | 存储库的完整路径。例如 namespace/name | 字符串 |
| path |
需要 标签 | 标签的名称 | 字符串 |
响应
2.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> 根据 operation.<op> 过滤标签名称,可以是 'like' 或 'eq'。 | 字符串 |
| query |
specificTag | 将标签过滤到特定标签。 | 字符串 |
响应
示例命令
curl -X GET \ -H "Authorization: Bearer <bearer_token>" \ -H "Accept: application/json" \ https://<quay-server.example.com>/api/v1/repository/<namespace>/<repository_name>/tag/
$ curl -X GET \
-H "Authorization: Bearer <bearer_token>" \
-H "Accept: application/json" \
https://<quay-server.example.com>/api/v1/repository/<namespace>/<repository_name>/tag/