Get a node
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/313a3a3a4f49445f24232140255f56
Response example: Using a node object ID
HTTP/1.1 200 OK "node" : { "UUID" : "db5fde82-246e-11cf-9001-4bee3faaca3b", "firmwareVersion" : "13.5.5521.00", "ipAddresses" : [ "192.0.2.200" ], "model" : "HNAS 4060", "name" : "Gizmo-CLUSTER-2", "nodeId" : 2, "objectId" : "323a3a3a3a3a3a303a3a3a4f49445f24232140255f56", "serial" : "M4SJKW1345760", "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" : "db5fde82-246e-11cf-9001-4bee3faaca3b", "firmwareVersion" : "13.5.5521.00", "ipAddresses" : [ "192.0.2.200" ], "model" : "HNAS 4060", "name" : "Gizmo-CLUSTER-2", "nodeId" : 2, "objectId" : "323a3a3a3a3a3a303a3a3a4f49445f24232140255f56", "serial" : "M4SJKW1345760", "status" : "ONLINE" } }