Skip to main content
Every object in an existing Scaleway Object Storage bucket becomes a file, and every / in a key becomes a folder.

Setup

Create an API key in the Scaleway console, then export it.
  1. In IAM, give the user or application that will hold the key a policy with ObjectStorageReadOnly, or ObjectStorageFullAccess for a write mount, on the bucket’s Project.
  2. Open API Keys and click Generate API key. Pick that user or application as the bearer.
  3. For Object Storage, choose Yes, set up preferred Project and pick the bucket’s Project.
  4. Copy the Access Key and Secret Key. The secret key is shown only once.
  5. Note the bucket’s region, for example fr-par.
The key reaches Object Storage in its preferred Project only.

Connect

workspace.yaml

Layout

  • The endpoint comes from region: s3.<region>.scw.cloud. endpoint_url (endpoint in TypeScript) overrides it.
  • key_prefix (keyPrefix in TypeScript) mounts one folder of the bucket as the root.
  • grep -r, find and du stop after 1000 files; a glob matching more, tar -c, cp -r and rm -r are refused.

Sample runs

On a write mount, cp, mv, rm and > change objects in the bucket. For write: conditional, see S3-compatible VFSes.

SDK guides

Python

Every config field, the VFS.md and write support.

TypeScript

Every config field, the VFS.md and write support.