Introduced : BIG-IP_v11.5.0
Gets the nameservers for the specified forward zones on a set of DNS caches. If more than one nameserver is listed for a given forward zone, a matching query will be sent to the nameserver that is currently deemed the most responsive, based on RTTs. If no response is received within a certain window of time, the DNS Cache will resend the query to another nameserver with an increased wait window, until a response is received.


IPPortDefinition [] [] [] get_nameserver(
    in String [] caches,
    in String [] [] zones


Parameter Type Description
caches String [] Names of the caches to query.
zones String [] [] Names of the forward zones to query for a set of caches.

Return Type

Type Description
IPPortDefinition [] [] [] Each nameserver’s IP address and port for the specified forward zones on a set of caches.


Exception Description
Common::AccessDenied Raised if the client credentials are not valid.
Common::InvalidArgument Raised if one of the arguments is invalid.
Common::OperationFailed Raised if an operation error occurs.

See Also


The links to the sample code below are remnants of the old DevCentral wiki and will result in a 404 error. For best results, please copy the link text and search the codeshare directly on DevCentral.

Sample Code

The BIG-IP API Reference documentation contains community-contributed content. F5 does not monitor or control community code contributions. We make no guarantees or warranties regarding the available code, and it may contain errors, defects, bugs, inaccuracies, or security vulnerabilities. Your access to and use of any code available in the BIG-IP API reference guides is solely at your own risk.