PROPPATCH Method

Topic Last Modified: 2006-06-13

The WebDAV PROPPATCH method sets properties for the resource at the specified destination Uniform Resource Identifier (URI). All property names must be scoped in the XML body using namespace URI references.

When a PROPPATCH method or a BPROPPATCH Method request contains a Brief Header with a value of "t", every propstat XML Element with a status of 200 (OK) is omitted from the 207 (Multi-Status) response. If all operations on all resources are completed successfully, the 200 (OK) response may be returned instead of a 207 (Multi-Status) response.

The PROPPATCH method may be included in the scope of a transaction by submitting a Transaction Header with a lock token that corresponds to that transaction.

Note

See Authentication and Security Using WebDAV for more information.

The list of WebDAV Protocol Status Codes in the following table is not comprehensive. For information about 500-level status codes, see WebDAV Status Codes: 500s.

Status Codes

The following are response codes that can be expected to be used in a 207 (Multi-Status) response for this method.

Status Code Meaning

200 (OK)

The command succeeded.

403 (Forbidden)

The client is unable to alter one of the properties.

409 (Conflict)

The client has provided an inappropriate value for this property. For example, the client tried to set a read-only property.

423 (Locked)

The destination resource is locked.

507 (Insufficient Storage)

The server did not have enough storage space to record the property.

Examples

The following example illustrates a WebDAV PROPPATCH method.

Request

PROPPATCH /docs/myfile.doc HTTP/1.1
Host: www.contoso.com
Content-Type: text/xml
Content-Length: XXX
Translate: F

<?xml version="1.0"?>
<d:propertyupdate xmlns:d="DAV:" xmlns:o="urn:schemas-microsoft-com:office:office">
  <d:set>
    <d:prop>
      <o:Author>Douglas Groncki</o:Author>
    </d:prop>
  </d:set>
</d:propertyupdate>

Response

HTTP/1.1 207 Multi-Status
Server: Microsoft-IIS/5.0
Date: Wed, 04 Aug 1999 21:52:58 GMT
Content-Type: text/xml
Content-Length: 310

<?xml version="1.0"?>
<a:multistatus xmlns:b="urn:schemas-microsoft-com:office:office" xmlns:a="DAV:">
  <a:response>
    <a:href>https://www.contoso.com/docs/myfile.doc</a:href>
    <a:propstat>
      <a:status>HTTP/1.1 200 OK</a:status>
        <a:prop>
          <b:Author/>
        </a:prop>
    </a:propstat>
  </a:response>
</a:multistatus>