bigip_dns_resolver

Manage BIG-IP DNS resolvers

Collection: f5networks.f5_modules

Full Name: f5networks.f5_modules.bigip_dns_resolver

Synopsis

Manage BIG-IP DNS resolvers

Parameters

Name	Type	Required	Description
provider	dict		Execution-host JSON provider: server, user, private password/pass/pwd (pwd overwrites pass); server_port443, validate_certs true, transport rest, timeout and auth_provider. F5_SERVER/F5_SERVER_PORT/F5_USER or ANSIBLE_NET_USERNAME/F5_PASSWORD or ANSIBLE_NET_PASSWORD/F5_VALIDATE_CERTS fallbacks apply only on the execution host. no_f5_teem defaults false; F5_TEEM/F5_TELEMETRY_OFF fallbacks and local/private telemetry policy match the held runtime. Original passwords, aliases, tokens and environment values remain private. No ambient proxy/netrc or redirects.
name	str	yes	Required resource name; absent differs from explicit null, which becomes empty string. Other JSON kinds use Python str/repr. Original converted spelling is sent on create. Fixed generated prepared arguments require unique object keys at every depth; direct native raw JSON preserves duplicate last value at first position. This does not manage DNS Express nameservers, GTM or system DNS.
route_domain	int		Optional core exact-integral Decimal conversion, then partition qualification. Bool retains True/False identity; raw integers stay exact, floats use actual binary64 value. Strings accept Decimal Unicode digits and underscores; list Decimal triples are source data. Null is unmanaged, zero is managed. Input int is not restricted to Go width. A reached4300-digit display error is distinct from Decimal construction.
cache_size	int		Optional core exact-integral Decimal conversion with no business range. Null is unmanaged; zero is managed. Actual API/report cache_size is an exact integer, or a preserved bool for bool input. The documented appliance cache default5767168 is not inserted by this manager.
answer_default_zones	bool		Optional core bool then yes/no string for API and return values. Null is unmanaged. Documented appliance defaultfalse is not sent for an omitted field.
randomize_query_case	bool		Optional core bool then yes/no string in API and return values. Null is unmanaged. Documented appliance defaulttrue is not synthesized.
use_ipv4	bool		Optional core bool then yes/no string in API and return values. Null is unmanaged; appliance defaulttrue is not synthesized.
use_ipv6	bool		Optional core bool then yes/no string in API and return values. Null is unmanaged; appliance defaulttrue is not synthesized.
use_udp	bool		Optional core bool then yes/no string in API and return values. Null is unmanaged; appliance defaulttrue is not synthesized.
use_tcp	bool		Optional core bool then yes/no string in API and return values. Null is unmanaged; appliance defaulttrue is not synthesized.
state	str		present (default) creates or updates; absent deletes and verifies absence. Check mode still authenticates, reads and evaluates reached properties, while skipping writes and delete verification. Diff invents no output. Failure may follow a successful appliance mutation; there is no rollback. Local fixtures are not live BIG-IP/device or custody acceptance.
partition	str		Omitted uses execution-host F5_PARTITION including present-empty, otherwise Common. Explicit null/empty remains empty; only surrounding slashes are stripped. No Common-only policy. Runtime retains inherited bounded JSON/owner profile, original80MiB modeled backing/40MiB modeled work and one original context, with no refill.

Example

yaml

- name: Create with omitted appliance defaults
  f5networks.f5_modules.bigip_dns_resolver:
    name: dns-resolver
    provider:
      server: '{{ bigip_server }}'
      user: '{{ bigip_user }}'
      password: '{{ bigip_password }}'
      no_f5_teem: true # Explicit caller choice; runtime default is enabled.
  delegate_to: localhost

- name: Configure resolver route cache and transports
  f5networks.f5_modules.bigip_dns_resolver:
    name: dns-resolver
    route_domain: 7
    cache_size: 5767168
    answer_default_zones: false
    randomize_query_case: true
    use_ipv4: true
    use_ipv6: false
    use_udp: true
    use_tcp: true
    partition: Tenant
    provider:
      server: '{{ bigip_server }}'
      user: '{{ bigip_user }}'
      password: '{{ bigip_password }}'
      no_f5_teem: true # Explicit caller choice; runtime default is enabled.
  delegate_to: localhost

- name: Preview a resolver cache update
  f5networks.f5_modules.bigip_dns_resolver:
    name: dns-resolver
    cache_size: 50000
    provider:
      server: '{{ bigip_server }}'
      user: '{{ bigip_user }}'
      password: '{{ bigip_password }}'
      no_f5_teem: true # Explicit caller choice; runtime default is enabled.
  check_mode: true
  delegate_to: localhost

- name: Remove and verify the resolver
  f5networks.f5_modules.bigip_dns_resolver:
    name: dns-resolver
    state: absent
    provider:
      server: '{{ bigip_server }}'
      user: '{{ bigip_user }}'
      password: '{{ bigip_password }}'
      no_f5_teem: true # Explicit caller choice; runtime default is enabled.
  delegate_to: localhost