6.18. 使用 Red Hat Quay API 管理标签

步骤

1. 使用 PUT /api/v1/repository/{repository}/tag/{tag} 端点更改标签指向或创建新标签：

   $ curl -X PUT "https://quay-server.example.com/api/v1/repository/<namespace>/<repo_name>/tag/<tag_name>" \
     -H "Authorization: Bearer <ACCESS_TOKEN>" \
     -H "Content-Type: application/json" \
     -d '{"manifest_digest": "<MANIFEST_DIGEST>"}'

   输出示例

   "Updated"

2. 使用 POST /api/v1/repository/{repository}/tag/{tag}/restore 端点将存储库标签恢复到存储库中以前的镜像：

   $ curl -X POST "https://quay-server.example.com/api/v1/repository/<namespace>/<repo_name>/tag/<tag_name>/restore" \
     -H "Authorization: Bearer <your_access_token>" \
     -H "Content-Type: application/json" \
     -d '{"manifest_digest": "sha256:<your_manifest_digest>"}'

   输出示例

   {}

3. 使用 GET /api/v1/repository/{repository}/tag/ 端点获取存储库标签列表：

   $ curl -X GET "https://quay-server.example.com/api/v1/repository/<namespace>/<repo_name>/tag/" \
     -H "Authorization: Bearer <your_access_token>" \
     -H "Content-Type: application/json"

   输出示例

   {"tags": [{"name": "test", "reversion": true, "start_ts": 1740496373, "manifest_digest": "sha256:d08334991a3dba62307016833083d6433f489ab0f7d36d0a4771a20b4569b2f6", "is_manifest_list": false, "size": 2280303, "last_modified": "Tue, 25 Feb 2025 15:12:53 -0000"}, {"name": "test", "reversion": false, "start_ts": 1740495442, "end_ts": 1740496373, "manifest_digest": "sha256:d08334991a3dba62307016833083d6433f489ab0f7d36d0a4771a20b4569b2f6", "is_manifest_list": false, "size": 2280303, "last_modified": "Tue, 25 Feb 2025 14:57:22 -0000", "expiration": "Tue, 25 Feb 2025 15:12:53 -0000"}, {"name": "test", "reversion": false, "start_ts": 1740495408, "end_ts": 1740495442, "manifest_digest": "sha256:d08334991a3dba62307016833083d6433f489ab0f7d36d0a4771a20b4569b2f6", "is_manifest_list": false, "size": 2280303, "last_modified": "Tue, 25 Feb 2025 14:56:48 -0000", "expiration": "Tue, 25 Feb 2025 14:57:22 -0000"}], "page": 1, "has_additional": false}

4. 使用 DELETE /api/v1/repository/{repository}/tag/{tag} 端点从存储库中删除标签：

   $ curl -X DELETE "https://quay-server.example.com/api/v1/repository/<namespace>/<repo_name>/tag/<tag_name>" \
     -H "Authorization: Bearer <your_access_token>"

   此命令不会在 CLI 中返回输出。