Logo
Akamai APIs API Documentation

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.

 

Body PARAM

Key Datatype Required Description 
page
string (Optional) Which page of results to return. The first page is page `1`, the default value.
pageSize
string (Optional) The number of results per page to return, `25` by default.
showAll
string (Optional) Disables paging and sorting and shows the entire list all at once, `false` by default. Using this parameter may significantly increase the response time.
accountSwitchKey
string (Optional) For customers who manage more than one account, this [runs the operation from another account](https://techdocs.akamai.com/developer/docs/manage-many-accounts-with-one-api-client). The Identity and Access Management API provides a [list of available account switch keys](https://techdocs.akamai.com/iam-api/reference/get-client-account-switch-keys).



HEADERS

Key Datatype Required Description 
Accept
string




RESPONSES

status OK

{ "metadata": { "contractIds": [ "K-0N7RAK71" ], "page": 1, "pageSize": 3, "showAll": false, "totalElements": 17 }, "versions": [ { "activationState": "ACTIVE", "aliasCount": 1, "contractId": "C-0N7RAC71", "lastActivationDate": "2021-02-02T12:00:00Z", "lastModifiedBy": "afero", "lastModifiedDate": "2021-02-02T12:00:00Z", "signAndServe": true, "signAndServeAlgorithm": "RSA_SHA512", "type": "PRIMARY", "versionId": "b55d3882-444a-4c19-8d9c-eb232867c1ed", "zone": "example.com" }, { "activationState": "ACTIVE", "aliasCount": 1, "contractId": "K-0N7RAK71", "lastActivationDate": "2021-01-03T12:00:00Z", "lastModifiedBy": "jperez", "lastModifiedDate": "2021-01-03T12:00:00Z", "signAndServe": false, "type": "PRIMARY", "versionId": "ae02357c-693d-4ac4-b33d-8352d9b7c786", "zone": "example.com" }, { "activationState": "OBSOLETE", "aliasCount": 1, "contractId": "C-0N7RAC71", "lastActivationDate": "2021-12-19T08:15:42Z", "lastModifiedBy": "jdupont", "lastModifiedDate": "2021-12-19T08:15:42Z", "signAndServe": false, "type": "PRIMARY", "versionId": "7949b2db-ac43-4773-a3ec-dc93202142fd", "zone": "example.com" } ] }



Curl
curl -X GET 'https://undefined/config-dns/v2/zones/:zone/versions?page=&pageSize=&showAll=&accountSwitchKey=' -H 'Accept: application/json'

ENDPOINTS