From 4c92f9c8cfd1d77d5549de3de50c552dbb442461 Mon Sep 17 00:00:00 2001 From: Itamar Turner-Trauring Date: Tue, 4 Jan 2022 13:10:23 -0500 Subject: [PATCH] Document additional semantics. --- docs/proposed/http-storage-node-protocol.rst | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/docs/proposed/http-storage-node-protocol.rst b/docs/proposed/http-storage-node-protocol.rst index 0d8cee466..a8555cd26 100644 --- a/docs/proposed/http-storage-node-protocol.rst +++ b/docs/proposed/http-storage-node-protocol.rst @@ -483,6 +483,13 @@ For example:: The upload secret is an opaque _byte_ string. +Handling repeat calls: + +* If the same API call is repeated with the same upload secret, the response is the same and no change is made to server state. + This is necessary to ensure retries work in the face of lost responses from the server. +* If the API calls is with a different upload secret, this implies a new client, perhaps because the old client died. + In this case, all relevant in-progress uploads are canceled, and then the command is handled as usual. + Discussion ``````````