| 1 | |
|---|
| 2 | |
|---|
| 3 | |
|---|
| 4 | HTTPbis Working Group J. Reschke |
|---|
| 5 | Internet-Draft greenbytes |
|---|
| 6 | Intended status: Informational February 23, 2013 |
|---|
| 7 | Expires: August 27, 2013 |
|---|
| 8 | |
|---|
| 9 | |
|---|
| 10 | Initial Hypertext Transfer Protocol (HTTP) Method Registrations |
|---|
| 11 | draft-ietf-httpbis-method-registrations-11 |
|---|
| 12 | |
|---|
| 13 | Abstract |
|---|
| 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 | |
|---|
| 19 | Editorial 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.11. |
|---|
| 31 | |
|---|
| 32 | Status 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 August 27, 2013. |
|---|
| 48 | |
|---|
| 49 | Copyright Notice |
|---|
| 50 | |
|---|
| 51 | Copyright (c) 2013 IETF Trust and the persons identified as the |
|---|
| 52 | |
|---|
| 53 | |
|---|
| 54 | |
|---|
| 55 | Reschke Expires August 27, 2013 [Page 1] |
|---|
| 56 | |
|---|
| 57 | Internet-Draft HTTP Method Registrations February 2013 |
|---|
| 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 | |
|---|
| 72 | Table 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 | B.10. Since draft-ietf-httpbis-method-registrations-09 . . . . . 6 |
|---|
| 91 | B.11. Since draft-ietf-httpbis-method-registrations-10 . . . . . 7 |
|---|
| 92 | |
|---|
| 93 | |
|---|
| 94 | |
|---|
| 95 | |
|---|
| 96 | |
|---|
| 97 | |
|---|
| 98 | |
|---|
| 99 | |
|---|
| 100 | |
|---|
| 101 | |
|---|
| 102 | |
|---|
| 103 | |
|---|
| 104 | |
|---|
| 105 | |
|---|
| 106 | |
|---|
| 107 | |
|---|
| 108 | |
|---|
| 109 | |
|---|
| 110 | |
|---|
| 111 | Reschke Expires August 27, 2013 [Page 2] |
|---|
| 112 | |
|---|
| 113 | Internet-Draft HTTP Method Registrations February 2013 |
|---|
| 114 | |
|---|
| 115 | |
|---|
| 116 | 1. 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 | |
|---|
| 123 | 2. Security Considerations |
|---|
| 124 | |
|---|
| 125 | There are no security considerations related to the registration |
|---|
| 126 | itself. |
|---|
| 127 | |
|---|
| 128 | 3. 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 8.1 of |
|---|
| 133 | [draft-ietf-httpbis-p2-semantics]). |
|---|
| 134 | |
|---|
| 135 | 4. 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 | |
|---|
| 167 | Reschke Expires August 27, 2013 [Page 3] |
|---|
| 168 | |
|---|
| 169 | Internet-Draft HTTP Method Registrations February 2013 |
|---|
| 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. and J. Reschke, |
|---|
| 204 | Ed., "Hypertext Transfer Protocol |
|---|
| 205 | (HTTP/1.1): Semantics and |
|---|
| 206 | Content", |
|---|
| 207 | draft-ietf-httpbis-p2-semantics-22 |
|---|
| 208 | (work in progress), February 2013. |
|---|
| 209 | |
|---|
| 210 | |
|---|
| 211 | |
|---|
| 212 | |
|---|
| 213 | |
|---|
| 214 | |
|---|
| 215 | |
|---|
| 216 | |
|---|
| 217 | |
|---|
| 218 | |
|---|
| 219 | |
|---|
| 220 | |
|---|
| 221 | |
|---|
| 222 | |
|---|
| 223 | Reschke Expires August 27, 2013 [Page 4] |
|---|
| 224 | |
|---|
| 225 | Internet-Draft HTTP Method Registrations February 2013 |
|---|
| 226 | |
|---|
| 227 | |
|---|
| 228 | Appendix 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 | yes | [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 | yes | [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 | |
|---|
| 271 | Appendix B. Change Log (to be removed by RFC Editor before publication) |
|---|
| 272 | |
|---|
| 273 | |
|---|
| 274 | |
|---|
| 275 | |
|---|
| 276 | |
|---|
| 277 | |
|---|
| 278 | |
|---|
| 279 | Reschke Expires August 27, 2013 [Page 5] |
|---|
| 280 | |
|---|
| 281 | Internet-Draft HTTP Method Registrations February 2013 |
|---|
| 282 | |
|---|
| 283 | |
|---|
| 284 | B.1. Since draft-ietf-httpbis-method-registrations-00 |
|---|
| 285 | |
|---|
| 286 | Added SEARCH method (RFC 5323). |
|---|
| 287 | |
|---|
| 288 | B.2. Since draft-ietf-httpbis-method-registrations-01 |
|---|
| 289 | |
|---|
| 290 | Update draft-ietf-httpbis-p2-semantics reference. |
|---|
| 291 | |
|---|
| 292 | B.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 | |
|---|
| 299 | B.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 | |
|---|
| 306 | B.5. Since draft-ietf-httpbis-method-registrations-04 |
|---|
| 307 | |
|---|
| 308 | Update draft-ietf-httpbis-p2-semantics reference. |
|---|
| 309 | |
|---|
| 310 | B.6. Since draft-ietf-httpbis-method-registrations-05 |
|---|
| 311 | |
|---|
| 312 | Update draft-ietf-httpbis-p2-semantics reference. |
|---|
| 313 | |
|---|
| 314 | B.7. Since draft-ietf-httpbis-method-registrations-06 |
|---|
| 315 | |
|---|
| 316 | Update draft-ietf-httpbis-p2-semantics reference. |
|---|
| 317 | |
|---|
| 318 | B.8. Since draft-ietf-httpbis-method-registrations-07 |
|---|
| 319 | |
|---|
| 320 | Update draft-ietf-httpbis-p2-semantics reference. |
|---|
| 321 | |
|---|
| 322 | B.9. Since draft-ietf-httpbis-method-registrations-08 |
|---|
| 323 | |
|---|
| 324 | Added itempotency information. Update |
|---|
| 325 | draft-ietf-httpbis-p2-semantics reference. |
|---|
| 326 | |
|---|
| 327 | B.10. Since draft-ietf-httpbis-method-registrations-09 |
|---|
| 328 | |
|---|
| 329 | Closed issues: |
|---|
| 330 | |
|---|
| 331 | |
|---|
| 332 | |
|---|
| 333 | |
|---|
| 334 | |
|---|
| 335 | Reschke Expires August 27, 2013 [Page 6] |
|---|
| 336 | |
|---|
| 337 | Internet-Draft HTTP Method Registrations February 2013 |
|---|
| 338 | |
|---|
| 339 | |
|---|
| 340 | o <http://tools.ietf.org/wg/httpbis/trac/ticket/377>: "what is the |
|---|
| 341 | idempotency of LINK and UNLINK?" |
|---|
| 342 | |
|---|
| 343 | Update draft-ietf-httpbis-p2-semantics reference. |
|---|
| 344 | |
|---|
| 345 | B.11. Since draft-ietf-httpbis-method-registrations-10 |
|---|
| 346 | |
|---|
| 347 | Update draft-ietf-httpbis-p2-semantics reference. |
|---|
| 348 | |
|---|
| 349 | Author's Address |
|---|
| 350 | |
|---|
| 351 | Julian F. Reschke |
|---|
| 352 | greenbytes GmbH |
|---|
| 353 | Hafenweg 16 |
|---|
| 354 | Muenster, NW 48155 |
|---|
| 355 | Germany |
|---|
| 356 | |
|---|
| 357 | EMail: julian.reschke@greenbytes.de |
|---|
| 358 | URI: http://greenbytes.de/tech/webdav/ |
|---|
| 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 | |
|---|
| 391 | Reschke Expires August 27, 2013 [Page 7] |
|---|
| 392 | |
|---|
![(please configure the [header_logo] section in trac.ini)](https://www.ietf.org/images/ietflogotrans.gif)
