LocalLB::DNSCache::get_forward_zone

Introduced : BIG-IP_v11.5.0
Gets the names of forward zones for a set of DNS caches. A given zone name should only use the symbols allowed for a fully qualified domain name (FQDN), namely ASCII letters &aposa&apos though &aposz&apos, digits &apos0&apos through &apos9&apos, hyphen &apos-&apos, and period &apos.&apos. For example &apossite.example.com&apos would be a valid zone name. A DNS Cache configured with a forward zone will forward any queries that resulted in a cache-miss (because the answer was not available in the cache) and which also match a configured zone name, to the nameserver specified on the zone. If no nameservers are specified on the zone, an automatic SERVFAIL is returned. When a forward zone&aposs nameserver returns a valid response to the DNS Cache, that response is cached and then returned to the requestor.

Prototype

String [] [] get_forward_zone(
    in String [] caches
);

Parameters

Parameter Type Description
caches String [] Names of the caches to query.

Return Type

Type Description
String [] [] Names of the forward zones for the set of caches.

Exceptions

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

iControl ::
iControl :: LocalLB :: DNSCache

Warning

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


Copyright © 1996-2012, F5 Networks, Inc. All rights reserved.

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.