Summary:
Adds a new group to the specified Realm.
Request specification:
Name |
Min/Max |
Type |
Description |
|
|
|
|
|
|
|
|
|
|
The new group information. |
|
|
|
|
|
Returns:
OK/Error
Description:
The group name can be specified as a DN or as a plain name. If you specify a fully qualified distinguished name, the group will be created in the specified location in the directory tree. If you use a plain name, the group will be created using the specified name in the default container for this realm. To find out what the default DN is, use the get_realm
call.
Note: The call will try to create a new directory object of class Group
(objectClass=Group
). Your directory schema must have the Group
class in it or the call will fail.
Example:
Creating a new group named Test_Group
in the specified Realm. The group name is specified as a plain name so it will be created in the default container for this Realm.
Input
<packet version="4.0.0" id="2">
<target>authm</target>
<data>
<authm>
<add_group>
<group>
<name>VGVzdF9Hcm91cA==</name>
<realm>3e761571-6607-1344-a064-a42679da8ed9</realm>
<data>
<attr>
<name>description</name>
<value>VGhpcyBpcyBhIHRlc3QgZ3JvdXA=</value>
</attr>
</data>
</group>
</add_group>
</authm>
</data>
</packet>
Output
<?xml version="1.0" encoding="UTF-8"?><packet xmlns:ns1="http://www.swsoft.com/webservices/vzl/4.0.0/protocol" xmlns:ns2="http://www.swsoft.com/webservices/vzl/4.0.0/authm" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" id="9c469dcebft6784r4b4" time="2007-07-18T06:21:21+0000" priority="0" version="4.0.0">
<ns1:origin>authm</ns1:origin>
<ns1:target>vzclient4-2cbbe469-8f57-7f46-97fb-fd987231d957</ns1:target>
<ns1:dst>
<ns1:director>gend</ns1:director>
</ns1:dst>
<ns1:data>
<ns2:authm>
<ns1:ok/>
</ns2:authm>
</ns1:data>
<ns1:src>
<ns1:director>gend</ns1:director>
</ns1:src>
</packet>