Skip to main content
POST
/
cloud
/
v1
/
servergroups
/
{project_id}
/
{region_id}
Python
import os
from gcore import Gcore

client = Gcore(
    api_key=os.environ.get("GCORE_API_KEY"),  # This is the default and can be omitted
)
placement_group = client.cloud.placement_groups.create(
    project_id=0,
    region_id=0,
    name="my-server-group",
    policy="anti-affinity",
)
print(placement_group.project_id)
{
  "instances": [
    {
      "instance_id": "<string>",
      "instance_name": "<string>"
    }
  ],
  "name": "<string>",
  "policy": "<string>",
  "project_id": 123,
  "region": "<string>",
  "region_id": 123,
  "servergroup_id": "<string>"
}

Authorizations

Authorization
string
header
required

API key for authentication. Make sure to include the word apikey, followed by a single space and then your token. Example: apikey 1234$abcdef

Path Parameters

project_id
integer
required

Project ID

region_id
integer
required

Region ID

Body

application/json
name
string
required

The name of the server group.

policy
enum<string>
required

The server group policy.

Available options:
affinity,
anti-affinity,
soft-anti-affinity

Response

200 - application/json

Returned placement group

instances
Instance brief details schema · object[]
required

The list of instances in this server group.

name
string
required

The name of the server group.

policy
string
required

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

project_id
integer
required

Project ID

region
string
required

Region name

region_id
integer
required

Region ID

servergroup_id
string
required

The ID of the server group.