---
title: "Xem một máy chạy"
locale: vi
url: https://tlg.builera.app/docs/reference/rest/nodes.get
verified: 2026-10-24
app_version: "2.0"
generated: true
---

# Xem một máy chạy

Một máy như Máy chạy → chi tiết: trạng thái, các bước dựng (mã), CPU / RAM / tài khoản đang chạy trung bình mỗi 5 phút trong 24 giờ, và các tài khoản trên máy. Cần kết nối được phép mọi tài khoản (vì thấy hoạt động mọi tài khoản trên máy). Không bao giờ có khoá, mật khẩu hay đường hỗ trợ.

Một máy như Máy chạy → chi tiết: trạng thái, các bước dựng (mã), CPU / RAM / tài khoản đang chạy trung bình mỗi 5 phút trong 24 giờ, và các tài khoản trên máy. Cần kết nối được phép mọi tài khoản (vì thấy hoạt động mọi tài khoản trên máy). Không bao giờ có khoá, mật khẩu hay đường hỗ trợ.

## Thông tin

| Tên | Giá trị |
| --- | --- |
| Mã | `nodes.get` |
| Scope cần | `accounts.read` |
| Mức | Chỉ đọc |
| Có thể cần xác nhận | Không |
| Kiểu chạy | Trả kết quả ngay |
| Cần `Idempotency-Key` | Không |
| Vai trò thành viên được phép | `owner`, `manager`, `agent`, `viewer` |
| Trong app | Máy chạy → chi tiết |

## Trường vào

| Trường | Kiểu | Bắt buộc | Mô tả |
| --- | --- | --- | --- |
| `nodeId` | `uuid` | Có |   |

## Ví dụ gọi

```bash
curl -X POST https://tlg.builera.app/api/public/v2/ops/nodes.get \
  -H "Authorization: Bearer $TELEGRAM_AUTO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"nodeId":"00000000-0000-0000-0000-000000000000"}'
```

## Trường ra (`data`)

| Trường | Kiểu | Bắt buộc |
| --- | --- | --- |
| `node` | `đối tượng` | Có |
| `steps` | `đối tượng[]` | Có |
| `metrics` | `đối tượng[]` | Có |
| `bucketMinutes` | `5` | Có |
| `accounts` | `đối tượng[]` | Có |

## Ví dụ trả về

```json
{
  "data": {
    "node": {
      "used": 1,
      "id": "00000000-0000-4000-8000-000000000000",
      "name": "text",
      "kind": "hetzner",
      "status": "error",
      "region": "text",
      "server_type": "text",
      "vcpu": 1,
      "ram_mb": 1,
      "capacity_accounts": 1,
      "drain": true,
      "full_flag": true,
      "ipv4": "text",
      "worker_version": "text",
      "worker_os": "text",
      "worker_arch": "text",
      "provision_attempts": 1,
      "last_seen_at": "2026-10-22T12:00:00.000Z",
      "last_tick_at": "2026-10-22T12:00:00.000Z",
      "worker_booted_at": "2026-10-22T12:00:00.000Z",
      "restart_requested_at": "2026-10-22T12:00:00.000Z",
      "monthly_price": 1,
      "price_currency": "text",
      "created_at": "2026-10-22T12:00:00.000Z"
    },
    "steps": [
      {
        "step": "text",
        "status": "text",
        "started_at": "2026-10-22T12:00:00.000Z",
        "finished_at": "2026-10-22T12:00:00.000Z"
      }
    ],
    "metrics": [
      {
        "at": "text",
        "cpu": 1,
        "ram": 1,
        "accounts_ok": 1,
        "accounts_error": 1,
        "telegram_latency_ms": 1
      }
    ],
    "bucketMinutes": 5,
    "accounts": [
      {
        "id": "00000000-0000-4000-8000-000000000000",
        "label": "text",
        "username": "text",
        "connection_state": "text",
        "session_state": "active",
        "safety_state": "healthy",
        "paused": true
      }
    ]
  }
}
```

## Dùng qua MCP

Không có tên sẵn trong profile nào: gọi `tools_describe` rồi `tools_run` với `code: "nodes.get"`. Tên tool khi được liệt kê: `nodes_get`.