Versions

Number of APIs: 5

1. List a zone's versions

GET https://{{host}}/config-dns/v2/zones/:zone/versions

Shows the settings for current and prior versions of this Zone, in reverse chronological order of modification. Many versions in this list may look very similar because a new version is created every time the zone's settings or record sets are changed. This operation is paginated.

---

2. Show zone version differences

GET https://{{host}}/config-dns/v2/zones/:zone/versions/diff?from={{from}}&to={{to}}

Displays the difference between any two versions of a zone, as specified in the query parameters.

---

3. Get a zone version

GET https://{{host}}/config-dns/v2/zones/:zone/versions/:uuid

Returns an image of the Zone from a previous version. Shows only zone settings, not record sets.

---

4. Get a version's record sets

GET https://{{host}}/config-dns/v2/zones/:zone/versions/:uuid/recordsets

Lists all record sets for this zone. It works only for PRIMARY and SECONDARY zones. This operation paginates.

---

5. Reactivate a version

POST https://{{host}}/config-dns/v2/zones/:zone/versions/:uuid/recordsets/activate

Creates and activates a new version of the zone by copying the record sets from a prior version of this zone and reapplying them to the current version. The new version has a new, auto-incremented SOA serial number, and the zone's modification data is set to the current time and user. All other zone settings remain the same as the current version.

---