compute

GET `/v1/compute/servers/{serverId}/usage`

One server's metered hours, charges and ledger check for a month.

احراز هویت

یک کلید API را به عنوان یک توکن برbearer ارسال کنید. این نقطه پایانی مجوز خاصی را در مشخصات خود ذکر نمی‌کند، بنابراین به جای فرض کردن، حداقل نیازهای کلید خود را بدهید و پاسخ را بررسی کنید.

این نقطه پایانی هیچ شناسه سازمانی را دریافت نمی‌کند. کلید شما در حال حاضر سازمان مربوطه را مشخص می‌کند و پاسخ در همان محدوده ارائه می‌شود.

امتحان کنید

هر چیزی را که داخل براکت‌های زاویه‌دار قرار دارد با مقادیر خودتان جایگزین کنید، و نگهدارنده کلید را با کلیدی از داشبورد خود جایگزین نمایید.

curl -X GET https://api.zinndigital.com/v1/compute/servers/{serverId}/usage \
  -H "Authorization: Bearer zdk_live_…"

وارد شده‌اید؟ کنسول API در داشبورد شما شناسه سازمان واقعی و کلید خودتان را پر می‌کند و درخواست را روی API زنده اجرا می‌کند تا بتوانید پاسخ واقعی را ببینید. این نقطه پایانی را در کنسول API باز کنید

پارامترها

نام	نوع	الزامی	چیست
`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.
`period (query)`	`string`	خیر	The month, `YYYY-MM` (UTC). Defaults to the current month.

پاسخ

نام	نوع	الزامی	چیست
`period`	`string`	بله	—
`hours`	`integer`	بله	Started hours rated in the month.
`rated_minor`	`integer`	بله	Whole minor units rated. A sub-unit remainder is carried, never rounded up.
`settled_minor`	`integer`	بله	Net of tax
`unsettled_minor`	`integer`	بله	Rated and not yet paid.
`currency`	`string`	بله	—
`settlements`	`ComputeUsageSettlement[]`	بله	—
`reconciles`	`boolean`	بله	Whether hours, settlements, their orders and the balance draws all agree. It is computed from four independently written records, never a figure against itself.
`discrepancies`	`string[]`	بله	Every disagreement found, in words. Empty when `reconciles` is true.

خطاهایی که این نقطه پایانی می‌تواند برگرداند

401 · 403 · 404 · 422 · 429