CloudRaya Documentation

StorageRaya

StorageRaya is CloudRaya’s S3-compatible object storage service, designed to store and retrieve data as objects rather than files on a disk.

It is built for scalability, durability, and flexible access, making it ideal for applications that need to store large amounts of unstructured data without managing underlying infrastructure.

This page introduces how StorageRaya works, when to use it, and how it fits into your overall architecture.

What Is StorageRaya?

StorageRaya stores data as objects inside buckets.

Each object consists of:

  • The data itself
  • A unique object key (name)
  • Metadata

Unlike VM Storage, StorageRaya:

  • Is not attached to a Virtual Machine
  • Is accessed over the network using APIs
  • Scales independently from compute resources

StorageRaya is compatible with the Amazon S3 API, allowing you to use common tools, SDKs, and workflows.

How StorageRaya Works

At a high level:

  • You create a bucket as a container for objects
  • You upload objects into the bucket
  • Applications or users access objects using:
    • Access keys
    • S3-compatible endpoints
  • Objects are retrieved directly from StorageRaya, not through a VM filesystem

This model removes the need to manage disks, partitions, or mount points.

StorageRaya vs VM Storage

StorageRaya and VM Storage serve different purposes.

AspectStorageRaya (Object Storage)VM Storage
Attachment to VM❌ Noβœ… Yes
Access methodAPI / S3 toolsFilesystem
Best forFiles, media, backupsOS, databases
ScalabilityVery highVM-bound
Use with containersCommonLimited

Use StorageRaya when you do not need filesystem access or low-level disk control.

Common Use Cases

StorageRaya is commonly used for:

  • Media files (images, videos, documents)
  • Static assets for websites or applications
  • Application backups and archives
  • Logs and application output
  • Data shared across multiple services

Because storage is independent from compute, StorageRaya remains available even when Virtual Machines are stopped or deleted.

Access Model and Security

StorageRaya is private by default.

Access is controlled using:

  • Access Key
  • Secret Key
  • S3-compatible endpoints

Applications authenticate directly to StorageRaya without exposing VM credentials.

Note

StorageRaya uses a bucket-scoped, ACL-based access model, not a centralized IAM policy system like public cloud providers.
Understanding this difference is critical when designing enterprise and multi-team architectures.

πŸ“„ See:

Persistence and Lifecycle

StorageRaya data:

  • Persists independently of Virtual Machines
  • Is not affected by VM restarts or deletion
  • Is billed based on storage usage

Buckets and objects must be managed explicitly throughout their lifecycle.

Getting Started with StorageRaya

To start using StorageRaya:

  1. Create a bucket
  2. Configure access credentials
  3. Upload and manage objects
  4. Integrate with applications or tools

Each step is covered in a dedicated guide.

Summary

  • StorageRaya stores data as objects inside buckets
  • It is accessed using APIs, not attached disks
  • It scales independently from compute
  • It is ideal for files, media, backups, and shared data
  • StorageRaya is S3-compatible

StorageRaya is a foundational service for modern, scalable applications built on CloudRaya.

Next Steps

Continue with the following guides to start using StorageRaya effectively:

Β© 2026 CloudRaya Product Team. All rights reserved.

On this page