Skip to main content
GET
/
storage
/
provisioning
/
v3
/
storage
Python
import os
from gcore import Gcore

client = Gcore(
    api_key=os.environ.get("GCORE_API_KEY"),  # This is the default and can be omitted
)
page = client.storage.list()
page = page.results[0]
print(page.id)
{
  "count": 1,
  "results": [
    {
      "address": "s-region-1.cloud.example.com",
      "client_id": 1,
      "created_at": "2025-08-05 09:17:02.095832+00:00",
      "id": 1,
      "location": "s-region-1",
      "name": "1-my-storage-prod",
      "provisioning_status": "ok",
      "reseller_id": 1,
      "type": "s3",
      "can_restore": true,
      "credentials": {
        "keys": [
          {
            "created_at": "2025-08-05 09:15:00+00:00",
            "id": 123,
            "name": "my-production-key"
          }
        ],
        "s3": {
          "access_key": "AKIAIOSFODNN7EXAMPLE",
          "secret_key": "wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY"
        },
        "sftp_password": "Xy9$mN2p!qR8"
      },
      "custom_config_file": false,
      "deleted_at": "2025-08-05 10:30:15.123456+00:00",
      "disable_http": false,
      "expires": "2026-08-05 09:17:02.095832+00:00",
      "rewrite_rules": {},
      "server_alias": "my-storage.example.com"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

API key for authentication. Make sure to include the word apikey, followed by a single space and then your token. Example: apikey 1234$abcdef

Query Parameters

​
order_by
string

Field name to sort by

​
order_direction
enum<string>

Ascending or descending order

Available options:
asc,
desc
​
id
string

Filter by storage ID

​
name
string

Filter by storage name (exact match)

​
location
string

Filter by storage location/region

​
type
enum<string>

Filter by storage type

Available options:
s3,
sftp
​
offset
integer<uint64>

Number of records to skip before beginning to write in response.

Required range: x >= 0
​
limit
integer<uint64>
default:10

Max number of records in response

Required range: 1 <= x <= 1000
​
status
enum<string>

Filter by storage status

Available options:
active,
suspended,
deleted,
pending
​
show_deleted
boolean

Include deleted storages in the response

Response

StorageListEndpointResV3

StorageListEndpointResV3 wraps storages with total count

​
count
integer<int64>
required

Total number of storages matching the filter

Example:

1

​
results
object[]
required

The list of storages