You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@hop.apache.org by ha...@apache.org on 2026/08/03 06:55:44 UTC

(hop) branch main updated: docs: document S3 endpoint URL and path-style access options (#7728)

This is an automated email from the ASF dual-hosted git repository.

hansva pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/hop.git


The following commit(s) were added to refs/heads/main by this push:
     new 9540a6f2b9 docs: document S3 endpoint URL and path-style access options (#7728)
9540a6f2b9 is described below

commit 9540a6f2b998bc4d3684dba2412acc232994e996
Author: Gonzalo Peña-Castellanos <go...@gmail.com>
AuthorDate: Mon Aug 3 01:55:38 2026 -0500

    docs: document S3 endpoint URL and path-style access options (#7728)
---
 .../modules/ROOT/pages/vfs/aws-s3-vfs.adoc                | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/docs/hop-user-manual/modules/ROOT/pages/vfs/aws-s3-vfs.adoc b/docs/hop-user-manual/modules/ROOT/pages/vfs/aws-s3-vfs.adoc
index 2c17e55d37..aa6c3f4dc2 100644
--- a/docs/hop-user-manual/modules/ROOT/pages/vfs/aws-s3-vfs.adoc
+++ b/docs/hop-user-manual/modules/ROOT/pages/vfs/aws-s3-vfs.adoc
@@ -56,6 +56,21 @@ You can set the following system environment variables:
 * `AWS_ACCESS_KEY_ID` : set it to your AWS access key
 * `AWS_SECRET_ACCESS_KEY` : set it to your secret access key
 
+== S3-compatible services
+
+Storage services that implement the S3 API can be used through this plugin as well.
+Create an **S3 Connection** metadata item and fill in the following options:
+
+* `Endpoint URL` : the endpoint of the service, for example `https://s3.example-region.example.com`.
+Leave this empty for Amazon S3, where the endpoint is derived from the region.
+* `Path-style access` : check this when the service expects the bucket in the path (`endpoint/bucketName`) instead of in the hostname (`bucketName.endpoint`).
+This option is only applied when an endpoint URL is set.
+
+The name of the connection is registered as a VFS scheme of its own, so a connection named `storage` gives you paths like `storage://bucketName/path/to/file.csv`.
+
+This works with Amazon S3 and with S3-compatible services such as Backblaze B2, Cloudflare R2 and MinIO.
+Check the documentation of your service for the endpoint to use and for whether path-style access is required.
+
 == Part size
 
 You can set the default part size for new files on S3 by setting the following variable: