Update image metadata items

Method URI Description
POST /v2/{tenant_id}/images/{image_id}/metadata キーで指定したイメージのメタデータ項目を更新します。

指定したキーに一致する項目を置換するが、リクエストで指定されない項目は変更しない。

操作の結果メタデータ項目の数が上限を超える場合、overLimit(413)エラーがスローされる可能性があります。

Normal response codes: 200

注意:
チェックサムが設定されていないイメージに対して、メタ情報は設定できません。チェックサムが設定されていないイメージに対しては、「Update an image」でメタ情報を設定してください。

Request

下表は、イメージメタデータ項目更新リクエストのURIパラメーターの一覧です。

Name Type Description
{tenant_id} UUID プロジェクトID
{image_id} UUID イメージID

下表は、イメージメタデータ項目更新リクエストのボディ部のパラメーターの一覧です。

Name Type Description
metadata object 一組のキー/値のペア。これらのペアは、リソースのメタデータにある既存のキーと値のペアを、一致するキーで置き換えます。既存リソースのメタデータに存在しないキーを持つパラメーター内のキーと値のペアがすべて、リソースのメタデータに追加されます。

Example. Update image metadata items: JSON request


{
	"metadata": {
		"kernel_id": "False",
		"Label": "UpdatedImage"
	}
}
     

Response

Example. Update image metadata items: JSON response


{
	"metadata": {
		"Label": "UpdatedImage",
		"architecture": "x86_64",
		"auto_disk_config": "True",
		"kernel_id": "False",
		"ramdisk_id": "nokernel"
	}
}