Create Server Group#

サーバグループを作成します。

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}/os-server-groups

HTTPステータスコード#

正常時：200

エラー時：400, 401, 403

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

名前	In	Type	デフォルト値 /必須指定	Description
project_id	path	string	必須	プロジェクトのUUID
server_group	body	object	必須	サーバグループのオブジェクト
name	body	string	必須	サーバグループ名指定可能文字数は255バイト以下です。
policies	body	array	必須	サーバグループに関連付けるポリシー「anti-affinity」または「soft-affinity」が指定できます。ポリシーについては、機能説明書の「サーバグループ機能」を参照してください。 📒注: マイクロバージョン2.63までは表示されます。ただし、「soft-affinity」を指定するにはマイクロバージョン2.15以上を指定してください。

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

名前	Type	Description
server_group	object	サーバグループのオブジェクト
id	string	サーバグループのUUID
name	string	サーバグループ名
policies	array	サーバグループに関連付けられているポリシー「anti-affinity」または「soft-affinity」のどちらかです。ポリシーについては、機能説明書の「サーバグループ機能」を参照してください。 📒注: マイクロバージョン2.63までは表示されます。
members	array	サーバグループのメンバー
metadata	object	メタデータのキーと値のペア最大値は255です。 📒注: マイクロバージョン2.63までは表示されます。
project_id	string	サーバグループの所有者のプロジェクトID 📒注: 表示するにはマイクロバージョン2.13以上を指定してください。
user_id	string	サーバグループの所有者のユーザーID 📒注: 表示するにはマイクロバージョン2.13以上を指定してください。

リクエスト例#

{
    "server_group": {
        "name": "test",
        "policies": ["anti-affinity"]
    }
}

レスポンス例#

{
    "server_group": {
        "id": "5bbcc3c4-1da2-4437-a48a-66f15b1b13f9",
        "name": "test",
        "policies": ["anti-affinity"],
        "members": [],
        "metadata": {}
    }
}