---
title: "DTC LBDN"
canonical: "https://docs.infoblox.com/space/niosmodulesansible/45908134/DTC%20LBDN"
format: markdown
---
<span style="color: #000000">Use the </span>`nios_dtc_lbdn`<span style="color: #000000"> module to create, update, or remove instances of the DTC Load Balanced Domain Name (LBDN) object from a NIOS Grid.</span>

<span style="color: #000000">The following table describes the parameters you can define in the </span>`nios_dtc_lbdn`<span style="color: #000000"> module:</span>

| <span style="color: #000000">**Parameter**</span> | <span style="color: #000000">**Required/Optional**</span> | <span style="color: #000000">**Description**</span> |
| --- | --- | --- |
| `name` | <span style="color: #000000">Required</span> | <span style="color: #000000">Specifies the name of the DTC LBDN that is displayed. This is not related to DNS.</span> |
| `lb_method` | <span style="color: #000000">Required</span> | <span style="color: #000000">Specifies the load balancing method used to select a pool. Choose one of the following methods:</span><br>- `GLOBAL_AVAILABILITY`
- `RATIO`
- `ROUND_ROBIN`
- `TOPOLOGY` |
| `topology` | Optional | Specifies the topology ruleset for the `TOPOLOGY` load balancing method.  
This field is required when you set `lb_method` to `TOPOLOGY`. |
| `auth_zones` | <span style="color: #000000">Optional</span> | <span style="color: #000000">Lists the linked authoritative zones.</span>  
<span style="color: #000000">When using the </span>`auth_zones`<span style="color: #000000"> parameter, you must specify at least one of the </span>`patterns`<span style="color: #000000"> values.</span> |
| `patterns` | <span style="color: #000000">Optional</span> | <span style="color: #000000">Specifies the LBDN wildcards for the pattern match.</span> |
| `types` | <span style="color: #000000">Optional</span> | <span style="color: #000000">Specifies the list of resource record types supported by the LBDN.</span>  
<span style="color: #000000">For this option to work, set the </span>`wapi_version`<span style="color: #000000"> variable in the </span>`provider`<span style="color: #000000"> parameter to a value greater than </span>`2.6`<span style="color: #000000"> for this option to work properly.</span><br><span style="color: #000000">Choose from the following types of records:</span><br>- `A`
- `AAAA`
- `CNAME`
- `NAPTR`
- `SRV` |
| `pools` | <span style="color: #000000">Optional</span> | <span style="color: #000000">Specifies the pools used for load balancing. It is a dictionary object that contains details of pools.</span><br><span style="color: #000000">Define the following subparameters:</span><br>- `pool`<span style="color: #000000"> (required): Specify the name of the pool to which the DTC LBDN instance must be linked.</span>
- `ratio`<span style="color: #000000">: Provide the weight of the pool. The default value is </span>`1`<span style="color: #000000">.</span><br><span style="color: #000000">When creating a DTC LBDN instance, you must specify </span>`pools`<span style="color: #000000"> as a required parameter.</span> |
| `ttl` | <span style="color: #000000">Optional</span> | <span style="color: #000000">Specifies the Time To Live (TTL) value for the record.</span>  
<span style="color: #000000">The duration that the record is valid for, in seconds (cached).</span> |
| `extattrs` | <span style="color: #000000">Optional</span> | <span style="color: #000000">Specifies extensible attributes for the DTC LBDN object.</span> |
| `state` | <span style="color: #000000">Optional</span> | <span style="color: #000000">Specifies the state of the DTC LBDN instance in NIOS. Set one of the following values:</span><br>- `present`<span style="color: #000000"> (default): Configures the object.</span>
- `absent`<span style="color: #000000">: Removes the object.</span> |
| `comment` | <span style="color: #000000">Optional</span> | <span style="color: #000000">Describes the DTC LBDN object.</span> |
| `provider` | <span style="color: #000000">Required</span> | <span style="color: #000000">A dictionary object that contains the connection details.</span><br>- `host`<span style="color: #000000">: DNS host name or IP address to connect to the remote instance of NIOS.</span>
- `username`<span style="color: #000000">: User name to use for authenticating the connection to the remote instance.</span>
- `password`<span style="color: #000000">: Password to use for authenticating the connection to the remote instance.</span><br><span style="color: #000000">For information on additional fields you can define, see the list of subparameters in the </span><span style="color: #000000">*[NIOS Modules for Ansible Collections](https://infoblox-docs.atlassian.net/wiki/spaces/niosmodulesansible/pages/44525470/NIOS+Modules+for+Ansible+Collections#Providerparameters)*</span><span style="color: #000000"> topi</span><span style="color: #003366">c.</span> |
| `connection` | <span style="color: #000000">Required</span> | <span style="color: #000000">The </span>`nios_dtc_lbdn`<span style="color: #000000"> module must be run locally.</span> |

## <span style="color: #000000">Examples</span>

`name: Configure a DTC LBDN`  
`infoblox.nios_modules.nios_dtc_lbdn:`  
`  name: web.ansible.com`  
`  lb_method: ROUND_ROBIN`  
`  pools:`  
`    - pool: web_pool`  
`  state: present`  
`  provider:`  
`    host: <nios_hostname_or_hostip>`  
`    username: <nios_username>`  
`    password: <nios_password>`  
`connection: local`


`name: Remove a DTC LBDN from the system`  
`infoblox.nios_modules.nios_dtc_lbdn:`  
`  name: web.ansible.com`  
`  lb_method: ROUND_ROBIN`  
`  state: absent`  
`  provider:`  
`    host: <nios_hostname_or_hostip>`  
`    username: <nios_username>`  
`    password: <nios_password>`  
`connection: local`


`name: Remove a DTC LBDN from the system`  
`infoblox.nios_modules.nios_dtc_lbdn:`  
`  name: web.ansible.com`  
`  lb_method: ROUND_ROBIN`  
`  state: absent`  
`  provider:`  
`    host: <nios_hostname_or_hostip>`  
`    username: <nios_username>`  
`    password: <nios_password>`  
`connection: local`