2
2
mirror of https://github.com/octoleo/restic.git synced 2024-06-08 03:50:49 +00:00

Merge pull request #3236 from Wouter0100/patch-1

doc: Note only path-style URL support for S3
This commit is contained in:
MichaelEischer 2021-01-31 18:44:58 +01:00 committed by GitHub
commit 0ce05d5725
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -238,7 +238,12 @@ after the bucket name like this:
For an S3-compatible server that is not Amazon (like Minio, see below), For an S3-compatible server that is not Amazon (like Minio, see below),
or is only available via HTTP, you can specify the URL to the server or is only available via HTTP, you can specify the URL to the server
like this: ``s3:http://server:port/bucket_name``. like this: ``s3:http://server:port/bucket_name``.
.. note:: restic expects `path-style URLs <https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingBucket.html#access-bucket-intro>`__
like for example ``s3.us-west-2.amazonaws.com/bucket_name``.
Virtual-hostedstyle URLs like ``bucket_name.s3.us-west-2.amazonaws.com``,
where the bucket name is part of the hostname are not supported. These must
be converted to path-style URLs instead, for example ``s3.us-west-2.amazonaws.com/bucket_name``.
.. note:: Certain S3-compatible servers do not properly implement the .. note:: Certain S3-compatible servers do not properly implement the
``ListObjectsV2`` API, most notably Ceph versions before v14.2.5. On these ``ListObjectsV2`` API, most notably Ceph versions before v14.2.5. On these