ログイン

サーバー再構築（OS再インストール）

Description

作成済みサーバーに対してOS再インストールをします。

実行するサーバーが停止している必要があります。

Request URL

Compute API

POST /v2.1/servers/{serverid}/action

Request Json

・パスワード認証の場合

{
    "rebuild":{
        "imageRef": "イメージID",
        "adminPass": "管理者パスワード"
    }
}

・鍵認証の場合

{
    "rebuild":{
        "imageRef": "イメージID",
        "adminPass": "管理者パスワード",
        "key_name": "SSH Key名"
    }
}

Request Parameters

Parameter Value Style Description
X-Auth-Token トークン header トークンの情報を指定します。
トークンの発行方法は、トークン発行 にてご確認ください。
Content-Type application/json header データの形式(メディアタイプ)を指定します。
serverid サーバーID path サーバーIDを指定します。
サーバーIDの確認方法は、サーバー一覧取得 を実行の上、レスポンス結果から対象VPSのサーバーIDをご確認ください。
imageRef イメージID body イメージIDを指定します。
イメージIDの確認方法は、イメージ一覧取得 を実行の上、レスポンス結果から対象のイメージIDをご確認ください。
adminPass 管理者パスワード body サーバーの管理者パスワードを指定します。
key_name
(Optional)		 SSH Key名 body SSH Key名を指定します。
SSH Key名の確認方法は、SSHキーペア一覧取得 を実行の上、レスポンス結果から対象SSH Keyの「name」をご確認ください。

Response Code

Success 

202

Example

Request 

curl -X POST \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "X-Auth-Token: トークン" \
-d '{"rebuild":{"imageRef": "イメージID","adminPass": "管理者パスワード"}}' \
https://compute.c3j1.conoha.io/v2.1/servers/サーバーID/action

Response 

{
	"server": {
		"id": "268c3fbc-e0b1-48f2-b614-4682d1ba6021",
		"name": "vm-37806450-5c",
		"status": "REBUILD",
		"tenant_id": "テナントID",
		"user_id": "ユーザーID",
		"metadata": {
			"instance_name_tag": "vps-2023-11-24-12-53",
			"backup_status": "active",
			"backup_id": "edfaa0b1-8619-408f-87d2-de13fef3b999",
			"backup_set": "6",
			"backup_rotate": "3",
			"hw_video_model": "vga"
		},
		"hostId": "f0f840fe0cb1a19fcb7a06c283eea0f7ccec9a175a471ae61fdb3881",
		"image": "",
		"flavor": {
			"vcpus": 2,
			"ram": 1024,
			"disk": 0,
			"ephemeral": 0,
			"swap": 0,
			"original_name": "g2l-t-c2m1",
			"extra_specs": {
				"aggregate_instance_extra_specs:aggregate_name": "vps-linux"
			}
		},
		"created": "2023-11-24T03:56:10Z",
		"updated": "2023-11-25T10:19:24Z",
		"addresses": {
			"ext-v4v6-XXX-XXX-XXX-0-23": [
				{
					"version": 6,
					"addr": "****:****:****:****:***:***:***:***",
					"OS-EXT-IPS:type": "fixed",
					"OS-EXT-IPS-MAC:mac_addr": "**:**:**:**:**:**"
				},
				{
					"version": 4,
					"addr": "XXX.XXX.XXX.XXX",
					"OS-EXT-IPS:type": "fixed",
					"OS-EXT-IPS-MAC:mac_addr": "**:**:**:**:**:**"
				}
			]
		},
		"accessIPv4": "",
		"accessIPv6": "",
		"links": [
			{
				"rel": "self",
				"href": "https://compute.c3j1.conoha.io/v2.1/servers/268c3fbc-e0b1-48f2-b614-4682d1ba6021"
			},
			{
				"rel": "bookmark",
				"href": "https://compute.c3j1.conoha.io/servers/268c3fbc-e0b1-48f2-b614-4682d1ba6021"
			}
		],
		"OS-DCF:diskConfig": "MANUAL",
		"progress": 0,
		"OS-EXT-AZ:availability_zone": "cell1-az1",
		"config_drive": "True",
		"key_name": null,
		"OS-SRV-USG:launched_at": "2023-11-24T03:56:17.000000",
		"OS-SRV-USG:terminated_at": null,
		"security_groups": [
			{
				"name": "セキュリティグループ名"
			}
		],
		"OS-EXT-SRV-ATTR:host": "cn-yf130181.z1.c3j1.v6",
		"OS-EXT-SRV-ATTR:instance_name": "c3j1-0000b117",
		"OS-EXT-SRV-ATTR:hypervisor_hostname": "ホストサーバー名",
		"OS-EXT-SRV-ATTR:reservation_id": "r-l8ribygk",
		"OS-EXT-SRV-ATTR:launch_index": 0,
		"OS-EXT-SRV-ATTR:hostname": "vm-37806450-5c",
		"OS-EXT-SRV-ATTR:kernel_id": "",
		"OS-EXT-SRV-ATTR:ramdisk_id": "",
		"OS-EXT-SRV-ATTR:root_device_name": "/dev/vda",
		"OS-EXT-STS:task_state": "rebuilding",
		"OS-EXT-STS:vm_state": "stopped",
		"OS-EXT-STS:power_state": 4,
		"os-extended-volumes:volumes_attached": [
			{
				"id": "edfaa0b1-8619-408f-87d2-de13fef3b999",
				"delete_on_termination": false
			}
		],
		"locked": false,
		"locked_reason": null,
		"description": "vm-37806450-5c",
		"tags": [],
		"trusted_image_certificates": null,
		"server_groups": [],
		"adminPass": "***********",
		"user_data": "*************************************"
	}
}

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