Previous page

Next page

Locate page in Contents

Print this page

get_env_by_sample

Summary:

Retrieves a list of nodes in a Virtuozzo group that are compatible with the specified sample configuration.

Request specification:

Name

Min/Max

Type

Description

get_env_by_sample

 

 

 

{

 

 

 

sample_id

0..[]

string

Sample configuration ID.

}

 

 

 

Returns:

Name

Min/Max

Type

Description

sample_env_list

0..[]

 

A list of sample_id/Server ID pairs. Each pair identifies a sample configuration and a server that is compatible with it. The list may contain multiple occurrences of the same sample IDs, as well as multiple occurrences of the same Server IDs.

{

 

 

 

sample_id

1..1

string

Sample configuration ID.

eid_list

1..1

eid_listType

Server ID.

}

 

 

 

Description:

Use this call when you have a sample configuration somewhere in a Virtuozzo group and would like to find out which nodes in the group can host Virtuozzo Containres based on this configuration. Every sample configuration is designed with a particular type of the host machine in mind and considers the operating system type, the CPU architecture, and other characteristics of the machine. Therefore, you need to know if a sample configuration is compatible with a designated host machine before you can create Virtuozzo Containers based on it. You may specify multiple sample configuration IDs in the call.

Example:

Input

<packet version="4.0.0">

<target>env_samplem</target>

<data>

<env_samplem>

<get_env_by_sample>

<sample_id>c897c4ff-e40b-41fe-8bbd-7bc62d2c1ab9</sample_id>

</get_env_by_sample>

</env_samplem>

</data>

</packet>

Output

<ns1:packet xmlns:ns1="http://www.swsoft.com/webservices/vzl/4.0.0/protocol" xmlns:ns2="http://www.swsoft.com/webservices/vzl/4.0.0/env_samplem" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" id="10c45ed54d0tbb3r274" time="2007-03-06T09:23:01+0000" priority="0" version="4.0.0">

<ns1:origin>env_samplem</ns1:origin>

<ns1:target>vzclient5</ns1:target>

<ns1:dst>

<ns1:director>gend</ns1:director>

</ns1:dst>

<ns1:data>

<ns2:env_samplem>

<ns2:sample_env_list>

<ns2:sample_id>c897c4ff-e40b-41fe-8bbd-7bc62d2c1ab9</ns2:sample_id>

<ns2:eid_list>

<ns2:eid>565b96bd-d2da-4c7e-a212-0943a4bd6b29</ns2:eid>

</ns2:eid_list>

</ns2:sample_env_list>

</ns2:env_samplem>

</ns1:data>

<ns1:src>

<ns1:director>gend</ns1:director>

</ns1:src>

</ns1:packet>

Please send us your feedback on this help page