Create server group

Method URI Description
POST /v2/{tenant_id}/os-server-groups サーバグループを作成します。

Normal response codes: 200

Request

下表は、仮想サーバグループ作成リクエストのURIパラメーターの一覧です。

Name Type Description
{tenant_id} String プロジェクトID

下表は、仮想サーバグループ作成リクエストのボディ部のパラメーターの一覧です。

Name Type Description
name String サーバグループ名。文字列の先頭と末尾に空白がなく、空ではない文字列。長さは最大255文字です。
policies array

(Optional)

サーバグループに関連付けられる1つ以上のポリシー名の一覧。一覧には、ポリシー名を少なくとも1つ含める必要があります。

各ポリシー名には、文字列の先頭と末尾に空白がなく、空ではない文字列を指定する必要があります。長さは最大255文字です。

"anti-affinity"および"affinity"が指定できます。

Availability zone内で冗長構成とする場合は、"anti-affinity"を指定します。

なお、"anti-affinity"のserver groupのuuidを指定してインスタンスを作成したとき、インスタンスを作成できるVMホストが無い場合は、インスタンスの作成要求を受け付けた後、インスタンスのstatusがERRORとなります。

availability_zone String

(Optional)

server groupを作成するavailability zoneを指定します。

省略時は、リクエスト実行ユーザーが属するドメインのUUIDよりAvailability zoneを自動的に決定します。

Example. Create server group: JSON request


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

Response

Example. Create server group: JSON response


{
	"server_group":{
		"members":[],
		"metadata":{},
		"id":"03a54e57-4fcc-40bc-b532-6426a238ee70",
		"policies":[
			"anti-affinity"
		],
		"name":"test"
	}
}