The set operation sets the various metadata fields of the specified resource.
The set operation requires a message that consists of a single SetRequest element.
Examples
URL Encoded:
uri=http://www.zelestra.com/images/kangaroos.jpg&name=Kangaroos
XML:
<SetRequest>
<URI>http://www.zelestra.com/images/kangaroos.jpg</URI>
<Name>Kangaroos</Name>
</SetRequest>
The SetRequest element MUST contain a URI element, which is the resource's URI. Maximum length is 1023 characters.
The SetRequest element MAY contain a Name element, which is the resource name. Maximum length is 255 characters.
The SetRequest element MAY contain a Category element, which is the resource category. Maximum length is 31 characters.
The SetRequest element MAY contain a Description element, which is the resource description. Maximum length is 8191 characters.
The SetRequest element MAY contain a HomePage element, which is the resource home page URL. Maximum length is 1023 characters.
The SetRequest element MAY contain one or more Add elements, which are used to add specific metadata information (see below).
The SetRequest element MAY contain one or more Remove elements, which are used to remove specific metadata information (see below).
The Add and Remove elements may be formatted as two, three, or four comma separated fields as follows:
Within the Add element, the scheme and locale may be empty strings, predicate and value may not be empty strings. An empty or missing scheme field indicates a blank scheme. An empty or missing locale field indicates the default local.
Within the Remove element, all fields may be empty strings. An empty predicate field indicates all predicates. An empty or missing scheme field indicates a blank scheme. An empty or missing locale field indicates the default local. An empty value field indicates all values. Therefore a single comma indicates removal of all metadata for the resource.
Predicates and Schemes are formatted as XML qualified names. Locales follow RFC1766 language designations.
The metadata for the specified resource is updated. All Remove actions take place before any Add actions.
The set operation does not return any data.
The set operation may return a badRequest fault if any of the request parameters are invalid.
The set operation may return a forbidden fault if the requestor does not have the appropriate permission.
The set operation may return an unauthorized fault if the requestor has not previously authenticated.
The set operation may return an operationFailed fault if the service was unable to otherwise fulfill the request.