2015-11-06 22:55:41 +01:00
|
|
|
---
|
|
|
|
set: 2
|
|
|
|
code: 208
|
|
|
|
title: Already Reported
|
|
|
|
---
|
|
|
|
|
2015-11-07 06:31:20 +01:00
|
|
|
The 208 Already Reported status code can be used inside a DAV: propstat
|
2015-11-07 02:41:41 +01:00
|
|
|
response element to avoid enumerating the internal members of multiple bindings
|
2015-11-07 06:31:20 +01:00
|
|
|
to the same collection repeatedly.
|
|
|
|
|
|
|
|
For each binding to a collection inside the request's scope, only one will be
|
|
|
|
reported with a 200 status, while subsequent DAV:response elements for all other
|
|
|
|
bindings will use the 208 status, and no DAV:response elements for their
|
|
|
|
descendants are included.
|
2015-11-07 02:41:41 +01:00
|
|
|
|
|
|
|
Note that the 208 status will only occur for "Depth: infinity" requests, and
|
|
|
|
that it is of particular importance when the multiple collection bindings cause
|
2015-11-07 04:03:35 +01:00
|
|
|
a bind loop as discussed in [RFC5842 Section 2.2][2].
|
2015-11-07 02:41:41 +01:00
|
|
|
|
|
|
|
A client can request the DAV:resource-id property in a PROPFIND request to
|
|
|
|
guarantee that they can accurately reconstruct the binding structure of a
|
|
|
|
collection with multiple bindings to a single resource.
|
|
|
|
|
|
|
|
For backward compatibility with clients not aware of the 208 status code
|
|
|
|
appearing in multistatus response bodies, it SHOULD NOT be used unless the
|
|
|
|
client has signaled support for this specification using the "DAV" request
|
2015-11-07 04:03:35 +01:00
|
|
|
header (see [RFC5842Section 8.2][3]). Instead, a 508 status should be
|
2015-11-07 02:41:41 +01:00
|
|
|
returned when a binding loop is discovered. This allows the server to return the
|
|
|
|
508 as the top-level return status, if it discovers it before it started the
|
|
|
|
response, or in the middle of a multistatus, if it discovers it in the middle of
|
|
|
|
streaming out a multistatus response.
|
|
|
|
|
2015-11-07 04:03:35 +01:00
|
|
|
Source: [RFC5842 Section 7.1][1]
|
2015-11-07 02:41:41 +01:00
|
|
|
|
2015-11-07 04:03:35 +01:00
|
|
|
[1]: <http://tools.ietf.org/html/rfc5842#section-7.1>
|
|
|
|
[2]: <http://tools.ietf.org/html/rfc5842#section-2.2>
|
|
|
|
[3]: <http://tools.ietf.org/html/rfc5842#section-8.2>
|