/
DTC LBDN
Document toolboxDocument toolbox

DTC LBDN

Owned by Jyothi KP
Last updated: Oct 04, 2024
2 min read

Use the nios_dtc_lbdn module to create, update, or remove instances of the DTC Load Balanced Domain Name (LBDN) object from a NIOS Grid.

The following table describes the parameters you can define in the nios_dtc_lbdn module:

Parameter

Required/Optional

Description

Parameter

Required/Optional

Description

name

Required

Specifies the name of the DTC LBDN that is displayed. This is not related to DNS.

lb_method

Required

Specifies the load balancing method used to select a pool. Choose one of the following methods:

  • 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

Optional

Lists the linked authoritative zones.
When using the auth_zones parameter, you must specify at least one of the patterns values.

patterns

Optional

Specifies the LBDN wildcards for the pattern match.

types

Optional

Specifies the list of resource record types supported by the LBDN.
For this option to work, set the wapi_version variable in the provider parameter to a value greater than 2.6 for this option to work properly.

Choose from the following types of records:

  • A

  • AAAA

  • CNAME

  • NAPTR

  • SRV

pools

Optional

Specifies the pools used for load balancing. It is a dictionary object that contains details of pools.

Define the following subparameters:

  • pool (required): Specify the name of the pool to which the DTC LBDN instance must be linked.

  • ratio: Provide the weight of the pool. The default value is 1.

When creating a DTC LBDN instance, you must specify pools as a required parameter.

ttl

Optional

Specifies the Time To Live (TTL) value for the record.
The duration that the record is valid for, in seconds (cached).

extattrs

Optional

Specifies extensible attributes for the DTC LBDN object.

state

Optional

Specifies the state of the DTC LBDN instance in NIOS. Set one of the following values:

  • present (default): Configures the object.

  • absent: Removes the object.

comment

Optional

Describes the DTC LBDN object.

provider

Required

A dictionary object that contains the connection details.

  • host: DNS host name or IP address to connect to the remote instance of NIOS.

  • username: User name to use for authenticating the connection to the remote instance.

  • password: Password to use for authenticating the connection to the remote instance.

For information on additional fields you can define, see the list of subparameters in the NIOS Modules for Ansible Collections topic.

connection

Required

The nios_dtc_lbdn module must be run locally.

Examples

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

Related content