compute
GET /v1/compute/servers/{serverId}/health
Read a server's hardware and live resource usage.
ການພິສູດຕົວຕົນ
ສົ່ງລະຫັດ API ເປັນ bearer token. ລະຫັດຕ້ອງມີສິດ sites.view; ລະຫັດທີ່ບໍ່ມີສິດດັ່ງກ່າວຈະຖືກປະຕິເສດດ້ວຍລະຫັດ 403, ບໍ່ແມ່ນ 404.
ຈຸດເຊື່ອມຕໍ່ນີ້ບໍ່ໄດ້ຮັບ ID ອົງກອນ. ລະຫັດຂອງທ່ານໄດ້ລະບຸອົງກອນທີ່ມັນຂຶ້ນກັບແລ້ວ, ແລະ ຄໍາຕອບແມ່ນຖືກຈໍາກັດຂອບເຂດໄວ້ສໍາລັບອົງກອນນັ້ນ.
ລອງໃຊ້ເບິ່ງ
ປ່ຽນແທນທຸກຢ່າງທີ່ຢູ່ໃນວົງເລັບມຸມດ້ວຍຄ່າຂອງທ່ານເອງ, ແລະ ປ່ຽນແທນຕົວແທນບ່ອນວ່າງຄີດ້ວຍຄີຈາກແຜງຄວບຄຸມຂອງທ່ານ.
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.
ພາຣາມິເຕີ
| ຊື່ | ປະເພດ | ຕ້ອງການ | ສິ່ງທີ່ມັນເປັນ |
|---|---|---|---|
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. |
ຖືກໂຈະ
| ຊື່ | ປະເພດ | ຕ້ອງການ | ສິ່ງທີ່ມັນເປັນ |
|---|---|---|---|
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