In the "Placement Groups" section, create a new group. Give it a name and select a policy — affinity or anti-affinity — and click Create Placement Group.
## Create a Virtual Machine included in a placement group
When creating a Virtual Machine, in the "Additional options" section, move the "Add to placement group" slider and select a group or create a new one — the machine will be a member of it.
## Add a previously created Virtual Machine to a group
In the Virtual Machine menu, open the "Placement Group" tab. Select the previously created group where you want to add the VM to, or create a new one. Click "Add".
## Move a Virtual Machine from one group to another
In the Virtual Machine menu, open the "Placement Group" tab. Remove a machine from one group and add it to another —you can add it to a new one or to a previously created one.
Placement groups control how VMs are distributed across physical hosts — grouping them together for low-latency communication or spreading them apart for fault tolerance.
Set environment variables before running any of the examples below:
```bash theme={null} export GCORE_API_KEY="{YOUR_API_KEY}" export GCORE_CLOUD_PROJECT_ID="{YOUR_PROJECT_ID}" export GCORE_CLOUD_REGION_ID="{YOUR_REGION_ID}" export IMAGE_ID="{YOUR_IMAGE_ID}" export FLAVOR_ID="{YOUR_FLAVOR_ID}" ```The scripts below create an anti-affinity placement group, launch a VM in it, verify membership, then remove the VM and delete the group.
Each step below explains what the call does and what to expect in the response.
GET /cloud/v1/flavors/{project_id}/{region_id}. |
| `image_id` | Yes | Public image ID — region-specific; list available images via GET /cloud/v1/images/{project_id}/{region_id}?visibility=public. |
GET /cloud/v1/tasks/{task_id} every 5 seconds until `state` is `FINISHED`. The instance ID is in `created_resources.instances[0]`.
Export the instance ID:
```bash theme={null}
export INSTANCE_ID="{instance_id from created_resources}"
```
GET /cloud/v1/tasks/{task_id} every 5 seconds until `state` is `FINISHED`.
GET /cloud/v1/tasks/{task_id} every 5 seconds until `state` is `FINISHED`.
GET /cloud/v1/tasks/{task_id} until each `state` is `FINISHED`.
Deleting a placement group does not delete the VMs in it — the VMs keep running without a placement constraint.
GET /cloud/v1/tasks/{task_id} every 5 seconds until `state` is `FINISHED`.
Group Virtual Machines by scheduling policy — `affinity` to co-locate, `anti-affinity` to spread across hosts. The [`gcore_cloud_placement_group`](https://registry.terraform.io/providers/G-Core/gcore/latest/docs/resources/cloud_placement_group) resource manages the group and its membership.
## Create a placement groupDeclares a placement group with the selected policy. Choose `affinity` to co-locate VMs on the same host, `anti-affinity` to spread them across different hosts, or `soft-anti-affinity` to prefer separation but allow sharing when resources are constrained.
```hcl theme={null} resource "gcore_cloud_placement_group" "example" { project_id = var.project_id region_id = var.region_id name = "my-group" policy = "anti-affinity" } output "group_id" { value = gcore_cloud_placement_group.example.id } ```Set the `instances` attribute to a list of VM IDs. Terraform manages the full membership declaratively — adding an entry assigns the VM to the group, removing an entry removes it.
```hcl theme={null} resource "gcore_cloud_placement_group" "example" { project_id = var.project_id region_id = var.region_id name = "my-group" policy = "anti-affinity" instances = [ { instance_id = var.instance_id }, ] } ```To assign a VM to a group at creation time, set `servergroup_id = gcore_cloud_placement_group.example.id` in the [Virtual Machine](/cloud/virtual-instances/create-an-instance) resource instead.
## Delete a placement groupRemove the resource block — Terraform detects the missing declaration and deletes the group on the next `terraform apply`. VMs keep running; the placement constraint no longer applies.
```hcl theme={null} # Remove or comment out this block: # resource "gcore_cloud_placement_group" "example" { # name = "my-group" # policy = "anti-affinity" # project_id = var.project_id # region_id = var.region_id # } ``` ```bash theme={null} terraform apply ``` ## Import a placement groupUse when a placement group was created outside Terraform and needs to be managed as code.
```hcl theme={null} resource "gcore_cloud_placement_group" "example" { project_id = var.project_id region_id = var.region_id name = "my-group" policy = "anti-affinity" } ``` ```bash theme={null} terraform import gcore_cloud_placement_group.example '