List storages

curl --request GET \
  --url https://api.gcore.com/storage/provisioning/v1/storage \
  --header 'Authorization: <api-key>'

{
  "data": [
    {
      "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"
    }
  ],
  "meta": {
    "ToMeta": {}
  }
}

GET

storage

provisioning

storage

List storages

curl --request GET \
  --url https://api.gcore.com/storage/provisioning/v1/storage \
  --header 'Authorization: <api-key>'

{
  "data": [
    {
      "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"
    }
  ],
  "meta": {
    "ToMeta": {}
  }
}

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

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

order_by

string

Field name to sort by

order_direction

enum<string>

Ascending or descending order

Available options:

asc,

desc

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

status

enum<string>

Filter by storage status

Available options:

active,

suspended,

deleted,

pending

show_deleted

boolean

Include deleted storages in the response

Response

StorageListEndpointRes

data

object[]

Show child attributes

data.address

string

required

Full hostname/address for accessing the storage endpoint

Example:

"s-region-1.cloud.example.com"

data.client_id

integer<int64>

required

Client identifier who owns this storage

Example:

1

data.created_at

string

required

ISO 8601 timestamp when the storage was created

Example:

"2025-08-05 09:17:02.095832+00:00"

data.id

integer<int64>

required

Unique identifier for the storage instance

Example:

1

data.location

string

required

Geographic location code where the storage is provisioned

Example:

"s-region-1"

data.name

string

required

User-defined name for the storage instance

Example:

"1-my-storage-prod"

data.provisioning_status

enum<string>

required

Current provisioning status of the storage instance

Available options:

creating,

ok,

updating,

deleting,

deleted

Example:

"ok"

data.reseller_id

integer<int64>

required

Reseller technical client ID associated with the client

Example:

1

data.type

enum<string>

required

Storage protocol type - either S3-compatible object storage or SFTP file transfer

Available options:

sftp,

s3

Example:

"s3"

data.can_restore

boolean

Whether this storage can be restored if deleted (S3 storages only, within 2 weeks)

Example:

true

data.credentials

object

Show child attributes

data.credentials.keys

object[]

SSH public keys associated with SFTP storage for passwordless authentication

Show child attributes

data.credentials.keys.created_at

string

ISO 8601 timestamp when the SSH key was created

Example:

"2025-08-05 09:15:00+00:00"

data.credentials.keys.id

integer<int64>

Unique identifier for the SSH key

Example:

123

data.credentials.keys.name

string

User-defined name for the SSH key

Example:

"my-production-key"

data.credentials.s3

object

Show child attributes

data.credentials.s3.access_key

string

S3-compatible access key identifier for authentication

Example:

"AKIAIOSFODNN7EXAMPLE"

data.credentials.s3.secret_key

string

S3-compatible secret key for authentication (keep secure)

Example:

"wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY"

data.credentials.sftp_password

string

Generated or user-provided password for SFTP access (only present for SFTP storage type)

Example:

"Xy9$mN2p!qR8"

data.custom_config_file

boolean

Whether custom configuration file is used for this storage

Example:

false

data.deleted_at

string

ISO 8601 timestamp when the storage was deleted (only present for deleted storages)

Example:

"2025-08-05 10:30:15.123456+00:00"

data.disable_http

boolean

Whether HTTP access is disabled for this storage (HTTPS only)

Example:

false

data.expires

string

ISO 8601 timestamp when the storage will expire (if set)

Example:

"2026-08-05 09:17:02.095832+00:00"

data.rewrite_rules

object

Custom URL rewrite rules for the storage (admin-configurable)

Show child attributes

data.rewrite_rules.{key}

string

data.server_alias

string

Custom domain alias for accessing the storage

Example:

"my-storage.example.com"

Overview

IAM

CDN

Managed DNS

Cloud

DDoS Protection

FastEdge

WAAP

Streaming

Object Storage

Resellers

List storages

Authorizations

Query Parameters

Response