The hostname-traffic-by-response report is being discontinued
This report is deprecated and will be deactivated on January 31, 2025. As an alternative, use the new delivery/traffic/current report, based on the Reporting API v2.
The following shows how to generate the hostname-traffic-by-response report using either the Reporting API's Generate a report POST operation or the Get a cacheable report GET operation. Details about each report's supported products, metrics, filters, and available data intervals are also available dynamically by running the API's Get a report type operation, also shown below. See also other available reports.
Report definition
Provides edge hits data that can be filtered by hostname grouped by response code.
Business object: cpcode
Data available for: 92 days
Available metrics
| Metric | Description | |
|---|---|---|
| Data metrics | ||
edgeHits | The request count delivered from Akamai edge servers to the end user. | |
edgeHitsPercent | The portion of all requests delivered from Akamai edge services to the end user. |
Available filters
| Filter | Type | Description |
|---|---|---|
| Optional filters | ||
ca | Enumeration | Indicates whether content is storable. |
non_cacheable: Can't be stored (identified as 'no-store' or has a 0 TTL) and will always trigger an origin request. | ||
cacheable: Can be stored after an initial request for faster future delivery. | ||
delivery_type | Enumeration | Distinguishes secure from non-secure traffic. |
secure: Secure traffic. | ||
non_secure: Non-secure traffic. | ||
hostname_contain | String | Hostname contains the specified string. |
hostname_end_with | String | Hostname ends with the specified string. |
hostname_exact_match | String | Hostname is an exact match for the specified string. |
hostname_match | String | Hostname is an exact match for the specified string. |
hostname_not_contain | String | Hostname does not contain the specified string. |
hostname_not_end_with | String | Hostname does not end with the specified string. |
hostname_not_match | String | Hostname does not match the specified string. |
hostname_not_start_with | String | Hostname does not start with the specified string. |
hostname_start_with | String | Hostname starts with the specified string. |
http_version | Enumeration | HTTP version. |
https1.1: https1.1 | ||
http2: http2 | ||
http3: http3 | ||
http1.1: http1.1 | ||
ip_version | Enumeration | IP for which the report is shown. |
ipv4: IP address in v4 format. | ||
ipv6: IP address in v6 format. | ||
response_class | Enumeration | A class of HTTP response status codes, from 0xx through 6xx. |
0xx: An aborted action on the client side. | ||
1xx: An informational response, like Continue. | ||
2xx: A successful response. | ||
3xx: Success, but a redirect where the thing you want is somewhere else. | ||
4xx: Error, where there’s some problem with the client request. | ||
5xx: Error, where there’s some problem with how the API server responded to the client request. | ||
6xx: Invalid headers (defined by Akamai). | ||
response_code | String | An HTTP response status code, for example, 201. |
response_status | Enumeration | An indicator of whether the HTTP response resulted in success or an error. |
success: Successful HTTP response status. | ||
error: Error HTTP response status. | ||
traffic | Enumeration | HTTP traffic to be included in the report data. |
get_head_responses: Response header traffic from GET operations. | ||
put_post_responses: Response traffic from PUT and POST operations. |
POST request
POST /reporting-api/v1/reports/hostname-traffic-by-response/versions/2/report-data{?start,end}
Sample: /reporting-api/v1/reports/hostname-traffic-by-response/versions/2/report-data?start=2022-09-01T00%3A00%3A00Z&end=2022-10-01T00%3A00%3A00Z
Query parameters
| Parameter | Type | Sample | Description |
|---|---|---|---|
| Required | |||
start | String | 2022-06-01T00:00:00Z | Specifies the start of the reported period as an ISO-8601 timestamp with optional time zone. The report includes data that matches the start value’s timestamp. |
end | String | 2022-07-01T00:00:00Z | Specifies the end of the reported period as an ISO-8601 timestamp with optional time zone. The report excludes any data that matches the end value’s timestamp. |
JSON request members
| Member | Type | Description |
|---|---|---|
objectIds | Array | Specifies the set of cpcode values you want to report on. |
objectIds | Enumeration | As an alternative to an array of ID values, specify all as a string for unfiltered data. Either way, objectIds is required. |
metrics | Array | The set of desired metrics. If omitted, the report includes all available metrics. |
filters | Map of Arrays | Specifies a set of custom filters, with each filter's name keying an array with each filter's set of values. |
Request body:
{
"objectIds": [
"55232",
"23433",
"32433"
],
"metrics": [
"edgeHits",
"edgeHitsPercent"
],
"filters": {
"ca": [
"cacheable",
"non_cacheable"
],
"delivery_type": [
"secure",
"non-secure"
],
"hostname_contain": [
"img.example.com",
"m.example.com"
],
"http_version": [
"http1.1",
"http2"
],
"ip_version": [
"ipv4",
"ipv6"
],
"response_class": [
"1xx",
"0xx"
],
"response_code": [
"200",
"404"
],
"response_status": [
"success",
"error"
],
"traffic": [
"put_post_responses",
"get_head_responses"
]
}
}
Note: Other filtering options for retrieving details about a groups of hostnames such as hostname_exact_match, hostname_start_with, hostname_end_with, hostname_not_contain, hostname_not_start_with, hostname_match, or hostname_not_match are supported.
GET request
GET /reporting-api/v1/reports/hostname-traffic-by-response/versions/2/report-data{?start,end,objectIds,allObjectIds,metrics,filters}
Sample: /reporting-api/v1/reports/hostname-traffic-by-response/versions/2/report-data?start=2022-09-01T00%3A00%3A00Z&end=2022-10-01T00%3A00%3A00Z&objectIds=55232,23433,32433&metrics=edgeHits%2CedgeHitsPercent&filters=ca%3Dcacheable%2Cca%3Dnon_cacheable%2Cdelivery_type%3Dsecure%2Cdelivery_type%3Dnon-secure
Query parameters
| Parameter | Type | Sample | Description |
|---|---|---|---|
| Required | |||
start | String | 2022-06-01T00:00:00Z | Specifies the start of the reported period as an ISO-8601 timestamp with optional time zone. The report includes data that matches the start value’s timestamp. |
end | String | 2022-07-01T00:00:00Z | Specifies the end of the reported period as an ISO-8601 timestamp with optional time zone. The report excludes any data that matches the end value’s timestamp. |
| Optional | |||
allObjectIds | Boolean | true | As an alternative to objectIds, enabling this generates a report that includes all IDs available for the cpcode objectType. This parameter is ignored if the request also specifies a set of objectIds. |
objectIds | String | 55232,23433,32433 | As an alternative to allObjectIds, specifies the set of unique IDs for the cpcode objectType you want to report on, formatted as a comma-delimited list. |
metrics | String | edgeHits,edgeHitsPercent | Specifies a comma-separated list of metrics to include in the report, otherwise all metrics if omitted. The set of available metrics depends on the type of report. URL-encode the entire value in the GET request. |
filters | String | ca=cacheable,ca=non_cacheable,delivery_type=secure,delivery_type=non-secure | Specifies criteria to filter the report’s data. The set of available filters depends on the type of report. Separate each filter name and value with an equals (=) character, and separate various name/value pairs with commas (,). To specify more than one filter value, repeat the filter name. See the accompanying example for guidance. URL-encode the entire value in the GET request. |
JSON response
Status 200 application/json
Response body:
{
"metadata": {
"name": "hostname-traffic-by-response",
"version": "2",
"outputType": "FLAT",
"groupBy": [
"response_code"
],
"start": "2022-06-01T00:00:00Z",
"end": "2022-07-01T00:00:00Z",
"availableDataEnds": null,
"suggestedRetryTime": null,
"rowCount": 4,
"filters": [
{
"name": "ca",
"values": [
"cacheable",
"non_cacheable"
]
},
{
"name": "delivery_type",
"values": [
"secure",
"non-secure"
]
},
{
"name": "hostname_contain",
"values": [
"m.example.com",
"img.example.com"
]
},
{
"name": "http_version",
"values": [
"http1.1",
"http2"
]
},
{
"name": "ip_version",
"values": [
"ipv4",
"ipv6"
]
},
{
"name": "response_class",
"values": [
"3xx",
"5xx"
]
},
{
"name": "response_code",
"values": [
"500",
"100"
]
},
{
"name": "response_status",
"values": [
"success",
"error"
]
},
{
"name": "traffic",
"values": [
"put_post_responses",
"put_post_requests"
]
}
],
"columns": [
{
"name": "groupBy",
"label": "response_code"
},
{
"name": "edgeHits",
"label": "Edge Hits"
},
{
"name": "edgeHitsPercent",
"label": "Edge Hits %"
}
],
"objectType": "cpcode",
"objectIds": [
"55232",
"23433",
"32433"
]
},
"data": [
{
"response_code": "201",
"edgeHits": "3208",
"edgeHitsPercent": "21"
},
{
"response_code": "100",
"edgeHits": "3981",
"edgeHitsPercent": "63"
},
{
"response_code": "403",
"edgeHits": "2859",
"edgeHitsPercent": "42"
},
{
"response_code": "200",
"edgeHits": "3330",
"edgeHitsPercent": "22"
}
],
"summaryStatistics": {}
}
CSV response
Status 200 text/csv
Response Body:
#METADATA_START
name,hostname-traffic-by-response
version,2
source,hostname-traffic-by-response/versions/2
groupBy,response_code
start,2022-06-01T00:00:00Z
end,2022-07-01T00:00:00Z
availableDataEnds,
suggestedRetryTime,
rowCount,4
objectType,cpcode
objectIds,55232,23433,32433
ca,cacheable,non_cacheable
delivery_type,secure,non-secure
hostname_contain,m.example.com,img.example.com
http_version,http1.1,http2
ip_version,ipv4,ipv6
response_class,3xx,5xx
response_code,500,100
response_status,success,error
traffic,put_post_responses,put_post_requests
#METADATA_END
#SUMMARYSTATISTICS_START
#SUMMARYSTATISTICS_END
#COLUMNS_START
response_code,edgeHits,edgeHitsPercent
#COLUMNS_END
#DATA_START
201,3208,21
100,3981,63
403,2859,42
200,3330,22
#DATA_END
Get report details
This sample Get a report type operation gets the same information you need to run the hostname-traffic-by-response report as provided in this reference documentation, but available dynamically to your API client application.
GET /reporting-api/v1/reports/hostname-traffic-by-response/versions/2
Status 200 application/json
Response body:
{
"name": "hostname-traffic-by-response",
"description": "This report provides edge traffic data that can be filtered by hostname.",
"businessObjectName": "cpcode",
"version": 2,
"status": "DEPRECATED",
"deprecated": true,
"timeBased": false,
"supportsPagination": false,
"outputType": "FLAT",
"requiredProducts": [
"Basic Traffic Reports"
],
"requiredRoles": [
"Reports - All privileges",
"Reports - View only",
"OTA App User"
],
"available": true,
"metrics": [
{
"name": "edgeHits",
"description": "The request count delivered from Akamai edge servers to the end user.",
"label": "Edge Hits",
"unit": "COUNT",
"summaryStatistic": false
},
{
"name": "edgeHitsPercent",
"description": "The portion of all requests delivered from Akamai edge services to the end user.",
"label": "Edge Hits %",
"unit": "RATIO",
"summaryStatistic": false
}
],
"groupOutlyingValues": {
"enabled": false
},
"groupBy": [
"response_code"
],
"filters": [
{
"name": "hostname_not_end_with",
"type": "string",
"description": "Hostname does not end with the specified string.",
"required": false
},
{
"name": "traffic",
"type": "enum",
"description": "HTTP traffic to be included in the report data.",
"values": [
{
"value": "get_head_responses",
"description": "Response header traffic from GET operations."
},
{
"value": "put_post_responses",
"description": "Response traffic from PUT and POST operations."
}
],
"required": false
},
{
"name": "hostname_end_with",
"type": "string",
"description": "Hostname ends with the specified string.",
"required": false
},
{
"name": "response_code",
"type": "string",
"description": "An HTTP response status code, for example, 201.",
"required": false
},
{
"name": "hostname_contain",
"type": "string",
"description": "Hostname contains the specified string.",
"required": false
},
{
"name": "response_class",
"type": "enum",
"description": "A class of HTTP response status codes, from 0xx through 6xx.",
"values": [
{
"value": "0xx",
"description": "An aborted action on the client side."
},
{
"value": "1xx",
"description": "An informational response, like Continue."
},
{
"value": "2xx",
"description": "A successful response."
},
{
"value": "3xx",
"description": "Success, but a redirect where the thing you want is somewhere else."
},
{
"value": "4xx",
"description": "Error, where there’s some problem with the client request."
},
{
"value": "5xx",
"description": "Error, where there’s some problem with how the API server responded to the client request."
},
{
"value": "6xx",
"description": "Invalid headers (defined by Akamai)."
}
],
"required": false
},
{
"name": "hostname_exact_match",
"type": "string",
"description": "Hostname is an exact match for the specified string.",
"required": false
},
{
"name": "ip_version",
"type": "enum",
"description": " IP for which the report is shown.",
"values": [
{
"value": "ipv4",
"description": "IP address in v4 format."
},
{
"value": "ipv6",
"description": "IP address in v6 format."
}
],
"required": false
},
{
"name": "hostname_start_with",
"type": "string",
"description": "Hostname starts with the specified string.",
"required": false
},
{
"name": "hostname_not_contain",
"type": "string",
"description": "Hostname does not contain the specified string.",
"required": false
},
{
"name": "hostname_match",
"type": "regexp",
"description": "Hostname is an exact match for the specified string.",
"required": false
},
{
"name": "http_version",
"type": "enum",
"description": "HTTP version.",
"values": [
{
"value": "https1.1",
"description": "https1.1"
},
{
"value": "http2",
"description": "http2"
},
{
"value": "http3",
"description": "http3"
},
{
"value": "http1.1",
"description": "http1.1"
}
],
"required": false
},
{
"name": "hostname_not_match",
"type": "regexp",
"description": "Hostname does not match the specified string.",
"required": false
},
{
"name": "ca",
"type": "enum",
"description": "Indicates whether content is storable.",
"values": [
{
"value": "non_cacheable",
"description": "Can't be stored (identified as 'no-store' or has a 0 TTL) and will always trigger an origin request."
},
{
"value": "cacheable",
"description": "Can be stored after an initial request for faster future delivery."
}
],
"required": false
},
{
"name": "response_status",
"type": "enum",
"description": "An indicator of whether the HTTP response resulted in success or an error.",
"values": [
{
"value": "success",
"description": "Successful HTTP response status."
},
{
"value": "error",
"description": "Error HTTP response status."
}
],
"required": false
},
{
"name": "hostname_not_start_with",
"type": "string",
"description": "Hostname does not start with the specified string.",
"required": false
},
{
"name": "delivery_type",
"type": "enum",
"description": "Distinguishes secure from non-secure traffic.",
"values": [
{
"value": "secure",
"description": "Secure traffic."
},
{
"value": "non_secure",
"description": "Non-secure traffic."
}
],
"required": false
}
],
"intervals": [
"MONTH",
"WEEK",
"DAY",
"HOUR",
"FIVE_MINUTES"
],
"dataRetentionDays": 92,
"links": [
{
"rel": "self",
"href": "/reporting-api/v1/reports/hostname-traffic-by-response/versions/2"
},
{
"rel": "versions",
"href": "/reporting-api/v1/reports/hostname-traffic-by-response/versions"
},
{
"rel": "all-reports",
"href": "/reporting-api/v1/reports"
},
{
"rel": "execute-report",
"href": "/reporting-api/v1/reports/hostname-traffic-by-response/versions/2/report-data"
}
]
}