Infraista DocsDocs
Data & storageObject Storage

Bucket settings

Turn on versioning, set a size limit, add lifecycle rules that delete old objects, allow browser uploads with CORS, tag a bucket, move it to a project or delete it.

A bucket's Settings tab holds everything you can change after creating it. Its name and region are fixed.

Access and versioning

Public read and Versioning switches save right away.

Versioning

With versioning on, overwriting or deleting an object keeps its earlier version, so you can restore it from the Files tab. Once turned on, versioning can only be suspended:

StateWhat happens
EnabledNew versions are kept every time an object changes
SuspendedNew changes replace objects, but versions kept earlier stay stored (and billed) until deleted
OffObjects are replaced when overwritten

Old versions use storage and are billed like any data. When a bucket keeps old versions, its Overview shows how much space they use, with Delete old versions now (permanently deletes them; current files aren't touched) and a shortcut to delete them automatically after a number of days.

Size limit

Set Limit (GB) to refuse uploads once the bucket reaches that size (at least 1 GB), then Save. Remove limit takes it off.

Lifecycle rules

Lifecycle rules delete objects automatically. Select Add rule and set:

  • Applies to: objects whose key starts with this, for example logs/. Empty means the whole bucket.
  • Delete objects after (days), counted from upload.
  • Delete old versions after (days), counted from when a version was replaced. Only applies with versioning on.
  • Abort unfinished uploads after (days), which frees space held by uploads that never completed.

Select Save. Without rules, objects are kept until you delete them.

CORS

CORS lets web pages on other sites read or upload to the bucket from the browser. Select Add rule and set Allowed origins (for example https://app.example.com, or * for any site), Allowed methods, Allowed headers, Exposed headers and how long browsers may Cache preflight (seconds). Then Save.

Tags

Add up to 50 key and value labels to the bucket, for example a team or cost center, and select Save tags.

Project

Pick a project under Move to project and select Move to group the bucket's costs on invoices.

Delete the bucket

Delete bucket deletes the bucket and everything in it. Type the bucket's name to confirm.

Deleting a bucket deletes every object and version in it. This can't be undone.

Big buckets take a while to empty; the bucket shows Deleting until it's gone.

On this page