Storage overview
Storage holds your application's files (objects) in buckets. Each bucket belongs to one app and is stored on Amazon S3 or Microsoft SharePoint. You choose the provider when you create the bucket, and it can't change later.
How it fits together
A file's path looks like a folder path, for example users/123/avatar.jpg.
Bucket names only need to be unique within one app.
What you can do
| Task | Start here |
|---|---|
| Store your first file | Get started |
| Create and configure buckets | Manage buckets |
| Upload, download, and update files | Work with objects |
| Folders, copy, and move | Organize |
| Batch uploads and SharePoint editing | Batch and SharePoint |
| Understand buckets and visibility | How storage works |
| Look up endpoints | REST reference |
| Access rules and limits | Security and limits |
| Fix a failure | Troubleshooting |
Choose an interface
| Interface | Use it to |
|---|---|
| TaruviBase Console | Create and edit buckets, upload and download files, and create folders. Open your app and select Storage. |
| JavaScript SDK | Upload, download, list, update, and delete files with the Storage client |
| Python SDK | Manage buckets and files with client.storage |
| REST API | Every operation, including search, copy, move, and SharePoint links |
Providers
| Provider | When to use it |
|---|---|
| Amazon S3 | The default. Use it for most application files. |
| SharePoint | Use it when people need to view and edit Office documents in the browser. |
You can't copy or move a file between an S3 bucket and a SharePoint bucket. To transfer one, download it and upload it to a bucket that uses the other provider. See Providers.
Access in brief
- Creating, changing, and deleting buckets requires an organization owner or admin, or another cloud user with access to the site.
- Uploading, downloading, and deleting files is controlled by each bucket's access policy.
- Assets buckets let signed-in users read files by default.
- Attachments buckets let signed-in users read, upload, and update files by default.
- No default policy allows deleting files; add a rule to allow it.
Details: Security and limits.