> ## 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 节点

> 从咏唱引擎 PIN 移除一个 GPU 节点，并级联删除其智能体与训练任务。

删除一个 GPU 节点及其全部关联资源。这会级联到节点上的每个智能体：先清理训练任务，再移除智能体，最后删除节点本身。

## 接口

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

认证：需要 Bearer API 密钥。

## 路径参数

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

## 响应

<ResponseField name="code" type="integer">
  响应码（成功为 0）。
</ResponseField>

<ResponseField name="data" type="object" required>
  删除确认。

  <Expandable>
    <ResponseField name="node_id" type="string" required>
      已删除的节点标识符。
    </ResponseField>

    <ResponseField name="deleted" type="boolean" required>
      成功时恒为 true。
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="message" type="string">
  成功时为空。
</ResponseField>

## 示例

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

```json theme={null}
{
  "code": 0,
  "data": {
    "node_id": "gn_a1b2c3d4",
    "deleted": true
  },
  "message": ""
}
```