a10_gslb_policy_dns

Synopsis

DNS related policy

Parameters

Parameters

Choices/Defaults

Comment

state

str/required

[‘noop’, ‘present’, ‘absent’]

State of the object to be created.

ansible_host

str/required

Host for AXAPI authentication

ansible_username

str/required

Username for AXAPI authentication

ansible_password

str/required

Password for AXAPI authentication

ansible_port

int/required

Port for AXAPI authentication

a10_device_context_id

int

[‘1-8’]

Device ID for aVCS configuration

a10_partition

str

Destination/target partition for object/command

policy_name

str/required

Key to identify parent object

action

bool

Apply DNS action for service

active_only

bool

Only keep active servers

active_only_fail_safe

bool

Continue if no candidate

dns_addition_mx

bool

Append MX Records in Addition Section

dns_auto_map

bool

Automatically build DNS Infrastructure

backup_alias

bool

Return alias name when fail

backup_server

bool

Return fallback server when fail

external_ip

bool

Return DNS response with external IP address

external_soa

bool

Return DNS response with external SOA Record

cname_detect

bool

Apply GSLB for DNS Server response when service is Canonical Name (CNAME)

ip_replace

bool

Replace DNS Server Response with GSLB Service-IPs

geoloc_alias

bool

Return alias name by geo-location

geoloc_action

bool

Apply DNS action by geo-location

geoloc_policy

bool

Apply different policy by geo-location

selected_only

bool

Only keep selected servers

selected_only_value

int

Answer Number

cache

bool

Cache DNS Server response

aging_time

int

Specify aging-time, default is TTL in DNS record, unit= second (Aging time, default 0 means using TTL in DNS record as aging time)

delegation

bool

Zone Delegation

hint

str

‘none’= None; ‘answer’= Append Hint Records in DNS Answer Section; ‘addition’= Append Hint Records in DNS Addition Section;

logging

str

‘none’= None; ‘query’= DNS Query; ‘response’= DNS Response; ‘both’= Both DNS Query and Response;

template

str

Logging template (Logging Template Name)

ttl

int

Specify the TTL value contained in DNS record (TTL value, unit= second, default is 10)

use_server_ttl

bool

Use DNS Server Response TTL value in GSLB Proxy mode

server

bool

Run GSLB as DNS server mode

server_srv

bool

Provide SRV Records

server_mx

bool

Provide MX Records

server_naptr

bool

Provide NAPTR Records

server_addition_mx

bool

Append MX Records in Addition Section

server_ns

bool

Provide NS Records

server_auto_ns

bool

Provide A-Records for NS-Records automatically

server_ptr

bool

Provide PTR Records

server_auto_ptr

bool

Provide PTR Records automatically

server_txt

bool

Provide TXT Records

server_custom

bool

Provide Custom Records

server_any

bool

Provide All Records

server_any_with_metric

bool

Provide All Records with GSLB Metrics applied to A/AAAA Records

server_authoritative

bool

As authoritative server

server_sec

bool

Provide DNSSEC support

server_ns_list

bool

Append All NS Records in Authoritative Section

server_full_list

bool

Append All A Records in Authoritative Section

server_mode_only

bool

Only run GSLB as DNS server mode

zone_owner_mode

bool

Only run GSLB as DNS server mode with zone ownership

server_cname

bool

Provide CNAME Records

server_caa

bool

Provide CAA Records

ipv6

list

Field ipv6

dns_ipv6_option

str

‘mix’= Return both AAAA Record and A Record; ‘smart’= Return AAAA Record by DNS Query Type; ‘mapping’= Map A Record to AAAA Record;

dns_ipv6_mapping_type

str

‘addition’= Append Mapped Record in DNS Addition Section; ‘answer’= Append Mapped Record in DNS Answer Section; ‘exclusive’= Only return AAAA Record; ‘replace’= Replace Record with Mapped Record;

block_action

bool

Specify Action

action_type

str

‘drop’= Drop query; ‘reject’= Send refuse response; ‘ignore’= Send empty response;

proxy_block_port_range_list

list

Field proxy_block_port_range_list

proxy_block_range_from

int

Specify Type Range (From)

proxy_block_range_to

int

To

block_value

list

Field block_value

block_value

int

Specify Type Number

block_type

str

Field block_type

sticky

bool

Make DNS Record sticky for certain time

sticky_mask

str

Specify IP mask, default is /32

sticky_ipv6_mask

int

Specify IPv6 mask length, default is 128

sticky_aging_time

int

Specify aging-time, unit= min, default is 5 (Aging time)

dynamic_preference

bool

Make dynamically change the preference

dynamic_weight

bool

dynamically change the weight

uuid

str

uuid of the object

Examples


Return Values

modified_values (changed, dict, )

Values modified (or potential changes if using check_mode) as a result of task operation

axapi_calls (always, list, )

Sequential list of AXAPI calls made by the task

endpoint (, str, [‘/axapi/v3/slb/virtual_server’, ‘/axapi/v3/file/ssl-cert’])

The AXAPI endpoint being accessed.

http_method (, str, [‘POST’, ‘GET’])

HTTP method being used by the primary task to interact with the AXAPI endpoint.

request_body (, complex, )

Params used to query the AXAPI

response_body (, complex, )

Response from the AXAPI

Status

  • This module is not guaranteed to have a backwards compatible interface. [preview]

  • This module is maintained by community.

Authors

  • A10 Networks