> ## 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.

# DNSZone

> DNSZone is the Schema for the dnszones API.

<Note>
  API resource reference for **DNSZone**, part of the [DNS service](/api/dns/overview). To create or change one, see [Changing resources](/datumctl/resources/changing); to read or inspect, see [Reading resources](/datumctl/resources/reading). For the underlying concept, see [Domains & DNS](/domain-dns/dns).
</Note>

<Warning>
  This resource is part of the `v1alpha1` API and is subject to change. Fields and behavior may change in future releases.
</Warning>

## Identity

|         |                               |
| ------- | ----------------------------- |
| Group   | `dns.networking.miloapis.com` |
| Version | `v1alpha1`                    |
| Kind    | `DNSZone`                     |
| Scope   | Project                       |

## 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

| Field                   | Type   | Required | Description                                              |
| ----------------------- | ------ | -------- | -------------------------------------------------------- |
| `spec.dnsZoneClassName` | string | Yes      | References the DNSZoneClass used to provision this zone. |
| `spec.domainName`       | string | Yes      | The FQDN of the zone (e.g., `example.com`).              |

## Status fields (read-only)

| Field                | Type      | Description                                                                    |
| -------------------- | --------- | ------------------------------------------------------------------------------ |
| `status.conditions`  | \[]Object | Tracks state such as Accepted and Programmed readiness.                        |
| `status.domainRef`   | Object    | References the Domain this zone belongs to.                                    |
| `status.nameservers` | \[]string | Lists the active authoritative nameservers for this zone.                      |
| `status.recordCount` | integer   | The number of DNSRecordSet resources in this Project that reference this zone. |

## Usage

```yaml theme={null}
apiVersion: dns.networking.miloapis.com/v1alpha1
kind: DNSZone
metadata:
  name: example-com
spec:
  dnsZoneClassName: standard
  domainName: example.com
```

```bash theme={null}
datumctl apply -f dnszone.yaml --project my-project
datumctl get dnszones --project my-project
datumctl describe dnszone example-com --project my-project
```

<Tip>
  Run `datumctl explain dnszones --recursive` to see the full, live field tree for this resource.
</Tip>