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": [
    {
      "additionalProperties": false, 
      "type": "object", 
      "description": "A list of errors that may be returned.", 
      "properties": {
        "errors": {
          "items": {
            "additionalProperties": false, 
            "type": "object", 
            "description": "An object describing a single error.", 
            "properties": {
              "field": {
                "type": "string", 
                "description": "The field with the error if applicable."
              }, 
              "message": {
                "type": "string", 
                "description": "The error message."
              }, 
              "code": {
                "type": "string", 
                "description": "The error code."
              }
            }
          }, 
          "type": "array"
        }
      }
    }, 
    {
      "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", 
                  "null"
                ], 
                "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", 
                  "null"
                ], 
                "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": "\\e\nThe 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."
        }
      }
    }
  ]
}
