DNSZoneClass

DNSZoneClass is the Schema for the dnszoneclasses API.

Platform-provided resource. Datum operates this resource; you typically reference or read it rather than create it. See Platform resources.

API resource reference for DNSZoneClass. See Platform resources for related platform-provided resources. A DNSZone selects a class through its spec.dnsZoneClassName. To read or inspect, see Reading resources. For the underlying concept, see Domains & DNS.

This resource is part of the v1alpha1 API and is subject to change. Fields and behavior may evolve in future releases.

Identity

Group	dns.networking.miloapis.com
Version	v1alpha1
Kind	DNSZoneClass
Scope	Platform

Overview

A DNSZoneClass describes a class of DNS zone: which downstream controller or backend implementation serves the zones that reference it, and the default behavior applied to those zones. You define a DNSZoneClass once, at the Platform level, so that individual DNS zones can select a backend (for example, powerdns or hickory) along with default TTLs and a nameserver-assignment policy.

Spec fields

Field	Type	Required	Description
spec.controllerName	string	Yes	Identifies the downstream controller/backend implementation (e.g., powerdns, hickory).
spec.defaults	Object	No	Provides optional default values applied to managed zones.
spec.defaults.defaultTTL	integer	No	Default TTL applied to records when not otherwise specified.
spec.nameServerPolicy	Object	No	Defines how nameservers are assigned for zones using this class.
spec.nameServerPolicy.mode	string	Yes	Which policy to use. Enum: Static.
spec.nameServerPolicy.static	Object	No	A static list of authoritative nameservers when mode == "Static".
spec.nameServerPolicy.static.servers	[]string	Yes	The authoritative nameservers.

spec.nameServerPolicy.mode and spec.nameServerPolicy.static.servers are only required when their parent object is present. The single top-level required field is spec.controllerName.

Status fields (read-only)

Field	Type	Description
status.conditions	[]Object	Represent the current state of the resource. Common types include Accepted and Programmed to standardize readiness reporting across controllers.

Usage

apiVersion: dns.networking.miloapis.com/v1alpha1
kind: DNSZoneClass
metadata:
  name: powerdns
spec:
  controllerName: powerdns

# Create or update the DNSZoneClass
datumctl apply -f dnszoneclass.yaml

# List all DNSZoneClasses
datumctl get dnszoneclasses

# Inspect a single DNSZoneClass
datumctl describe dnszoneclass powerdns

Run datumctl explain dnszoneclasses --recursive to see the full, live field tree for this resource.