Get serving names of a virtual server
Get a list of the CIFS/SMB serving names that the virtual server advertises to clients.
For CIFS/SMB clients to access a virtual server, it needs to have a name, and it must be a member of a specific domain. A virtual server can have multiple names, but they must be in the same domain, and all virtual servers in the global security context must also use the same domain.
HTTP request syntax (URI)
GET <base_URI>/v8/storage/virtual-servers/{virtualServerId}/serving-names
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 | servingNames | Serving names retrieved successfully. |
| 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/serving-names
Response example
HTTP/1.1 200 OK
{
"servingNames": [
{
"dnsSuffix": "protocols.example.com",
"domain": "PROTOCOLS",
"isDisjoint": false,
"isOnline": true,
"mode": "ADS",
"objectId": "313a3a3a6d6572637572793131306e312d733a3a3a303a3a3a4f49445f24232140255f56",
"servingName": "mercury110n1-s",
"virtualServerId": 1
}
]
}