Create Multiple Servers

サーバを一括作成します。

📒注: 「/etc/cloud/cloud.cfg」に以下の設定がない場合は、「/etc/cloud/cloud.cfg.d/datasource.cfg」を作成して追加してください。すでに設定済の場合は、対応する必要はありません。

datasource_list: ['OpenStack']

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, 503

📒注: 「503 Sorry. We're busy for now. Please retry after a while.」が返却された場合は、数分間待ってリトライしてください。

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

Create Serverのリクエストパラメータおよび以下のパラメータを指定できます。

名前	In	Type	デフォルト値 /必須指定	Description
project_id	path	string	必須	プロジェクトのUUID
name	body	string	必須	サーバ名前のベース 作成される各サーバの名前の末尾に、一意の文字列が追加されます。 本情報は、コンピュータ名/ホスト名としても使用されます。 なお、本パラメータに設定する文字列は、以下のように変更され、設定されます。 - 64文字以上を指定した場合、63文字に短縮 - 空白とアンダースコア(_)を、ハイフン(-)に置換 - アルファベットの大文字を、小文字に置換 - ピリオド(.)とハイフン(-)以外の記号を削除 - 先頭がピリオド(.)またはハイフン(-)の場合、文字列を削除 - 末尾がピリオド(.)またはハイフン(-)の場合、文字列を削除 - Windowsにおいては、文字列の先頭、末尾以外にピリオド(.)が存在する場合、ピリオド(.)直前までの文字列を採用 - Unicode文字U+0000からU+0FFF以外の文字を削除 - 変換によってホスト名が空になった場合、ランダムサーバー名を設定
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"
            }
        ]
    }
}