Update a GPU Node

Send a partial update to an existing GPU node. Only provided fields are changed; omitted fields keep their current values. SSH credentials are re-encrypted before storage when supplied.

Endpoint

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

Path parameters

string

required

GPU node identifier, e.g. gn_a1b2c3d4.

Request body

string

Updated human-readable name.

string

Updated IP address.

integer

Updated SSH port.

string

Updated SSH username.

string

New SSH private key (re-encrypted before storage).

string

New SSH password (re-encrypted before storage).

string

Updated hardware spec summary.

array of strings

Replacement label list.

string

New status string, e.g. active or maintenance.

Response

string

required

Node identifier.

string

required

Updated name.

string

required

Updated IP.

integer

SSH port.

string

required

SSH username.

string

Spec summary.

array of strings

Labels.

string

Current status.

string (ISO 8601)

Creation timestamp.

string (ISO 8601)

Last update timestamp.

Example

curl -s -X PUT http://<pin-host>:8001/v1/gpu-nodes/gn_a1b2c3d4 \
  -H "Authorization: Bearer $ARIA_PIN_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "node-01-renamed",
    "spec": "A100-80G x8",
    "labels": ["training", "a100", "priority"]
  }'

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

PIN API

ROUTER API

AGENT API

Endpoint

Path parameters

Request body

Response

Example

​Endpoint

​Path parameters

​Request body

​Response

​Example

Endpoint

Path parameters

Request body

Response

Example