Sets the iSCSI domain associated with a virtual server.
HTTP request syntax (URI)
POST <base_URI>/v7/storage/virtual-servers/{id}/iscsi-domain
Parameters
| Name | Type | Required | Values | Description |
|---|---|---|---|---|
| id | URI_PARAM | Y | string/number | Specifies either the virtual server object ID or the HNAS storage virtual server ID. |
| iSCSIDomain | BODY | Y | string | iSCSI domain name to be set. |
Return codes
| Code | Data | Description |
|---|---|---|
| 204 | No Data | iSCSI domain name has been set successfully. |
| 400 | No Data | Missing or invalid request contents. |
| 500 | Error message | Error associated with the storage system. |
| 501 | No Data | Server has not implemented the request operation on the resource. |
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/v7/storage/virtual-servers/ 333a3a3a4f49445f24232140255f56/iscsi-domain -d ‘{"iSCSIDomain":"xyz- iscsiDomain"}’ -X POST
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/v7/storage/virtual-servers/15/iscsi-domain -d ‘{"iSCSIDomain":"xyz-iscsiDomain"}’ -X POST
Response example: Using the HNAS storage virtual server ID
HTTP/1.1 204 No Content