22.2. changeTag
タグが参照するイメージを変更するか、新規タグを作成します。
PUT /api/v1/repository/{repository}/tag/{tag}
認可: oauth2_implicit (repo:write)
パスパラメーター
| 型 | 名前 | 説明 | スキーマ |
|---|---|---|---|
| path |
repository | リポジトリーの完全パス (例: namespace/name) | string |
| path |
tag | タグの名前 | string |
要求の body スキーマ (application/json)
特定のタグを変更します。
| 名前 | 説明 | スキーマ |
|---|---|---|
|
manifest_digest | (指定されている場合) タグが参照すべきマニフェストダイジェスト | |
|
expiration | (指定されている場合) イメージの有効期限 |
レスポンス
| HTTP コード | 説明 | スキーマ |
|---|---|---|
| 201 | 正常な呼び出し | |
| 400 | Bad Request (不適切な要求) | |
| 401 | セッションが必要 | |
| 403 | 不正アクセス | |
| 404 | 見つからない |
コマンドの例
$ 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>