You use the Skyline Insights APIs to consume Skyline Findings and manage your infrastructures more efficiently.

Using the Skyline Insights APIs, you can get the following:

  • Active Findings (Max Limit per page is 200)

  • Findings with Affected Objects for a given finding (Max Limit per page is 200)

Prerequisites

Verify that you have an active access token. See Getting Your Authentication Token.

Procedure

  1. Open the https://skyline.vmware.com/public/api/docs URL in the browser.
  2. Click Docs on top right of the screen.

  3. Click Execute Query.
  4. Execute the following POST request to view the active findings:
    curl -s -X POST 'https://skyline.vmware.com/public/api/data' \
    -H "Authorization: Bearer $TOKEN" \
    -H 'Content-Type: application/json' \
    -d '{"query":
      "{
        activeFindings(limit: 200)
            {
            findings {
                findingId
                accountId
                findingDisplayName
                severity
                findingDescription
                findingImpact 
                recommendations 
                kbLinkURLs 
                recommendationsVCF 
                kbLinkURLsVCF 
                categoryName 
                findingTypes 
                firstObserved 
                totalAffectedObjects 
                } 
            totalRecords
            timeTaken
         }
      }"
    }' | jq .


    Expected Response:

  5. Execute the following POST request to view the findings with affected objects for RuleID.
    curl -s -X POST 'https://skyline.vmware.com/public/api/data' \
    -H "Authorization: Bearer $TOKEN" \
    -H 'Content-Type: application/json' \
    -d '
    {"query":
      "{
      activeFindings(
          filter: {
            findingId: "Horizon-enableDMA-KB#2144475",
            product: "brm-prod-vc.brmstorage.com",
          }
          limit: 200) {
        findings {
          findingId
          accountId
          products
          findingDisplayName
          severity
          findingDescription
          findingImpact
          recommendations
          kbLinkURLs
          recommendationsVCF
          kbLinkURLsVCF
          categoryName
          findingTypes
          firstObserved
          totalAffectedObjectsCount
          affectedObjects(start: 0, limit: 200)  {
              sourceName
              objectName
              objectType
              version
              buildNumber
              solutionTags {
                type
                version
              }
              firstObserved
            }
        }
        totalRecords
        timeTaken
      }
    }"
    }' | jq .


    Expected Output: