ExternalVendorCode/tahoe-lafs
1
0
Fork 0
mirror of https://github.com/tahoe-lafs/tahoe-lafs.git synced 2025-02-08 04:10:25 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

collapse these two APIs, they are the same

Browse Source 
also add mutable .../shares listing
This commit is contained in:
Jean-Paul Calderone 2018-05-18 13:01:57 -04:00
parent 9388903515
commit f09ed91ab6
1 changed files with 15 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

22
docs/proposed/http-storage-node-protocol.rst
View File

@ -297,21 +297,29 @@ For example::
Reading Reading
~~~~~~~ ~~~~~~~
``GET /v1/mutable/:storage_index?share=s0&share=sN`` ``GET /v1/mutable/:storage_index/shares``
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
Read mutable shares (like the immutable version). Retrieve a list indicating all shares available for the indicated storage index.
For example::
``GET /v1/mutable/:storage_index?share=:s1&share=:sN&offset=o1&size=z1&offset=oN&size=zN`` [1, 5]
``GET /v1/mutable/:storage_index?share=:s0&share=:sN&offset=o1&size=z0&offset=oN&size=zN``
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
Read a vector from the numbered shares associated with the given storage index. Read some data from some shares associated with the given storage index.
If ``share`` query parameters are given, only data from those shares is read.
Otherwise, data from all shares is read.
If ``size`` and ``offset`` query parameters are given,
only the portions of the selected shares thus identified are returned.
The response body contains a mapping giving the read data. The response body contains a mapping giving the read data.
For example:: For example::
{ {
3: ["foo"], 3: ["foo", "bar"],
7: ["bar"] 7: ["baz", "quux"]
} }
``POST /v1/mutable/:storage_index/:share_number/corrupt`` ``POST /v1/mutable/:storage_index/:share_number/corrupt``