> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ariacompute.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# 获取 GPU 节点

> 按 ID 从咏唱引擎 PIN 获取单个 GPU 节点，包括 SSH 详情、标签、状态与智能体数量。

使用唯一标识符检索特定 GPU 节点的详情。响应包含所有 SSH 连接字段、标签、状态与当前智能体数量。

## 接口

**GET** `/v1/gpu-nodes/:id`

认证：需要 Bearer API 密钥。

## 路径参数

<ParamField path="id" type="string" required>
  GPU 节点标识符，例如 gn\_a1b2c3d4。
</ParamField>

## 响应

<ResponseField name="id" type="string" required>
  节点标识符。
</ResponseField>

<ResponseField name="name" type="string" required>
  节点名称。
</ResponseField>

<ResponseField name="ip" type="string" required>
  节点 IP 地址。
</ResponseField>

<ResponseField name="ssh_port" type="integer">
  SSH 端口。
</ResponseField>

<ResponseField name="ssh_user" type="string" required>
  SSH 用户名。
</ResponseField>

<ResponseField name="spec" type="string">
  硬件或配置规格。
</ResponseField>

<ResponseField name="labels" type="array of strings">
  调度标签。
</ResponseField>

<ResponseField name="status" type="string">
  当前状态，例如 active。
</ResponseField>

<ResponseField name="agent_count" type="integer">
  部署在此节点上的智能体数量。
</ResponseField>

<ResponseField name="created_at" type="string (ISO 8601)">
  创建时间戳。
</ResponseField>

<ResponseField name="updated_at" type="string (ISO 8601)">
  最近更新时间戳。
</ResponseField>

## 示例

```bash theme={null}
curl -s http://<pin-host>:8001/v1/gpu-nodes/gn_a1b2c3d4 \
  -H "Authorization: Bearer $ARIA_PIN_KEY"
```

```json theme={null}
{
  "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"
}
```