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

Get DNS config for a virtual server

Last updated
Save as PDF

Retrieves DNS settings.

Specify a virtual server ID of 0 to ensure the global DNS settings are retrieved. If the virtual server specified has a global security context, then the global DNS settings will be retrieved, otherwise the DNS settings will be specific to the specified virtual server.

HTTP request syntax (URI)

GET <base_URI>/v8/storage/virtual-servers/{virtualServerId}/name-services/dns

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	dnsConfig	DNS config successfully retrieved.
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/name-services/dns

Response example

HTTP/1.1 200 OK
{
  "dnsConfig": {
    "context": "GLOBAL",
    "dnsDomain": "example.com",
    "dnsServers": [
      "10.72.40.2"
    ],
    "searchOrder": [
      "example.com"
    ]
  }
}

Quick Links