draft-ietf-httpbis-resumable-upload-15.txt   draft-ietf-httpbis-resumable-upload-latest.txt 
skipping to change at page 3, line 51 skipping to change at page 3, line 51
20.7. Different Origins . . . . . . . . . . . . . . . . . . . 38 20.7. Different Origins . . . . . . . . . . . . . . . . . . . 38
21. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 38 21. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 38
21.1. HTTP Fields . . . . . . . . . . . . . . . . . . . . . . 38 21.1. HTTP Fields . . . . . . . . . . . . . . . . . . . . . . 38
21.2. HTTP Status Code . . . . . . . . . . . . . . . . . . . . 39 21.2. HTTP Status Code . . . . . . . . . . . . . . . . . . . . 39
21.3. Media Type . . . . . . . . . . . . . . . . . . . . . . . 39 21.3. Media Type . . . . . . . . . . . . . . . . . . . . . . . 39
21.4. HTTP Problem Types . . . . . . . . . . . . . . . . . . . 40 21.4. HTTP Problem Types . . . . . . . . . . . . . . . . . . . 40
22. References . . . . . . . . . . . . . . . . . . . . . . . . . 41 22. References . . . . . . . . . . . . . . . . . . . . . . . . . 41
22.1. Normative References . . . . . . . . . . . . . . . . . . 41 22.1. Normative References . . . . . . . . . . . . . . . . . . 41
22.2. Informative References . . . . . . . . . . . . . . . . . 42 22.2. Informative References . . . . . . . . . . . . . . . . . 42
Appendix A. Changes . . . . . . . . . . . . . . . . . . . . . . 42 Appendix A. Changes . . . . . . . . . . . . . . . . . . . . . . 42
A.1. Since draft-ietf-httpbis-resumable-upload-14 . . . . . . 42 A.1. Since draft-ietf-httpbis-resumable-upload-15 . . . . . . 42
A.2. Since draft-ietf-httpbis-resumable-upload-13 . . . . . . 43 A.2. Since draft-ietf-httpbis-resumable-upload-14 . . . . . . 43
A.3. Since draft-ietf-httpbis-resumable-upload-12 . . . . . . 43 A.3. Since draft-ietf-httpbis-resumable-upload-13 . . . . . . 43
A.4. Since draft-ietf-httpbis-resumable-upload-11 . . . . . . 43 A.4. Since draft-ietf-httpbis-resumable-upload-12 . . . . . . 43
A.5. Since draft-ietf-httpbis-resumable-upload-10 . . . . . . 44 A.5. Since draft-ietf-httpbis-resumable-upload-11 . . . . . . 43
A.6. Since draft-ietf-httpbis-resumable-upload-09 . . . . . . 44 A.6. Since draft-ietf-httpbis-resumable-upload-10 . . . . . . 44
A.7. Since draft-ietf-httpbis-resumable-upload-08 . . . . . . 44 A.7. Since draft-ietf-httpbis-resumable-upload-09 . . . . . . 44
A.8. Since draft-ietf-httpbis-resumable-upload-07 . . . . . . 45 A.8. Since draft-ietf-httpbis-resumable-upload-08 . . . . . . 44
A.9. Since draft-ietf-httpbis-resumable-upload-06 . . . . . . 45 A.9. Since draft-ietf-httpbis-resumable-upload-07 . . . . . . 45
A.10. Since draft-ietf-httpbis-resumable-upload-05 . . . . . . 45 A.10. Since draft-ietf-httpbis-resumable-upload-06 . . . . . . 45
A.11. Since draft-ietf-httpbis-resumable-upload-04 . . . . . . 45 A.11. Since draft-ietf-httpbis-resumable-upload-05 . . . . . . 45
A.12. Since draft-ietf-httpbis-resumable-upload-03 . . . . . . 46 A.12. Since draft-ietf-httpbis-resumable-upload-04 . . . . . . 45
A.13. Since draft-ietf-httpbis-resumable-upload-02 . . . . . . 46 A.13. Since draft-ietf-httpbis-resumable-upload-03 . . . . . . 46
A.14. Since draft-ietf-httpbis-resumable-upload-01 . . . . . . 46 A.14. Since draft-ietf-httpbis-resumable-upload-02 . . . . . . 46
A.15. Since draft-ietf-httpbis-resumable-upload-00 . . . . . . 47 A.15. Since draft-ietf-httpbis-resumable-upload-01 . . . . . . 46
A.16. Since draft-tus-httpbis-resumable-uploads-protocol-02 . . 47 A.16. Since draft-ietf-httpbis-resumable-upload-00 . . . . . . 47
A.17. Since draft-tus-httpbis-resumable-uploads-protocol-01 . . 47 A.17. Since draft-tus-httpbis-resumable-uploads-protocol-02 . . 47
A.18. Since draft-tus-httpbis-resumable-uploads-protocol-00 . . 47 A.18. Since draft-tus-httpbis-resumable-uploads-protocol-01 . . 47
A.19. Since draft-tus-httpbis-resumable-uploads-protocol-00 . . 47
Appendix B. Draft Version Identification . . . . . . . . . . . . 47 Appendix B. Draft Version Identification . . . . . . . . . . . . 47
Acknowledgments . . . . . . . . . . . . . . . . . . . . . . . . . 48 Acknowledgments . . . . . . . . . . . . . . . . . . . . . . . . . 48
Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . 49 Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . 49
1. Introduction 1. Introduction
HTTP data transfers can encounter interruption due to reasons such as HTTP data transfers can encounter interruption due to reasons such as
canceled requests or dropped connections. If the intended recipient canceled requests or dropped connections. If the intended recipient
can indicate how much of the data was processed prior to can indicate how much of the data was processed prior to
interruption, a sender can resume data transfer at that point instead interruption, a sender can resume data transfer at that point instead
skipping to change at page 42, line 46 skipping to change at page 42, line 46
http://ha.ckers.org/slowloris/>. http://ha.ckers.org/slowloris/>.
22.3. URIs 22.3. URIs
[1] https://tus.io/ [1] https://tus.io/
Appendix A. Changes Appendix A. Changes
This section is to be removed before publishing as an RFC. This section is to be removed before publishing as an RFC.
A.1. Since draft-ietf-httpbis-resumable-upload-14 A.1. Since draft-ietf-httpbis-resumable-upload-15
No changes yet.
A.2. Since draft-ietf-httpbis-resumable-upload-14
o State that unknown Structured Fields parameters MUST be ignored. o State that unknown Structured Fields parameters MUST be ignored.
o Discourage change of upload URLs. o Discourage change of upload URLs.
o Append request cannot use different content codings. o Append request cannot use different content codings.
o Define ranges for integer values in "Upload-Limit" and problem o Define ranges for integer values in "Upload-Limit" and problem
type members. type members.
A.2. Since draft-ietf-httpbis-resumable-upload-13 A.3. Since draft-ietf-httpbis-resumable-upload-13
Editorial changes only. Editorial changes only.
A.3. Since draft-ietf-httpbis-resumable-upload-12 A.4. Since draft-ietf-httpbis-resumable-upload-12
o Upload-Complete and Upload-Length are no longer required on offset o Upload-Complete and Upload-Length are no longer required on offset
retrieval responses. retrieval responses.
o Remove discouragement against sending requests after expiration. o Remove discouragement against sending requests after expiration.
o Clarify how upload offset is inferred from responses. o Clarify how upload offset is inferred from responses.
o Disallow successful responses indicating an incomplete upload when o Disallow successful responses indicating an incomplete upload when
the request indicated completion. the request indicated completion.
o Describe considerations for the initially targeted resource and o Describe considerations for the initially targeted resource and
the upload resource having different origins. the upload resource having different origins.
A.4. Since draft-ietf-httpbis-resumable-upload-11 A.5. Since draft-ietf-httpbis-resumable-upload-11
o Clear up different responsibilities of server and upload resource. o Clear up different responsibilities of server and upload resource.
o Relax recommendations on client handling greater offsets. o Relax recommendations on client handling greater offsets.
o Clarify client behavior for 413 responses. o Clarify client behavior for 413 responses.
o Remove Accept-Patch from OPTIONS responses. o Remove Accept-Patch from OPTIONS responses.
o Allow upload creation requests with no content regardless of the o Allow upload creation requests with no content regardless of the
skipping to change at page 44, line 20 skipping to change at page 44, line 26
o Clarify that clients might not know limits when starting upload. o Clarify that clients might not know limits when starting upload.
o Remove section covering integrity digests. o Remove section covering integrity digests.
o Increase the draft interop version. o Increase the draft interop version.
o Add version-specific details on cancelling in-flight transfers. o Add version-specific details on cancelling in-flight transfers.
o Clarify client retry strategies. o Clarify client retry strategies.
A.5. Since draft-ietf-httpbis-resumable-upload-10 A.6. Since draft-ietf-httpbis-resumable-upload-10
o Add recommended disposition type for file name indication. o Add recommended disposition type for file name indication.
A.6. Since draft-ietf-httpbis-resumable-upload-09 A.7. Since draft-ietf-httpbis-resumable-upload-09
o Requires Accept-Patch in OPTIONS. o Requires Accept-Patch in OPTIONS.
o Add security consideration regarding time-of-check to time-of-use. o Add security consideration regarding time-of-check to time-of-use.
o Lift requirement on Upload-Complete for all final responses. o Lift requirement on Upload-Complete for all final responses.
o Relax requirements on limit changes. o Relax requirements on limit changes.
o Describe the interaction between 100 and 104 responses. o Describe the interaction between 100 and 104 responses.
o Numerous editorial improvements. o Numerous editorial improvements.
A.7. Since draft-ietf-httpbis-resumable-upload-08 A.8. Since draft-ietf-httpbis-resumable-upload-08
o Clarify definitions of new header fields. o Clarify definitions of new header fields.
o Make handling of OPTIONS * optional. o Make handling of OPTIONS * optional.
o Require server to announce limits using Upload-Limit. o Require server to announce limits using Upload-Limit.
o Require clients to adhere to known limits. o Require clients to adhere to known limits.
o Rephrase requirements for concurrency handling, focusing on the o Rephrase requirements for concurrency handling, focusing on the
outcome. outcome.
o Remove requirement for 204 status code for DELETE responses. o Remove requirement for 204 status code for DELETE responses.
o Increase the draft interop version. o Increase the draft interop version.
o Add section about 104 status code. o Add section about 104 status code.
o Rephrase recommendation for sending information back to client. o Rephrase recommendation for sending information back to client.
A.8. Since draft-ietf-httpbis-resumable-upload-07 A.9. Since draft-ietf-httpbis-resumable-upload-07
o Clarify server handling when upload length is exceeded. o Clarify server handling when upload length is exceeded.
o Extend security considerations about upload resource URIs, o Extend security considerations about upload resource URIs,
representation metadata, and untrusted inputs. representation metadata, and untrusted inputs.
o Allow clients to retry for appropriate 4xx responses. o Allow clients to retry for appropriate 4xx responses.
A.9. Since draft-ietf-httpbis-resumable-upload-06 A.10. Since draft-ietf-httpbis-resumable-upload-06
o Minor editorial improvements to introduction and examples. o Minor editorial improvements to introduction and examples.
o Define structured types for new header fields. o Define structured types for new header fields.
A.10. Since draft-ietf-httpbis-resumable-upload-05 A.11. Since draft-ietf-httpbis-resumable-upload-05
o Increase the draft interop version. o Increase the draft interop version.
o Numerous editorial changes. o Numerous editorial changes.
o Rename "expires" limit to "max-age". o Rename "expires" limit to "max-age".
o Require "Upload-Complete", but not "Upload-Offset" or "Upload- o Require "Upload-Complete", but not "Upload-Offset" or "Upload-
Limit", for append responses. Limit", for append responses.
o Add problem type for inconsistent length values. o Add problem type for inconsistent length values.
o Reduce use of "file" in favor of "representation". o Reduce use of "file" in favor of "representation".
A.11. Since draft-ietf-httpbis-resumable-upload-04 A.12. Since draft-ietf-httpbis-resumable-upload-04
o Clarify implications of "Upload-Limit" header. o Clarify implications of "Upload-Limit" header.
o Allow client to fetch upload limits upfront via "OPTIONS". o Allow client to fetch upload limits upfront via "OPTIONS".
o Add guidance on upload creation strategy. o Add guidance on upload creation strategy.
o Add "Upload-Length" header to indicate length during creation. o Add "Upload-Length" header to indicate length during creation.
o Describe possible usage of "Want-Repr-Digest". o Describe possible usage of "Want-Repr-Digest".
A.12. Since draft-ietf-httpbis-resumable-upload-03 A.13. Since draft-ietf-httpbis-resumable-upload-03
o Add note about "Content-Location" for referring to subsequent o Add note about "Content-Location" for referring to subsequent
resources. resources.
o Require "application/partial-upload" for appending to uploads. o Require "application/partial-upload" for appending to uploads.
o Explain handling of content and transfer codings. o Explain handling of content and transfer codings.
o Add problem types for mismatching offsets and completed uploads. o Add problem types for mismatching offsets and completed uploads.
o Clarify that completed uploads must not be appended to. o Clarify that completed uploads must not be appended to.
o Describe interaction with Digest Fields from RFC9530. o Describe interaction with Digest Fields from RFC9530.
o Require that upload offset does not decrease over time. o Require that upload offset does not decrease over time.
o Add Upload-Limit header field. o Add Upload-Limit header field.
o Increase the draft interop version. o Increase the draft interop version.
A.13. Since draft-ietf-httpbis-resumable-upload-02 A.14. Since draft-ietf-httpbis-resumable-upload-02
o Add upload progress notifications via informational responses. o Add upload progress notifications via informational responses.
o Add security consideration regarding request filtering. o Add security consideration regarding request filtering.
o Explain the use of empty requests for creation uploads and o Explain the use of empty requests for creation uploads and
appending. appending.
o Extend security consideration to include resource exhaustion o Extend security consideration to include resource exhaustion
attacks. attacks.
o Allow 200 status codes for offset retrieval. o Allow 200 status codes for offset retrieval.
o Increase the draft interop version. o Increase the draft interop version.
A.14. Since draft-ietf-httpbis-resumable-upload-01 A.15. Since draft-ietf-httpbis-resumable-upload-01
o Replace Upload-Incomplete header with Upload-Complete. o Replace Upload-Incomplete header with Upload-Complete.
o Replace terminology about procedures with HTTP resources. o Replace terminology about procedures with HTTP resources.
o Increase the draft interop version. o Increase the draft interop version.
A.15. Since draft-ietf-httpbis-resumable-upload-00 A.16. Since draft-ietf-httpbis-resumable-upload-00
o Remove Upload-Token and instead use Server-generated upload URL o Remove Upload-Token and instead use Server-generated upload URL
for upload identification. for upload identification.
o Require the Upload-Incomplete header field in Upload Creation o Require the Upload-Incomplete header field in Upload Creation
Procedure. Procedure.
o Increase the draft interop version. o Increase the draft interop version.
A.16. Since draft-tus-httpbis-resumable-uploads-protocol-02 A.17. Since draft-tus-httpbis-resumable-uploads-protocol-02
None None
A.17. Since draft-tus-httpbis-resumable-uploads-protocol-01 A.18. Since draft-tus-httpbis-resumable-uploads-protocol-01
o Clarifying backtracking and preventing skipping ahead during the o Clarifying backtracking and preventing skipping ahead during the
Offset Receiving Procedure. Offset Receiving Procedure.
o Clients auto-retry 404 is no longer allowed. o Clients auto-retry 404 is no longer allowed.
A.18. Since draft-tus-httpbis-resumable-uploads-protocol-00 A.19. Since draft-tus-httpbis-resumable-uploads-protocol-00
o Split the Upload Transfer Procedure into the Upload Creation o Split the Upload Transfer Procedure into the Upload Creation
Procedure and the Upload Appending Procedure. Procedure and the Upload Appending Procedure.
Appendix B. Draft Version Identification Appendix B. Draft Version Identification
This section is to be removed before publishing as an RFC. This section is to be removed before publishing as an RFC.
To assist the development of implementations and interoperability To assist the development of implementations and interoperability
testing while this document is still a draft, an interop version is testing while this document is still a draft, an interop version is
 End of changes. 19 change blocks. 
36 lines changed or deleted 41 lines changed or added

This html diff was produced by rfcdiff 1.48. The latest version is available from http://tools.ietf.org/tools/rfcdiff/