Get the node associated with a virtual server
Retrieves the cluster node on which a virtual server resides.
HTTP request syntax (URI)
GET <base_URI>/v8/storage/virtual-servers/{virtualServerId}/nodes
Parameters
Name | Type | Required | Values | Description |
virtualServerId | URI_PARAM | Y | string/number | Specifies either virtual server object ID or HNAS storage virtual server ID |
Return codes
Code | Data | Description |
200 | Nodes | Node associated with the virtual server successfully retrieved. |
400 | Error Message | Missing or invalid request contents. |
404 | Error Message | Requested resource not found. |
500 | Error message | Error associated with the storage system. |
Any HTTP status code other than 200 indicates that the API did not complete successfully.
Request example: Using the virtual server object ID
curl -vk -H "X-Api-Key: zrxvSDAv9x.RIP4gkmKarG3beF.or.4Tc2im7oeqYN88C9XPGHxbXC" https://172.17.11.11:8444/v8/storage/virtual-servers/313a3a3a4f49445f24232140255f56/nodes
Response example: Using the virtual server object ID
HTTP/1.1 200 OK { "nodes": [ { "UUID": "328511ce-680f-11d1-9001-040400070206", "firmwareVersion": "14.4.7322.05", "ipAddresses": [ "10.0.0.20", "192.168.48.1" ], "model": "G600", "name": "G600-440726-1", "nodeId": 1, "objectId": "313a3a3a4f49445f24232140255f56", "serial": "440726", "status": "ONLINE" } ] }
Request example: Using the HNAS storage virtual server ID
curl -vk -H "X-Api-Key: zrxvSDAv9x.RIP4gkmKarG3beF.or.4Tc2im7oeqYN88C9XPGHxbXC" https://172.17.11.11:8444/v8/storage/virtual-servers/8/nodes
Response example: Using the HNAS storage virtual server ID
HTTP/1.1 200 OK { "nodes": [ { "UUID": "328511ce-680f-11d1-9001-040400070206", "firmwareVersion": "14.4.7322.05", "ipAddresses": [ "10.0.0.20", "192.168.48.1" ], "model": "G600", "name": "G600-440726-1", "nodeId": 1, "objectId": "313a3a3a4f49445f24232140255f56", "serial": "440726", "status": "ONLINE" } ] }