The Lookup Service maintains a registration list of all services in the virtual environment. You can use the Lookup Service to retrieve registration information for every service by setting a registration filter that you pass to the List() function on the Lookup Service. The functions and objects that you can use with the Lookup Service are defined in the lookup.wsdl file that is part of the SDK.

Lookup Service Registration Filters

You can query for service endpoints through a service registration object that you obtain from the Lookup Service. You invoke theList() function on the Lookup Service to list the endpoints that you need by passing LookupServiceRegistrationFilter . LookupServiceRegistrationFilter identifies the service and the endpoint type that you can retrieve.

Optionally, you can include the node ID parameter in the filter that identifies the vCenter Server instance where the endpoint is hosted. When the node ID is omitted, the List() function returns the endpoint URLs of the service that are hosted on all vCenter Server instances in the environment.

For example, a LookupServiceRegistrationFilter for queering the vCloud Suite service has these service endpoint elements.

Service Registration Filter Parameters

Filter Types

Value

Description

LookupServiceRegistrationServiceType

product=

"com.vmware.cis"

vCloud Suite namespace.

type=

"cs.vapi"

Identifies the vCloud Suite service.

LookupServiceRegistrationEndpointType

type=

"com.vmware.vapi.endpoint"

Specifies the endpoint path for the service.

protocol=

"vapi.json.https.public"

Identifies the protocol that will be used for communication with the endpoint .

For information about the filter parameter of the available predefined service endpoints, see Filter Parameters for Predefined Service Endpoints.