import os
from gcore import Gcore
client = Gcore(
api_key=os.environ.get("GCORE_API_KEY"), # This is the default and can be omitted
)
response = client.storage.statistics.get_usage_series()
print(response.data)package main
import (
"context"
"fmt"
"github.com/G-Core/gcore-go"
"github.com/G-Core/gcore-go/option"
"github.com/G-Core/gcore-go/storage"
)
func main() {
client := gcore.NewClient(
option.WithAPIKey("My API Key"),
)
response, err := client.Storage.Statistics.GetUsageSeries(context.TODO(), storage.StatisticGetUsageSeriesParams{})
if err != nil {
panic(err.Error())
}
fmt.Printf("%+v\n", response.Data)
}
curl --request POST \
--url https://api.gcore.com/storage/stats/v1/storage/usage/series \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"from": "2006-01-02",
"granularity": "12h",
"locations": [
"s-region-1",
"s-region-2"
],
"source": 123,
"storage_ids": [
12345
],
"storages": [
"123-myStorage"
],
"to": "2006-01-02",
"ts_string": true
}
'const options = {
method: 'POST',
headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
from: '2006-01-02',
granularity: '12h',
locations: ['s-region-1', 's-region-2'],
source: 123,
storage_ids: [12345],
storages: ['123-myStorage'],
to: '2006-01-02',
ts_string: true
})
};
fetch('https://api.gcore.com/storage/stats/v1/storage/usage/series', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.gcore.com/storage/stats/v1/storage/usage/series",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'from' => '2006-01-02',
'granularity' => '12h',
'locations' => [
's-region-1',
's-region-2'
],
'source' => 123,
'storage_ids' => [
12345
],
'storages' => [
'123-myStorage'
],
'to' => '2006-01-02',
'ts_string' => true
]),
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}HttpResponse<String> response = Unirest.post("https://api.gcore.com/storage/stats/v1/storage/usage/series")
.header("Authorization", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"from\": \"2006-01-02\",\n \"granularity\": \"12h\",\n \"locations\": [\n \"s-region-1\",\n \"s-region-2\"\n ],\n \"source\": 123,\n \"storage_ids\": [\n 12345\n ],\n \"storages\": [\n \"123-myStorage\"\n ],\n \"to\": \"2006-01-02\",\n \"ts_string\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.gcore.com/storage/stats/v1/storage/usage/series")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"from\": \"2006-01-02\",\n \"granularity\": \"12h\",\n \"locations\": [\n \"s-region-1\",\n \"s-region-2\"\n ],\n \"source\": 123,\n \"storage_ids\": [\n 12345\n ],\n \"storages\": [\n \"123-myStorage\"\n ],\n \"to\": \"2006-01-02\",\n \"ts_string\": true\n}"
response = http.request(request)
puts response.read_body{
"data": {
"clients": {}
}
}{
"detail": "<string>",
"error": "<string>",
"request_id": "8f1c9a2e4d6b4f0e9a1b3c5d7e9f0a1b",
"status": 123,
"title": "<string>",
"type": "validation-error",
"context": {
"allowed_methods": [
"<string>"
],
"blocking_count": 123,
"blocking_resources": [
{
"resource_id": "123",
"resource_name": "my-storage",
"resource_type": "object_storages"
}
],
"client_id": 123,
"operation": "<string>",
"project_id": 123,
"quotas": [
{
"available": 123,
"limit": 123,
"name": "access_keys",
"overflow": 123,
"region_id": 123,
"requested": 123,
"resulting_usage": 123,
"scope": "<string>",
"unit": "<string>",
"usage": 123
}
],
"reason": "region",
"region_id": 123,
"resource_id": "123",
"resource_status": "<string>",
"resource_type": "object_storages",
"retry_after": 123
},
"errors": [
{
"code": "missing",
"ctx": {},
"detail": "<string>",
"loc": [
"body",
"name"
]
}
],
"hint": "<string>",
"trace_id": "4bf92f3577b34da6a3ce929d0e0e4736"
}{
"detail": "<string>",
"error": "<string>",
"request_id": "8f1c9a2e4d6b4f0e9a1b3c5d7e9f0a1b",
"status": 123,
"title": "<string>",
"type": "validation-error",
"context": {
"allowed_methods": [
"<string>"
],
"blocking_count": 123,
"blocking_resources": [
{
"resource_id": "123",
"resource_name": "my-storage",
"resource_type": "object_storages"
}
],
"client_id": 123,
"operation": "<string>",
"project_id": 123,
"quotas": [
{
"available": 123,
"limit": 123,
"name": "access_keys",
"overflow": 123,
"region_id": 123,
"requested": 123,
"resulting_usage": 123,
"scope": "<string>",
"unit": "<string>",
"usage": 123
}
],
"reason": "region",
"region_id": 123,
"resource_id": "123",
"resource_status": "<string>",
"resource_type": "object_storages",
"retry_after": 123
},
"errors": [
{
"code": "missing",
"ctx": {},
"detail": "<string>",
"loc": [
"body",
"name"
]
}
],
"hint": "<string>",
"trace_id": "4bf92f3577b34da6a3ce929d0e0e4736"
}Storage usage series
Consumption statistics is updated in near real-time as a standard practice. However, the frequency of updates can vary, but they are typically available within a 60 minutes period. Exceptions, such as maintenance periods, may delay data beyond 60 minutes until servers resume and backfill missing statistics.
Shows storage usage data in series format filtered by clients, storages and interval.
import os
from gcore import Gcore
client = Gcore(
api_key=os.environ.get("GCORE_API_KEY"), # This is the default and can be omitted
)
response = client.storage.statistics.get_usage_series()
print(response.data)package main
import (
"context"
"fmt"
"github.com/G-Core/gcore-go"
"github.com/G-Core/gcore-go/option"
"github.com/G-Core/gcore-go/storage"
)
func main() {
client := gcore.NewClient(
option.WithAPIKey("My API Key"),
)
response, err := client.Storage.Statistics.GetUsageSeries(context.TODO(), storage.StatisticGetUsageSeriesParams{})
if err != nil {
panic(err.Error())
}
fmt.Printf("%+v\n", response.Data)
}
curl --request POST \
--url https://api.gcore.com/storage/stats/v1/storage/usage/series \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"from": "2006-01-02",
"granularity": "12h",
"locations": [
"s-region-1",
"s-region-2"
],
"source": 123,
"storage_ids": [
12345
],
"storages": [
"123-myStorage"
],
"to": "2006-01-02",
"ts_string": true
}
'const options = {
method: 'POST',
headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
from: '2006-01-02',
granularity: '12h',
locations: ['s-region-1', 's-region-2'],
source: 123,
storage_ids: [12345],
storages: ['123-myStorage'],
to: '2006-01-02',
ts_string: true
})
};
fetch('https://api.gcore.com/storage/stats/v1/storage/usage/series', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.gcore.com/storage/stats/v1/storage/usage/series",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'from' => '2006-01-02',
'granularity' => '12h',
'locations' => [
's-region-1',
's-region-2'
],
'source' => 123,
'storage_ids' => [
12345
],
'storages' => [
'123-myStorage'
],
'to' => '2006-01-02',
'ts_string' => true
]),
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}HttpResponse<String> response = Unirest.post("https://api.gcore.com/storage/stats/v1/storage/usage/series")
.header("Authorization", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"from\": \"2006-01-02\",\n \"granularity\": \"12h\",\n \"locations\": [\n \"s-region-1\",\n \"s-region-2\"\n ],\n \"source\": 123,\n \"storage_ids\": [\n 12345\n ],\n \"storages\": [\n \"123-myStorage\"\n ],\n \"to\": \"2006-01-02\",\n \"ts_string\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.gcore.com/storage/stats/v1/storage/usage/series")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"from\": \"2006-01-02\",\n \"granularity\": \"12h\",\n \"locations\": [\n \"s-region-1\",\n \"s-region-2\"\n ],\n \"source\": 123,\n \"storage_ids\": [\n 12345\n ],\n \"storages\": [\n \"123-myStorage\"\n ],\n \"to\": \"2006-01-02\",\n \"ts_string\": true\n}"
response = http.request(request)
puts response.read_body{
"data": {
"clients": {}
}
}{
"detail": "<string>",
"error": "<string>",
"request_id": "8f1c9a2e4d6b4f0e9a1b3c5d7e9f0a1b",
"status": 123,
"title": "<string>",
"type": "validation-error",
"context": {
"allowed_methods": [
"<string>"
],
"blocking_count": 123,
"blocking_resources": [
{
"resource_id": "123",
"resource_name": "my-storage",
"resource_type": "object_storages"
}
],
"client_id": 123,
"operation": "<string>",
"project_id": 123,
"quotas": [
{
"available": 123,
"limit": 123,
"name": "access_keys",
"overflow": 123,
"region_id": 123,
"requested": 123,
"resulting_usage": 123,
"scope": "<string>",
"unit": "<string>",
"usage": 123
}
],
"reason": "region",
"region_id": 123,
"resource_id": "123",
"resource_status": "<string>",
"resource_type": "object_storages",
"retry_after": 123
},
"errors": [
{
"code": "missing",
"ctx": {},
"detail": "<string>",
"loc": [
"body",
"name"
]
}
],
"hint": "<string>",
"trace_id": "4bf92f3577b34da6a3ce929d0e0e4736"
}{
"detail": "<string>",
"error": "<string>",
"request_id": "8f1c9a2e4d6b4f0e9a1b3c5d7e9f0a1b",
"status": 123,
"title": "<string>",
"type": "validation-error",
"context": {
"allowed_methods": [
"<string>"
],
"blocking_count": 123,
"blocking_resources": [
{
"resource_id": "123",
"resource_name": "my-storage",
"resource_type": "object_storages"
}
],
"client_id": 123,
"operation": "<string>",
"project_id": 123,
"quotas": [
{
"available": 123,
"limit": 123,
"name": "access_keys",
"overflow": 123,
"region_id": 123,
"requested": 123,
"resulting_usage": 123,
"scope": "<string>",
"unit": "<string>",
"usage": 123
}
],
"reason": "region",
"region_id": 123,
"resource_id": "123",
"resource_status": "<string>",
"resource_type": "object_storages",
"retry_after": 123
},
"errors": [
{
"code": "missing",
"ctx": {},
"detail": "<string>",
"loc": [
"body",
"name"
]
}
],
"hint": "<string>",
"trace_id": "4bf92f3577b34da6a3ce929d0e0e4736"
}Authorizations
Headers
Body
a StorageIDs list of filter, by ID. Each ID selects exactly that storage, deleted ones included, narrowed by locations. An ID that is not one of the client's storages fails the request with 404. Omit it, or send null, when not selecting by ID; an empty list fails the request with 400. Mutually exclusive with storages.
1 - 100 elements[12345]
a Storages list of filter, by name.
A name selects the client's live storages with that name; a deleted storage is reachable by storage_ids only.
Omit both storages and storage_ids, or send storages as [], to select the whole account.
Mutually exclusive with storage_ids.
["123-myStorage"]
Was this page helpful?