You can create, edit, or delete an Edge DNS zone from Azion Console, the Azion CLI, or the Azion API. To add or change the records inside a zone, refer to Add, edit, or delete a record instead.
Select your interface once. The prerequisites and every task below show only that path.
- The Edit Edge DNS permission. It grants access to create, edit, and remove zones, and it requires View Edge DNS. Refer to Teams permissions.
- To create a zone, a domain you control that no other zone in Azion hosts.
A zone holds one domain, and the domain is fixed once the zone exists. Replace example.com with your domain in every step.
To create the zone with the Azion CLI, run:
The command prints the ID of the zone:
The zone exists and is active. To read the nameservers for your registrar, describe the zone:
The output lists them under Nameservers::
To create the zone with the Azion API, send a POST request to the zones endpoint. Replace [TOKEN VALUE] with your personal token:
A 201 returns the zone:
The nameservers array lists the three nameservers to set at your registrar. Record the id: every later request on the zone uses it.
To create the zone in Azion Console:
Name the zoneIn the General section, enter a Name of 1 to 50 characters, such as example-zone. The name identifies the zone in lists.
Enter the domainIn the Domain Name section, enter your root domain in Domain Name, such as example.com.
(Optional) Turn on DNSSECTo sign the zone from the start, turn on Enable DNSSEC in the DNSSEC section.
Keep Active turned onIn the Status section, keep Active turned on.
The Console opens the zone’s Records tab and shows Your DNS zone has been created. To complete the setup, ensure the Azion nameservers are configured in your domain provider.
To copy the nameservers for your registrar, return to the Zones page and select Copy Nameserver Values. It copies the three names joined by semicolons. The zone’s Main Settings tab also lists each one under Configure your Nameserver, with a copy button.
A domain another zone already hosts is refused. For each refusal and its code, refer to Zones and records.
The new zone answers only for the records you add to it. Resolvers on the internet ask Azion’s nameservers only after you delegate the domain to all three at your registrar: ns1.aziondns.net, ns2.aziondns.com, and ns3.aziondns.org. For the full move, refer to Migrate nameservers to Azion.
After creation, you can rename a zone, turn it off or back on, and turn DNSSEC on. The domain cannot change: to serve another domain, create another zone.
A zone with Active turned off keeps its records, but Azion’s nameservers answer its names with REFUSED. Like any change, this can take a few minutes to reach every nameserver.
To rename the zone with the Azion CLI, pass the new name to --name. Replace <zone-id> with the ID of your zone:
The command confirms the update:
To turn the zone off, set --active=false. To turn it back on, set --active=true:
The command confirms the update:
To check the result, run azion describe dns-zone --zone-id <zone-id>. It prints the name under Name: and the state under Active:, which reads false for a zone turned off.
DNSSEC has its own command. To turn it on, refer to Turn on DNSSEC for a zone.
To rename the zone with the Azion API, send a PATCH request with the new name. Replace <zone-id> with the id of your zone:
A 200 returns the zone with the new name:
To turn the zone off, send {"active":false} in the same request:
A 200 returns the zone with active set to false:
A PATCH changes only the fields you send. To turn the zone back on, send {"active":true}. A request that sends domain is refused with 19036 Domain Cannot Be Modified.
DNSSEC has its own endpoint. To turn it on, refer to Turn on DNSSEC for a zone.
To edit the zone in Azion Console:
Open the zoneOn the Zones page, select the row of the zone. It opens on the Main Settings tab, where the Domain Name field of the Domain section is locked.
(Optional) Rename the zoneIn the General section, enter a new Name.
(Optional) Turn the zone off or onIn the Status section, turn Active off to stop answers for the zone, or on to resume them.
(Optional) Turn on DNSSECIn the DNSSEC section, turn on Enable DNSSEC.
The Console shows Edge DNS has been updated, and the zone stays open on Main Settings.
After you turn on DNSSEC, reload the page. The Key Tag, Algorithm, Digest Type, and Digest fields then show the values your registrar needs, each with a copy button. To give them to your registrar, refer to Turn on DNSSEC for a zone.
The same Enable DNSSEC switch turns DNSSEC off. Before you turn it off, follow the order in Turn DNSSEC off.
Deleting a zone removes it with its records and settings, and it cannot be reversed. To stop answers for the zone while you keep its records, turn Active off instead.
To delete the zone with the Azion CLI, replace <zone-id> with the ID of your zone:
The command confirms the delete:
The zone and its records are deleted. Afterward, the zone no longer appears on the Zones page in Azion Console.
To delete the zone with the Azion API, send a DELETE request to the zone. Replace <zone-id> with the id of your zone:
The API answers 200:
The zone and its records are deleted. Afterward, the zone no longer appears on the Zones page in Azion Console, and a GET on its ID returns 404 with 10004 Not Found.
To delete the zone in Azion Console:
Select Delete on the zone's rowOn the Zones page, open the actions of the zone’s row and select Delete. The zone’s edit page has no delete control.
Type the zone nameIn the Delete zone dialog, type the zone’s name in the box.
The Console shows Your Edge DNS has been deleted, and the zone leaves the Zones list.