Objects
Concepts
In SysEleven Object Storage, objects are the individual pieces of data stored within buckets. They can be any type of file, such as documents, images, or videos. Each object is identified by a unique key within its bucket.
List Objects
Listing objects shows you all the objects within a specific bucket.
Usage:
mc ls s11_dus2/my-bucket
This command lists all objects in the specified bucket.
Output:
[2023-05-15 14:35:25 CEST] 1.5MiB document.pdf
[2023-05-15 16:50:10 CEST] 500KiB image.jpg
Upload an Object
Uploading an object adds it to a specified bucket in your SysEleven Object Storage.
Usage:
mc cp /path/to/local/file s11_dus2/my-bucket/
This command uploads a file to the specified bucket.
Output:
/path/to/local/file: 5.00 MiB / 5.00 MiB ┃▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓┃ 100.00% 21.39 MiB/s 0s
Download an Object
You can download objects from your SysEleven Object Storage to your local system.
Usage:
mc cp s11_dus2/my-bucket/file.txt /path/to/local/destination/
This command downloads a file from the specified bucket to your local system.
Output:
s11_dus2/my-bucket/file.txt: 5.00 MiB / 5.00 MiB ┃▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓┃ 100.00% 25.12 MiB/s 0s
Delete an Object
You can delete objects from your SysEleven Object Storage when they are no longer needed.
Usage:
mc rm s11_dus2/my-bucket/file.txt
This command removes the specified object from the bucket.
Output:
Removed `s11_dus2/my-bucket/file.txt`.
Object Metadata
You can view and set metadata for objects in your SysEleven Object Storage.
To view object metadata:
mc stat s11_dus2/my-bucket/file.txt
Output:
Name : file.txt
Date : 2023-05-15 17:30:25 CEST
Size : 5.00 MiB
ETag : a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6
Type : file
Metadata :
Content-Type: text/plain
X-Amz-Meta-Custom: value
To set custom metadata when uploading an object:
mc cp --attr "Content-Type=application/pdf,X-Amz-Meta-CustomField=CustomValue" /path/to/local/file.pdf s11_dus2/my-bucket/
Multipart Upload
For large files, SysEleven Object Storage supports multipart uploads, which can improve upload performance and allow for resumable uploads.
The MinIO Client automatically uses multipart uploads for large files. You don't need to explicitly enable it:
mc cp /path/to/large/file s11_dus2/my-bucket/
The client will automatically split the file into parts and upload them concurrently.
Remember to replace s11_dus2 with the appropriate alias if you're using a different region or have set up your MinIO Client differently.
For more detailed information on SysEleven Object Storage concepts and best practices, please refer to our Object Storage Concepts documentation.