Get a node

NAS File Storage REST API v7 Reference

Version
14.7.x
14.6.x
Audience
anonymous
Part Number
MK-92HNAS088-05

Retrieves detailed information about a node in a cluster. A node identifier identifies the node.

HTTP request syntax (URI)

GET <base_URI>/v7/storage/nodes/{id}

Parameters

Name Type Required Values Description
id URI_PARAM Y string/number Specifies either a node object ID or an HNAS storage cluster node ID.

Return codes

Code Data Description
200 node Individual node information retrieved successfully.
400 No Data Missing or invalid request contents.
404 Error Message Requested resource not found.
500 Error message Error associated with the storage system.
501 No Data Server has not implemented the request operation on the resource.

Any HTTP status code other than 200 indicates that the API did not complete successfully.

Request example: Using a node object ID

curl -vk -H "X-Api-Key: zrxvSDAv9x.RIP4gkmKarG3beF.or.4Tc2im7oeqYN88C9XPGHxbXC" https://172.17.11.11:8444/v7/storage/nodes/313a3a3a3a3a3a303a3a3a4f49445f24232140255f56

Response example: Using a node object ID

HTTP/1.1 200 OK
{
  "node": {
    "UUID": "bbd85dd2-3016-11d5-9001-040403000307",
    "firmwareVersion": "13.9.6809.00",
    "ipAddresses": [
      "192.168.0.190",
      "10.251.48.1"
    ],
    "model": "N800",
    "name": "G800-443037-1",
    "nodeId": 1,
    "objectId": "313a3a3a3a3a3a303a3a3a4f49445f24232140255f56",
    "serial": "443037",
    "status": "ONLINE"
  }
}

Request example: Using an HNAS storage node ID

curl -vk -H "X-Api-Key: zrxvSDAv9x.RIP4gkmKarG3beF.or.4Tc2im7oeqYN88C9XPGHxbXC" https://172.17.11.11:8444/v7/storage/nodes/1

Response example: Using an HNAS storage node ID

HTTP/1.1 200 OK
{
  "node": {
    "UUID": "bbd85dd2-3016-11d5-9001-040403000307",
    "firmwareVersion": "13.9.6809.00",
    "ipAddresses": [
      "192.168.0.190",
      "10.251.48.1"
    ],
    "model": "N800",
    "name": "G800-443037-1",
    "nodeId": 1,
    "objectId": "313a3a3a3a3a3a303a3a3a4f49445f24232140255f56",
    "serial": "443037",
    "status": "ONLINE"
  }
}