GPUs

GPU server allocation and deallocation

Allocate or deallocate GPU servers

patch

https://localhost:8443http://localhost:8787

/fabrics/{fabricName}/tenants/{tenantName}

Adds or removes GPU servers from a tenant. Only one operation (ADD or DELETE) is performed per request. Server hostnames are required to synthesize connections and provision the network accordingly.

Note: Once servers are associated with a tenant, network reachability is limited to servers within the same tenant, enforced by the tenant-aware East–West fabric. Tenant front-end access is via the tenant-specific VLAN (retrievable from Get Tenant Details).

Path parameters

fabricNamestringRequired

Name of the fabric. Required in every API request.

Example: Fabric2SU

tenantNamestringRequired

Name of the tenant.

Example: coke

Body

application/json

operationstring · enumRequired

ADD to allocate servers to the tenant; DELETE to deallocate.

Possible values:

Responses

200

GPU update processed successfully

application/json

messagestringOptionalExample: GPU update processed successfully.

400

Invalid request — GPU allocation exceeds tenant quota, or server list is null/empty

application/json

404

Server list is null or empty

application/json

409

One or more GPU servers are already allocated to another tenant

application/json

patch

/fabrics/{fabricName}/tenants/{tenantName}

HTTPcURLJavaScriptPython

PATCH /fabrics/{fabricName}/tenants/{tenantName} HTTP/1.1
Host: localhost:8443
Content-Type: application/json
Accept: */*
Content-Length: 118

{
  "operation": "ADD",
  "servers": [
    {
      "serverName": "hgx-su00-00",
      "shared": false
    },
    {
      "serverName": "hgx-su00-01",
      "shared": true
    }
  ]
}

Allocate GPU serversDeallocate GPU servers

{
  "message": "GPU update processed successfully."
}

Get available GPU servers

get

https://localhost:8443http://localhost:8787

/fabrics/{fabricName}/available_servers

Retrieves the list of free GPU servers available for allocation to a tenant in the specified fabric.

Path parameters

fabricNamestringRequired

Name of the fabric. Required in every API request.

Example: Fabric2SU

Responses

200

List of available GPU servers retrieved successfully

application/json

availableGPUsstring[]Optional

List of GPU server hostnames available for allocation.

Example: ["hgx-su01-h00","hgx-su01-h01"]

get

/fabrics/{fabricName}/available_servers

HTTPcURLJavaScriptPython

GET /fabrics/{fabricName}/available_servers HTTP/1.1
Host: localhost:8443
Accept: */*

200

List of available GPU servers retrieved successfully

{
  "availableGPUs": [
    "hgx-su01-h00",
    "hgx-su01-h01"
  ]
}