Resource URL: /platform/<<version=3>>/upgrade/cluster/nodes

    Overview: View information about nodes during an upgrade, rollback, or
              pre-upgrade assessment.

     Methods: GET

********************************************************************************

Method GET: View information about nodes during an upgrade, rollback, or
            pre-upgrade assessment.

       URL: GET /platform/<<version=3>>/upgrade/cluster/nodes

There are no query arguments for this method.

GET response body schema:
{
  "type": "object", 
  "description": "View information about nodes during an upgrade, rollback, or pre-upgrade assessment.", 
  "properties": {
    "nodes": {
      "items": {
        "type": "object", 
        "description": "The node details useful during an upgrade or assessment.", 
        "properties": {
          "last_action": {
            "type": "string", 
            "description": "The last action performed to completion/failure on this node.  Null if the node_state is 'committed' or 'assessing.' One of the following values: 'upgrade', 'rollback'."
          }, 
          "last_action_result": {
            "type": "string", 
            "description": "Did the node pass upgrade or rollback without failing? Null if the node_state is 'committed.' One of the following values: 'pass', 'fail', null"
          }, 
          "lnn": {
            "type": "integer", 
            "description": "The lnn of the node."
          }, 
          "node_state": {
            "type": "string", 
            "description": "The state of the node during the upgrade, rollback, or assessment. One of the following values: 'committed', 'upgraded', 'upgrading', 'rolling back', 'assessing', 'error'"
          }, 
          "progress": {
            "type": "integer", 
            "description": "What step is the upgrade, assessment, or rollback in? To show via progress indicator. NOTE: the value is an integer between 0 and 100 (percent)"
          }, 
          "error": {
            "type": [
              "object", 
              "null"
            ], 
            "description": "The current OneFS version before upgrade.", 
            "properties": {
              "log": {
                "type": "string", 
                "description": "Upgrade error log."
              }, 
              "failed_upgrade_action": {
                "type": "string", 
                "description": "Last upgrade step which failed on node."
              }
            }
          }, 
          "onefs_version": {
            "type": "object", 
            "description": "The current OneFS version before upgrade.", 
            "properties": {
              "bugfix": {
                "type": "integer"
              }, 
              "major": {
                "type": "integer"
              }, 
              "version": {
                "type": "string", 
                "description": "hex representation of the OneFS version integer."
              }, 
              "minor": {
                "type": "integer"
              }, 
              "maintenance": {
                "type": "integer"
              }
            }
          }
        }
      }, 
      "type": "array", 
      "description": "List of detailed info of nodes which are part of the current upgrade"
    }, 
    "total": {
      "type": "integer", 
      "description": "Total number of nodes the upgrade framework is aware of and was able to collect info for at this point."
    }
  }
}
