ログイン

ボリュームイメージ保存

Description

ボリュームのイメージ保存をします。

・ サーバーにアタッチされているボリュームの場合、対象のサーバーが停止中である必要があります。
・ サイズが1TB以上のボリュームはイメージ保存ができません。
・ イメージ保存容量を超過している場合、イメージ保存を実行してもイメージは保存できません。イメージ保存容量を変更してから再実行してください。

Request URL

Volume API

POST /v3/{projectid}/volumes/{volumeid}/action

Request Json

{
  "os-volume_upload_image": {
    "image_name": "保存イメージの名前"
  }
}

Request Parameters

Parameter Value Style Description
X-Auth-Token トークン header トークンの情報を指定します。
トークンの発行方法は、トークン発行 にてご確認ください。
projectid テナントID path テナントIDを指定します。
指定する情報は、API情報を確認する にてご確認ください。
volumeid ボリュームID path ボリュームIDを指定します。
ボリュームIDの確認方法は、ボリューム一覧取得 を実行の上、レスポンス結果から対象ボリュームのボリュームIDをご確認ください。
image_name 保存イメージの名前 body 保存するイメージの任意の名前を指定します。
コントロールパネルのネームタグに反映されます。

Response Code

Success 

202

Example

Request 

curl -X POST \
-H "Accept: application/json" \
-H "X-Auth-Token: トークン" \
-d '{"os-volume_upload_image": {"image_name": "保存イメージの名前"}}' \
https://block-storage.c3j1.conoha.io/v3/テナントID/volumes/ボリュームID/action

Response 

{
	"os-volume_upload_image": {
		"id": "15197557-585c-46b9-85e0-cd2c3f794ebd",
		"updated_at": "2023-11-25T01:17:59.000000",
		"status": "uploading",
		"display_description": null,
		"size": 200,
		"volume_type": {
			"id": "be4575a3-67bb-47c5-9cf7-3fdfeca50d38",
			"name": "c3j1-ds02-add",
			"description": "for vps add volume",
			"is_public": true,
			"extra_specs": {
				"volume_backend_name": "c3j1-ds02-add"
			},
			"qos_specs_id": "c4b3f6f9-3c6f-4102-ab79-04960835e826",
			"created_at": "2023-09-25T05:06:19.000000",
			"updated_at": "2023-09-25T05:13:04.000000",
			"deleted_at": null,
			"deleted": false
		},
		"image_id": "97d918c2-82a1-47f4-a887-0bd2e42a586f",
		"container_format": "ovf",
		"disk_format": "qcow2",
		"image_name": "保存イメージの名前",
		"protected": false,
		"visibility": "shared"
	}
}

ConoHaにて提供しておりますAPIにつきましては、クラウド基盤として採用しておりますOpenStackの機能にて実装しておりますので、詳細な情報や使い方はOpenStackのドキュメントにてご確認ください。