ログイン

OS再インストール

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