Create an HA rule

Creates a placement rule for 2 to 3 VMs of the project: keep them on separate nodes (negative, the default) or on the same node (positive). HA is enabled on the listed VMs if it is not yet. Each VM can be in one rule only.

Authorization

bearerAuth

AuthorizationBearer <token>

API key created in the portal (Settings → API Keys). Send as Authorization: Bearer <key>.

In: header

Path Parameters

project_uuid*string

Project UUID.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

HA rule to create.

vmids*array<>

VMIDs the rule applies to: 2 to 3, no duplicates. Each VM can be in one rule only. HA is enabled on these VMs if it is not yet.

affinity?string

negative keeps the VMs on separate nodes, positive keeps them on the same node. Defaults to negative.

Default"negative"

Value in

"positive"
"negative"

Response Body

`application/json`

curl -X POST "https://example.com/cloud/project/string/vm/ha/rules/" \  -H "Content-Type: application/json" \  -d '{    "vmids": [      1    ]  }'

{  "rule": "string",  "affinity": "positive",  "enabled": true,  "vmids": [    0  ],  "managed": true}