Add an IP address to a virtual server
Adds an IP address to a virtual server.
This API call has changed in version 8.
HTTP request syntax (URI)
POST <base_URI>/v8/storage/virtual-servers/{virtualServerId}/ip-addresses
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. |
| ipAddress | BODY | Y | string | New IPv4 or IPv6 address. |
| port | BODY | Y | string | Name or aggregate object ID or VLAN object ID to associate the IP address wtih . |
| netmask | BODY | Y | string | Netmask can be of the form x.x.x.x for an IPv4 address or specify a prefix length, which would be valid for both IPv4 or IPv6 addresses. |
Return codes
| Code | Data | Description |
| 204 | No Data | New IP address successfully added. |
| 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: 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/333a3a3a4f49445f24232140255f56/ip-addresses -X POST -d '{"ipAddress":"203.2.43.2", "port":"ag1", "netmask": "255.255.255.0"}'
Response example: Using the virtual server object ID
HTTP/1.1 204 No Content
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/15/ip-addresses -X POST -d '{"ipAddress":"203.2.43.2", "port":"ag1", "netmask": "255.255.255.0"}'
Response example: Using the HNAS storage virtual server ID
HTTP/1.1 204 No Content