Rebuild Server (rebuild Action)

指定したサーバを再構築します。サーバの再起動と同等の動作です。

APIエンドポイント

リージョン	APIエンドポイント
西日本リージョン3の場合	https://compute.jp-west-3.cloud.global.fujitsu.com
東日本リージョン3の場合	https://compute.jp-east-3.cloud.global.fujitsu.com

HTTPメソッドとURI

POST

/v2.1/{project_id}/servers/{server_id}/action

HTTPステータスコード

正常時：202

エラー時：400, 401, 403, 404, 409

リクエストパラメータの説明

名前	In	Type	デフォルト値 /必須指定	Description
project_id	path	string	必須	プロジェクトのUUID
server_id	path	string	必須	サーバのUUID
rebuild	body	object	必須	サーバを再構築するアクション
imageRef	body	string	必須	参照するイメージのUUID 再構築前と同じイメージのUUIDを指定してください。
accessIPv4	body	string	任意	サーバにアクセスするためのIPv4アドレス
adminPass	body	string	任意	サーバの管理者パスワード省略する場合は、自動的に生成されます。
metadata	body	object	任意	メタデータのキーと値のペア最大値は255です。
name	body	string	任意	サーバ名注: サーバ名に以下の文字は使用しないでください。小なり不等号(<) 大なり不等号(>) アンパサンド(&) シングルクォート(') ダブルクォート(") パーセント(%) アットマーク(@)
preserve_ephemeral	body	boolean	任意	サーバ揮発性ディスクの有無を表示します(ベアメタルサーバの場合だけ)。
description	body	string	任意	サーバの説明 255文字までです。注: マイクロバージョン2.19以上を指定してください。
key_name	body	string	任意	再構築後のキーペア名「null」の場合は、既存のキーペアは設定されません。注: 提供しているOSイメージでは、本指定が反映されません。必要に応じてプライベートイメージを作成してください。マイクロバージョン2.54以上を指定してください。
user_data	body	string	任意	再構築後のスクリプトの設定情報 Base64で暗号化されている必要があります。「null」の場合は、既存のユーザーデータは設定されません。注: 提供しているOSイメージでは、本指定が反映されません。必要に応じてプライベートイメージを作成してください。マイクロバージョン2.57以上を指定してください。

レスポンスボディ（正常系）の説明

名前	Type	Description
server	object	サーバのオブジェクト
accessIPv4	string	サーバにアクセスするためのIPv4アドレス
accessIPv6	string	サーバにアクセスするためのIPv6アドレス
addresses	object	サーバのアドレス情報
adminPass	string	サーバの管理者パスワード enable_instance_passwordが「false」の場合は、表示されません。
created	string	リソースの作成日時日時の入力形式は以下のISO 8601形式です。 CCYY-MM-DDThh:mm:ss±hh:mm 例：2015-08-27T09:49:58-05:00 「±hh:mm」の部分は、タイムゾーンにUTCからのオフセットがある場合だけ表示されます。上記の例は、オフセットの値が「-05:00」です。
flavor	object	サーバの作成元のフレーバー情報
flavor.id	string	フレーバーのID 注: マイクロバージョン2.46までは表示されます。
flavor.links	array	フレーバーへのリンク情報注: マイクロバージョン2.46までは表示されます。
flavor.vcpus	integer	サーバに割り当てられている仮想CPUの数注: 表示するにはマイクロバージョン2.47以上を指定してください。
flavor.ram	integer	フレーバーのRAMサイズ(MB単位) 注: 表示するにはマイクロバージョン2.47以上を指定してください。
flavor.disk	integer	ルートディスクのサイズ(GB単位) 注: 表示するにはマイクロバージョン2.47以上を指定してください。
flavor.ephemeral	integer	揮発性ディスクのサイズ(GB単位) 注: 表示するにはマイクロバージョン2.47以上を指定してください。
flavor.swap	integer	スワップ専用ディスクのサイズ(MB単位) 注: 表示するにはマイクロバージョン2.47以上を指定してください。
flavor.original_name	string	フレーバーの表示名注: 表示するにはマイクロバージョン2.47以上を指定してください。
flavor.extra_specs	object	フレーバーの拡張仕様のキーと値のペア注: 表示するにはマイクロバージョン2.47以上を指定してください。
flavor.extra_specs.key	string	フレーバーの拡張仕様のキー注: 表示するにはマイクロバージョン2.47以上を指定してください。
flavor.extra_specs.value	string	フレーバーの拡張仕様の値注: 表示するにはマイクロバージョン2.47以上を指定してください。
hostId	string	ハッシュされているホストID
id	string	サーバのUUID
image	object	サーバのUUIDとリンクURL ボリュームからブートする場合は、「null」になります。
image.id	string	イメージのID
image.links	array	サーバへのリンクURL
links	array	サーバに関連するリンクURL
metadata	object	メタデータのキーと値のペア最大値は255です。
name	string	サーバ名
OS-DCF:diskConfig	string	ディスクの設定「AUTO」または「MANUAL」を指定します。
progress	integer	ビルド進捗率
status	string	サーバのステータス
tenant_id	string	プロジェクトのUUID
updated	string	サーバの更新日時日時の入力形式は以下のISO 8601形式です。 CCYY-MM-DDThh:mm:ss±hh:mm 例：2015-08-27T09:49:58-05:00 「±hh:mm」の部分は、タイムゾーンにUTCからのオフセットがある場合だけ表示されます。上記の例は、オフセットの値が「-05:00」です。
user_id	string	サーバの所有者のユーザーID
locked	boolean	仮想サーバのロック状態「true」の場合は、仮想サーバがロックされています。注: 表示するにはマイクロバージョン2.9以上を指定してください。
description	string	サーバの説明注: 表示するにはマイクロバージョン2.19以上を指定してください。
tags	array	サーバのタグ表示するタグの最大数は50です。注: 表示するにはマイクロバージョン2.26以上を指定してください。
key_name	string	関連付けられているキーペアの名前注: 表示するにはマイクロバージョン2.54以上を指定してください。
user_data	string	サーバのユーザーデータ注: 表示するにはマイクロバージョン2.57以上を指定してください。

リクエスト例

{
    "rebuild" : {
        "accessIPv4" : "1.2.3.4",
        "accessIPv6" : "80fe::",
        "imageRef" : "70a599e0-31e7-49b7-b260-868f441e862b",
        "name" : "foobar",
        "key_name": "new-key",
        "description" : "description of foobar",
        "adminPass" : "seekr3t",
        "metadata" : {
            "meta_var" : "meta_val"
        }
    }
}

レスポンス例

{
    "server": {
        "accessIPv4": "1.2.3.4",
        "accessIPv6": "80fe::",
        "addresses": {
            "private": [
                {
                    "addr": "192.168.0.3",
                    "version": 4
                }
            ]
        },
        "adminPass": "seekr3t",
        "created": "2013-11-14T06:29:00Z",
        "flavor": {
            "id": "ce448e97-6b84-4ccb-bcd6-618cea3248fd",
            "links": [
               {
                 "href": "https://compute.jp-east-3.cloud.global.fujitsu.com/6f70656e737461636b20342065766572/flavors/ce448e97-6b84-4ccb-bcd6-618cea3248fd",
                 "rel": "bookmark"
               }
             ]
        },
        "hostId": "28d8d56f0e3a77e20891f455721cbb68032e017045e20aa5dfc6cb66",
        "id": "a0a80a94-3d81-4a10-822a-daa0cf9e870b",
        "image": {
            "id": "70a599e0-31e7-49b7-b260-868f441e862b",
            "links": [
                {
                    "href": "http://openstack.example.com/6f70656e737461636b20342065766572/images/70a599e0-31e7-49b7-b260-868f441e862b",
                    "rel": "bookmark"
                }
            ]
        },
        "links": [
            {
                "href": "http://openstack.example.com/v2/6f70656e737461636b20342065766572/servers/a0a80a94-3d81-4a10-822a-daa0cf9e870b",
                "rel": "self"
            },
            {
                "href": "http://openstack.example.com/6f70656e737461636b20342065766572/servers/a0a80a94-3d81-4a10-822a-daa0cf9e870b",
                "rel": "bookmark"
            }
        ],
        "locked": false,
        "metadata": {
            "meta_var": "meta_val"
        },
        "name": "foobar",
        "key_name": "new-key",
        "description" : "description of foobar",
        "progress": 0,
        "status": "ACTIVE",
        "OS-DCF:diskConfig": "AUTO",
        "tenant_id": "6f70656e737461636b20342065766572",
        "updated": "2013-11-14T06:29:02Z",
        "user_id": "fake",
        "tags": []
    }
}