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