corecluster_ compute_ family_ switch
Change a CoreCluster's server type.
When to use it
Move every site of a CoreCluster to the Standard or the Performance server type, now or tonight. Each site moves to the new servers in turn; if any site cannot move yet, nothing changes. Price it first with corestack_billing_quote_preview.
Ask for it
Using the Corefinity MCP server, call corecluster_compute_family_switch with cluster_id 812, family general. (Change a CoreCluster's server type.) Tell me what it returned.Inputs
applystring
now (the default) or tonight, in the maintenance window, with everything else queued for the row. window: the row's next maintenance window (tonight is kept as its alias). Defaults to now.
nowwindowtonightcluster_idintegerRequired
At least 1.
confirm_namestringRequiredConfirmation
The CoreCluster's name, typed to confirm. Up to 253 characters.
familystringRequired
general: Standard; optimised: Performance.
generaloptimisedquote_idstring
A quote from corestack_billing_quote_preview (optional): the write refuses with stale if the price moved.
Your assistant fills in a confirmation only after you agree.
Example call
{
"name": "corecluster_compute_family_switch",
"arguments": {
"cluster_id": 812,
"family": "general",
"confirm_name": "Staging"
}
}If it is refused
| Reason | What to do |
|---|---|
platform_cluster | This is a platform cluster, where this setting is not yours to change. |
same_family | The row already uses that server type; nothing to change. |
contract_missing | The billing contract changed while the change was being made; read the options again and call again. (A site or cluster with no billing contract is changed all the same, without a quote: it is not billed in the Control Panel.) |
stale | The quote no longer matches this change or has expired; preview a new one with corestack_billing_quote_preview and call again with its quote_id. |
no_payment_method | The company has no payment method; the person must add one in the Control Panel. |
compute_capacity_blocked | The cluster's servers have no room for this; free capacity or upgrade the cluster first. |
family_change_pending | A server-type change is already pending; wait for it or cancel it. |
restart_batches_off | The maintenance window queue is switched off, so nothing can be queued for tonight; apply now instead. |
family_unavailable | That server type is not available here; choose another. |
feature_off | An input needs a feature that is switched off (for example apply: "tonight" while the maintenance window queue is switched off); leave that input out. |
confirm_mismatch | A typed confirmation does not match (confirm_domain: the site's domain on production, the canonical host elsewhere; confirm_name: the cluster's or environment's name); ask the person for the exact value. |
billing_forbidden | The person has no billing role in the company; ask a company owner or billing member. |
demo_keep_required | The site or cluster is a free demo that is not kept yet, and this change costs money: it starts once the demo is kept. Ask the person to keep it (corestack_demo_keep, or open keep_url); change names this change and what it would cost a month once kept. |
invalid_arguments | The arguments do not match the tool's input schema, or the Control Panel refused a field. Fix the fields named in the answer and call again. |
tenant_mismatch | The object does not exist or the token may not see it. Check the id. |
scope_required | The token lacks a scope this call needs. Open the link in the answer to add it, then call again. |
pin_refused | The grant is limited to chosen clusters, sites or environments, and this call is outside them. Open the link in the answer to widen it. |
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. |
The same task elsewhere
Was this helpful?