Description
作成済みVMに対してOS再インストールをします。
実行するVMが停止している必要があります。
VMの管理者パスワードについて
VMの管理者パスワードは「adminPass」パラメータを利用します。
「adminPass」は「Optional」ですが、指定する「image」によって動作が変わります。
| ・ | Publicイメージを指定した場合、パスワードが入力されなかったらランダムなパスワードが設定されます。 |
| ・ | Privateイメージ（自身のVPSの保存イメージ）を指定した場合、パスワードが入力されなかったら元イメージのパスワードが設定されます。(※レスポンスのadminPassには““と表示されます) |
| ・ | 文字種は、半角英大文字と半角英小文字と半角数字または記号の組み合わせ以外はエラーになります。文字数は、9文字以上～70文字以内です。使用可能の記号は以下となります。 |
! # $ % & ? ” ' = + - _ { } [ ] ^ ~ : ; ( ) . , / | * @
Request URL
Compute API
POST /v2/{tenant_id}/servers/{server_id}/action
Request Json
{
"rebuild": {
"imageRef": "イメージID",
"adminPass": "管理者パスワード",
"key_name": "SSHキー名"
}
}
Request Parameters
| Parameter | Value | Style | Description |
|---|---|---|---|
| X-Auth-Token | トークンID | header | トークンIDを指定します。 |
| tenant_id | テナントID | path | テナントIDを指定します。 |
| server_id | サーバーID | path | サーバーIDを指定します。 |
| imageRef | イメージID | body | イメージIDを指定します。 |
| adminPass(Optional) | 管理者パスワード | body | サーバーの管理者パスワードを指定します。 |
| key_name(Optional) | SSHキー名 | body | SSHキー名を指定します。 |
Response Code
Success
202
Example
Request
curl -i -X POST -H "Accept: application/json" -H "X-Auth-Token: トークンID" -d '{"rebuild": {"imageRef": "イメージID", "adminPass":"管理者パスワード"}}' https://compute.tyo1.conoha.io/v2/テナントID/servers/サーバーID/action
Response
HTTP/1.1 202 Accepted
Date: Tue, 09 Dec 2014 10:02:58 GMT
Server: Apache
Content-Length: 1385
Content-Type: text/html; charset=UTF-8
{
"server": {
"OS-DCF:diskConfig": "MANUAL",
"accessIPv4": "",
"accessIPv6": "",
"addresses": {
"ext-133-130-48-0-xx": [
{
"addr": "133.130.49.xxx",
"version": 4
},
{
"addr": "2400:8500:1301:727:133:130:49:xxxx",
"version": 6
}
]
},
"adminPass": "72LY2hf38Kf84vCy4,Ur",
"created": "2015-05-08T01:00:41Z",
"flavor": {
"id": "7eea7469-0d85-4f82-8050-6ae742394681",
"links": [
{
"href": "https://compute.tyo1.conoha.io/1864e71d2deb46f6b47526b69c65a45d/flavors/7eea7469-0d85-4f82-8050-6ae742394681",
"rel": "bookmark"
}
]
},
"hostId": "1b21cb1fa28badef69e02b6a2e71909dbf62a982e65892fad8ad01cf",
"id": "e25b3611-96df-4514-a54b-7729aec48dc1",
"image": {
"id": "fb1d084f-357f-40e2-a2c3-59b8ecc1f6f2",
"links": [
{
"href": "https://compute.tyo1.conoha.io/1864e71d2deb46f6b47526b69c65a45d/images/fb1d084f-357f-40e2-a2c3-59b8ecc1f6f2",
"rel": "bookmark"
}
]
},
"links": [
{
"href": "https://compute.tyo1.conoha.io/v2/1864e71d2deb46f6b47526b69c65a45d/servers/e25b3611-96df-4514-a54b-7729aec48dc1",
"rel": "self"
},
{
"href": "https://compute.tyo1.conoha.io/1864e71d2deb46f6b47526b69c65a45d/servers/e25b3611-96df-4514-a54b-7729aec48dc1",
"rel": "bookmark"
}
],
"metadata": {
"backup_id": "",
"backup_set": "0",
"backup_status": "active",
"instance_name_tag": "vps-2015-05-08-09-59",
"properties": {
"vnc_keymap": "ja",
"hw_video_model": "vga",
"hw_vif_model": "virtio",
"hw_disk_bus": "virtio",
"cdrom_path": ""
}
},
"name": "server1",
"status": "SHUTOFF",
"tenant_id": "1864e71d2deb46f6b47526b69c65a45d",
"updated": "2015-05-08T06:56:45Z",
"user_id": "068ae7141b3a4e15bebb8b9ca177e9d3"
}
}
ConoHaにて提供しておりますAPIにつきましては、クラウド基盤として採用しておりますOpenStackの機能にて実装しておりますので、詳細な情報や使い方はOpenStackのドキュメントにてご確認ください。
