Skip to main content
Unlisted page
This page is unlisted. Search engines will not index it, and only users having a direct link can access it.

Object Storage (Beta)

draft

Doc in development.

Hyperstack Object Storage provides scalable, S3-compatible storage designed for workloads that require reliable, cost-efficient, and flexible data access—such as AI/ML datasets, logs, media, and backup files. This guide covers the key concepts and functionality of Hyperstack Object Storage, including how to generate access credentials, interact with storage using S3-compatible tools, manage storage buckets, and understand relevant security considerations.

For complete documentation on Hyperstack's Object Storage APIs, see the Object Storage API Reference.

In this article​

Overview​

Hyperstack Object Storage is built on Amazon S3-compatible technology, offering a scalable, secure, and API-compliant solution for large-scale data handling.

This storage option is suitable for workloads that include backups, long-term archives, AI/ML datasets, and media delivery. It is optimized for redundancy, availability, and cost-efficiency.

Key Benefits​

  • Redundancy and Resilience: Data is stored with built-in redundancy, ensuring durability and availability even in the event of hardware failures.
  • Cost Optimization: Designed for high-volume storage with an efficient pay-as-you-go pricing model.
  • S3 Compatibility: Supports standard S3 API operations via access keys, making it easy to integrate with existing tools and SDKs.
  • Optimized for Unstructured Data: Object storage is designed for storing large-scale unstructured data such as media, logs, and datasets.
  • Efficient Metadata Handling: Each object can include custom metadata, making it easier to manage, categorize, and retrieve content at scale.

What is an Access Key?​

Access keys are credentials used to authenticate programmatic access to Object Storage. Each access key consists of:

  • Access Key ID (public identifier)
  • Secret Access Key (used to sign requests; shown once at creation)

These are required for interacting with Object Storage via CLI or SDKs.

Region Availability

Object storage is currently available only in the CANADA-1 region.

What is a Bucket?​

Buckets are the top-level containers where your data is stored in Object Storage. Each bucket can store an unlimited number of objects and includes configuration options like region, access level, and lifecycle settings.

Getting Started with Hyperstack Object Storage​

Follow these steps to set up access and create your first bucket:

  1. Generate Access Key Credentials

    • Log in to the Hyperstack Console
    • Navigate to Object Storage > Access Keys
    • Click the Generate Access Key button, select the region where the key will be created, and click Generate
    • Copy and securely store your Access Key ID and Secret Access Key (shown only once)
    Secret Access Key Visibility

    Once you dismiss the key display, the secret access key cannot be recovered.

  2. Connect via S3 Compatible Client

    To connect to Object Storage using a compatible tool such as AWS CLI, MinIO Client (mc), or SDKs like boto3, you’ll need to configure your tool using the credentials and endpoint provided.

    Hyperstack S3 endpoint: https://no1-dev.s3.nexgencloud.io

    a. Example configuration with AWS CLI:

    aws configure

    b. Enter your access credentials and configuration details when prompted:

    • AWS Access Key ID: (paste from Hyperstack)
    • AWS Secret Access Key: (paste from Hyperstack)
    • Default region name: us-east-1 (used for S3 client compatibility and not related to your Hyperstack deployment region)
    • Default output format: (press Enter to skip)

    c. Verify the configuration:

    aws s3 ls --endpoint-url https://no1-dev.s3.nexgencloud.io

    This confirms your access key is working and that your CLI can communicate with the Object Storage service.

  3. Create a Bucket

    a. Run the following command to create your first bucket. Replace <your-bucket-name> with a globally unique name of your choosing:

    aws s3api create-bucket \
      --bucket <your-bucket-name> \
      --endpoint-url https://no1-dev.s3.nexgencloud.io \
      --region us-east-1

    b. Verify the bucket was created:

    aws s3 ls --endpoint-url https://no1-dev.s3.nexgencloud.io

    Example output of successful bucket creation:

    2025-05-27 06:51:09 your-bucket-name

    You should see your new bucket listed. It will also appear in the Hyperstack Console > Object Storage > Buckets.

    Next Steps

    You're now ready to begin using Hyperstack Object Storage. To learn how to upload data to your new bucket, refer to the Amazon S3 - Uploading Objects guide.

Manage Access Keys and Buckets​

View and Manage Access Keys​

  • In Hyperstack, navigate to Object Storage > Access Keys
  • View all keys associated with your account, including:
    • Access Key ID
    • Region
    • Date of creation
Access Key Visibility

Organization owners will see all access keys while members will only see the keys they created.

Delete Access Keys​

  1. Click the ⋮ menu next to the key
  2. Confirm deletion by entering the key name
Access Key Deletion

Deleting an access key will immediately disable all access using that key.

View and Manage Buckets​

  1. In Hyperstack, navigate to Object Storage > Buckets
  2. View list of existing buckets and their basic info including:
    • Name
    • Creation date
    • Region
    • Storage size
    • Number of objects
  3. Click on the name of a bucket or hover over the ⋮ menu and click More Details to see:
    • Creation date – the exact timestamp when the bucket was created.
    • Region – the Hyperstack region (e.g., CANADA-1) where the bucket is hosted.
    • Per hour running cost – current hourly cost for storing objects in the bucket, calculated based on storage size used.
    • Number of objects – total count of objects stored in the bucket.
    • Total Storage Used – cumulative storage consumption in human-readable units.
    • Endpoint – the unique S3-compatible URL to access the bucket (e.g., https://no1-dev.s3.nexgencloud.io/<bucket-name>).

Delete a Bucket​

  1. From the bucket list or detail page, click the ⋮ next to the bucket
  2. Click Delete, confirm via dialog
  3. A deletion confirmation email will be sent
Deletion Warning

Bucket deletions are permanent. Ensure all necessary data is backed up before deleting.