.. _slb_template_dns_recursive_dns_resolution:

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

	 **Schema**                             :download:`recursive-dns-resolution schema <slb-template-dns-recursive-dns-resolution/slb-template-dns-recursive-dns-resolution.txt>`
	===================================== =========================================================================================





	**Operations Allowed:**




.. raw:: html

   <script type="text/javascript">
 function showExample(a,b) { document.getElementById(a+'_div').style.display = 'block'; document.getElementById(a+'_cl').style.display = 'block'; document.getElementById(a+'_eg').style.display = 'none';}
   function closeExample(a,b) { document.getElementById(a+'_div').style.display = 'none'; document.getElementById(a+'_cl').style.display = 'none'; document.getElementById(a+'_eg').style.display = 'block';}
 </script>
   <table width='90%' style='margin-left:5%'>



.. raw:: html

   <tr style='border-bottom: thin solid; border-top: thin solid'><th width=15%>Operation</th><th width=10%>Method</th><th>URI</th><th width=15%>Payload</th><th width=10%></th></tr>




.. raw:: html

   <tr  style='border-bottom: thin solid;'><td valign = 'top'>


Create Object



.. raw:: html

   </td><td valign = 'top'>


POST



.. raw:: html

   </td><td valign = 'top'>


/axapi/v3/slb/template/dns/{name}/recursive-dns-resolution



.. raw:: html

   </td><td valign = 'top'>


:ref:`2159_recursive-dns-resolution_attributes`



.. raw:: html

   </td><td></td></tr>




.. raw:: html

   <tr  style='border-bottom: thin solid;'><td valign = 'top'>


Get Object



.. raw:: html

   </td><td valign = 'top'>


GET



.. raw:: html

   </td><td valign = 'top'>


/axapi/v3/slb/template/dns/{name}/recursive-dns-resolution



.. raw:: html

   </td><td valign = 'top'>


:ref:`2159_recursive-dns-resolution_attributes`



.. raw:: html

   </td><td></td></tr>




.. raw:: html

   <tr  style='border-bottom: thin solid;'><td valign = 'top'>


Modify Object



.. raw:: html

   </td><td valign = 'top'>


POST



.. raw:: html

   </td><td valign = 'top'>


/axapi/v3/slb/template/dns/{name}/recursive-dns-resolution



.. raw:: html

   </td><td valign = 'top'>


:ref:`2159_recursive-dns-resolution_attributes`



.. raw:: html

   </td><td></td></tr>




.. raw:: html

   <tr  style='border-bottom: thin solid;'><td valign = 'top'>


Replace Object



.. raw:: html

   </td><td valign = 'top'>


PUT



.. raw:: html

   </td><td valign = 'top'>


/axapi/v3/slb/template/dns/{name}/recursive-dns-resolution



.. raw:: html

   </td><td valign = 'top'>


:ref:`2159_recursive-dns-resolution_attributes`



.. raw:: html

   </td><td></td></tr>




.. raw:: html

   <tr  style='border-bottom: thin solid;'><td valign = 'top'>


Delete Object



.. raw:: html

   </td><td valign = 'top'>


DELETE



.. raw:: html

   </td><td valign = 'top'>


/axapi/v3/slb/template/dns/{name}/recursive-dns-resolution



.. raw:: html

   </td><td valign = 'top'>


:ref:`2159_recursive-dns-resolution_attributes`



.. raw:: html

   </td><td></td></tr>




.. raw:: html

   </table>

.. _2159_recursive-dns-resolution_attributes:

recursive-dns-resolution attributes
-----------------------------------

    **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

    **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

    **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:** :doc:`/axapi/v3/ip/nat/pool <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:** :doc:`/axapi/v3/ipv6/nat/pool <ipv6_nat_pool>`

    **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

.. _2159_host-list-cfg:

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:** :doc:`/axapi/v3/class-list <class_list>`