Create Multiple Servers
サーバを一括作成します。
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
HTTPステータスコード
正常時:202
エラー時:400, 401, 403, 404, 409
リクエストパラメータの説明
Create Serverのリクエストパラメータおよび以下のパラメータを指定できます。
名前 | In | Type |
デフォルト値 /必須指定 |
Description |
---|---|---|---|---|
project_id | path | string | 必須 | プロジェクトのUUID |
name | body | string | 必須 |
サーバ名前のベース 作成される各サーバの名前の末尾に、一意の文字列が追加されます。 本情報は、コンピュータ名/ホスト名としても使用されます。 なお、本パラメータに設定する文字列は、以下のように変更され、設定されます。
|
min_count | body | integer |
1 任意 |
作成するサーバの最小数 |
max_count | body | integer |
(min_count) 任意 |
作成するサーバの最大数 |
return_reservation_id | body | boolean |
false 任意 |
「true」の場合は、サーバ情報の代わりに予約IDが返却されます。 |
レスポンスボディ(正常系)の説明
名前 | Type | Description |
---|---|---|
reservation_id | string |
サーバの予約ID 一括作成で作成されるサーバは同じ予約IDを有します。 |
リクエスト例
{
"server": {
"name": "new-server-test",
"flavorRef": "f5dc173b-6804-445a-a6d8-c705dad5b5eb",
"networks": [
{
"uuid": "f5dc173b-6804-445a-a6d8-c705dad5b5eb"
}
],
"block_device_mapping_v2": [
{
"boot_index": "0",
"uuid": "f5dc173b-6804-445a-a6d8-c705dad5b5eb",
"source_type": "image",
"volume_size": "40",
"destination_type": "volume"
}
],
"key_name": "key_pair",
"security_groups": [
{
"name": "default"
}
],
"min_count": "2"
}
}
レスポンス例
予約IDを利用する場合{
"reservation_id": "r-3fhpjulh"
}
予約IDを利用しない場合
{
"server": {
"OS-DCF:diskConfig": "AUTO",
"adminPass": "wfksH3GTTseP",
"id": "440cf918-3ee0-4143-b289-f63e1d2000e6",
"links": [
{
"href": "http://openstack.example.com/v2/6f70656e737461636b20342065766572/servers/440cf918-3ee0-4143-b289-f63e1d2000e6",
"rel": "self"
},
{
"href": "http://openstack.example.com/6f70656e737461636b20342065766572/servers/440cf918-3ee0-4143-b289-f63e1d2000e6",
"rel": "bookmark"
}
],
"security_groups": [
{
"name": "default"
}
]
}
}