From 725059c4d8a5df284a4e6424e497980e70d8e988 Mon Sep 17 00:00:00 2001
From: Jacek Laskowski <jacek@japila.pl>
Date: Sun, 20 Oct 2024 20:02:30 +0200
Subject: [PATCH] S3StorageConfig

---
 docs/credential-vending/S3StorageConfig.md | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)
 create mode 100644 docs/credential-vending/S3StorageConfig.md

diff --git a/docs/credential-vending/S3StorageConfig.md b/docs/credential-vending/S3StorageConfig.md
new file mode 100644
index 00000000..d29d9a57
--- /dev/null
+++ b/docs/credential-vending/S3StorageConfig.md
@@ -0,0 +1,20 @@
+# S3StorageConfig
+
+`S3StorageConfig` represents a configuration of a bucket (_a container for objects_) in [Amazon S3](https://aws.amazon.com/s3/).
+
+`S3StorageConfig` is a collection of the following properties:
+
+* <span id="bucketPath"> Bucket Path
+* <span id="region"> S3 Region
+* <span id="awsRoleArn"> Role ARN
+* <span id="accessKey"> Access Key
+* <span id="secretKey"> Secret Key
+* <span id="sessionToken"> Session Token
+
+`S3StorageConfig` is created only when `ServerProperties` is requested for the [S3 configurations](../server/ServerPropertiesUtils.md#getS3Configurations).
+
+`S3StorageConfig` is used by the following services:
+
+* [AwsCredentialVendor](AwsCredentialVendor.md#s3Configurations) to [vendAwsCredentials](AwsCredentialVendor.md#vendAwsCredentials) and [getStsClientForStorageConfig](AwsCredentialVendor.md#getStsClientForStorageConfig)
+* [FileIOFactory](../iceberg/FileIOFactory.md) to [getS3FileIO](../iceberg/FileIOFactory.md#getS3FileIO)
+* [TableConfigService](../iceberg/TableConfigService.md#s3Configurations) to [getS3Config](../iceberg/TableConfigService.md#getS3Config)