octoleo
/
restic
mirror of https://github.com/octoleo/restic.git
2
2
Fork 0
Code Issues Releases Wiki Activity

Highlight that s3.list-objects-v1 is a temporary

This commit is contained in:
Alexander Neumann 2020-11-11 20:00:34 +01:00
parent f013662e3f
commit 3e0456d88b
2 changed files with 18 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

18
changelog/unreleased/issue-3083
View File

@ -1,13 +1,19 @@
Enhancement: Allow usage of deprecated S3 ListObjectsV1 API
Restic didn't work with some S3 API implementations that don't have a
working ListObjectsV2 API endpoint. This concerns mainly Ceph versions
before v14.2.5 , but may impact other S3 API implementations.
broken `ListObjectsV2` API endpoint. This concerns mainly Ceph versions
before v14.2.5 , but may impact other S3 API implementations. When a broken
server implementation is used, restic prints errors similar to the following:
Restic now allows selection of the older ListObjectsV1 endpoint by using
the 's3.list-objects-v1' extended option, for instance:
List() returned error: Truncated response should have continuation token set
`restic -o s3.list-objects-v1=true snapshots`
As a temporary workaround, restic now allows selection of the older
`ListObjects` endpoint by using the `s3.list-objects-v1` extended option, for
instance:
restic -o s3.list-objects-v1=true snapshots
This option may be removed in future versions of restic.
https://github.com/restic/restic/issues/3083
https://github.com/restic/restic/pull/3085
https://github.com/restic/restic/pull/3085

9
doc/030_preparing_a_new_repo.rst
View File

@ -240,9 +240,12 @@ or is only available via HTTP, you can specify the URL to the server
like this: ``s3:http://server:port/bucket_name``.
.. note:: Certain S3-compatible servers do not properly implement the ListObjectsV2 API,
most notably Ceph versions before v14.2.5. On these backends you need to
provide the ``-o s3.list-objects-v1=true`` option to use the ListObjects API instead.
.. note:: Certain S3-compatible servers do not properly implement the
``ListObjectsV2`` API, most notably Ceph versions before v14.2.5. On these
backends, as a temporary workaround, you can provide the
``-o s3.list-objects-v1=true`` option to use the older
``ListObjects`` API instead. This option may be removed in future
versions of restic.
Minio Server