List a site's Varnish versions
Answers the Varnish versions the site's Magento may use, on their own.
GET/ api/ corestack/ sites/ {site}/ varnish/ versions
Path parameters
siteintegerRequired
The id of a site row. A website's production site and each of its environments has its own id. Digits only. At least 1.
Returns
200 The versions.
Fields of the 200 answer
default_versionstring or nullRequired
enabledboolean or nullRequired
optionsarray of objectsRequired
Fields of each item
allowedbooleanRequired
Whether the site may move to it. False for the current version, which it already runs.
currentbooleanRequired
reasonstring or nullRequired
Why it is not allowed; for the current version, that it is the current one.
statusstringRequired
Where the version stands, such as lts, eol or prerelease.
versionstringRequired
versionstring or nullRequired
If it is refused
| Status | Reason | What to do |
|---|---|---|
401 | none | Send a valid token as Authorization: Bearer <token>. |
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 | varnish_not_offered | Varnish is available for Magento 2 sites only. Nothing to change here. |
429 | rate_limited | Wait for the seconds in Retry-After. |
Reasons are listed by name in Errors and refusals.
The same task elsewhere
curl https://manage.corefinity.com/api/corestack/sites/1042/varnish/versions \
-H "Authorization: Bearer $COREFINITY_TOKEN" \
-H "Accept: application/json"use Illuminate\Support\Facades\Http;
$response = Http::withToken(env('COREFINITY_TOKEN'))
->acceptJson()
->get('https://manage.corefinity.com/api/corestack/sites/1042/varnish/versions');
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/corestack/sites/1042/varnish/versions', {
method: 'GET',
headers: {
Authorization: `Bearer ${process.env.COREFINITY_TOKEN}`,
Accept: 'application/json',
},
});
// 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.get(
"https://manage.corefinity.com/api/corestack/sites/1042/varnish/versions",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
)
data = res.json() if res.content else None{
"default_version": "7.7",
"enabled": true,
"options": [
{
"allowed": true,
"current": false,
"reason": null,
"status": "eol",
"version": "8.0"
},
{
"allowed": false,
"current": true,
"reason": "This is the current version",
"status": "eol",
"version": "7.7"
},
{
"allowed": true,
"current": false,
"reason": null,
"status": "lts",
"version": "6.0"
}
],
"version": "7.7"
}{
"message": "Unauthenticated."
}{
"code": "company_unavailable",
"message": "Your company is unavailable.",
"reason": "company_unavailable"
}{
"code": "feature_off",
"message": "Not found.",
"reason": "feature_off"
}{
"code": "varnish_not_offered",
"message": "Varnish is available for Magento 2 sites only.",
"reason": "varnish_not_offered"
}{
"code": "rate_limited",
"message": "Too many requests. Try again in 60 seconds.",
"reason": "rate_limited",
"retry_after_seconds": 60
}Try it
Was this helpful?