Switch a CoreCluster's server type
Moves every site of a CoreCluster between the two server types, general (Standard) and optimised (Performance); the CoreCluster is billed at the new price once the last site has moved. It is all or nothing: when any site cannot move yet, nothing is queued and the refusal's refused lists each such site. A CoreCluster with no billing contract takes the change all the same, unpriced: quote is null.
Path parameters
The id of a CoreCluster. Digits only. At least 1.
Body
When a change that needs a maintenance window is applied. now applies it at once. tonight queues it for the site's next window. window means the same as tonight. An endpoint that takes window only while maintenance windows are on for your company says so, and refuses it 422 on apply otherwise. Defaults to now.
nowtonightwindowThe CoreCluster's name, typed exactly. Up to 253 characters.
The server type to move to. general is Standard and optimised is Performance.
generaloptimisedThe id of a quote from POST /corestack/billing/quote. With it, the change is refused 409 stale when the price is no longer the quote's. Format: uuid.
Returns
201 The moves are queued or started: one entry of items for each site, with its own operation once it has started. settled is true when no site had to move.
Fields of the 201 answer
The sites that are on the server type already.
The CoreCluster, as GET /corestack/clusters/{cluster} answers it.
One entry for each site that moves.
Fields of each item
Always null. Each site's move is its own operation.
Whether no site had to move.
If it is refused
| Status | Reason | What to do |
|---|---|---|
401 | none | Send a valid token as Authorization: Bearer <token>. |
403 | billing_forbidden | Billing is for the organisation's owner and billing contacts. Ask one of them to do this. |
403 | company_unavailable | Your company is unavailable. |
403 | scope_required | Use a token with the scope named in scope. |
403 | two_factor_required | Turn on two-factor on your account, then send again. |
404 | feature_off | This feature is not on for your organisation yet. |
409 | same_family | This is already the server type. Choose a different one. |
422 | confirm_mismatch | Send the confirmation exactly as the field named in field asks for it. |
422 | invalid | Fix the field named in field; errors says why. |
429 | rate_limited | Wait for the seconds in Retry-After. |
503 | temporarily_unavailable | The Control Panel could not answer just now. Nothing was started; try again shortly. |
503 | tier_cluster_missing | The platform has no compute cluster for this here yet. Contact support. |
Reasons are listed by name in Errors and refusals.
The same task elsewhere
curl -X POST https://manage.corefinity.com/api/corestack/clusters/1017/compute-family \
-H "Authorization: Bearer $COREFINITY_TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"confirm_name": "Northwind UK 1",
"family": "optimised"
}'use Illuminate\Support\Facades\Http;
$response = Http::withToken(env('COREFINITY_TOKEN'))
->acceptJson()
->post('https://manage.corefinity.com/api/corestack/clusters/1017/compute-family', [
'confirm_name' => 'Northwind UK 1',
'family' => 'optimised',
]);
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/corestack/clusters/1017/compute-family', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.COREFINITY_TOKEN}`,
Accept: 'application/json',
'Content-Type': 'application/json',
},
body: JSON.stringify({
confirm_name: 'Northwind UK 1',
family: 'optimised',
}),
});
// An answer with no body (204) has nothing to parse.
const text = await res.text();
const data = text && JSON.parse(text);import os
import requests
res = requests.post(
"https://manage.corefinity.com/api/corestack/clusters/1017/compute-family",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
json={
"confirm_name": "Northwind UK 1",
"family": "optimised",
},
)
data = res.json() if res.content else None{
"already": [],
"cluster": {},
"items": [],
"operation": null,
"pending": null,
"queued": false,
"quote": null,
"settled": true
}{
"message": "Unauthenticated."
}{
"code": "billing_forbidden",
"message": "Billing is available to your company's owner and billing contacts.",
"reason": "billing_forbidden"
}{
"code": "feature_off",
"message": "Not found.",
"reason": "feature_off"
}{
"code": "same_family",
"message": "This is already the server type",
"reason": "same_family"
}{
"code": "confirm_mismatch",
"errors": {
"confirm_name": [
"Type the cluster's name to confirm"
]
},
"field": "confirm_name",
"message": "Type the cluster's name to confirm",
"reason": "confirm_mismatch"
}{
"code": "rate_limited",
"message": "Too many requests. Try again in 60 seconds.",
"reason": "rate_limited",
"retry_after_seconds": 60
}{
"code": "temporarily_unavailable",
"message": "This region is not ready",
"reason": "temporarily_unavailable"
}Try it is off for this endpointIt can add to your bill. Copy the request and run it yourself when you are sure.