API Explorer retrieves the VMware Skyline Health Diagnostics REST APIs from a selected endpoint to give you information and context around API calls. The API documentation is hosted on the swagger client which can be accessed from VMware Skyline Health Diagnostics client or accessing the direct link https://<vm_ip>/api/apischema/swagger.

As an operator, you might want to explore and use VMware Skyline Health Diagnostics REST APIs for various reasons. Support for below schemas are available now:

  1. Authentication: For authentication & authorization by using login credentials.

  2. Offline Analysis: Log bundle from local or remote server can be uploaded for analysis.

  3. SHD Management: Details about presently deployed configurations of SHD.

  4. Tasks: Monitor and view analysis status by using this API.

  5. Workflow Reports: Download the HTML analysis report (x-gzip and Base64 encoded).

  6. Workflow Summary: Analysis details in JSON format.

Prerequisites

You should have valid login credentials for VMware Skyline Health Diagnostics.

Procedure

  1. Log in to the VMware Skyline Health Diagnostics UI using the supported browser.
  2. In the top-menu, click User Menu > API Explorer to explore the available REST APIs from swagger interface

    You should be redirected to VMware Skyline Health Diagnostics, swagger documentation link.

    The swagger API documentation can also be accessed from https://<vm_ip>/api/apischema/swagger



  3. Click POST under Authentication and Try out. Enter the username and password (base64 Encoded value) and click Execute.
  4. Copy the value of access_token from the response body, click Authorize button on top right of the page, enter the access_token value and click Authorize button.
  5. For performing authorization using access_token, please follow below steps:
    1. Copy the value of access_token from response body.
    2. Click Authorize button on top right of the page.
    3. Enter the access_token value and click Authorize button.
  6. Close the popup post successful validation of token.
  7. Explore and use APIs hosted on the page.

Results

As an operator, you can use the VMware Skyline Health Diagnostics APIs to perform operation automatically and you no manual steps to execute any operations.