v32

latestOpenAPI 3.1.0raw.githubusercontent.com2026-05-151,1412,2144.5 MB
S3-Compatible Storage

Create S3-compatible storage

Creates a new S3-compatible storage instance in the specified location and returns the storage details including credentials.

post/storage/v4/object_storages

Request body

location_namestring required

Location code where the storage should be created

namestring required

User-defined name for the storage instance

Example request

{
  "location_name": "s-region-1",
  "name": "my-storage-prod"
}

Response

S3StorageResV4

addressstring required

Full hostname/address for accessing the storage endpoint

created_atstring date-time required

ISO 8601 timestamp when the storage was created

full_namestring required

Read-only internal full name of the storage, composed as "{client_id}-{name}". Used internally by the backend. Clients should continue to identify the storage by name.

idinteger required

Unique identifier for the storage instance

location_namestring required

Geographic location code where the storage is provisioned

namestring required

User-defined name for the storage instance, as supplied at creation time.

provisioning_status'creating' | 'active' | 'updating' | 'deleting' | 'deleted' required

Lifecycle status of the storage. Use this to check readiness before operations.

Example response

{
  "access_keys": [
    {
      "access_key": "AKIAIOSFODNN7EXAMPLE",
      "secret_key": "wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY"
    }
  ],
  "address": "luxembourg-2.storage.example.com",
  "created_at": "2025-08-05T09:17:02Z",
  "full_name": "696-my-storage-prod",
  "id": 1,
  "location_name": "luxembourg-2",
  "name": "my-storage-prod",
  "provisioning_status": "active"
}