Skip to content

RESUMABLE: Remove nominative languages addressing the lost final response#3405

Merged
guoye-zhang merged 6 commits into
httpwg:mainfrom
guoye-zhang:lost-response
May 13, 2026
Merged

RESUMABLE: Remove nominative languages addressing the lost final response#3405
guoye-zhang merged 6 commits into
httpwg:mainfrom
guoye-zhang:lost-response

Conversation

@guoye-zhang
Copy link
Copy Markdown
Contributor

Discussed during IETF125. Removing nominative language recommending that the server should keep the temporary resource alive, 410 Gone, and the completed-upload problem type.

Mention the possibility of the client performing offset retrieval and upload append even if the upload is complete in the server's perspective, but do not require a specific way to handle this situation.

Resolves #3270

Comment thread draft-ietf-httpbis-resumable-upload.md
Comment thread draft-ietf-httpbis-resumable-upload.md Outdated
Comment thread draft-ietf-httpbis-resumable-upload.md Outdated
- If the client attempted to append a zero-length document:
- If the server retains knowledge of the upload resource but it is not available, the `410 (Gone)` status code can be used; the response could also contain a `Location` header field to indicate the location of the completed upload. The server can use the problem type {{PROBLEM}} of "https://iana.org/assignments/http-problem-types#completed-upload" ({{completed-upload}}) in the response.
- If the server has not retained knowledge of the upload resource, a `404 (Not Found)` status code can be used.
Even if the upload is complete ({{upload-complete}}) in the server's perspective and the final response from the targeted resource has already been sent, the client might still perform an upload append {#upload-appending} after an offset retrieval {#offset-retrieving} due to the response being lost during transmission. The server can choose to replay the final response to the client if the request to append to the completed upload is valid.
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can we move this paragraph down one paragraph after "If the Upload-Complete request header field is set to true [...]"? This other paragraph talks about generating responses, which helpful context to understand what this new sentence is about.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I moved it 2 paragraphs down since they are related

Copy link
Copy Markdown
Member

@Acconut Acconut left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks! Let's ship it!

Comment thread draft-ietf-httpbis-resumable-upload.md Outdated
Comment thread draft-ietf-httpbis-resumable-upload.md Outdated
Copy link
Copy Markdown
Contributor

@LPardue LPardue left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM modulo some minor comments

@guoye-zhang guoye-zhang merged commit c159b75 into httpwg:main May 13, 2026
1 check passed
@guoye-zhang guoye-zhang deleted the lost-response branch May 13, 2026 02:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Development

Successfully merging this pull request may close these issues.

RESUMABLE: Retrieving the lost final response after a completed upload

4 participants