0 out of 1 rated this helpful - Rate this topic

Use ETag values through the REST service to get document list item versioning

apps for SharePoint

Learn how to use HTML ETags with the SharePoint REST service for concurrency control of SharePoint lists and list items.

Last modified: July 15, 2013

Applies to: apps for SharePoint | SharePoint Server 2013

The SharePoint REST service, which follows the OData standard, uses HTML ETags for concurrency control of SharePoint lists and list items. To check on an item’s version when you perform a PUT, MERGE, or DELETE request, specify an ETag in the If-Match HTTP request header.

If the ETag you specify in your request does not match the ETag of the document or list item on the server, the REST service returns a 412 exception, per the OData specification.

  • To force an overwrite of the item regardless of version, set the ETag value to "*".

  • If you do not specify an ETag, SharePoint overwrites the item regardless of version.

Within SharePoint, ETags apply only to SharePoint lists and list items.

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.