FugokuFugoku Docs
Mask

Object Storage

S3-compatible object storage for unstructured data, backups, and static assets

Object Storage

Fugoku Object Storage provides S3-compatible object storage for unstructured data, backups, static assets, and large-scale data lakes. It is accessed through the Fugoku API and works with any S3-compatible client.

Overview

Key features:

  • S3-compatible API — works with AWS SDKs, rclone, s3cmd, and any S3 client
  • High performance — Wasabi (standard) and VAST (high-performance) backends
  • Versioning — keep multiple versions of objects
  • Object lock — GOVERNANCE and COMPLIANCE modes for WORM protection
  • Scoped access keys — per-bucket access control
  • No egress fees — free outbound traffic

Buckets

Buckets are the top-level containers for objects. Each bucket is associated with a provider and region.

List Buckets

GET /v1/storage/object-storage/buckets?providerId=:providerId

Query parameters:

ParameterTypeRequiredDescription
providerIdstringYesProvider ID to list buckets from

Example:

curl "https://api.fugoku.com/v1/storage/object-storage/buckets?providerId=prov-lagos" \
  -H "Authorization: Bearer $TOKEN"

Create Bucket

POST /v1/storage/object-storage/buckets?providerId=:providerId

Request body:

{
  "name": "my-assets",
  "region": "lagos-1"
}

Example:

curl -X POST "https://api.fugoku.com/v1/storage/object-storage/buckets?providerId=prov-lagos" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "my-assets",
    "region": "lagos-1"
  }'

S3 Clients

You can use any S3-compatible client with Fugoku Object Storage. Configure your client with:

  • Endpoint: https://s3.fugoku.com (or provider-specific endpoint)
  • Access key: Your Fugoku API key or provider access key
  • Secret key: Your Fugoku API secret or provider secret
  • Region: The region where your bucket was created

AWS CLI

aws s3 ls s3://my-assets \
  --endpoint-url https://s3.fugoku.com

rclone

rclone config create fugoku s3 \
  --endpoint https://s3.fugoku.com \
  --access-key-id $ACCESS_KEY \
  --secret-access-key $SECRET_KEY

Use Cases

  • Static assets — host images, videos, and files for web applications
  • Backups — store database dumps and server backups
  • Data lakes — store large datasets for analytics and ML training
  • Logs — archive application and infrastructure logs

Limits

  • Bucket names: 3-63 characters, lowercase letters, numbers, and hyphens
  • Object size: Up to 5 TB per object
  • Bucket limit: 100 buckets per project (contact support to increase)

On this page