Get a GPU Node

Retrieve the details for a specific GPU node using its unique identifier. The response includes all SSH connection fields, labels, status, and the current agent count.

Endpoint

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

Path parameters

string

required

GPU node identifier, e.g. gn_a1b2c3d4.

Response

string

required

Node identifier.

string

required

Node name.

string

required

Node IP address.

integer

SSH port.

string

required

SSH username.

string

Hardware or configuration spec.

array of strings

Scheduling labels.

string

Current status, e.g. active.

integer

Number of deployed agents on this node.

string (ISO 8601)

Creation timestamp.

string (ISO 8601)

Last update timestamp.

Example

curl -s http://<pin-host>:8001/v1/gpu-nodes/gn_a1b2c3d4 \
  -H "Authorization: Bearer $ARIA_PIN_KEY"

{
  "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",
  "agent_count": 2,
  "created_at": "2024-05-01T12:00:00Z",
  "updated_at": "2024-05-10T08:30:00Z"
}

PIN API

ROUTER API

AGENT API

Endpoint

Path parameters

Response

Example

​Endpoint

​Path parameters

​Response

​Example

Endpoint

Path parameters

Response

Example