Akamai APIs API Documentation
Test network connectivity with MTR
POST https://{{host}}/edge-diagnostics/v1/mtr
Uses MTR to provide information about packet loss and latency between an edge server IP, location, or Site Shield map and a remote destination. To run this operation for an IP, you may need to verify an IP if it belongs to an edge server. To run this operation for a GTM hostname, run List GTM properties and List test and target IPs for a GTM hostname operations first to get the test and target IPs for the hostname.
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
| {
"completedTime": "2021-03-19T06:46:08Z",
"createdBy": "alfulani",
"createdTime": "2021-03-19T06:45:39Z",
"destinationIpLocation": {
"asNumber": 20005,
"city": "TOKYO",
"countryCode": "JP",
"regionCode": "13"
},
"executionStatus": "SUCCESS",
"request": {
"destination": "192.0.2.0",
"destinationType": "IP",
"packetType": "ICMP",
"port": 80,
"resolveDns": true,
"showIps": true,
"showLocations": true,
"source": "192.0.2.9",
"sourceType": "EDGE_IP"
},
"result": {
"averageLatency": 0.5,
"hops": [
{
"averageLatency": 51.3,
"bestRtt": 1.3,
"host": "NNN.NNN-NNNN.netarch.akamai.com",
"ip": "192.0.2.7",
"ipLocation": {
"asNumber": 20000,
"city": "TOKYO",
"countryCode": "JP",
"regionCode": "13"
},
"lastPacketLatency": 1.3,
"number": 1,
"packetLoss": 0,
"sentPackets": 10,
"standardDeviation": 82.4,
&quo Curl curl -X POST 'https://host/edge-diagnostics/v1/mtr?accountSwitchKey=' -H 'Content-Type: application/json' -H 'Accept: application/json' -d '{"destination":"192.0.2.0","destinationType":"IP","packetType":"ICMP","port":80,"resolveDns":true,"showIps":true,"showLocations":true,"source":"192.0.2.9","sourceType":"EDGE_IP"}' ENDPOINTS |