Merge pull request mendix#9052 from strategicalliances/s3-metadata

AWS S3 documentation updated with the new metadata functionality

Author: katarzyna-koltun-mx

content/en/docs/appstore/use-content/platform-supported-content/modules/aws/aws-s3-connector.md

@@ -87,6 +87,20 @@ The name generated by the expression must be all lower-case. If the bucket name
 
  {{< figure src="/attachments/appstore/platform-supported-content/modules/aws-s3-connector/microflow.png" alt="Configured microflow" class="no-border" >}}
 
+### Adding Metadata to an S3 Object
+
+You can add metadata to an S3 object using the **PutObject** or **CopyObject** operations. To retrieve this metadata, you can use the **GetObject** operation or view it directly in the Amazon S3 portal.
+
+To add metadata, perform the following steps:
+
+1. When adding metadata with **PutObject** or **CopyObject**, populate the **S3RequestMetaData** object with the necessary key-value pairs.
+
+    Every call utilizes **AbstractS3Request**, which works with **S3RequestMetaData**. This object uses **AbstractMetaData** as its generalization, enabling a one-to-many relationship for metadata management.
+
+2. Use the same **S3RequestMetaData** object to retrieve metadata with **GetObject**.
+
+{{< figure src="/attachments/appstore/platform-supported-content/modules/aws-s3-connector/s3metadata.png" alt="Metadata domain model" class="no-border" >}}
+ 
 ## Technical Reference {#technical-reference}
 
 The module includes technical reference documentation for the available entities, enumerations, activities, and other items that you can use in your application. You can view the information about each object in context by using the **Documentation** pane in Studio Pro.