# Objects

In Object Storage, objects are the individual pieces of data stored within buckets. They include documents, images, videos, and other files. A unique key within its bucket identifies each object.

## List Objects

Listing objects shows you all the objects within a specific bucket.

Usage:

```text
mc ls s11_dus2/my-bucket
```

This command lists all objects in the specified bucket.

Output:

```text
[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 Object Storage.

Usage:

```text
mc cp /path/to/local/file s11_dus2/my-bucket/
```

This command uploads a file to the specified bucket.

Output:

```text
/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 Object Storage to your local system.

Usage:

```text
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:

```text
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 Object Storage when they are no longer needed.

Usage:

```text
mc rm s11_dus2/my-bucket/file.txt
```

This command removes the specified object from the bucket.

Output:

```text
Removed `s11_dus2/my-bucket/file.txt`.
```

## Object Metadata

You can view and set metadata for objects in your Object Storage.

To view object metadata:

```text
mc stat s11_dus2/my-bucket/file.txt
```

Output:

```text
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:

```text
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, 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:

```text
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 Object Storage concepts and best practices, see our [Object Storage Concepts](<https://documentation.syseleven.de/en/products/object-storage/concepts/index.md>) documentation.
