One of the key features that was added to IBM Cloud Provisioning and Management PTFs (UI55996 and UI56001) in 2Q 2018 is the use of Swagger to document and present the associated REST APIs in an easily consumable format. With this addition, cloud architects can easily view the constructs of the Cloud Provisioning and Management REST APIs so that enabled z/OS subsystems can be incorporated into their cloud offering.
Swagger is pre-installed and enabled on the z/OSMF Liberty Server. In order to successfully access the Swagger UI, the user may need to configure additional security for z/OSMF. Refer to z/OSMF Programming Guide for details. Supplying the appropriate values for host name and port, use this address in a browser: â€śhttps://
APIs in the Swagger UI are organized based on the Cloud Provisioning and Management functions, such as the Published Software Catalog (PSC), Resource Management (RM), etc. Here is an example of the Swagger UI for the PSC:
The primary purpose of the Swagger UI is to display API documentation. This includes the model of the request body that the API expects, as well as the response body it will return upon completion. Swagger will show a description of each property defined by the API. Another function of the Swagger UI is its ability to drive the APIs. This greatly simplifies and speeds up development and testing. Here is an example of what the UI looks like to a user that is trying to submit a request.
Submitting an API request through the UI is very easy; just input any required information into the boxes, and then click the â€śTry it outâ€ť button. A real request will then be sent to the server, and the response will be displayed in the UI, as shown in this example:
The Swagger UI allows a cloud architect to easily view, interact with, and understand the constructs of the Cloud Provisioning and Management APIs, and can more easily incorporate z/OS into their cloud offering.