S3 buckets management
Explore managing your buckets in the system using S3 API, GUI, CLI, or API, with flexible permissions through IAM or bucket policies for anonymous access.
Manage your buckets, either through standard S3 API calls or the NeuralMesh GUI/API/CLI. Determine bucket permissions by using IAM policies for authorized users or setting bucket policies for anonymous access.
Buckets and objects created through the S3 protocol come with default root POSIX permissions. For more precise control, create a user with an S3 role and set specific POSIX permissions for objects generated with their access/secret keys.
Objects created through anonymous access are assigned the anonymous UID and GID configured for the tenant. If the tenant does not define these values, the system uses the cluster-level defaults.
By default, all buckets are created in the tenant default filesystem, which can be set during S3 cluster configuration. This configuration is optional. Because S3 native API bucket creation does not support a filesystem parameter, bucket creation fails if no tenant default filesystem is configured. To place a bucket in a different filesystem, use the NeuralMesh GUI, API, or CLI, which accept a filesystem parameter.
Bucket names must be unique across the entire cluster. If a bucket name is already in use, the system returns an error to choose another name.
In multi-tenant deployments, bucket visibility is tenant-scoped. ListBuckets and weka s3 bucket list return only buckets in the calling user's tenant. Buckets from other tenants are not visible, regardless of admin role.
Related topics
Last updated