Working with Buckets & Objects
To store data in OSS, you must first create a bucket (storage container) with a unique name. Use any S3-compatible tool to manage your buckets and objects.
Creating Buckets
Bucket Naming Rules
- 3-63 characters long
- Lowercase letters, numbers, and hyphens only
- Must start and end with alphanumeric character
- Globally unique across all OSS users
Using GUI Tools
S3Browser (Windows):
- Open S3Browser (see setup guide)
- Click New Bucket button
- Enter bucket name and click Create
![Figure needed: Screenshot of S3Browser bucket creation dialog]
CloudBerry Explorer (Cross-platform):
- Open CloudBerry Explorer (see setup guide)
- Click New Bucket icon
- Enter bucket name and create
![Figure needed: Screenshot of CloudBerry bucket creation interface]
Using Command Line
# AWS CLI
aws s3 mb s3://my-bucket --endpoint-url https://<customer-id>.oss.swiftserve.com
# S3cmd
s3cmd mb s3://my-bucket
Managing Objects
Upload Files
GUI Tools:
- Drag & Drop: Drag files from your computer to the tool window
- Upload Button: Use the upload button to select files
Command Line:
# Upload single file
aws s3 cp file.txt s3://my-bucket/ --endpoint-url https://<customer-id>.oss.swiftserve.com
# Upload directory
aws s3 sync ./folder s3://my-bucket/folder/ --endpoint-url https://<customer-id>.oss.swiftserve.com
Download Files
GUI Tools:
- Drag & Drop: Drag files from OSS to your local computer
- Right-click: Right-click object → Download
Command Line:
# Download single file
aws s3 cp s3://my-bucket/file.txt ./ --endpoint-url https://<customer-id>.oss.swiftserve.com
# Download directory
aws s3 sync s3://my-bucket/folder/ ./folder/ --endpoint-url https://<customer-id>.oss.swiftserve.com
Delete Objects
GUI Tools:
- Select objects and press Delete key
- Right-click → Delete
Command Line:
# Delete single object
aws s3 rm s3://my-bucket/file.txt --endpoint-url https://<customer-id>.oss.swiftserve.com
# Delete all objects in folder
aws s3 rm s3://my-bucket/folder/ --recursive --endpoint-url https://<customer-id>.oss.swiftserve.com
Best Practices
Organization
company-data/
├── documents/2024/
├── images/products/
├── backups/daily/
└── logs/application/
Security
- Use appropriate permissions (Read/Read-Write/Full Control)
- Don't make buckets public unless necessary
- Regularly rotate access keys
- Monitor access logs
Performance
- Use multipart upload for files >100MB
- Organize with logical folder structures
- Consider lifecycle policies for automatic cleanup
Common Operations
| Task | S3Browser | CloudBerry | AWS CLI |
|---|---|---|---|
| Create bucket | New Bucket button | New Bucket icon | aws s3 mb |
| Upload file | Drag & drop | Drag & drop | aws s3 cp |
| Download file | Right-click → Download | Drag to local | aws s3 cp |
| Delete object | Right-click → Delete | Delete key | aws s3 rm |
| Sync folder | Folder sync feature | Synchronize | aws s3 sync |
Troubleshooting
| Issue | Solution |
|---|---|
| Bucket already exists | Use a different bucket name |
| Access denied | Check credentials and permissions |
| Upload failed | Verify file size and network connection |
| Slow transfers | Use multipart upload for large files |
For detailed tool setup, see S3-Compatible Tools.