Previous page

Next page

Locate page in Contents

Print this page

add_group

Summary:

Adds a new group to the specified Realm.

Request specification:

Name

Min/Max

Type

Description

add_group

 

 

 

{

 

 

 

group

1..1

security_principalType

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>

Please send us your feedback on this help page