创建 GPU 节点

注册一个新的 GPU 节点，以便咏唱引擎 PIN 能够在其上管理智能体。提供 SSH 连接详情以及可选的规格与标签集合。节点以 active 状态创建。

接口

POST /v1/gpu-nodes 认证：需要 Bearer API 密钥。

请求体

string

required

便于识别的节点名称。

string

required

用于 SSH 访问的节点 IP 地址。

string

required

SSH 用户名。

integer

SSH 端口（默认 22）。

string

SSH 私钥（明文，存储前加密）。

string

SSH 密码（明文，存储前加密）。

string

硬件规格摘要。

array of strings

调度标签。

响应

integer

响应码（成功为 0）。

object

required

所创建的 GPU 节点对象。

Show child attributes

string

required

节点标识符，例如 gn_abc123de。

string

required

节点名称。

string

required

节点 IP。

integer

SSH 端口。

string

required

SSH 用户名。

string

规格摘要。

array of strings

标签。

string

创建时的状态，例如 active。

string (ISO 8601)

创建时间戳。

string (ISO 8601)

更新时间戳。

string

成功时为空。

示例

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

接口

请求体

响应

示例

​接口

​请求体

​响应

​示例

接口

请求体

响应

示例