[tahoe-lafs-trac-stream] [Tahoe-LAFS] #3764: Add standard interaction patterns to GBS HTTP protocol spec

[Tahoe-LAFS]

#3764: Add standard interaction patterns to GBS HTTP protocol spec
----------------------+---------------------------------------
 Reporter:  itamarst  |          Owner:  exarkun
     Type:  task      |         Status:  new
 Priority:  normal    |      Milestone:  HTTP Storage Protocol
Component:  unknown   |        Version:  n/a
 Keywords:            |  Launchpad Bug:
----------------------+---------------------------------------
 The HTTP protocol spec includes a number of endpoints, but doesn't really
 document the interaction patterns.

 For example, one can create a storage index, create a lease on a storage
 index, write to a share in a storage index, renew a lease... It's not
 immediately clear which order these operations happen in.

 Some example sessions, "here's how you create an immutable", "here's how
 you renew it", "here's the same for mutable", "here's how you update an
 immutable", will make the spec clearer and probably be useful in nailing
 down details about things like endpoint error codes.

--
Ticket URL: <https://tahoe-lafs.org/trac/tahoe-lafs/ticket/3764>
Tahoe-LAFS <https://Tahoe-LAFS.org>
secure decentralized storage