Skip to main content

Overview

A DNS zone is the authoritative domain boundary that contains all record sets for a given domain (e.g., example.com.). Creating a zone in Xloud DNS registers that domain with the platform’s nameservers and makes it available for record management.
Prerequisites
  • An active Xloud account with appropriate permissions
  • Access to the Xloud Dashboard (https://connect.<your-domain>) or CLI configured with credentials
  • API credentials sourced (source admin-openrc.sh)
Zone names must end with a trailing dot. Submitting example.com without the trailing dot is invalid and will result in a creation error.

Zone Types

TypeDescriptionUse Case
PRIMARYYour authoritative copy — you manage the recordsStandard zone management
SECONDARYRead-only replica pulled from a primary via zone transferDisaster recovery, geographic redundancy

Create a Zone

1

Navigate to DNS Zones

Log in to the Xloud Dashboard (https://connect.<your-domain>) and navigate to Project → DNS → Zones.Click Create Zone to open the zone creation dialog.
2

Configure zone details

FieldDescription
Zone NameFully qualified domain name with trailing dot (e.g., example.com.)
EmailAdministrative contact address — written into the SOA record
TTLDefault TTL in seconds for records in this zone (e.g., 3600)
DescriptionOptional — visible in zone listings
TypePRIMARY for a zone you manage; SECONDARY for a replica zone
3

Review and create

Click Submit. The zone enters PENDING status during creation and transitions to ACTIVE within a few seconds.
Zone appears in the list with status ACTIVE.

Zone Lifecycle


List and Manage Zones

openstack zone list
Deleting a zone removes all record sets within it permanently. DNS resolution for the domain will fail immediately. Ensure the zone is no longer in use before deletion.

Next Steps

Manage Records

Add A, AAAA, CNAME, MX, and TXT records to your zone

Record Types Reference

Full reference for every supported DNS record type

Reverse DNS

Configure PTR records for your zone’s IP addresses

Troubleshooting

Resolve zone stuck in PENDING or ERROR status