Previous Topic: Start a Lab by Using LISA InvokeNext Topic: Deploy a MAR to a Lab


Obtain Information About a Lab

You can use LISA Invoke to obtain basic information about a running lab. The syntax is as follows:

/lisa-invoke/getLab?labKey=LAB:key

The available lab keys are included in the response to the listRunnableLabs operation. For more information, see List the Available Labs.

The response is an XML document. The following information is provided:

If the lab is in the middle of starting, then some of the information is not available.

If the lab cannot be found, the response contains an error message.

 

Example

The following URL makes a request to obtain information about a lab whose key is VCD:50.

http://localhost:1505/lisa-invoke/getLab?labKey=VCD:50 

The following response contains the lab information.

<?xml version="1.0" encoding="UTF-8" ?>
<invokeResult>
  <method name="GetLab">
    <params />
  </method>
  <status>OK</status>
  <result>
    <lab name="MM-Test run by rich-50" key="VCD:50">
      <labMember name="Coordinator_1_50_16_15_3" serviceName="tcp://50.16.15.3:2011/Coordinator_1_50_16_15_3" ip="50.16.15.3" />
      <labMember name="Simulator_2_23_20_80_144" serviceName="tcp://23.20.80.144:2014/Simulator_2_23_20_80_144" ip="23.20.80.144" />
      <labMember name="Simulator_1_23_21_5_69" serviceName="tcp://23.21.5.69:2014/Simulator_1_23_21_5_69" ip="23.21.5.69" />
    </lab>
  </result>
</invokeResult>