DNS Zones

A DNS zone is a portion of the DNS namespace that is managed by a specific organization or administrator. In ResolvX, zones are the primary containers for your DNS records.

Creating a Zone

Via Dashboard

Navigate to Zones in the sidebar
Click Create Zone
Enter the zone name (e.g., example.com)
Click Create

Via API

curl -X POST http://localhost:8080/api/v1/zones \
  -H "Content-Type: application/json" \
  -d '{"name": "example.com"}'

Via CLI

resolvx zone create example.com

Listing Zones

Via API

curl http://localhost:8080/api/v1/zones

Response:

{
  "zones": [
    {
      "name": "example.com",
      "soa": {
        "mname": "ns1.example.com.",
        "rname": "admin.example.com.",
        "serial": 2024011501,
        "refresh": 86400,
        "retry": 7200,
        "expire": 3600000,
        "minimum": 300
      },
      "created_at": "2024-01-15T10:30:00Z",
      "updated_at": "2024-01-15T10:30:00Z"
    }
  ]
}

Via CLI

resolvx zone list

Zone Details

Get detailed information about a zone:

curl http://localhost:8080/api/v1/zones/example.com

SOA Record

Every zone automatically has a Start of Authority (SOA) record created. The SOA contains:

Field	Description	Default
`mname`	Primary nameserver	`ns1.<zone>.`
`rname`	Admin email (@ replaced with .)	`admin.<zone>.`
`serial`	Zone version number	Auto-generated
`refresh`	Refresh interval	86400 (24h)
`retry`	Retry interval	7200 (2h)
`expire`	Expiry time	3600000 (~41 days)
`minimum`	Minimum TTL	300 (5m)

Deleting a Zone

Deleting a zone will also delete all records in that zone. This action cannot be undone.

Via API

curl -X DELETE http://localhost:8080/api/v1/zones/example.com

Via CLI

resolvx zone delete example.com

Exporting Zone Files

Export a zone in BIND format:

Via Dashboard

Go to Zones
Click the ... menu on a zone
Select Download Zone File

Via API

curl http://localhost:8080/api/v1/zones/example.com/export

This returns a BIND-compatible zone file:

; Zone file for example.com
; Generated by ResolvX

$ORIGIN example.com.
$TTL 300

@	IN	SOA	ns1.example.com. admin.example.com. (
			2024011501	; Serial
			86400		; Refresh
			7200		; Retry
			3600000		; Expire
			300 )		; Minimum TTL

; A Records
www	300	IN	A	192.168.1.100

Next Steps

Records - Add DNS records to your zones
GTM Overview - Set up traffic management policies

Zones

On this page