compute

POST `/v1/compute/servers/{serverId}/resize/quote`

Get what resizing a server would cost, before the charge.

Πισtoποίηση

Στείλτε ένα κλειδί API ως διακριτικό φορέα (bearer token). Το κλειδί πρέπει να διαθέτει το δικαίωμα sites.view· ένα κλειδί που δεν το διαθέτει απορρίπτεται με 403, όχι 404.

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

Δοκιμάστε το

Ατικ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 POST https://api.zinndigital.com/v1/compute/servers/{serverId}/resize/quote \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{  }'

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

Λεπτομέρειες

The provider's own figure for moving this machine to another size. A POST that changes nothing, deliberately: the size being quoted is a body field, and a quote is not a cacheable representation of a resource. ⛔ Showing it is not optional — an upgrade charged at an unstated amount is a refund request (§2.8). ⛔ amount is the provider's own string, unparsed, and it carries no currency field. Inventing one to fit a money type would put a number in front of a customer in the wrong currency, so a client renders it exactly as the provider stated it and labels it as the provider's estimate. 404 for a server that is not the caller's; 422 for a size the provider does not offer or a machine that is not in an operable state. Requires sites.view — reading a price commits to nothing.

Παράμετροι

Όνομα	Τύ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.

Σώμα αίτησης

Όνομα	Τύpος	Υποχρεωτικό	Τι είναι
`spec`	`string`	Όχι	The target size, as `getComputeCatalogue` reported it.
`plan_code`	`string`	Όχι	The plan to move to, as `getComputeCatalogue`'s `tiers[].plan_code`.

Απάντηση

Όνομα	Τύpος	Υποχρεωτικό	Τι είναι
`spec`	`string`	Ναι	The size the figure is for.
`plan_code`	`string`	Ναι	The plan quoted, on an own-account range. `""` on the resold range.
`price_minor`	`integer`	Ναι	⛔ D24975 (W43-48). OUR price for the plan, in minor units, in the machine's own data centre at its own cadence. On an own-account range this is the only figure; `amount` and…
`currency`	`string`	Ναι	ISO currency of `price_minor`, or `""`.
`interval`	`string`	Ναι	`monthly` or `annual` — the machine's billing cadence — or `""`.
`amount`	`string`	Ναι	The provider's figure, verbatim. Rendered as the provider stated it and labelled as the provider's estimate, never reformatted.
`detail`	`string`	Ναι	Whatever else the provider said about the change, or `""`. Blank is common and is not an error.

Σφάλματα που μπορεί να επιστρέψει αυτό το τελικό σημείο

401 · 403 · 404 · 422 · 429 · 503

POST /v1/compute/servers/{serverId}/resize/quote