ExternalVendorCode/tahoe-lafs
1
0
Fork 0
mirror of https://github.com/tahoe-lafs/tahoe-lafs.git synced 2025-01-20 03:36: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
~~~~~~~
``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.
For example::
{
3: ["foo"],
7: ["bar"]
3: ["foo", "bar"],
7: ["baz", "quux"]
}
``POST /v1/mutable/:storage_index/:share_number/corrupt``