repl-uid

Topic Last Modified: 2006-06-12

A repl-uid is a universally unique identifier for a resource. The repl-uid Field can be obtained from a resource using the PROPFIND Method or the SEARCH Method.

If a resource is deleted and another resource is created in the same location, each resource would have the same URL but different values for the repl-uid Field. The difference in the repl-uid Field values on each resource would assist the client in determining that each resource is, in fact, different.

If a resource was moved from one collection to another collection, the value for the repl-uid Field would remain the same but the URL for the resource would change. In this case, the client might want to avoid downloading the resource again because only the location has changed but not the contents of the resource. In this case, the client could use the repl-uid Field to detect that a move operation had ocurred.

Deletes might not have valid URL identifiers but they must have a valid repl-uid.

A client can include the repl-uid identifier in the request header if its intention is to ensure that it is dealing with the exact same resource that it was previously. However, note that the server can change the repl-uid Field on a resource if the resource is moved.