Akamai APIs API Documentation
Get the Connectivity problems scenario response
GET https://{{host}}/edge-diagnostics/v1/connectivity-problems/requests/:requestId
Returns the status of the asynchronous Run the connectivity problems scenario request. Operations with the SUCCESS status include also fetched GREP, cURL, and MTR data.
Body
PARAM
| Key | Datatype | Required | Description |
includeContentResponseBody
|
string | (Optional) Includes response bodies in the response. | |
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
| {
"clientIpLocation": {
"asNumber": 9583,
"city": "BANGALORE",
"countryCode": "IN",
"regionCode": "KA"
},
"connectivity": [
{
"additionalRequestParameters": {
"destination": "2001:db8:a72f:1cc:7b10:c16d:ffc3:62cd",
"source": "192.0.2.14"
},
"destinationContext": "ORIGIN_IP",
"destinationIpLocation": {
"asNumber": 20940,
"city": "ASHBURN",
"countryCode": "US",
"regionCode": "VA"
},
"executionContext": "EDGE_IP_TO_ORIGIN_IP",
"executionStatus": "SUCCESS",
"result": {
"averageLatency": 200.3,
"hops": [
{
"averageLatency": 8577,
"bestRtt": 7550,
"host": "ae0.tata-bom3.netarch.akamai.com",
"ip": "2001:db8:53be:7e65:535b:3683:fa1:f12b",
"ipLocation": {
"asNumber": 20940,
"city": "MUMBAI",
"countryCode": "IN",
"regionCode": "MH"
},
"lastPacketLatency": 7550,
"number": 1,
"packetLoss": 60,
"sentPackets": 10,
"standardDeviation": 956.9,
"worstRtt": 9749
},
{
"averageLatency": 200.3,
"bestRtt": 200.3,
"host": "g2600-1408-7400-0000-0000-0000-17c7-3f1b.deploy.static.akamaitechnologies.com",
"lastPacketLatency": 200.3,
"number": 2,
"packetLoss": 0,
"sentPackets": 10,
"standardDeviation": 0.1,
"worstRtt": 200.6
}
],
"host": "a23-212-50-38.deploy.akamaitechnologies.com",
"packetLoss": 0,
"result": "Start: 2021-09-29T03:56:40+0000\nHOST: a23-212-50-38.deploy.akamaitechnologies.com Loss% Snt Last Avg Best Wrst StDev\n 1.|-- ae0.tata-bom3.netarch.akamai.com (2600:140f:4::1) 60.0% 10 7550. 8577. 7550. 9749. 956.9\n 2.|-- 2403:0:100::911 0.0% 10 0.5 0.6 0.3 2.8 0.8\n 3.|-- if-ae-1-101.tcore2.mlv-mumbai.ipv6.as6453.net (2001:db8::c) 0.0% 10 0.4 4.4 0.3 37.5 11.6\n 4.|-- if-ae-12-2.tcore1.l78-london.ipv6.as6453.net (2001:db8::d) 0.0% 10 128.4 128.4 128.2 129.0 0.2\n 5.|-- if-ae-15-2.tcore3.njy-newark.ipv6.as6453.net (2001:db8::e) 0.0% 10 199.5 199.5 199.4 199.7 0.1\n 6.|-- if-ae-1-3.tcore4.njy-newark.ipv6.as6453.net (2001:db8::b) 0.0% 10 199.3 205.2 199.2 227.7 10.0\n 7.|-- if-ae-12-2.tcore3.aeq-ashburn.ipv6.as6453.net (2001:db8::b) 0.0% 10 204.3 204.4 204.2 204.6 0.1\n 8.|-- 2001:5a0:600:502::2 0.0% 10 204.3 204.3 204.2 204.4 0.0\n 9.|-- ae1.r01.iad01.icn.netarch.akamai.com (2600:1488:a180:125::a) 0.0% 10 215.6 214.2 204.5 262.8 17.6\n 10.|-- ae3.r01.iad03.icn.netarch.akamai.com (2600:1488:5fc3:4d::b) 0.0% 10 213.3 206.9 204.4 213.3 3.3\n 11.|-- ae21.r02.iad03.ien.netarch.akamai.com (2600:1488:a181:211::b) 0.0% 10 218.4 206.3 200.1 227.5 9.8\n 12.|-- ae3.ctl-iad4.netarch.akamai.com (2600:1488:a181:205::b) 0.0% 10 205.0 240.7 204.8 382.7 68.8\n 13.|-- g2600-1408-7400-0000-0000-0000-17c7-3f1b.deploy.static.akamaitechnologies.com (2 0.0% 10 200.3 200.3 200.3 200.6 0.1",
"startTime": 1632887800
},
"sourceContext": "EDGE_IP_CONNECTED_TO_ORIGIN",
"sourceIpLocation": {
"asNumber": 20940,
"city": "MUMBAI",
"countryCode": "IN",
"regionCode": "MH"
},
"suggestedActions": [
"Look for a packet loss or sudden jumps in the hop time.",
"For a loss or latency within the end user ISP network, ask the end user to contact thier ISP.",
"For a loss or latency within Akamai network, contact Akamai Technical Support.",
"If a packet loss occurs at one hop but does not propogate to the end of the trace, it is irrelevant.",
"If source Ip country and destination IP country is same then there should not be any hops outside the country."
]
},
{
"additionalRequestParameters": {
"destination": "2001:db8::4",
"source": "192.0.2.219"
},
"destinationContext": "CLIENT_IP",
"destinationIpLocation": {
"asNumber": 9583,
"city": "BANGALORE",
"countryCode": "IN",
"regionCode": "KA"
},
"executionContext": "EDGE_IP_TO_CLIENT_IP",
"executionStatus": "SUCCESS",
"result": {
"averageLatency": 0,
"hops": [
{
"averageLatency": 29.4,
"bestRtt": 7.2,
"host": "ae0.cyrusone-iad2.netarch.akamai.com",
"ip": "2001:db8:578:71fb:e463:9d9e:4f0c:edc7",
"ipLocation": {
"asNumber": 20940,
"city": "ASHBURN",
"countryCode": "US",
"regionCode": "VA"
},
"lastPacketLatency": 22.6,
"number": 1,
"packetLoss": 0,
"sentPackets": 10,
"standardDeviation": 26.3,
"worstRtt": 96.5
},
{
"averageLatency": 0,
"bestRtt": 0,
"host": "???",
"lastPacketLatency": 0,
"number": 2,
"packetLoss": 100,
"sentPackets": 10,
"standardDeviation": 0,
"worstRtt": 0
}
],
"host": "a23-50-51-236.deploy.akamaitechnologies.com",
"packetLoss": 100,
"result": "Start: 2021-09-29T03:56:18+0000\nHOST: a23-50-51-236.deploy.akamaitechnologies.com Loss% Snt Last Avg Best Wrst StDev\n 1.|-- ae0.cyrusone-iad2.netarch.akamai.com (2600:1408:24::1) 0.0% 10 22.6 29.4 7.2 96.5 26.3\n 2.|-- ae0-86.cr2-was1.ip6.gtt.net (2001:668:0:3:ffff:0:45ae:1189) 0.0% 10 0.5 4.7 0.3 36.6 11.4\n 3.|-- 2001:668:0:2:ffff:0:5995:8dd5 0.0% 10 74.4 79.2 73.5 96.1 8.9\n 4.|-- 2001:668:0:3:ffff:0:4d43:50be 0.0% 10 71.4 73.1 70.9 89.6 5.8\n 5.|-- 2404:a800::60 20.0% 10 408.5 323.7 226.9 426.2 103.5\n 6.|-- 2404:a800:3a00::1ba 0.0% 10 227.5 227.6 227.5 227.8 0.1\n 7.|-- ??? 100.0 10 0.0 0.0 0.0 0.0 0.0",
"startTime": 1632887778
},
"sourceContext": "EDGE_IP_BASED_ON_LOCATION",
"sourceIpLocation": {
"asNumber": 20940,
"city": "ASHBURN",
"countryCode": "US",
"regionCode": "VA"
},
"suggestedActions": [
"Look for a packet loss or sudden jumps in the hop time.",
"For a loss or latency within the end user ISP network, ask the end user to contact thier ISP.",
"For a loss or latency within Akamai network, contact Akamai Technical Support.",
"If a packet loss occurs at one hop but does not propogate to the end of the trace, it is irrelevant.",
"If source Ip country and destination IP country is same then there should not be any hops outside the country."
]
}
],
"content": [
{
"additionalRequestParameters": {
"requestHeaders": [
"Pragma: akamai-x-cache-on, akamai-x-cache-remote-on, akamai-x-check-cacheable, akamai-x-get-true-cache-key, akamai-x-get-cache-key, akamai-x-serial-no, akamai-x-get-request-id"
]
},
"executionContext": "DEFAULT",
"executionStatus": "SUCCESS",
"result": {
"httpStatusCode": 200,
"httpVersion": "HTTP/1.1",
"reasonPhrase": "OK",
"responseHeaderList": [
"X-Cache: TCP_MISS from a23-212-50-38.deploy.akamaitechnologies.com (AkamaiGHost/10.4.4-34537092) (-)",
"X-True-Cache-Key: /D/000/akamaiflowershop.com/ vcd=1456",
"Content-Length: 15051",
"Content-Type: text/html"
],
"timing": {
"dnsLookupTime": 1.509502,
"sslConnectionTime": 0,
"tcpConnectionTime": 1.524193,
"timeToFirstByte": 1.555875,
"totalTime": 2.091051
}
},
"suggestedActions": [
"Compare the response headers served from edge and origin.",
"Check for content correctness.",
"Check content length/bytes served."
]
}
],
"createdBy": "mrossi",
"createdTime": "2021-09-29T03:56:01Z",
"executionStatus": "SUCCESS",
"internalIp": "192.0.2.5",
"internalIpLocation": {
"asNumber": 20940,
"city": "ASHBURN",
"countryCode": "US",
"regionCode": "VA"
},
"logLines": [
{
"executionContext": "DEFAULT",
"executionStatus": "SUCCESS",
"result": {
"legend": {
"fObjectStatus": {
"D": "A default object was served.",
"a": "This response was sent through the ESI processor.",
"o": "The origin server was contacted for the request.",
"x": "Either 'no-store' is turned on by metadata and not disabled by \"!no-store\" in the response or the downstream TTL was set by metadata and not by the response header."
},
"fObjectStatus2": {},
"fObjectStatus3": {},
"logType": {
"f": "(f) going forward to forward hostname"
},
"rObjectStatus": {},
"rObjectStatus2": {},
"rObjectStatus3": {}
},
"logs": [
{
"arl": "/D/16382/1234567/000/akamaiflowershop.com/",
"bytesReceived": "3980",
"bytesServed": "-",
"clientIp": "192.0.2.5",
"contentBytesServed": "-",
"contentType": "text/html",
"cookie": "-",
"cpCode": "1234567",
"dateTime": "2021-09-29T03:56:05.609Z",
"edgeIp": "192.0.2.14",
"error": "-",
"forwardIp": "192.0.2.15",
"hostHeader": "-",
"httpMethod": "GET",
"httpStatus": "200",
"logType": "f",
"objectSize": "-",
"objectStatus": "oaDx",
"objectStatus2": "-",
"objectStatus3": "-",
"referer": "-",
"sslVersion": "-",
"timeTaken": "0",
"turnaroundTime": "268",
"userAgent": "-"
}
]
},
"suggestedActions": [
"Check for long times.",
"Check content length/bytes served."
]
}
],
"request": {
"clientIp": "2001:db8::4",
"edgeLocationId": "allen-tx-unitedregionCodes",
"ipVersion": "IPV6",
"packetType": "ICMP",
"port": 443,
"requestHeaders": [
"X-Location: NGDT"
],
"spoofEdgeIp": "192.0.2.9",
"url": "http://www.atcuser15.akamaiu.com"
},
"requestId": 181,
"spoofEdgeIpLocation": {
"asNumber": 20940,
"city": "MUMBAI",
"countryCode": "IN",
"regionCode": "MH"
},
"summary": {
"connectivity": [
{
"additionalRequestParameters": {
"destination": "2001:db8::4",
"source": "192.0.2.20"
},
"destinationContext": "CLIENT_IP",
"destinationIpLocation": {
"asNumber": 9583,
"city": "BANGALORE",
"countryCode": "IN",
"regionCode": "KA"
},
"executionContext": "EDGE_IP_TO_CLIENT_IP",
"executionStatus": "SUCCESS",
"result": {
"hops": [
{
"averageLatency": 0,
"bestRtt": 0,
"host": "???",
"lastPacketLatency": 0,
"number": 7,
"packetLoss": 100,
"sentPackets": 10,
"standardDeviation": 0,
"worstRtt": 0
},
{
"averageLatency": 323.7,
"bestRtt": 226.9,
"ip": "2001:db8:1c4:b130:bbf9:4ed0:d80d:d09d",
"ipLocation": {
"asNumber": 9498,
"city": "BANGALORE",
"countryCode": "IN",
"regionCode": "KA"
},
"lastPacketLatency": 408.5,
"number": 5,
"packetLoss": 20,
"sentPackets": 10,
"standardDeviation": 103.5,
"worstRtt": 426.2
}
],
"host": "a23-50-51-236.deploy.akamaitechnologies.com"
},
"sourceContext": "EDGE_IP_BASED_ON_LOCATION",
"sourceIpLocation": {
"asNumber": 20940,
"city": "ASHBURN",
"countryCode": "US",
"regionCode": "VA"
},
"suggestedActions": [
"Look for a packet loss or sudden jumps in the hop time.",
"For a loss or latency within the end user ISP network, ask the end user to contact thier ISP.",
"For a loss or latency within Akamai network, contact Akamai Technical Support.",
"If a packet loss occurs at one hop but does not propogate to the end of the trace, it is irrelevant."
]
},
{
"additionalRequestParameters": {
"destination": "2001:db8:e926:72ff:478b:4dce:811:f23a",
"source": "192.0.2.14"
},
"destinationContext": "ORIGIN_IP",
"destinationIpLocation": {
"asNumber": 20940,
"city": "ASHBURN",
"countryCode": "US",
"regionCode": "VA"
},
"executionContext": "EDGE_IP_TO_ORIGIN_IP",
"executionStatus": "SUCCESS",
"result": {
"hops": [
{
"averageLatency": 8577,
"bestRtt": 7550,
"host": "ae0.tata-bom3.netarch.akamai.com",
"ip": "2001:db8:293b:7c0e:504b:2d9e:83bf:7ec8",
"ipLocation": {
"asNumber": 20940,
"city": "MUMBAI",
"countryCode": "IN",
"regionCode": "MH"
},
"lastPacketLatency": 7550,
"number": 1,
"packetLoss": 60,
"sentPackets": 10,
"standardDeviation": 956.9,
"worstRtt": 9749
}
],
"host": "a23-212-50-38.deploy.akamaitechnologies.com"
},
"sourceContext": "EDGE_IP_CONNECTED_TO_ORIGIN",
"sourceIpLocation": {
"asNumber": 20940,
"city": "MUMBAI",
"countryCode": "IN",
"regionCode": "MH"
},
"suggestedActions": [
"Look for a packet loss or sudden jumps in the hop time.",
"For a loss or latency within the end user ISP network, ask the end user to contact thier ISP.",
"For a loss or latency within Akamai network, contact Akamai Technical Support.",
"If a packet loss occurs at one hop but does not propogate to the end of the trace, it is irrelevant."
]
}
],
"content": [
{
"additionalRequestParameters": {
"requestHeaders": [
"Pragma: akamai-x-cache-on, akamai-x-cache-remote-on, akamai-x-check-cacheable, akamai-x-get-true-cache-key, akamai-x-get-cache-key, akamai-x-serial-no, akamai-x-get-request-id"
]
},
"executionContext": "DEFAULT",
"executionStatus": "SUCCESS",
"result": {
"responseHeaderList": [
"Last-Modified: Thu, 12 Feb 2015 15:44:28 GMT",
"Content-Length: 15051"
]
},
"suggestedActions": [
"Compare the response headers served from edge and origin.",
"Check for content correctness.",
"Check content length/bytes served."
]
}
],
"logLines": [
{
"executionContext": "DEFAULT",
"executionStatus": "SUCCESS",
"result": {
"legend": {
"fObjectStatus": {
"D": "A default object was served.",
"a": "This response was sent through the ESI processor.",
"o": "The origin server was contacted for the request.",
"x": "Either 'no-store' is turned on by metadata and not disabled by \"!no-store\" in the response or the downstream TTL was set by metadata and not by the response header."
},
"fObjectStatus2": {},
"fObjectStatus3": {},
"logType": {
"f": "(f) going forward to forward hostname"
},
"rObjectStatus": {},
"rObjectStatus2": {},
"rObjectStatus3": {}
},
"logs": [
{
"clientIp": "192.0.2.5",
"contentBytesServed": "-",
"edgeIp": "192.0.2.14",
"forwardIp": "192.0.2.15",
"logType": "f",
"objectStatus": "oaDx",
"timeTaken": "0",
"turnaroundTime": "268"
}
]
},
"suggestedActions": [
"Check for long times.",
"Check content length/bytes served."
]
}
]
}
} |
Curl
curl -X GET 'https://undefined/edge-diagnostics/v1/connectivity-problems/requests/:requestId?includeContentResponseBody=&accountSwitchKey=' -H 'Accept: application/json'
ENDPOINTS