Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 5.3

Update membership

Float
right
right
HTML Table
border0
bgcolor#FFF0F0
Table Row (tr)
Table Cell (td)
colspan2
Conventions
Table Row (tr)
Table Cell (td)
{text} :
Table Cell (td)
replace {text} with specific content
Table Row (tr)
Table Cell (td)
(root):
Table Cell (td)
WebService URL base
Table Row (tr)
Table Cell (td)
(type) :
Table Cell (td)
uwnetid | group | dns | eppn

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. |

     

    Code Block
    xml
    xml
    <!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.

    Code Block
      <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.