Azion CLI dns-record

The Azion CLI dns-record commands create, list, describe, update, and delete the records of an Edge DNS zone. A record is one name, one type, and the values Edge DNS answers with for that name. A record belongs to one zone, so every command takes the --zone-id of that zone. The fields of a record are on Zones and records. The options every command accepts, such as --format, --out, and -y, are on Global options.

Create

azion create dns-record creates a record in a zone, with the name, type, and values you pass:

This command creates an A record named www with two values and a TTL of 3600 seconds:

The command prints the ID of the record:

--rdata splits its value at every comma, so a value that contains a comma becomes several values. With --rdata 'v=spf1 include:a.example.com,b.example.com ~all', the record stores v=spf1 include:a.example.com and b.example.com ~all as two values. To keep the comma inside one value, wrap the value in double quotes inside the single quotes, or pass the value in a JSON file with --file.

This command creates a TXT record named spf2 whose one value contains a comma:

The command prints the ID of the record, which stores the value whole:

A --type value that is not a record type, such as ZZZ, is refused with this error:

List

azion list dns-record lists the records of a zone, 50 to a page:

This command lists the records of the zone with ID 1234:

The command prints one row per record:

The RDATA column joins the values of a record with a comma and a space. The spf record holds two values and the spf2 record holds one, and the two rows look almost the same. To read each value apart, describe the record with --format json.

Describe

azion describe dns-record prints the settings of one record:

This command describes the record with ID 100001:

The command prints the name, the type, the values, and the routing settings of the record:

With --format json, the command prints description, id, name, policy, rdata, ttl, type, and weight, with rdata as an array of one item per value. A record created without --policy holds the policy simple and the weight 255.

A record ID that does not exist in the zone fails with this error:

Update

azion update dns-record changes the name, type, values, TTL, or routing settings of a record:

--rdata replaces every value of the record and splits its value at every comma, as on create.

This command sets one value and a TTL of 7200 seconds on the record with ID 100001:

The command confirms the update:

The record then holds the single value 192.0.2.3, and its name and type stay www and A.

Delete

azion delete dns-record deletes a record from a zone:

This command deletes the record with ID 100001:

The command confirms the deletion:

Use a JSON file

azion create dns-record and azion update dns-record read the attributes of the record from a JSON file with --file. The zone stays on the command line as --zone-id, and on update the record stays on the command line as --record-id.

In the file, rdata is an array with one item per value, so a comma inside a value stays part of it. This file creates a TXT record named txt with one value and a TTL of 300 seconds:

Pass the file to the create command:

The command prints the ID of the record:

On update, the command changes only the fields in the file, and the fields you leave out keep their values. This file replaces the value of the record and sets a TTL of 600 seconds:

Pass the file to the update command:

The command confirms the update:

The record keeps the name txt and the type TXT, and holds the value v=spf1 -all with a TTL of 600 seconds.

Related resources