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"
}