Create image

Method URI Description
POST /v2/{tenant_id}/volumes/{volume_id}/action イメージを作成します。

Normal response codes: 202

注意:

CentOS、Ubuntu、またはRed Hat Enterprise LinuxをOSとする仮想サーバイメージを作成する場合、イメージの作成前に実施する作業があります。

設定がイメージ内に残っていると、そのイメージから作成した仮想サーバとのネットワーク通信ができなくなります。

なお、作業の詳細については、「FUJITSU Cloud Service for OSS IaaS 機能説明書」の「仮想サーバイメージの管理」を参照してください。

注意:

システムボリューム内のオペレーティングシステムがWindowsの場合、イメージの作成前後に実施する作業があります。

  • イメージを作成する前の作業

    Windows仮想サーバ上でSysprep作業を実施してください。

    なお、作業の詳細については、「FUJITSU Cloud Service for OSS IaaS 機能説明書」の「Windows OSのSysprep手順」の「手順」を参照してください。

  • イメージを作成した後の作業

    イメージ化を実施したあと、仮想サーバに対してスナップショットのリストアおよび仮想サーバの再起動を実施します。

    なお、作業の詳細については、「FUJITSU Cloud Service for OSS IaaS 機能説明書」の「Windows OSのSysprep手順」の「実行結果」を参照してください。

Request

下表は、イメージ作成リクエストのURIパラメーターの一覧です。

Name Type Description
{tenant_id} String プロジェクトID
{volume_id} UUID 既存ボリュームの固有識別子

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

Name Type Description
container_format string

(Optional)

 作成するイメージのコンテナー形式を指定します。

"bare"を指定してください。

省略した場合、"bare"が指定されたものとして動作します。
disk_format string

(Optional)

 作成するイメージのディスク形式を指定します。

"raw"を指定してください。

省略した場合、"raw"が指定されたものとして動作します。
image_name string 作成するイメージの名前を指定します。
force boolean

(Optional)

 Falseを指定した場合、ボリュームがインスタンスに取り付けられていると、イメージを作成することができません。

Trueを指定した場合、ボリュームがインスタンスに取り付けられていても、イメージを作成することができます。本パラメーターを指定する場合、事前に、OSを停止してください。

省略した場合、Falseが指定されたものとして動作します。

Example. Create volume: JSON request


{
	"os-volume_upload_image": {
		"container_format": "bare",
		"disk_format": "raw",
		"image_name": "my_image",
		"force": "True"
	}
}

Response

Example. Create volume: JSON response


{
  "os-volume_upload_image":{
    "status":"uploading",
    "image_id":"3dc6c4d9-95e9-4cdb-a076-cc3ed50b9654",
    "image_name":"20150430_volume_to_image-003",
    "volume_type":{
      "name":"M1",
      "qos_specs_id":null,
      "deleted":false,
      "created_at":"2014-10-11T11:26:56.000000",
      "updated_at":null,
      "deleted_at":null,
      "id":"13a0247c-9363-401d-acd3-c5d07ccd1a45"
    },
    "container_format":"bare",
    "size":2,
    "disk_format":"raw",
    "id":"52102306-e352-4c84-9233-2ac2b511d29b",
    "display_description":null,
    "updated_at":"2015-04-30T06:31:31.000000"
  }
}

下表は、イメージ作成レスポンスのボディ部のパラメーターの一覧です。

Name Type Description
status String ボリュームの状態です。

ボリュームからイメージを作成し始めた直後は、"uploading"となります。イメージの作成が完了すると、"available"または"in-use"に戻ります。
image_id uuid 作成したイメージのidです。
image_name String Request Bodyで指定した値です。
volume_type String ボリュームのボリュームタイプです。

ボリュームタイプが未設定の場合は、子要素はなく、"null"が返却されます。
  name String ボリュームタイプの名前です。
qos_specs_id uuid qos specのidです。
deleted Boolean 削除されたか否かを示すフラグです。

trueが削除されたことを示します。
created_at Datetime ボリュームタイプの作成日時です。
updated_at Datetime ボリュームタイプの更新日時です。
deleted_at Datetime ボリュームタイプの削除日時です。
id uuid ボリュームタイプのidです。
container_format String Request Bodyで指定（または省略値）した値です。
size Int ボリュームの容量（GB）です。
disk_format String Request Bodyで指定（または省略値）した値です。
id Uuid ボリュームのidです。
display_description String ボリュームの説明です。
updated_at Datetime ボリュームの更新日時です。