Skip to end of metadata
Go to start of metadata

Update membership

Resource

  • PUT| (root)/group/{group_id}/member
  1. The group_id can be a group name (cn) or a regid.
  2. You must include an If-Match header.
  3. You may specify a wild-card header: If-Match: *

Upload data

  1. This is similar to the response of Get Membership.
  2. Content of the response contains one class "group" with one class "members".
  3. Other html is for browser formatting.
  4. Within the class "members" there is one "member" for each member.
  5. 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.