Get a list of services
Use the HTTP method
GET
to obtain a list of the IBM® z/OS® Connect services installed in the run
time.
- HTTP method
- GET
- URI
- /zosConnect/services
- Description
- Gets a list of the IBM z/OS Connect services installed in the runtime, including some basic information. Services are included in the list whether they are started or stopped.
- Security
- Users with
Admin
,Operations
orReader
authority can get a list of services, users withInvoke
authority cannot. For more information about user authorization, see Overview of IBM z/OS Connect security.Note: A user must be a member of a global group to be able to see a list of services. If individual services have also configured the authorization interceptor explicitly with theinterceptorsRef
attribute of theservice
orzosConnectService
element, and defined service scope groups, then the list of installed services returned will be restricted to those for which the authenticated user ID is a member of both a global and a service scope Admin, Operations or Reader group - Response body
-
{ "zosConnectServices": [ { "ServiceName": "<service name>", "ServiceDescription": "<service description>", "ServiceProvider": "<service provider>", "ServiceURL": "<service URL>" }, ... (repeats) ] }
- Example response body
-
{ "zosConnectServices": [ { "ServiceName": "recordOpsCreate", "ServiceDescription": "Creates a new record", "ServiceProvider": "SAMPLE-1.0", "ServiceURL": "https://host:port/zosConnect/services/recordOpsCreate" }, { "ServiceName": "recordOpsDelete", "ServiceDescription": "Deletes an existing record", "ServiceProvider": "SAMPLE-1.0", "ServiceURL": "https://host:port/zosConnect/services/recordOpsDelete" }, { "ServiceName": "patient", "ServiceDescription": "Patient lookup service", "ServiceProvider": "imsmobile-2.0", "ServiceURL": "https://host:port/zosConnect/services/patientService" } ] }