Sign in

v32

latestOpenAPI 3.1.0raw.githubusercontent.com2026-05-151,1412,2144.5 MB
Placement Groups

Create placement group

Create an affinity or anti-affinity or soft-anti-affinity placement group

post/cloud/v1/servergroups/{project_id}/{region_id}

Path parameters

project_idinteger required

Project ID

region_idinteger required

Region ID

Request body

namestring required

The name of the server group.

policy'affinity' | 'anti-affinity' | 'soft-anti-affinity' required

Example request

{
  "name": "my-server-group"
}

Response

Returned placement group

namestring required

The name of the server group.

policystring required

The server group policy. Options are: anti-affinity, affinity, or soft-anti-affinity.

project_idinteger required

Project ID

regionstring required

Region name

region_idinteger required

Region ID

servergroup_idstring required

The ID of the server group.

Example response

{
  "instances": [
    {
      "instance_id": "6d14f194-6c1e-49b3-9fc7-50dc8401eb74",
      "instance_name": "my-instance-1"
    },
    {
      "instance_id": "142988bb-291e-4862-bffb-b1cf20036c27",
      "instance_name": "my-instance-2"
    }
  ],
  "name": "my-server-group",
  "policy": "anti-affinity",
  "project_id": 1337,
  "region": "Luxembourg 1",
  "region_id": 7,
  "servergroup_id": "47003067-550a-6f17-93b6-81ee16ba061e"
}