3.1.5.8 RefreshCache

Synopsis:

This method is called by the client to refresh the revision IDs it uses to reference its cache revisions when it initiates synchronization with a new server.

This protocol uses revision IDs to identify revisions. Because revision IDs are generated by each server, the client MUST invoked this method to update the revision ID identifiers for each revision in its cache whenever it changes servers. This method MUST only be called by the client in response to the server throwing a ServerChanged or InvalidCookie ErrorCode and it MUST be called in the sequence specified for the error in section 2.2.2.4.

Request Validation:

Parameter	Validation conditions	Error code
cookie	MUST be a valid cookie, issued by this server, that has not expired.	InvalidCookie, ServerChanged, or CookieExpired
globalIDs	MUST be present.	InvalidParameters

Results:

If no faults occur during the operation, the server MUST return a RefreshCacheResponse message to the client.

The response consists of an array of RefreshCacheResult elements. There MUST be one element for each GlobalID parameter for which an entry exists in the deployment table from that update to the client's target group. Each such element MUST contain:

RevisionID: The revision ID referenced by the entry in the deployment.

GlobalID: The GlobalID parameter.

IsLeaf: The IsLeaf element in the revision table referenced by the revision ID.

Deployment: The entry in the deployment table that specifies the revision ID and the client's TargetGroupName.