Skip to main content

Storage providers — S3 and SharePoint

Each bucket stores its files on one provider, chosen when you create the bucket with storage_provider set to s3 (the default) or sharepoint. The provider can't be changed later.

Amazon S3​

S3 is the default and supports every Storage operation: uploads and downloads, single and batch delete, copy and move, list, filter, browse, and search.

S3 buckets don't offer in-browser Office viewing or editing; is_office_editable is always false for their files.

Microsoft SharePoint​

SharePoint buckets support the same file operations as S3 and add in-browser viewing and editing of Office documents:

  • GET …/objects/{key}/view/ returns a link to view the file in SharePoint.
  • GET …/objects/{key}/edit/ returns a link to edit it. Editing always requires sign-in, even for public files.

Only these Office file types can be edited in the browser:

ExtensionMIME type
.doc / .docxapplication/msword; application/vnd.openxmlformats-officedocument.wordprocessingml.document
.xls / .xlsxapplication/vnd.ms-excel; application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
.ppt / .pptxapplication/vnd.ms-powerpoint; application/vnd.openxmlformats-officedocument.presentationml.presentation
Macro-enabled.docm, .xlsm, .pptm

Opening a link may invite the user to SharePoint as a guest. TaruviBase waits up to 8 seconds for SharePoint to grant access. Email addresses from the SharePoint organization's own domain can't be invited as guests.

is_office_editable is true only for Office files in SharePoint buckets.

SharePoint limits the length of file paths; a path that is too long is rejected with path_too_long. Files of 4 MB or less upload in one request, and larger files upload in chunks automatically.

To use SharePoint buckets, SharePoint must be enabled for your site. If creating a SharePoint bucket fails with sharepoint_site_not_ready, see Troubleshooting or contact TaruviBase support.

Moving between providers​

Copy and move between an S3 bucket and a SharePoint bucket are both rejected. To transfer a file, download it and upload it to a bucket that uses the other provider, check it, then delete the original.