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のドキュメントにてご確認ください。
