Summary:
Retrieves the list of the available Realms from the current Agent configuration.
Request specification:
Name |
Min/Max |
Type |
Description |
|
|
|
|
Returns:
Name |
Min/Max |
Type |
Description |
|
|
|
|
|
|
|
|
|
|
The list of the available realms. The appropriate data type will be used for a particular realm type (LDAP, System, etc.). See the subtypes of the |
|
|
|
|
|
Description:
Use this call to retrieve the list of realms to present to the user during login or any other operation requiring the realm ID as an input parameter. To get the list of realms during the initial login to the system, use the system/get_realm
call.
Example:
Input
<packet version="4.0.0">
<target>authm</target>
<data>
<authm>
<get_realm/>
</authm>
</data>
</packet>
Output
<?xml version="1.0" encoding="UTF-8"?><packet xmlns:ns4="http://www.swsoft.com/webservices/vzl/4.0.0/types" 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="33c469e34a3t1238r4b4" time="2007-07-18T11:02:59+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>
<ns2:realms>
<ns2:realm xsi:type="ns2:dir_realmType">
<ns2:login>
<ns2:name>Y249dnphZ2VudCxkYz1WWkw=</ns2:name>
<ns2:realm>3e761571-6607-1344-a064-a42679da8ed9</ns2:realm>
</ns2:login>
<ns4:builtin/>
<ns4:name>Virtuozzo Internal</ns4:name>
<ns4:type>1</ns4:type>
<ns4:id>3e761571-6607-1344-a064-a42679da8ed9</ns4:id>
<ns2:address>vzsveaddress</ns3:address>
<ns2:port>389</ns3:port>
<ns2:base_dn>dc=vzl</ns3:base_dn>
<ns2:default_dn>cn=users,dc=vzl</ns2:default_dn>
</ns2:realm>
<ns2:realm xsi:type="ns4:realmType">
<ns4:builtin/>
<ns4:name>System</ns4:name>
<ns4:type>0</ns4:type>
<ns4:id>00000000-0000-0000-0000-000000000000</ns4:id>
</ns2:realm>
<ns2:realm xsi:type="ns4:realmType">
<ns4:builtin/>
<ns4:name>Virtuozzo VE</ns4:name>
<ns4:type>1000</ns4:type>
<ns4:id>00000000-0000-0000-0100-000000000000</ns4:id>
</ns2:realm>
</ns2:realms>
</ns2:authm>
</ns1:data>
<ns1:src>
<ns1:director>gend</ns1:director>
</ns1:src>
</packet>