Skip to main content
API resource reference for DNSZone, part of the DNS service. To create or change one, see Changing resources; 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 change in future releases.

Identity

Groupdns.networking.miloapis.com
Versionv1alpha1
KindDNSZone
ScopeProject

Overview

A DNSZone represents an authoritative DNS zone for a fully qualified domain name, provisioned from a referenced DNSZoneClass. Use it to establish the zone (for example, example.com) that DNS record sets are attached to within a Project.

Spec fields

FieldTypeRequiredDescription
spec.dnsZoneClassNamestringYesReferences the DNSZoneClass used to provision this zone.
spec.domainNamestringYesThe FQDN of the zone (e.g., example.com).

Status fields (read-only)

FieldTypeDescription
status.conditions[]ObjectTracks state such as Accepted and Programmed readiness.
status.domainRefObjectReferences the Domain this zone belongs to.
status.nameservers[]stringLists the active authoritative nameservers for this zone.
status.recordCountintegerThe number of DNSRecordSet resources in this Project that reference this zone.

Usage

apiVersion: dns.networking.miloapis.com/v1alpha1
kind: DNSZone
metadata:
  name: example-com
spec:
  dnsZoneClassName: standard
  domainName: example.com
datumctl apply -f dnszone.yaml --project my-project
datumctl get dnszones --project my-project
datumctl describe dnszone example-com --project my-project
Run datumctl explain dnszones --recursive to see the full, live field tree for this resource.
Last modified on July 2, 2026