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 必須

サーバ名前のベース

作成される各サーバの名前の末尾に、一意の文字列が追加されます。

本情報は、コンピュータ名/ホスト名としても使用されます。

なお、本パラメータに設定する文字列は、以下のように変更され、設定されます。

  • 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"
            }
        ]
    }
}