Tovanix
Tovanix

Using object storage

This guide covers activating and using Tovanix object storage:

  • S3-compatible, with no extra charge for egress traffic; subscribed per account, the monthly fee includes a certain amount of storage and requests, and anything beyond is settled daily from your balance.
  • When creating a bucket you choose its location and storage class, and the system adds a prefix to the bucket name to keep it globally unique.
  • Each bucket can have several read-only or read-write access keys; the Secret is shown only once, and new keys take a while to sync.
  • The console lets you upload and download, uploads large files in parts automatically, and sets up public access, CORS, lifecycle, migration and lock.
  • From the day it expires, storage becomes read-only and issued keys are revoked; if it is still not renewed 7 days after expiry, the data is emptied and deleted.

What it is and how it is billed

Object storage is S3-compatible: each bucket gets its own access keys, existing S3 SDKs and tools connect directly, and egress traffic is not charged extra. Under Cloud Services → Buckets, choose a term (1, 3, 6 or 12 months) and click "Enable now"; the subscription is per account, and once activated you can create multiple buckets.

  • The monthly fee includes a certain amount of storage and requests per month, and there is a cap on the number of buckets; anything beyond is charged by storage and by requests (split into Class A and Class B). The exact figures are as shown on the activation page.
  • Usage is collected once a day (per UTC day); "Overage this month (est.)" is estimated from the usage collected so far and does not include the monthly fee.
  • Overage is settled daily from your account balance, which may go negative as a result; you are notified when it does, so keep your balance sufficient.

Creating a bucket

On the Buckets page, click "Create bucket": the name may contain only lowercase letters, digits and hyphens, and the system automatically adds a prefix to keep it globally unique, while you always see the name you chose; for location you can choose "Auto" (the system picks the nearest) or specify a region; and the storage class can be "Standard" or "Infrequent Access".

The bucket list shows each bucket's usage, location and storage class. Click a name to open its details, which have four tabs: "Objects", "Access keys", "Metrics" and "Settings".

Access keys

  • On a bucket's "Access keys" tab, click "Issue key" and choose "Read & write" or "Read only" permission. An issued key can access only this one bucket and can be entered into any S3 SDK or tool, and a bucket can have several keys.
  • The Secret Access Key is shown only once, when the key is issued, and cannot be viewed again after you close it, so copy and save it immediately; you can also click "Copy as config".
  • A new key takes a while to sync to the storage nodes, and the page tells you roughly how many seconds; calls during this time return 401, which does not mean you entered the key wrong — just wait a moment and try again.
  • The S3 endpoint and the bucket's full name, which you need for integration, are under "General" in the bucket's "Settings"; click "Revoke" for keys you no longer use. For integration steps and code examples, see the object storage API docs (/docs/objstore).

Managing files in the console

A bucket's "Objects" tab lets you create a "New folder", "Upload" files or "Upload folder", as well as download, copy links, delete and filter by name prefix; large files are uploaded in parts automatically, and file paths can be up to 1024 bytes. Tick several files or folders to delete them together.

The first time you open a bucket, temporary access credentials have to be prepared, which takes about half a minute and then continues automatically. The "Metrics" tab shows this bucket's usage, with data updated once a day, so a new bucket has no data until the next day.

Bucket settings

The "Settings" tab of a bucket's details is divided into the following:

  • General — Shows the bucket's full name, S3 endpoint, location, storage class and creation time.
  • Public access — When enabled, every object in the bucket can be read publicly by anyone. The "Public dev URL" is only for testing; for production, bind a "Custom domain", which must be a domain you hold whose DNS is hosted on the platform.
  • CORS — Needed when web pages read from or write to this bucket directly (direct uploads or reads from the front end); the origin cannot be the wildcard *.
  • Lifecycle — Automatically delete objects, move them to Infrequent Access, or clean up unfinished multipart uploads by prefix and number of days; adding a rule that cleans up unfinished multipart uploads to every bucket is recommended.
  • Migration — Move data over gradually, as it is accessed, from an S3 bucket you have elsewhere: when a file is read that this bucket does not have yet, it is fetched from the source bucket in real time and stored, with no downtime. You enter the source bucket's name, region and access key, which needs only read permission; the platform uses that key only to read the source bucket and does not store it. Migrated data takes up this bucket's storage and counts toward requests; when migration is turned off, the files already migrated stay in this bucket.
  • Lock — During the retention period, files matching the prefix cannot be deleted or overwritten — neither you nor platform support can delete them — and they are billed as usual meanwhile. It is set in days, the maximum is as shown on the page, and permanent locks are not offered.
  • Unfinished uploads — An interrupted large upload leaves behind the parts already uploaded, which are billed as storage but do not appear in the file list; here you can view them and clean up parts older than 24 hours.
  • Danger zone — "Empty bucket" deletes every file in the bucket and cannot be undone; a bucket must be emptied before it can be deleted, and deleting it revokes all of its keys along with it.

Renewal and expiry

  • On the Buckets page, click "Renew", choose a term and pay. There is no automatic renewal at the moment, and the platform sends reminders before expiry.
  • From the day it expires, storage becomes read-only: you can still browse, download, delete and empty, but you cannot upload, change settings, create new buckets or issue new keys.
  • After expiry, the access keys already issued are revoked, and you need to issue new ones after renewing.

If it is still not renewed 7 days after expiry, the platform empties the buckets and deletes the data, which cannot be recovered, and notifies you afterwards. Download any data you need to keep, or renew, before then.

Troubleshooting

  • A newly issued key returns 401 — The new key is still syncing to the storage nodes — Wait as long as the page suggests and try again; do not keep recreating the key.
  • The bill shows storage charges, but the bucket does not seem to hold that many files — Parts left by interrupted uploads are not in the file list — View and clean them up under "Settings → Unfinished uploads".
  • Deleting a bucket fails — The bucket still has files, or some files are still within a lock period — "Empty bucket" first; if you are told there is a lock, check the rules under "Settings → Lock" — files within the retention period can only be deleted once it ends.
  • Opening a bucket says temporary access credentials are being prepared — Temporary credentials are prepared the first time you open a bucket — It takes about half a minute and then continues automatically; there is no need to refresh the page.
  • The message says the bucket limit has been reached — Your account has reached the maximum number of buckets — Delete buckets you no longer use, then create a new one.
  • The account balance has gone negative — Usage beyond the included amount is settled daily from your balance — Top up to cover it; you can see this month's estimated overage on the Buckets page.

Frequently Asked Questions

Is there an extra traffic charge for downloading files?

No, egress traffic is not charged extra. Charges come from the monthly fee plus any storage and requests beyond the included amounts.

Is data deleted immediately after expiry?

No. From the day it expires, storage becomes read-only and you can download and clean up; only if it is still not renewed 7 days after expiry is the data emptied and deleted, which cannot be recovered.

What if I lose the Secret Access Key?

It is shown only once, when the key is issued, and cannot be recovered if lost. Revoke the old key and issue a new one.

Related pages: Help Center · Guides & FAQ · S3-compatible object storage · Object Storage API

Loading…