Get a CoreCluster's usage
The CPU, memory and disk the CoreCluster's sites used over a time range, in even steps, with how many sites reported in each step and the CoreCluster's allowance.
Path parameters
The id of a CoreCluster. Digits only. At least 1.
Query parameters
The time range to read. Defaults to 24h.
6h24h7d30dReturns
200 The usage series.
Fields of the 200 answer
Fields
The most the row can use.
One point for each step: the time in epoch milliseconds, then the figures for that step. A figure is null where nothing was measured.
The guaranteed amount.
The size of the disk.
Fields
The most the row can use.
One point for each step: the time in epoch milliseconds, then the figures for that step. A figure is null where nothing was measured.
The guaranteed amount.
The size of the disk.
Fields
The most the row can use.
One point for each step: the time in epoch milliseconds, then the figures for that step. A figure is null where nothing was measured.
The guaranteed amount.
The size of the disk.
6h24h7d30dWhat the package allows.
Fields
One point for each step: the time in epoch milliseconds, how many sites reported, and how many sites there are.
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 | none | Check the id. You see only what your account can reach. |
422 | invalid | Fix the field named in field; errors says why. |
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/clusters/1017/usage \
-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/clusters/1017/usage');
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/corestack/clusters/1017/usage', {
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/clusters/1017/usage",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
)
data = res.json() if res.content else None{
"allowance": {
"cpu_millicores": 4000,
"disk_bytes": 214748364800,
"memory_bytes": 17179869184
},
"coverage": [
[
1794045600000,
1,
1
],
[
1794049200000,
1,
1
]
],
"cpu": {
"limit": 2000,
"points": [
[
1794045600000,
172,
410
],
[
1794049200000,
180,
395
]
],
"request": 100,
"unit": "millicores"
},
"disk": {
"points": [
[
1794045600000,
2351746252,
null
],
[
1794049200000,
2362232012,
null
]
],
"size": 10737418240,
"unit": "bytes"
},
"from": "2026-11-07T10:00:00Z",
"last_sample_at": "2026-11-14T09:55:00Z",
"memory": {
"limit": 4294967296,
"points": [
[
1794045600000,
901775360,
955252736
],
[
1794049200000,
912261120,
960495616
]
],
"request": 536870912,
"unit": "bytes"
},
"range": "7d",
"step_seconds": 3600,
"to": "2026-11-14T10:00:00Z"
}{
"message": "Unauthenticated."
}{
"code": "company_unavailable",
"message": "Your company is unavailable.",
"reason": "company_unavailable"
}{
"message": "Not found."
}{
"code": "invalid",
"errors": {
"range": [
"Choose a range of 6h, 24h, 7d or 30d."
]
},
"field": "range",
"message": "Choose a range of 6h, 24h, 7d or 30d.",
"reason": "invalid"
}{
"code": "rate_limited",
"message": "Too many requests. Try again in 60 seconds.",
"reason": "rate_limited",
"retry_after_seconds": 60
}