Akamai APIs API Documentation
Get secondary zones transfer status
POST https://{{host}}/config-dns/v2/zones/zone-transfer-status
Returns the results of the most recent zone transfer attempts for one or more zones. When you configure a SECONDARY zone, several Akamai name servers known as zone transfer agents perform zone transfer requests to fetch the record data from the zone's configured master name servers. The data returned by this operation describes the results of those zone transfers.
Body
PARAM
| Key | Datatype | Required | Description |
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 |
Content-Type
|
string | ||
Accept
|
string |
RESPONSES
status OK
| {
"zones": [
{
"masters": [
{
"masterIP": "192.0.2.70",
"zoneTransferAgents": [
{
"actions": [
{
"actionType": "SOA",
"lastSuccessSerial": 2019017037,
"lastSuccessTimestamp": "2019-01-23T20:47:55Z"
},
{
"actionType": "XFR",
"lastFailureTimestamp": "2019-01-23T20:47:55Z",
"messages": [
{
"errorCode": "TIMED_OUT",
"timestamp": "2021-11-23T20:47:55Z",
"tokens": []
},
{
"errorCode": "TOO_MANY_RECORDS",
"timestamp": "2019-01-23T20:47:55Z",
"tokens": [
"2019017001 108163 100000"
]
}
]
}
],
"agentIP": "192.0.2.189",
"lastFailureTimestamp": "2021-01-23T20:47:55Z"
},
{
"actions": [
{
"actionType": "SOA",
"lastSuccessSerial": 2019017044,
"lastSuccessTimestamp": "2019-01-23T20:47:55Z"
},
{
"actionType": "XFR",
"lastFailureTimestamp": "2019-01-17T20:47:55Z",
"messages": [
{
"errorCode": "TOO_MANY_RECORDS",
"timestamp": "2019-01-17T20:47:55Z",
"tokens": [
"2019015704 107931 100000"
]
},
{
"errorCode": "TIMED_OUT",
"timestamp": "2021-12-25T20:47:55Z",
"tokens": []
}
]
}
],
"agentIP": "192.0.2.202",
"lastFailureTimestamp": "2019-01-17T20:47:55Z"
}
]
},
{
"masterIP": "192.0.2.49",
"zoneTransferAgents": [
{
"actions": [
{
"actionType": "SOA",
"lastSuccessSerial": 2019017044,
"lastSuccessTimestamp": "2019-01-21T20:47:55Z"
},
{
"actionType": "XFR",
"lastFailureTimestamp": "2019-01-23T20:47:55Z",
"messages": [
{
"errorCode": "TOO_MANY_RECORDS",
"timestamp": "2019-01-23T20:47:55Z",
"tokens": [
"2019017044 108173 100000"
]
},
{
"errorCode": "TIMED_OUT",
"timestamp": "2019-01-21T20:47:55Z",
"tokens": []
},
{
"errorCode": "EOF",
"timestamp": "2019-01-17T20:47:55Z",
"tokens": []
}
]
}
],
"agentIP": "192.0.2.126",
"lastFailureTimestamp": "2019-01-23T20:47:55Z"
},
{
"actions": [
{
"actionType": "SOA",
"lastSuccessSerial": 2019017044,
"lastSuccessTimestamp": "2019-01-23T20:47:55Z"
},
{
"actionType": "XFR",
"lastFailureTimestamp": "2019-01-17T20:47:55Z",
"messages": [
{
"errorCode": "TOO_MANY_RECORDS",
"timestamp": "2019-01-17T20:47:55Z",
"tokens": [
"2019015768 107946 100000"
]
},
{
"errorCode": "TIMED_OUT",
"timestamp": "2019-01-15T20:47:55Z",
"tokens": []
},
{
"errorCode": "EOF",
"timestamp": "2021-12-10T20:47:55Z",
"tokens": []
}
]
}
],
"agentIP": "192.0.2.98",
"lastFailureTimestamp": "2019-01-17T20:47:55Z"
}
]
}
],
"metadata": {
"lastFailureTimestamp": "2019-01-14T16:27:02Z",
"lastSuccessSerial": 2021042400,
"lastSuccessTimestamp": "2019-01-30T22:14:34Z"
},
"zone": "example.com"
}
]
} |
Curl
curl -X POST 'https://undefined/config-dns/v2/zones/zone-transfer-status?accountSwitchKey=' -H 'Content-Type: application/json' -H 'Accept: application/json' -d '{"comment":"Removing rivers and streams.","zones":["river.com","stream.com"]}'
ENDPOINTS