Sign in
pools

Create a node pool and place its VMs across hypervisors (anti-affinity spread, all-or-nothing). Placements are available at GET /pools/{id}/placements.

post/pools

Request

  • Base URL: /api/v1 (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /api/v1/pools
  • Auth: HTTP bearer

Request body

$schemastring uri

A URL to the JSON Schema for this object.

datacenter_idstring uuid required
desired_countinteger required
metadataunknown
namestring required
slot_idstring uuid required

Example request

{
  "$schema": "/api/v1/schemas/CreatePoolInputBody.json"
}

Response

Created

$schemastring uri

A URL to the JSON Schema for this object.

created_atstring date-time required
datacenter_idstring required
desired_countinteger required
idstring required
metadataunknown
namestring required
slot_idstring required
updated_atstring date-time required

Example response

{
  "$schema": "/api/v1/schemas/PoolView.json"
}

Changes

No recorded changes to this operation across all 13 revisions of this API.