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