7.4. 使用 API 将新标签添加到镜像标签到镜像

流程

1. 您可以使用 PUT /api/v1/repository/{repository}/tag/{tag} 命令更改标签指向或创建新标签：

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

   Copy to Clipboard Toggle word wrap

   输出示例

   "Updated"

   Copy to Clipboard Toggle word wrap

2. 您可以使用 POST /api/v1/repository/{repository}/tag/{tag}/restore 命令将存储库标签恢复到以前的镜像。例如：

   $ curl -X POST \
     -H "Authorization: Bearer <bearer_token>" \
     -H "Content-Type: application/json" \
     --data '{
       "manifest_digest": <manifest_digest>
     }' \
     quay-server.example.com/api/v1/repository/quayadmin/busybox/tag/test/restore

   Copy to Clipboard Toggle word wrap

   输出示例

   {}

   Copy to Clipboard Toggle word wrap

3. 要在创建新标签后查看标签列表，您可以使用 GET /api/v1/repository/{repository}/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

   Copy to Clipboard Toggle word wrap

   输出示例

   {"tags": [{"name": "test", "reversion": false, "start_ts": 1716324069, "manifest_digest": "sha256:57583a1b9c0a7509d3417387b4f43acf80d08cdcf5266ac87987be3f8f919d5d", "is_manifest_list": false, "size": 2275314, "last_modified": "Tue, 21 May 2024 20:41:09 -0000"}, {"name": "example", "reversion": false, "start_ts": 1715698131, "manifest_digest": "sha256:57583a1b9c0a7509d3417387b4f43acf80d08cdcf5266ac87987be3f8f919d5d", "is_manifest_list": false, "size": 2275314, "last_modified": "Tue, 14 May 2024 14:48:51 -0000"}, {"name": "example", "reversion": false, "start_ts": 1715697708, "end_ts": 1715698131, "manifest_digest": "sha256:57583a1b9c0a7509d3417387b4f43acf80d08cdcf5266ac87987be3f8f919d5d", "is_manifest_list": false, "size": 2275314, "last_modified": "Tue, 14 May 2024 14:41:48 -0000", "expiration": "Tue, 14 May 2024 14:48:51 -0000"}, {"name": "test", "reversion": false, "start_ts": 1715695488, "end_ts": 1716324069, "manifest_digest": "sha256:57583a1b9c0a7509d3417387b4f43acf80d08cdcf5266ac87987be3f8f919d5d", "is_manifest_list": false, "size": 2275314, "last_modified": "Tue, 14 May 2024 14:04:48 -0000", "expiration": "Tue, 21 May 2024 20:41:09 -0000"}, {"name": "test", "reversion": false, "start_ts": 1715631517, "end_ts": 1715695488, "manifest_digest": "sha256:57583a1b9c0a7509d3417387b4f43acf80d08cdcf5266ac87987be3f8f919d5d", "is_manifest_list": false, "size": 2275314, "last_modified": "Mon, 13 May 2024 20:18:37 -0000", "expiration": "Tue, 14 May 2024 14:04:48 -0000"}], "page": 1, "has_additional": false}

   Copy to Clipboard Toggle word wrap