NodeRings Docs

Validate Node Topology

Dedicated CPU cores: parse-preview of a topology paste without persisting.

POST
/v1/node/topology/validate
Authorization<token>

Bearer token

In: header

X-Organization-ID<token>

Tenant or organization identifier

In: header

topologyPaste?string

Raw topology paste to validate without persisting.

nodeId?string

Optional node to cross-check the paste against (edit flow). When set, the parsed totals are compared with the node's Proxmox-reported CPU inventory (metadata.proxmox_cpu) and mismatches are returned as warnings.

Response Body

application/json

curl -X POST "https://api.nrings.io/v1/node/topology/validate" \  -H "Authorization: Bearer {your_token}" \  -H "X-Organization-ID: {your_org_id}" \  -H "Content-Type: application/json" \  -d '{  "topologyPaste": "string",  "nodeId": "string"}'
{
  "valid": true,
  "error": "string",
  "modelName": "string",
  "sockets": 0,
  "numaNodes": 0,
  "physicalCores": 0,
  "threadsPerCore": 0,
  "logicalCpus": 0,
  "smtEnabled": true,
  "numaSummary": [
    {
      "id": 0,
      "sockets": [
        0
      ],
      "memoryMb": "string",
      "memoryReservedMb": "string",
      "memoryAllocatedMb": "string",
      "memoryFreeMb": "string",
      "totalCores": 0,
      "freeCores": 0,
      "memoryEstimated": true
    }
  ],
  "warnings": [
    {
      "code": "string",
      "message": "string"
    }
  ]
}