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 に出力を返しません。