.. _slb_template_dns_recursive_dns_resolution:

slb template dns recursive-dns-resolution
=========================================

Recursive DNS resolver configuration


recursive-dns-resolution Specification
--------------------------------------

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

	 **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:`518_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:`518_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:`518_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:`518_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:`518_recursive-dns-resolution_attributes`



.. raw:: html

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




.. raw:: html

   </table>

.. _518_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 recurisve mode, forward query to bound service-group if hostnames matched

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

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

        **Refernce Object:** :doc:`/axapi/v3/ipv6/nat/pool <ipv6_nat_pool>`

    **lookup-order**

        **Description:** lookup-order is a **JSON Block**.  Please see below for :ref:`518_lookup-order` 

        **Type:** Object

        **Refernce Object:** :doc:`/axapi/v3/slb/template/dns/{name}/recursive-dns-resolution/lookup-order <slb_template_dns>`

    **max-trials**

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

        **Type:** number

        **Range:** 1-62

        **Default:** 30

    **minimal-response**

        **Description** Remove authority and additional records when applicable

        **Type:** boolean

        **Supported Values:** true, false, 1, 0

        **Default:** 0

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

    **uuid**

        **Description** uuid of the object

        **Type:** string

        **Maximum Length:** 64 characters

        **Maximum Length:** 1 characters

.. _518_lookup-order:

lookup-order
^^^^^^^^^^^^
	=============================== ===================================================
	**Specification**
	=============================== ===================================================
	 **Type**                        *object*

	=============================== ===================================================

    **query-type**

        **Type:** List

    **uuid**

        **Description** uuid of the object

        **Type:** string

        **Maximum Length:** 64 characters

        **Maximum Length:** 1 characters

.. _518_lookup-order_query-type:

lookup-order_query-type
^^^^^^^^^^^^^^^^^^^^^^^
	=============================== ===================================================
	**Specification**
	=============================== ===================================================
	 **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

.. _518_host-list-cfg:

host-list-cfg
^^^^^^^^^^^^^
	=============================== ===================================================
	**Specification**
	=============================== ===================================================
	 **Type**                        *list*

	 **Block object keys**             

	=============================== ===================================================

    **hostnames**

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

        **Type:** string

        **Format:** string-rlx

        **Maximum Length:** 63 characters

        **Maximum Length:** 1 characters

        **Refernce Object:** :doc:`/axapi/v3/class-list <class_list>`