Update an image#
イメージを更新します。
APIエンドポイント#
リージョン | APIエンドポイント |
---|---|
西日本リージョン3の場合 | https://image.jp-west-3.cloud.global.fujitsu.com |
東日本リージョン3の場合 | https://image.jp-east-3.cloud.global.fujitsu.com |
HTTPメソッドとURI#
PATCH
/v2/images/{image_id}
HTTPステータスコード#
正常時:200
エラー時:400, 401, 403, 404, 409, 413, 415
リクエストパラメータの説明#
名前 | In | Type | デフォルト値 /必須指定 |
Description |
---|---|---|---|---|
image_id | path | string | 必須 | イメージのUUID |
Content-Type | header | string | 必須 | 「application/openstack-images-v2.1-json-patch」を指定します。 |
レスポンスボディ(正常系)の説明#
名前 | Type | Description |
---|---|---|
checksum | string | イメージデータを検証するためのハッシュ値 「null」が表示される場合もあります。 |
container_format | enum | イメージコンテナのフォーマット 指定可能な値はイメージを定義するスキーマのレスポンスに表示されます。 例: ami, ari, aki, bare, ovf, ovaまたはdocker 「null」が表示される場合もあります。 |
created_at | string | リソースの作成日時 日時の入力形式は以下のISO 8601形式です。 CCYY-MM-DDThh:mm:ss±hh:mm 例:2015-08-27T09:49:58-05:00 「±hh:mm」の部分は、タイムゾーンにUTCからのオフセットがある場合にだけ表示されます。 |
disk_format | enum | ディスクのフォーマット 指定可能な値はイメージを定義するスキーマのレスポンスに表示されます。 例: ami, ari, aki, vhd, vhdx, vmdk, raw, qcow2, vdi, ploopまたはiso 「null」が表示される場合もあります。 |
file | string | イメージファイルのURL |
id | string | 以下の形式のイメージUUID nnnnnnnn-nnnn-nnnn-nnnn-nnnnnnnnnnnn 「n」は、16進数の0~Fです。 例:b2173dd3-7ad6-4362-baa6-a68bce3565cb 省略する場合は、UUIDが自動的に生成されます。 |
min_disk | integer | イメージを起動するために必要なディスク領域(GB単位) 「null」が表示される場合もあります。 |
min_ram | integer | イメージを起動するために必要なram領域(MB単位) 「null」が表示される場合もあります。 |
owner | string | イメージの所有者のプロジェクトID 「null」が表示される場合もあります。 |
name | string | イメージ名 「null」が表示される場合もあります。 |
protected | boolean | 「true」の場合はイメージは削除不可能 |
schema | string | イメージを定義するスキーマのURL |
self | string | イメージのURL |
size | integer | イメージデータのサイズ(バイト単位) 「null」が表示される場合もあります。 |
status | string | イメージのステータス |
tags | array | イメージのタグのリスト 空配列の場合もあります。 |
updated_at | string | リソースの最新更新日時 日時の入力形式は以下のISO 8601形式です。 CCYY-MM-DDThh:mm:ss±hh:mm 「±hh:mm」の部分は、UTCからのオフセットで表示されるタイムゾーンです。表示されない場合もあります。 例えば、以下の出力例に、UTCのタイムゾーンからの-05:00のオフセットが想定されます。 2015-08-27T09:49:58-05:00 設定されていない場合は、「null」です。 |
visibility | string | イメージの公開状況 |
direct_url | string | イメージをアクセスするためのURL |
locations | array | イメージの場所が記載されているオブジェクトのリスト 各オブジェクトにイメージへのリンクURL(URL)とそのキーと値のペアのリスト(メタデータ)が含まれています。 |
リクエスト例#
[ { "op": "replace", "path": "/name", "value": "Fedora 17" }, { "op": "replace", "path": "/tags", "value": [ "fedora", "beefy" ] } ]
レスポンス例#
{ "checksum": "710544e7f0c828b42f51207342622d33", "container_format": "ovf", "created_at": "2016-06-29T16:13:07Z", "disk_format": "vhd", "file": "/v2/images/2b61ed2b-f800-4da0-99ff-396b742b8646/file", "id": "2b61ed2b-f800-4da0-99ff-396b742b8646", "min_disk": 20, "min_ram": 512, "name": "Fedora 17", "owner": "02a7fb2dd4ef434c8a628c511dcbbeb6", "protected": false, "schema": "/v2/schemas/image", "self": "/v2/images/2b61ed2b-f800-4da0-99ff-396b742b8646", "size": 21909, "status": "active", "tags": [ "beefy", "fedora" ], "updated_at": "2016-07-25T14:48:18Z", "virtual_size": null, "visibility": "private" }