About Buckets
Learn about Object Storage buckets
What are buckets?
Buckets are the primary organizational containers for your data in AI Object Storage. Think of them as top-level folders that contain your objects (files). Each bucket has a globally unique name and its own access policies.
Prerequisites
After you've set up authentication and access control (access tokens, access keys, and organization policies), you can create and use buckets in Object Storage.
Before you create your first bucket, set up your endpoint configuration once to ensure you're using the required virtual-hosted addressing style, and the correct endpoints for AI Object Storage. This helps reduce errors.
Typical workflow
- Configure authentication and access control, making sure to set an organization access policy.
- Configure your endpoints (one-time setup)
- Set bucket policies if needed for fine-grained access
- Create buckets for different projects/purposes
- Upload objects using your preferred tools
To manage buckets and objects, you can use the Object Storage S3-compatible API, as well as command-line tools and libraries like the AWS CLI, s3cmd, and Boto3. You can also use Cyberduck or Cloud Console.
Bucket security
Access to buckets is controlled by two levels of policies:
- Organization policies: Required baseline access (set up during authentication)
- Bucket policies: Optional fine-grained control per bucket
See Bucket Access Policies for details.