Tham chiếu

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ợ.

Xem MarkdownTrang này sinh tự động từ mã nguồn mỗi lần phát hành.

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

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ề

{
  "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.

Xem một máy chạy

#Thông tin

#Trường vào

#Ví dụ gọi

#Trường ra (data)