slb template dns recursive-dns-resolution

Recursive DNS resolver configuration

recursive-dns-resolution Specification

Parameter	Value
Type	Configuration Resource
Element Name	recursive-dns-resolution
Element URI	/axapi/v3/slb/template/dns/{name}/recursive-dns-resolution
Element Attributes	recursive-dns-resolution_attributes
Partition Visibility	shared
Operational Data URI	/axapi/v3/slb/template/dns/{name}/recursive-dns-resolution/oper
Schema	recursive-dns-resolution schema

Operations Allowed:

Operation	Method	URI	Payload
Create Object	POST	/axapi/v3/slb/template/dns/{name}/recursive-dns-resolution	recursive-dns-resolution attributes
Get Object	GET	/axapi/v3/slb/template/dns/{name}/recursive-dns-resolution	recursive-dns-resolution attributes
Modify Object	POST	/axapi/v3/slb/template/dns/{name}/recursive-dns-resolution	recursive-dns-resolution attributes
Replace Object	PUT	/axapi/v3/slb/template/dns/{name}/recursive-dns-resolution	recursive-dns-resolution attributes
Delete Object	DELETE	/axapi/v3/slb/template/dns/{name}/recursive-dns-resolution	recursive-dns-resolution attributes

recursive-dns-resolution attributes

csubnet-retry

Description retry when server REFUSED AX inserted EDNS(0) subnet, works only when insert-client-subnet is configured

Type: boolean

Supported Values: true, false, 1, 0

Default: 0

default-recursive

Description Default recursive mode, forward query to bound service-group if hostnames matched

Type: boolean

Supported Values: true, false, 1, 0

Default: 0

fast-ns-selection

Description ‘enabled’: Enable fast NS selection; ‘disabled’: Disable fast NS selection;

Type: string

Supported Values: enabled, disabled

Default: enabled

force-cname-resolution

Description ‘enabled’: Force CNAME resolution always; ‘disabled’: Use answer record in CNAME response if it exists, else resolve;

Type: string

Supported Values: enabled, disabled

Default: enabled

full-response

Description Serve all records (authority and additional) when applicable

Type: boolean

Supported Values: true, false, 1, 0

Default: 0

gateway-health-check

Description: gateway-health-check is a JSON Block. Please see below for gateway-health-check

Type: Object

Reference Object: /axapi/v3/slb/template/dns/{name}/recursive-dns-resolution/gateway-health-check

host-list-cfg

Type: List

ipv4-nat-pool

Description IPv4 Source NAT pool or pool group

Type: string

Format: string-rlx

Maximum Length: 63 characters

Maximum Length: 1 characters

Reference Object: /axapi/v3/ip/nat/pool

ipv6-nat-pool

Description IPv6 Source NAT pool or pool group

Type: string

Format: string-rlx

Maximum Length: 63 characters

Maximum Length: 1 characters

Reference Object: /axapi/v3/ipv6/nat/pool

lookup-order

Description: lookup-order is a JSON Block. Please see below for lookup-order

Type: Object

Reference Object: /axapi/v3/slb/template/dns/{name}/recursive-dns-resolution/lookup-order

max-trials

Description Total number of times to try DNS query to server before closing client connection, default 255

Type: number

Range: 1-255

Default: 255

ns-cache-lookup

Description ‘disabled’: Disable NS Cache Lookup; ‘enabled’: Enable NS Cache Lookup;

Type: string

Supported Values: disabled, enabled

Default: enabled

request-for-pending-resolution

Description ‘drop’: Drop of the request during ongoing; ‘respond-with-servfail’: Respond with SERVFAIL of the request during ongoing; ‘start-new-resolution’: Start new resolution of the request during ongoing;

Type: string

Supported Values: drop, respond-with-servfail, start-new-resolution

Default: respond-with-servfail

retries-per-level

Description Number of DNS query retries at each server level before closing client connection, default 6

Type: number

Range: 1-6

Default: 6

udp-initial-interval

Description UDP DNS Retry Interval value 1-6, default is 5 sec (1-6, default is 5sec)

Type: number

Range: 1-6

Default: 5

