Add, edit, or delete a record
Add, change, or delete a record in an Edge DNS zone from Azion Console, the Azion CLI, or the API, and see when Azion's nameservers answer it.
You can add, edit, or delete a record in an Edge DNS zone from Azion Console, the Azion CLI, or the Azion API. Each record tells Azion’s nameservers which values to return for one name of the zone. To create the zone itself, refer to Create, edit, or delete a zone.
Prerequisites
Console
- A zone in Edge DNS for your domain. To create one, refer to Create, edit, or delete a zone.
- The Edit Edge DNS permission, which requires View Edge DNS. Refer to Teams permissions.
- Access to Azion Console. To sign in, refer to Access Azion Console.
Add a record
The example adds an A record that answers 192.0.2.1 for www.example.com. Replace the name, the type, and the value with your own. The value format of each type is on Record types.
Console
To add the record in Azion Console:
Access Azion Console > Edge DNS.
On the Zones page, select the row of the zone.
The Create Record drawer opens.
In Name, enter www. The name is relative to the zone, and the Console adds the domain for you, so never type it. To answer for the domain itself, enter @.
In Record Type, select A - IPv4 Address.
In TTL (seconds), keep 3600, or enter how long resolvers may cache the answer. For an ANAME record, keep the TTL at 20.
In Value, enter 192.0.2.1. To answer with several values, enter one value per line.
In the Policy section, keep Policy Type at Simple. To share answers between several records of one name, select Weighted and follow Weight records to balance traffic.
The Console shows Edge DNS Record has been created, and the record appears in the Records table of the zone.
The API refuses a record that conflicts with the zone, such as a second simple record of the same name and type, and the record is not saved. For each refusal and its code, refer to Zones and records.
Save a record before anything queries its name. A name that nobody queried before you saved its record answers within seconds. A name queried earlier is answered NXDOMAIN for up to one hour, the SOA minimum. To fix it, refer to A new record returns NXDOMAIN.
Edit a record
You change a record in place, with no need to delete and add it again. The example lowers the TTL of www to 300 seconds, which shortens how long resolvers keep the old value before a planned change. For that practice, refer to Lower the TTL a few days before a planned change.
Console
To edit the record in Azion Console:
Access Azion Console > Edge DNS.
On the Zones page, select the row of the zone.
In the Records table, select the row of the record. The Edit Record drawer opens with its fields.
In TTL (seconds), enter 300. To change what the record answers, edit Value instead.
The Console shows Edge DNS Record has been updated, and the TTL (seconds) column of the record reads 300.
A change to an existing record can take a few minutes to reach every nameserver. After that, each resolver keeps the old value until its TTL runs out. If a query still returns the old value, refer to A changed record still returns the old value.
Delete a record
Deleting a record removes it from the zone, and it cannot be reversed. For a weighted record, first set its weight to 0, as Set a weight of 0 before you delete a weighted record explains.
Console
To delete the record in Azion Console:
Access Azion Console > Edge DNS.
On the Zones page, select the row of the zone.
In the Records table, open the actions of the record’s row and select Delete.
In the Delete record dialog, type the Name of the record in the box, such as www or @.
The Console shows Edge DNS Record successfully deleted, and the record leaves the Records table.
Resolvers that cached an answer from the record keep it until the record’s TTL runs out.