DNSZoneClass

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.

Overview

Concepts

Resource Manager

IAM

Compute

Networking

DNS

IPAM

Quota

Billing

Telemetry

Notification

Platform resources

Identity

Overview

Spec fields

Status fields (read-only)

Usage

​Identity

​Overview

​Spec fields

​Status fields (read-only)

​Usage

Identity

Overview

Spec fields

Status fields (read-only)

Usage