compute

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

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

Πισtoποίηση

Στείλτε ένα κλειδί API ως διακριτικό φορέα (bearer token). Αυτό το τελικό σημείο δεν ορίζει μια συγκεκριμένη άδεια στην προδιαγραφή, οπότε δώστε στο κλειδί σας τα ελάχιστα δυνατά δικαιώματα και ελέγξτε την απόκριση αντί να κάνετε υποθέσεις.

Αυτό το τελικό σημείο δεν δέχεται αναγνωριστικό οργανισμού. Το κλειδί σας προσδιορίζει ήδη τον οργανισμό στον οποίο ανήκει, και η απάντηση περιορίζεται σε αυτόν.

Δοκιμάστε το

Ατικatastήstε ό,τι βρίskεtai μέσα σe γώniaδeς μe τis δikές sas timές, kai to placeholder klεidioύ μe éna klεidi apó ton pinaka ελέgchou sas.

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

Συνδεθήκατε; Η κονσόλα API στον πίνακα ελέγχου σας συμπληρώνει το πραγματικό αναγνωριστικό του οργανισμού σας και το δικό σας κλειδί, και εκτελεί το αίτημα στο ζωντανό API, ώστε να μπορείτε να δείτε την πραγματική απόκριση. Ανοίξτε αυτό το τελικό σημείο στην κονσόλα API

Παράμετροι

Όνομα	Τύpος	Υποχρεωτικό	Τι είναι
`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.

Απάντηση

Όνομα	Τύpος	Υποχρεωτικό	Τι είναι
`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