Create a GPU Node

Register a new GPU node so Aria Compute PIN can manage agents on it. Provide SSH connection details and an optional spec and label set. The node is created with status active.

Endpoint

POST /v1/gpu-nodes Authorization: Bearer API key required.

Request body

string

required

Human-readable node name.

string

required

Node IP address for SSH access.

string

required

SSH username.

integer

SSH port (defaults to 22).

string

SSH private key (plaintext, encrypted before storage).

string

SSH password (plaintext, encrypted before storage).

string

Hardware spec summary.

array of strings

Scheduling labels.

Response

integer

Response code (0 for success).

object

required

The created GPU node object.

Show child attributes

string

required

Node identifier, e.g. gn_abc123de.

string

required

Node name.

string

required

Node IP.

integer

SSH port.

string

required

SSH username.

string

Spec summary.

array of strings

Labels.

string

Created status, e.g. active.

string (ISO 8601)

Creation timestamp.

string (ISO 8601)

Update timestamp.

string

Empty on success.

Example

curl -s -X POST http://<pin-host>:8001/v1/gpu-nodes \
  -H "Authorization: Bearer $ARIA_PIN_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "node-01",
    "ip": "10.0.1.10",
    "ssh_user": "ubuntu",
    "ssh_port": 22,
    "ssh_key": "-----BEGIN OPENSSH PRIVATE KEY-----\n...",
    "spec": "A100-80G x8",
    "labels": ["training", "a100"]
  }'

{
  "code": 0,
  "data": {
    "id": "gn_a1b2c3d4",
    "name": "node-01",
    "ip": "10.0.1.10",
    "ssh_port": 22,
    "ssh_user": "ubuntu",
    "spec": "A100-80G x8",
    "labels": ["training", "a100"],
    "status": "active",
    "created_at": "2024-05-01T12:00:00Z",
    "updated_at": "2024-05-01T12:00:00Z"
  },
  "message": ""
}

PIN API

ROUTER API

AGENT API

Endpoint

Request body

Response

Example

​Endpoint

​Request body

​Response

​Example

Endpoint

Request body

Response

Example