Missing Parameters when querying api.openshift.com

Solution In Progress - Updated -

Environment

  • Red Hat OpenShift Container Platform 4.x

Issue

  • Trying to get information out of api.openshift.com about my OpenShift version graphs, fails with the following error:

    $ curl -sH 'Accept:application/json' 'https://api.openshift.com/api/upgrades_info/v1/graph?channel=stable-4.1'
    {"kind":"missing_params","value":"mandatory client parameters missing: arch, version"}
    

Resolution

Supply a version or arch parameter with the api requests.

Examples

  • Supply an arch parameter:

    $ curl --silent --header 'Accept: application/json' 'https://api.openshift.com/api/upgrades_info/v1/graph?channel=fast-4.2&arch=amd64'
    
    $ curl --silent --header 'Accept: application/json' 'https://api.openshift.com/api/upgrades_info/v1/graph?channel=fast-4.2&arch=s390x'
    
  • Supply a version parameter:

    $ curl -sH 'Accept:application/json' 'https://api.openshift.com/api/upgrades_info/v1/graph?channel=stable-4.1&version=4.1.23'
    

Root Cause

In early December 2019, api.openshift.com api's moved from requiring only one parameter (channel), to requiring 2 parameters (channel + arch or version).

These changes were later reverted as this change was seen as a breaking API/Contract change.

This solution is part of Red Hat’s fast-track publication program, providing a huge library of solutions that Red Hat engineers have created while supporting our customers. To give you the knowledge you need the instant it becomes available, these articles may be presented in a raw and unedited form.