corestack_ order_ link_ preview
Preview an order link.
When to use it
Check a package, upgrades, region, currency, server type and billing period, price them as the order does, and return the order page link that opens with them chosen. Use it before sending somebody to /order, so the link opens with exactly what you priced.
Nothing is created, saved or charged. Every price is the catalogue's, worked out on the server: the link carries no price, and a price or total in it would be ignored.
Ask for it
Using the Corefinity MCP server, call corestack_order_link_preview with package CC8, region nl, currency EUR, compute_family optimised, addons {"cores":2,"memory_gb":8,"disk_gb":50}. (Preview an order link.) Tell me what it returned.Inputs
Extra resources on top of the package, within the package's steps and ceilings (the answer's addon_steps).
Fields
Extra CPU cores. At least 0.
Extra disk in GB. At least 0.
Extra memory in GB. At least 0.
monthly or annual; default monthly. What annual means, and when it is honoured, is decided by the order page.
monthlyannualgeneral: Standard; optimised: Performance. Default general. Performance is refused with the order's own sentence where the region does not offer it: Performance servers are not available in the <region> region right now.
generaloptimisedThe currency the order page shows. A currency one product line has no price in is refused.
GBPUSDEURA package code the order sells, for example CS4 or CC8. Up to 16 characters.
A CoreStack platform key, for example wordpress or magento2; required for a CoreStack package, refused for a CoreCluster one. Up to 32 characters.
The region the order page opens on. It must be a region the package's product line can be ordered in.
ukusnlausExample call
{
"name": "corestack_order_link_preview",
"arguments": {
"package": "CC8",
"region": "nl",
"currency": "EUR",
"compute_family": "optimised",
"addons": { "cores": 2, "memory_gb": 8, "disk_gb": 50 }
}
}If it is refused
| Reason | What to do |
|---|---|
invalid_arguments | One of the values is not one the order would take; the errors name the field in the order page's own words ("Add up to 16 extra cores", "Prices in EUR are not available right now", "Choose a package", …). Correct it and try again. |
scope_required | The token lacks a scope this call needs. Open the link in the answer to add it, then call again. |
rate_limited | Too many calls. Wait for the number of seconds the answer names. |
temporarily_unavailable | The Control Panel could not answer just now. Nothing was started; try again shortly. |
internal_error | Something went wrong on our side. Quote the trace id to support. |