4.1.1 Authentication

To get a reference to this endpoint, use the getOvmWsUtilitiesEndpoint() method exposed through the OvmWsApi endpoint. If retrieved in this way, login credentials are handed off such that the client using this new endpoint can access the Utilities API without the need to re-authenticate.

The getOvmWsUtilitiesEndpoint() method returns an Endpoint Reference. Use the facilities provided by your client library to follow the reference.

Note

Due to difficulties redefining endpoints according to WS-addressing in the Python Suds library, Python users should consider taking advantage of the REST interface if there is a requirement to access the Utilities API.

The following example method, taken from OvmWsSoapClient, shows how to use the getOvmWsUtilitiesEndpoint() method to access the Utilities API using Java:

@Override
  public OvmWsUtilitiesClient getWsUtilities() throws WsException, MalformedURLException
  {
    final OvmUtilities_Service utilitiesService =
            new OvmUtilities_Service(new URL
             (protocol + "://" + hostname + ":" + port + "/ovm/core/wsapi/soap/utilities"));
    final OvmUtilities utilityApi = 
            utilitiesService.getPort(api.getOvmWsUtilitiesEndpoint(), OvmUtilities.class);
    return new OvmWsUtilitiesSoapClient(utilityApi);
  }