Web service applications use the HTTPS protocol to establish connections to the Orchestrator server through simple object access protocol (SOAP) binding.

Before you begin

  • Verify that you have generated the Orchestrator Web service client and server stubs from the Orchestrator WSDL definition.

  • Verify that you have created a Web service client application class that implements the VSOWebControl interface.

Procedure

  1. In your Web service client application class, create a VSOWebControl instance that connects to the Web service endpoint.

    The default HTTPS port is 8281. The URL is also a default.

    The following example shows how to create a connection to the Web service.

    String urlprefix = "https://10.0.0.1:8281/vco" ;
    URL url = new URL(urlprefix + "/vmware-vmo-webcontrol/webservice");
    vsoWebControl = new VSOWebControlServiceLocator().getwebservice(url);
  2. Check the server connections by calling the echo operation.

    The following example shows how you can call the echo operation.

    vsoWebControl.echo(string);

    The call to the echo operation returns the String object that you provided as an argument.

  3. (Optional) : To check which plug-ins are running on the Orchestrator server, call the getAllPlugins operation.

    The following example shows how you can call the getAllPlugins operation.

    ModuleInfo[] modules = vsoWebControl.getAllPlugins(username, password);

    The preceding call to the getAllPlugins operation returns an array of ModuleInfo objects, each of which contains the name and version information about a plug-in running in the Orchestrator server.

Results

You created a connection to the Orchestrator Web service, verified the connection, and established what technologies plug in to the Orchestrator server.

What to do next

Find objects in the Orchestrator server through the Web service connection.