udp-retry-interval

Description UDP DNS Retry Interval value 1-6, default is 1 sec (1-6 , default is 1 sec)

Type: number

Range: 1-6

Default: 1

use-client-qid

Description Use client side query id for recursive query

Type: boolean

Supported Values: true, false, 1, 0

Default: 0

use-service-group-response

Description ‘disabled’: Start Recursive Resolver if Server response doesnt have final answer; ‘enabled’: Forward Backend Server response to client and dont start recursive resolver;

Type: string

Supported Values: disabled, enabled

Default: enabled

uuid

Description uuid of the object

Type: string

Maximum Length: 64 characters

Maximum Length: 1 characters

lookup-order

Specification	Value
Type	object

query-type

Type: List

uuid

Description uuid of the object

Type: string

Maximum Length: 64 characters

Maximum Length: 1 characters

lookup-order_query-type

Specification	Value
Type	list
Block object keys

num-query-type

Description Other query type value

Type: number

Range: 1-65535

order

Description ‘ipv4-precede-ipv6’: Recursive lookup via IPv4 then IPv6; ‘ipv6-precede-ipv4’: Recursive lookup via IPv6 then IPv4;

Type: string

Supported Values: ipv4-precede-ipv6, ipv6-precede-ipv4

str-query-type

Description ‘A’: Address record; ‘AAAA’: IPv6 Address record; ‘CNAME’: Canonical name record; ‘MX’: Mail exchange record; ‘NS’: Name server record; ‘SRV’: Service locator; ‘PTR’: PTR resource record; ‘SOA’: Start of authority record; ‘TXT’: Text record; ‘ANY’: All cached record;

Type: string

Supported Values: A, AAAA, CNAME, MX, NS, SRV, PTR, SOA, TXT, ANY

gateway-health-check

Specification	Value
Type	object

gwhc-ns-cache-lookup

Description ‘disabled’: Disable NS Cache Lookup; ‘enabled’: Enable NS Cache Lookup;

Type: string

Supported Values: disabled, enabled

Default: disabled

interval

Description Specify the health check interval, default is 10 sec (Interval value, in seconds (default 10))

Type: number

Range: 1-300

Default: 10

num-query-type

Description Other record type value

Type: number

Range: 1-65535

Mutual Exclusion: num-query-type and str-query-type are mutually exclusive

query-name

Description Specify the query name used in probe queries, default “a10networks.com”

Type: string

Maximum Length: 255 characters

Maximum Length: 1 characters

Default: a10networks.com

retry

Description Maximum number of DNS query retries at each server level before health check fails, default 6 (Retry count (default 6))

Type: number

Range: 1-6

Default: 6

retry-multi

Description Specify number of times that health check consecutively fails before declaring gateway DOWN, default 1 (retry-multi count (default 1))

Type: number

Range: 1-10

Default: 1

str-query-type

Description ‘A’: Address record; ‘AAAA’: IPv6 Address record; ‘CNAME’: Canonical name record; ‘MX’: Mail exchange record; ‘NS’: Name server record; ‘SRV’: Service locator; ‘PTR’: PTR resource record; ‘SOA’: Start of authority record; ‘TXT’: Text record;

Type: string

Supported Values: A, AAAA, CNAME, MX, NS, SRV, PTR, SOA, TXT

Default: A

Mutual Exclusion: str-query-type and num-query-type are mutually exclusive

timeout

Description Specify the health check timeout before retrying or finish, default is 5 sec (Timeout value, in seconds (default 5))

Type: number

Range: 1-6

Default: 5

up-retry

Description Specify number of times that health check consecutively passes before declaring gateway UP, default 1 (up-retry count (default 1))

Type: number

Range: 1-10

Default: 1

uuid

Description uuid of the object

Type: string

Maximum Length: 64 characters

Maximum Length: 1 characters

host-list-cfg

Specification	Value
Type	list
Block object keys

hostnames

Description Hostnames class-list name (dns type), perform resolution while query name matched

Type: string

Format: string-rlx

Maximum Length: 63 characters

Maximum Length: 1 characters

Reference Object: /axapi/v3/class-list