> ## Documentation Index
> Fetch the complete documentation index at: https://datum-4926dda5-docs-api-reference-demo.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# DNS

> Managed authoritative DNS on Datum Cloud — zones and the record sets that answer queries for them.

Datum Cloud provides managed authoritative DNS through the `dns.networking.miloapis.com` API. You declare a zone for a domain you control, add the record sets that answer queries for it, and Datum handles provisioning the zone on a backend, assigning nameservers, and publishing your records. Zones and record sets are Project resources you create with `datumctl apply -f`; a Platform-level zone class selects the backend controller and supplies provisioning defaults.

<Warning>
  The DNS API is **alpha** (`v1alpha1`). Fields and behavior may change in backward-incompatible ways between releases.
</Warning>

## Resources

<CardGroup cols={2}>
  <Card title="DNSZone" icon="globe" href="/api/dns/dnszone">
    A managed zone for a domain (for example `example.com`). Binds a domain name to a zone class and reports its active nameservers.
  </Card>

  <Card title="DNSRecordSet" icon="list" href="/api/dns/dnsrecordset">
    One or more records of a single type (A, AAAA, CNAME, and more) attached to a zone.
  </Card>
</CardGroup>

**Platform-provided:** the [DNSZoneClass](/api/dns/dnszoneclass) referenced by a zone lives under [Platform resources](/api/platform/overview).

## How the pieces fit together

* A **DNSZone** references a **DNSZoneClass** by name (`spec.dnsZoneClassName`) and declares the fully qualified `spec.domainName`. Once accepted, its status reports the authoritative `nameservers` you delegate to and a `recordCount`.
* A **DNSRecordSet** references its **DNSZone** (`spec.dnsZoneRef`), sets a `spec.recordType`, and carries one or more `spec.records`. Its status tracks per-owner readiness.

<Tip>
  Inspect the exact fields for any resource with `datumctl explain`, for example `datumctl explain dnszones.spec` or `datumctl explain dnsrecordsets.spec`.
</Tip>

## Learn more

* [API resources overview](/api/overview) — the resource reference landing page across all Datum Cloud services.
* [Domains & DNS](/domain-dns/dns) — concepts behind managing domains and DNS on Datum Cloud.
* [Changing resources](/datumctl/resources/changing) — how to apply, edit, and safely preview changes to these resources.
* [Reading resources](/datumctl/resources/reading) — how to list, get, and inspect these resources with `datumctl`.