← Back to index

opnsense_unbound_host_override (Resource)

Host overrides can be used to change DNS results from client queries or to add custom DNS records.

Example Usage

// 'A' record
resource "opnsense_unbound_host_override" "a_override" {
  enabled = true
  description = "A record override"

  hostname = "*"
  domain = "example.com"
  server = "192.168.1.1"
}

// 'AAAA' record
resource "opnsense_unbound_host_override" "aaaa_override" {
  enabled = true

  type = "AAAA"
  hostname = "*"
  domain = "example.com"
  server = "fd00:abcd::1"
}

// 'MX' record
resource "opnsense_unbound_host_override" "mx_override" {
  enabled = false
  description = "MX record override"

  type = "MX"
  hostname = "*"
  domain = "example.com"

  mx_priority = 10
  mx_host = "mail.example.dev"
}

Schema

Required

  • domain (String) Domain of the host, e.g. example.com
  • hostname (String) Name of the host, without the domain part. Use * to create a wildcard entry.

Optional

  • description (String) Optional description here for your reference (not parsed).
  • enabled (Boolean) Enable the override for this host. Defaults to true.
  • mx_host (String) Host name of MX host, e.g. mail.example.com. Must be set when type is MX.
  • mx_priority (Number) Priority of MX record, e.g. 10. Must be set when type is MX.
  • server (String) IP address of the host, e.g. 192.168.100.100 or fd00:abcd::1. Must be set when type is A or AAAA.
  • type (String) Type of resource record. Available values: A, AAAA, MX. Defaults to A.

Read-Only

  • id (String) UUID of the host override.

Import

In Terraform v1.5.0 and later, use an import block to import opnsense_unbound_host_override using the id. For example:

import {
  to = opnsense_unbound_host_override.example
  id = "<opnsense-resource-id>"
}

Using terraform import, import opnsense_unbound_host_override using the id. For example:

% terraform import opnsense_unbound_host_override.example <opnsense-resource-id>