Previous page

Next page

Locate page in Contents

Print this page

get_realm

Summary:

Retrieves the list of the available Realms from the current Agent configuration.

Request specification:

Name

Min/Max

Type

Description

get_realm

1..1

 

 

Returns:

Name

Min/Max

Type

Description

realms

 

 

 

{

 

 

 

realm

1..[]

realmType

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 realmType type for the available realm types.

}

 

 

 

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>

Please send us your feedback on this help page