We've Moved! Product Documentation has moved to docs.hitachivantara.com

Get a serving name of a virtual server

Last updated
Save as PDF

Gets details about a specific CIFS/SMB serving name associated with a virtual server.

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/serving-names/{servingNameObjectId}

Parameters

Name	Type	Required	Values	Description
servingNameObjectId	URI_PARAM	Y	string	Object ID of the serving name

Return codes

Code	Data	Description
200	servingName	Serving name 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/serving-names/313a3a3a6d6572637572793131306e312d733a3a3a303a3a3a4f49445f24232140255f56

Response example

HTTP/1.1 200 OK
{
  "servingName": {
    "dnsSuffix": "protocols.example.com",
    "domain": "PROTOCOLS",
    "isDisjoint": false,
    "isOnline": true,
    "mode": "ADS",
    "objectId": "313a3a3a6d6572637572793131306e312d733a3a3a303a3a3a4f49445f24232140255f56",
    "servingName": "mercury110n1-s",
    "virtualServerId": 1
  }
}

Quick Links