compute
GET /v1/compute/servers/{serverId}/health
Read a server's hardware and live resource usage.
Аутентификация
API кілтін bearer токені ретінде жіберіңіз. Кілтте sites.view рұқсаты болуы тиіс; онсыз кілтке 404 емес, 403 қатесі қайтарылады.
Бұл соңғы нүкте ұйым идентификаторын қабылдамайды. Сіздің кілтіңіз оның қай ұйымға тиесілі екенін өзі анықтайды және жауап соған шектеледі.
Әрекет етіп көру
Бұрыштық жақшалардағы кез келген нәрсені өз мәндеріңізбен, ал кілт орналастырушысын басқару тақтасынан алынған кілтпен алмастырыңыз.
curl -X GET https://api.zinndigital.com/v1/compute/servers/{serverId}/health \
-H "Authorization: Bearer zdk_live_…"Жүйеге кіргенсіз бе? Бақылау тақтасындағы API консолі ұйымыңыздың нақты идентификаторы мен жеке кілтіңізді автоматты түрде толтырады да, нақты жауапты көре алуыңыз үшін сұрауды тікелей жұмыс істеп тұрған API арқылы орындайды. Бұл соңғы нүктені API консолінде ашыңыз
Мәліметтер
What the machine is made of - cores, memory, disk, operating system - and how hard it is working right now: CPU, memory, disk and this month's bandwidth. Read live from the provider on every call and never stored, for the same reason the renewal is: a cached CPU reading is stale the moment it is written, and a customer looking at a usage gauge is asking about now. Every usage figure is -1 when the provider did not answer, which is not the same as zero. A client must render the difference: 0% says the machine is idle, -1 says we could not ask. Memory and disk are byte counts with both halves of the ratio, so a screen can say "224 MB of 1 GB" rather than only a percentage. power_state is the provider's own word (running, shut off), carried verbatim and never rounded to a boolean. This response deliberately carries no hostname. The provider also states the guest hostname and the physical KVM host; both name our supplier and are never exposed to a customer. Requires sites.view.
Параметрлер
| Аты | Tүрі | Міндетті | Мазмұны |
|---|---|---|---|
serverId (path) | Uuid | Иә | The server's id, as listComputeServers reports it. Ours (UUIDv7), minted when the order row was written — never the provider's own identifier for the machine. |
Жауап
| Аты | Tүрі | Міндетті | Мазмұны |
|---|---|---|---|
cores | integer | Иә | Virtual CPU cores the machine is sold with. |
ram_mb | integer | Иә | Memory the machine is sold with, in megabytes. |
disk_gb | integer | Иә | Primary disk the machine is sold with, in gigabytes. |
os_name | string | Иә | The provider's own name for the operating system image, or "". |
ram_used_bytes | integer | Иә | Memory in use, in bytes. null when the provider did not say. |
ram_total_bytes | integer | Иә | Total memory, in bytes. null when the provider did not say. |
disk_used_bytes | integer | Иә | Disk in use, in bytes. null when the provider did not say. |
disk_total_bytes | integer | Иә | Total disk, in bytes. null when the provider did not say. |
cpu_percent | number | Иә | Processor in use, 0-100. null when the provider did not say. ⛔ Normalised to a real percentage at the boundary, on every range. One provider reports every non-idle CPU class… |
bandwidth_used_gb | number | Иә | This month's transfer, in gigabytes. null when not stated. |
bandwidth_allowance_gb | number | Иә | The monthly transfer allowance, in gigabytes. ⭐ The one field on this schema that may be -1, meaning the allowance has no ceiling; null means the provider did not state… |
bandwidth_overage_gb | number | Иә | Transfer used beyond the allowance this month, in gigabytes, as the provider states it — the figure overage charges are computed from. null when not stated, and a client must… |
power_state | string | Иә | The provider's own word for the machine's state (running, shut off), verbatim and never rounded to a boolean, or "". |
Бұл соңғы нүкте қайтара алатын қателер
401 · 403 · 404 · 422 · 429 · 503