The retrieve operation retrieves a clip list.
The retrieve operation requires a message that consists of a single RetrieveRequest element.
Examples
URL Encoded:
clipList=http://www.zelestra.com/ClipList.xml
XML:
<RetrieveRequest>
<ClipList>http://www.zelestra.com/ClipList.xml</ClipList>
</RetrieveRequest>
The RetrieveRequest element MUST contain a ClipList element, which is the URI of a clip list.
The specified clip list is retrieved and returned. Note that a clip list's URI is usually internally forwarded to this service to generate the clip list's definition document.
The retrieve operation returns a ClipListDefinition document.
The retrieve operation may return an badRequest fault if the request parameter is invalid.
The retrieve operation may return an forbidden fault if the requestor does not have the appropriate permission.
The retrieve operation may return an notFound fault if the specified clip list does not exist.
The retrieve operation may return an unauthorized fault if the requestor has not previously authenticated.
The retrieve operation may return an operationFailed fault if the service was unable to otherwise fulfill the request.