Get name service order for a virtual server
Retrieves the order that the various name services will be used to lookup names.
Specify a virtual server ID of 0 to ensure the global name service order settings are retrieved. If the virtual server specified has a global security context, then the global name service order settings will be retrieved, otherwise the name service order settings will be specific to the specified virtual server.
HTTP request syntax (URI)
GET <base_URI>/v8/storage/virtual-servers/{virtualServerId}/name-services
Parameters
Name | Type | Required | Values | Description |
virtualServerId | URI_PARAM | Y | string/number | Specifies either the virtual server object ID or the HNAS storage virtual server ID. |
Return codes
Code | Data | Description |
200 | nameServiceOrder | Name service order 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
curl -vk -H "X-Api-Key: zrxvSDAv9x.RIP4gkmKarG3beF.or.4Tc2im7oeqYN88C9XPGHxbXC" https://172.17.11.11:8444/v8/storage/virtual-servers/1/name-services
Response example
HTTP/1.1 200 OK { "nameServiceOrder": { "context": "GLOBAL", "order": [ "DNS", "NIS", "WINS" ] } }