Set WINS config for a virtual server
Sets the WINS configuration.
Specify a virtual server ID of 0 to ensure the global WINS configuration is updated. If the virtual server specified has a global security context, then the global WINS configuration will be updated, otherwise the WINS configuration will be updated for the specified virtual server.
HTTP request syntax (URI)
POST <base_URI>/v8/storage/virtual-servers/{virtualServerId}/name-services/wins
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. |
servers | BODY | Y | list of strings | List of IPv4 addresses of WINS servers. A maximum of two WINS servers are supported. |
Return codes
Code | Data | Description |
204 | No Data | WINS servers successfully updated. |
400 | Error Message | Missing or invalid request contents. |
403 | Error Message | Operation forbidden by access level. |
404 | Error Message | Requested resource not found. |
500 | Error message | Error associated with the storage system. |
Any HTTP status code other than 204 indicates that the API did not complete successfully.
Request example: Set 2 WINS servers for virtual server 4
curl -vk -H "X-Api-Key: zrxvSDAv9x.RIP4gkmKarG3beF.or.4Tc2im7oeqYN88C9XPGHxbXC" https://172.17.11.11:8444/v8/storage/virtual-servers/4/name-services/wins -X POST -d '{"servers":["172.27.128.110", "172.27.128.111"]}'
Response example
HTTP/1.1 204 No Content
Request example: Clear WINS servers for virtual server 4
curl -vk -H "X-Api-Key: zrxvSDAv9x.RIP4gkmKarG3beF.or.4Tc2im7oeqYN88C9XPGHxbXC" https://172.17.11.11:8444/v8/storage/virtual-servers/4/name-services/wins -X POST -d '{"servers":[]}'
Response example
HTTP/1.1 204 No Content