Last updated on: 2023-05-25 08:49:13.

QKView Metadata

The QKView resource provides access to different aspects of an uploaded QKView, both to data originally contained within the QKView and to data that the iHealth servers generate upon receipt of a QKView, as well as available metadata about a QKView. There are methods to retrieve Diagnostic output, command output, individual files from within the QKView, metadata associated with the QKView, as well as configuration, licensing, hardware, and software details. All these methods use a common RESTful base address, and in addition, may have parameterized options.

Metadata

Associated with an uploaded QKView is various metadata that may be of interest, including the following data:
  • support entitlement data
  • credentials used to upload the QKView
  • upload timestamp
  • chassis serial number
  • GUI visibility
  • sharing status
  • F5 support case
  • non F5 case

This data is retrieved via a single method (verb: GET):
query:
curl -H"Authorization: Bearer {auth token}" -H"Accept: application/vnd.f5.ihealth.api" --user-agent "MyGreatiHealthClient"-o - https://ihealth2-api.f5.com/qkview-analyzer/api/qkviews/<qkview_id>

The following attributes are editable:
  • visible_in_gui
  • f5_support_case
  • description
  • share_with_case_owner

These may be changed using the following method (verb: POST), either with URL encoded URL parameters, or with form data in the POST body.
query:
curl -H"Authorization: Bearer {auth token}" -H"Accept: application/vnd.f5.ihealth.api" --user-agent "MyGreatiHealthClient" -o  —data ‘visible_in_gui=true&description=this%20is%20my%20description’- https://ihealth2-api.f5.com/qkview-analyzer/api/qkviews/<qkview_id>

Possible responses:
  • 200 OK, body contains metadata about qkview, including entitlement status, uploader name and e-mail and upload date
  • 202 ACCEPTED, body may contain reason for delay
  • 403 FORBIDDEN
  • 404 NOT FOUND
  • 406 Not Acceptable

If a 202 is received, then the caller should wait at least 10 seconds to allow processing to finish, and then try the request again.