Update NIS config for a virtual server
Update the NIS configuration if NIS is the selected mode of operation.
Specify a virtual server ID of 0 to ensure the global NIS configuration is updated. If the virtual server specified has a global security context, then the global NIS configuration will be updated, otherwise the NIS configuration will be updated for the specified virtual server.
HTTP request syntax (URI)
PATCH <base_URI>/v8/storage/virtual-servers/{virtualServerId}/name-services/nis
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. |
characterSet | BODY | N | string |
NIS character set to use. Accepted values are:
|
domain | BODY | N | string | NIS domain. |
isEnabled | BODY | N | boolean | Controls whether NIS is enabled or not. |
maxBindResponseTime | BODY | N | integer | Time in milliseconds, that the NIS client will wait for a response from the NIS server. |
rebindPeriod | BODY | N | integer | Period in minutes between attempts to rebind to the current NIS server. |
servers | BODY | N | list of objects | Array of NIS server objects |
useBroadcast | BODY | N | boolean | Enable broadcast for NIS servers. |
Return codes
Code | Data | Description |
204 | No Data | NIS config 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: Add 2 NIS servers, at different priorities, and enable broadcast for server
curl -vk -H "X-Api-Key: zrxvSDAv9x.RIP4gkmKarG3beF.or.4Tc2im7oeqYN88C9XPGHxbXC" https://172.17.11.11:8444/v8/storage/virtual-servers/4/name-services/nis -X PATCH -d '{"useBroadcast":true, "servers":[{"ipAddress":"10.2.3.4", "priority":2}, {"ipAddress":"12.3.4.5", "priority":3}]}'
Response example
HTTP/1.1 204 No Content