source: draft-ietf-httpbis-method-registrations/09/draft-ietf-httpbis-method-registrations-09.txt

Last change on this file was 1812, checked in by julian.reschke@…, 8 years ago

-09

  • Property svn:eol-style set to native
  • Property svn:executable set to *
File size: 13.2 KB
Line 
1
2
3
4HTTPbis Working Group                                         J. Reschke
5Internet-Draft                                                greenbytes
6Intended status: Informational                             July 16, 2012
7Expires: January 17, 2013
8
9
10    Initial Hypertext Transfer Protocol (HTTP) Method Registrations
11               draft-ietf-httpbis-method-registrations-09
12
13Abstract
14
15   This document registers those Hypertext Transfer Protocol (HTTP)
16   methods which have been defined in standards-track RFCs before the
17   IANA HTTP Method Registry was established.
18
19Editorial Note (To be removed by RFC Editor)
20
21   Discussion of this draft takes place on the HTTPBIS working group
22   mailing list (ietf-http-wg@w3.org), which is archived at
23   <http://lists.w3.org/Archives/Public/ietf-http-wg/>.
24
25   The current issues list is at <http://trac.tools.ietf.org/wg/httpbis/
26   trac/query?component=method-registrations> and related documents
27   (including fancy diffs) can be found at
28   <http://tools.ietf.org/wg/httpbis/>.
29
30   The changes in this draft are summarized in Appendix B.9.
31
32Status of This Memo
33
34   This Internet-Draft is submitted in full conformance with the
35   provisions of BCP 78 and BCP 79.
36
37   Internet-Drafts are working documents of the Internet Engineering
38   Task Force (IETF).  Note that other groups may also distribute
39   working documents as Internet-Drafts.  The list of current Internet-
40   Drafts is at http://datatracker.ietf.org/drafts/current/.
41
42   Internet-Drafts are draft documents valid for a maximum of six months
43   and may be updated, replaced, or obsoleted by other documents at any
44   time.  It is inappropriate to use Internet-Drafts as reference
45   material or to cite them other than as "work in progress."
46
47   This Internet-Draft will expire on January 17, 2013.
48
49Copyright Notice
50
51   Copyright (c) 2012 IETF Trust and the persons identified as the
52
53
54
55Reschke                 Expires January 17, 2013                [Page 1]
56
57Internet-Draft          HTTP Method Registrations              July 2012
58
59
60   document authors.  All rights reserved.
61
62   This document is subject to BCP 78 and the IETF Trust's Legal
63   Provisions Relating to IETF Documents
64   (http://trustee.ietf.org/license-info) in effect on the date of
65   publication of this document.  Please review these documents
66   carefully, as they describe your rights and restrictions with respect
67   to this document.  Code Components extracted from this document must
68   include Simplified BSD License text as described in Section 4.e of
69   the Trust Legal Provisions and are provided without warranty as
70   described in the Simplified BSD License.
71
72Table of Contents
73
74   1.  Introduction  . . . . . . . . . . . . . . . . . . . . . . . . . 3
75   2.  Security Considerations . . . . . . . . . . . . . . . . . . . . 3
76   3.  IANA Considerations . . . . . . . . . . . . . . . . . . . . . . 3
77   4.  Normative References  . . . . . . . . . . . . . . . . . . . . . 3
78   Appendix A.  Initial Registry Contents  . . . . . . . . . . . . . . 5
79   Appendix B.  Change Log (to be removed by RFC Editor before
80                publication) . . . . . . . . . . . . . . . . . . . . . 5
81     B.1.  Since draft-ietf-httpbis-method-registrations-00  . . . . . 6
82     B.2.  Since draft-ietf-httpbis-method-registrations-01  . . . . . 6
83     B.3.  Since draft-ietf-httpbis-method-registrations-02  . . . . . 6
84     B.4.  Since draft-ietf-httpbis-method-registrations-03  . . . . . 6
85     B.5.  Since draft-ietf-httpbis-method-registrations-04  . . . . . 6
86     B.6.  Since draft-ietf-httpbis-method-registrations-05  . . . . . 6
87     B.7.  Since draft-ietf-httpbis-method-registrations-06  . . . . . 6
88     B.8.  Since draft-ietf-httpbis-method-registrations-07  . . . . . 6
89     B.9.  Since draft-ietf-httpbis-method-registrations-08  . . . . . 6
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111Reschke                 Expires January 17, 2013                [Page 2]
112
113Internet-Draft          HTTP Method Registrations              July 2012
114
115
1161.  Introduction
117
118   This document registers those Hypertext Transfer Protocol (HTTP)
119   methods which have been defined in standards-track RFCs other than
120   [draft-ietf-httpbis-p2-semantics] before the IANA HTTP Method
121   Registry was established.
122
1232.  Security Considerations
124
125   There are no security considerations related to the registration
126   itself.
127
1283.  IANA Considerations
129
130   Appendix A provides initial registrations of HTTP method names for
131   the IANA HTTP Method registry at
132   <http://www.iana.org/assignments/http-methods> (see Section 2.2 of
133   [draft-ietf-httpbis-p2-semantics]).
134
1354.  Normative References
136
137   [RFC2068]                          Fielding, R., Gettys, J., Mogul,
138                                      J., Nielsen, H., and T. Berners-
139                                      Lee, "Hypertext Transfer Protocol
140                                      -- HTTP/1.1", RFC 2068,
141                                      January 1997.
142
143   [RFC3253]                          Clemm, G., Amsden, J., Ellison,
144                                      T., Kaler, C., and J. Whitehead,
145                                      "Versioning Extensions to WebDAV
146                                      (Web Distributed Authoring and
147                                      Versioning)", RFC 3253,
148                                      March 2002.
149
150   [RFC3648]                          Whitehead, J. and J. Reschke, Ed.,
151                                      "Web Distributed Authoring and
152                                      Versioning (WebDAV) Ordered
153                                      Collections Protocol", RFC 3648,
154                                      December 2003.
155
156   [RFC3744]                          Clemm, G., Reschke, J., Sedlar,
157                                      E., and J. Whitehead, "Web
158                                      Distributed Authoring and
159                                      Versioning (WebDAV) Access Control
160                                      Protocol", RFC 3744, May 2004.
161
162   [RFC4437]                          Whitehead, J., Clemm, G., and J.
163                                      Reschke, Ed., "Web Distributed
164
165
166
167Reschke                 Expires January 17, 2013                [Page 3]
168
169Internet-Draft          HTTP Method Registrations              July 2012
170
171
172                                      Authoring and Versioning (WebDAV)
173                                      Redirect Reference Resources",
174                                      RFC 4437, March 2006.
175
176   [RFC4791]                          Daboo, C., Desruisseaux, B., and
177                                      L. Dusseault, "Calendaring
178                                      Extensions to WebDAV (CalDAV)",
179                                      RFC 4791, March 2007.
180
181   [RFC4918]                          Dusseault, L., Ed., "HTTP
182                                      Extensions for Web Distributed
183                                      Authoring and Versioning
184                                      (WebDAV)", RFC 4918, June 2007.
185
186   [RFC5323]                          Reschke, J., Ed., Reddy, S.,
187                                      Davis, J., and A. Babich, "Web
188                                      Distributed Authoring and
189                                      Versioning (WebDAV) SEARCH",
190                                      RFC 5323, November 2008.
191
192   [RFC5789]                          Dusseault, L. and J. Snell, "PATCH
193                                      Method for HTTP", RFC 5789,
194                                      March 2010.
195
196   [RFC5842]                          Clemm, G., Crawford, J., Reschke,
197                                      J., Ed., and J. Whitehead,
198                                      "Binding Extensions to Web
199                                      Distributed Authoring and
200                                      Versioning (WebDAV)", RFC 5842,
201                                      April 2010.
202
203   [draft-ietf-httpbis-p2-semantics]  Fielding, R., Ed., Lafon, Y., Ed.,
204                                      and J. Reschke, Ed., "HTTP/1.1,
205                                      part 2: Semantics and Payloads",
206                                      draft-ietf-httpbis-p2-semantics-20
207                                      (work in progress), July 2012.
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223Reschke                 Expires January 17, 2013                [Page 4]
224
225Internet-Draft          HTTP Method Registrations              July 2012
226
227
228Appendix A.  Initial Registry Contents
229
230   +-------------------+------+------------+---------------------------+
231   | Method Name       | Safe | Idempotent | Reference                 |
232   +-------------------+------+------------+---------------------------+
233   | ACL               | no   | yes        | [RFC3744], Section 8.1    |
234   | BASELINE-CONTROL  | no   | yes        | [RFC3253], Section 12.6   |
235   | BIND              | no   | yes        | [RFC5842], Section 4      |
236   | CHECKIN           | no   | yes        | [RFC3253], Section 4.4    |
237   |                   |      |            | and [RFC3253], Section    |
238   |                   |      |            | 9.4                       |
239   | CHECKOUT          | no   | yes        | [RFC3253], Section 4.3    |
240   |                   |      |            | and [RFC3253], Section    |
241   |                   |      |            | 8.8                       |
242   | COPY              | no   | yes        | [RFC4918], Section 9.8    |
243   | LABEL             | no   | yes        | [RFC3253], Section 8.2    |
244   | LINK              | no   |            | [RFC2068], Section        |
245   |                   |      |            | 19.6.1.2                  |
246   | LOCK              | no   | no         | [RFC4918], Section 9.10   |
247   | MERGE             | no   | yes        | [RFC3253], Section 11.2   |
248   | MKACTIVITY        | no   | yes        | [RFC3253], Section 13.5   |
249   | MKCALENDAR        | no   | yes        | [RFC4791], Section 5.3.1  |
250   | MKCOL             | no   | yes        | [RFC4918], Section 9.3    |
251   | MKREDIRECTREF     | no   | yes        | [RFC4437], Section 6      |
252   | MKWORKSPACE       | no   | yes        | [RFC3253], Section 6.3    |
253   | MOVE              | no   | yes        | [RFC4918], Section 9.9    |
254   | ORDERPATCH        | no   | yes        | [RFC3648], Section 7      |
255   | PATCH             | no   | no         | [RFC5789], Section 2      |
256   | PROPFIND          | yes  | yes        | [RFC4918], Section 9.1    |
257   | PROPPATCH         | no   | yes        | [RFC4918], Section 9.2    |
258   | REBIND            | no   | yes        | [RFC5842], Section 6      |
259   | REPORT            | yes  | yes        | [RFC3253], Section 3.6    |
260   | SEARCH            | yes  | yes        | [RFC5323], Section 2      |
261   | UNBIND            | no   | yes        | [RFC5842], Section 5      |
262   | UNCHECKOUT        | no   | yes        | [RFC3253], Section 4.5    |
263   | UNLINK            | no   |            | [RFC2068], Section        |
264   |                   |      |            | 19.6.1.3                  |
265   | UNLOCK            | no   | yes        | [RFC4918], Section 9.11   |
266   | UPDATE            | no   | yes        | [RFC3253], Section 7.1    |
267   | UPDATEREDIRECTREF | no   | yes        | [RFC4437], Section 7      |
268   | VERSION-CONTROL   | no   | yes        | [RFC3253], Section 3.5    |
269   +-------------------+------+------------+---------------------------+
270
271Appendix B.  Change Log (to be removed by RFC Editor before publication)
272
273
274
275
276
277
278
279Reschke                 Expires January 17, 2013                [Page 5]
280
281Internet-Draft          HTTP Method Registrations              July 2012
282
283
284B.1.  Since draft-ietf-httpbis-method-registrations-00
285
286   Added SEARCH method (RFC 5323).
287
288B.2.  Since draft-ietf-httpbis-method-registrations-01
289
290   Update draft-ietf-httpbis-p2-semantics reference.
291
292B.3.  Since draft-ietf-httpbis-method-registrations-02
293
294   Update draft-ietf-httpbis-p2-semantics reference.  PATCH is now
295   defined in draft-dusseault-http-patch.  BIND, UNBIND and REBIND are
296   defined in draft-ietf-webdav-bind.  Drop the "updates
297   draft-ietf-httpbis-p2-semantics" clause.
298
299B.4.  Since draft-ietf-httpbis-method-registrations-03
300
301   draft-dusseault-http-patch was published as RFC 5789.
302   draft-ietf-webdav-bind was published as RFC 5842.  Fix typo in
303   MKACTIVITY entry.  Update draft-ietf-httpbis-p2-semantics reference.
304   Fix change log section titles.
305
306B.5.  Since draft-ietf-httpbis-method-registrations-04
307
308   Update draft-ietf-httpbis-p2-semantics reference.
309
310B.6.  Since draft-ietf-httpbis-method-registrations-05
311
312   Update draft-ietf-httpbis-p2-semantics reference.
313
314B.7.  Since draft-ietf-httpbis-method-registrations-06
315
316   Update draft-ietf-httpbis-p2-semantics reference.
317
318B.8.  Since draft-ietf-httpbis-method-registrations-07
319
320   Update draft-ietf-httpbis-p2-semantics reference.
321
322B.9.  Since draft-ietf-httpbis-method-registrations-08
323
324   Added itempotency information.  Update
325   draft-ietf-httpbis-p2-semantics reference.
326
327
328
329
330
331
332
333
334
335Reschke                 Expires January 17, 2013                [Page 6]
336
337Internet-Draft          HTTP Method Registrations              July 2012
338
339
340Author's Address
341
342   Julian F. Reschke
343   greenbytes GmbH
344   Hafenweg 16
345   Muenster, NW  48155
346   Germany
347
348   EMail: julian.reschke@greenbytes.de
349   URI:   http://greenbytes.de/tech/webdav/
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391Reschke                 Expires January 17, 2013                [Page 7]
392
Note: See TracBrowser for help on using the repository browser.