View Source

Update membership

Conventions

{text} :

replace {text} with specific content

(root):

WebService URL base

(type) :

uwnetid | group | dns | eppn

Resource

PUT| (root)/group/{group_id}/member

The group_id can be a group name (cn) or a regid.
You must include an If-Match header.
You may specify a wild-card header: If-Match: *

Upload data

This is similar to the response of Get Membership.
Content of the response contains one class "group" with one class "members".
Other html is for browser formatting.
Within the class "members" there is one "member" for each member.

Each "member" must include a "type" attribute. |

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
  "http://www.w3.org/TR/xhtml11/DTD/xhtml11/dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
<head>
 <meta http-equiv="Content-Type" content="application/xhtml+xml; charset=utf-8"/>
</head>
<body>
  <div class="group">
    Regid: <span class="regid">{regid}</span>
    <br/>
   <ul class="members">
     <li>
       <a rel="memberlink" class="member" type="{type}"
          href="(root)/group/{regid}/member/{member_id}">{member_id}</a>
     </li>
     <!-- Additional (li) for each member -->
</body>
</html>

Return

200	Status only, plus ETag header. Group membership is not returned.
400	Invalid upload xhtml
401	No authorization
404	Group not found
409	Incorrect If-Match data
412	Missing If-Match header

Notes

The response will be 404 only if the group is not found. If one or more members are not found, or if they are not in the dependency group, the response will be 200 and a class="notfoundmembers"element will be included, containing one "notfoundmember" element for each bogus member.
<span class="notfoundmembers"> <span class="notfoundmember">member_id</span> ... </span>
The response always includes an ETag header, which can be used on subsequent GETs and must be used on subsequent updates or deletes.