compute

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

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

Toute la documentation pour développeurs →

Authentification

Envoyez une clé API en tant que jeton du porteur. La clé doit posséder l'autorisation sites.view ; une clé qui ne l'a pas est refusée avec le code 403, et non 404.

Cet endpoint ne prend aucun identifiant d'organisation. Votre clé identifie déjà l'organisation à laquelle elle appartient, et la réponse y est limitée.

Essayer

Remplacez tout ce qui se trouve entre crochets par vos propres valeurs, et le espace réservé à la clé par une clé de votre tableau de bord.

curl -X POST https://api.zinndigital.com/v1/compute/servers/{serverId}/resize/quote \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{  }'

Connecté ? La console d'API de votre tableau de bord saisit votre véritable ID d'organisation ainsi que votre propre clé, et exécute la requête sur l'API de production afin que vous puissiez voir la réponse réelle. Ouvrir ce point de terminaison dans la console API

Détails

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.

Paramètres

Nom	Type	Obligatoire	Qu'est-ce que c'est
`serverId (path)`	`Uuid`	Oui	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.

Corps de la requête

Nom	Type	Obligatoire	Qu'est-ce que c'est
`spec`	`string`	Non	The target size, as `getComputeCatalogue` reported it.
`plan_code`	`string`	Non	The plan to move to, as `getComputeCatalogue`'s `tiers[].plan_code`.

Réponse

Nom	Type	Obligatoire	Qu'est-ce que c'est
`spec`	`string`	Oui	The size the figure is for.
`plan_code`	`string`	Oui	The plan quoted, on an own-account range. `""` on the resold range.
`price_minor`	`integer`	Oui	⛔ 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`	Oui	ISO currency of `price_minor`, or `""`.
`interval`	`string`	Oui	`monthly` or `annual` — the machine's billing cadence — or `""`.
`amount`	`string`	Oui	The provider's figure, verbatim. Rendered as the provider stated it and labelled as the provider's estimate, never reformatted.
`detail`	`string`	Oui	Whatever else the provider said about the change, or `""`. Blank is common and is not an error.

Erreurs que cet point de terminaison peut renvoyer

401 · 403 · 404 · 422 · 429 · 503

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