
- Overview
- Resources
- API summary
- List Media Services Live 4 dimensions
- List Media Services Live 4 metrics
- Get Media Services Live 4 data
- Get Media Services Live 4 data stores
- Get a Media Services Live 4 data store
- Get Media Services Live 4 entry point switch information
- List Media Services Live 4 Origin Shield dimensions
- List Media Services Live 4 Origin Shield metrics
- Get Media Services Live 4 Origin Shield data
- List Media Services Live Stream Packaging dimensions
- List Media Services Live Stream Packaging metrics
- Get Media Services Live Stream Packaging data
- Get Media Services Live Stream Packaging entry point switching information
- List Media Services Live HLS/HDS/DASH Ingest metrics
- List Media Services Live HLS/HDS/DASH Ingest dimensions
- List Media Services Live HLS/HDS/DASH Ingest data
- List Media Services Live HLS/HDS/DASH Ingest active streams delivery data
- List Media Services Live HLS/HDS/DASH Ingest active streams ingest data
- List Media Services Live HLS/HDS/DASH Ingest data stores
- Get a Media Services Live HLS/HDS/DASH Ingest data store
- List Media Services Live RTMP metrics
- List Media Services Live RTMP dimensions
- List Media Services Live RTMP active streams delivery data
- List Media Services Live RTMP active streams ingest data
- List Media Services Live RTMP data
- List Media Services Live RTMP data stores
- Get a Media Services Live RTMP data store
- List Media Services On Demand RTMP dimensions
- List Media Services On Demand RTMP metrics
- List Media Service On Demand RTMP data
- List Progressive Media Delivery dimensions
- List Progressive Media Delivery metrics
- List Progressive Media Delivery data
- Data
- Errors
Media Services Reports API v1
Monitor traffic for your Media Services Live, Media Services On Demand, and Progressive Media Delivery solutions.
Learn more:
Download this API’s RAML and JSON schema descriptors.
Overview
These first-mile reports provide information on ingest quality, availability, and accelerated streams.
Get started
To configure this API for the first time:
- Review
Get Started with APIs
for details on how to set up client tokens to access any Akamai API.
These tokens appear as custom hostnames that look like this:
https://akzz-XXXXXXXXXXXXXXXX-XXXXXXXXXXXXXXXX.luna.akamaiapis.net
. - To enable this API, choose the API service named Media Reports, and set the access level to READ-ONLY.
Rate limiting
The Media Reports API imposes a rate-limiting constraint of 20 requests per minute. Exceeding that limit results in a 429 error response. Consider this when calling successive operations as part of a loop. The following response headers provide rate limit information:
X-RateLimit-Limit
: The total number of tokens allowed.X-RateLimit-Remaining
: The number of tokens remaining.X-RateLimit-Next
: The time when you can make one more request. For example:2018-05-11T07:04:40.004Z
.
Once X-RateLimit-Remaining
becomes 0, you get a 429 error the next
time you make an API call.
If you do not make any more API calls after you receive a 429 error,
X-RateLimit-Remaining
gradually increases and becomes equal to
X-RateLimit-Limit
.
API workflow
First, you need to obtain information on the available metrics and dimensions. You can use this information to select specific combinations and call the relevant URLs to create customized reports tailored to your specifications.
Step 1: retrieve available dimensions
You can extract a dimension from a key-value pair, URI Components or strings in log data.
You can run the API operation below to retrieve available dimensions. Skip the step if you already know the dimension IDs.
The sample request and response below shows how to generate an Media Services Live 4 ingest report. (See List Media Services Live 4 dimensions):
GET: /media-reports/v1/media-services-live/http-ingest/dimensions
[
{
"id": 99,
"name": "Source Type",
"description": "Source type - IAT or Encoder."
},
{
"id": 100,
"name": "Time",
"description": "Indicates the consumption time of the content. Akamai sets this dimension automatically."
},
{
"id": 101,
"name": "CP Code",
"description": "Identifier assigned to a contract associated with a particular stream."
},
{
"id": 102,
"name": "Stream ID",
"description": "Unique identifier associated with a stream generated by the Akamai provisioning workflow."
},
{
"id": 103,
"name": "Unique End Point",
"description": "The URL path after the Stream ID in the ingest URL. For manifest files, the file name is part of the Unique End Point. For segment requests, the file name (last path element) is left out. This also indicates the bit rate of the stream."
},
{
"id": 104,
"name": "File Type",
"description": "The ingested object's file type."
},
{
"id": 105,
"name": "Encoder IP",
"description": "IP address of encoder generating the stream."
},
{
"id": 106,
"name": "Entry Point",
"description": "IP address for the entry point. Akamai ingested the stream from this entry point."
},
{
"id": 107,
"name": "Stream Type",
"description": "The stream type, either `Primary` or `Backup`."
},
{
"id": 108,
"name": "Source IP",
"description": "Source IP or Source IAT IP"
},
{
"id": 109,
"name": "File Type",
"description": "File extension of the object requested. The system extracts this from the URL of the requested object."
},
{
"id": 111,
"name": "File Extension",
"description": "File extension of the ingested object. The system extracts this from the URL of the ingested object."
}
]
Step 2: retrieve available metrics
Akamai measures dimensions using metrics.
You can run the API operation below to retrieve available metrics. Skip the step if you already know the metric IDs.
The sample request and response below shows how to generate a Media Services Live 4 ingest report. (See List Media Services Live 4 metrics):
GET: /media-reports/v1/media-services-live/http-ingest/metrics
[
{
"id": 200,
"name": "Avg Bit rate",
"unit": "kbps",
"type": "bandwidth",
"description": "Average amount of data transferred in a unit of time, calculated in bits per second. Expressed in kbps, Mbps, Gbps etc."
},
{
"id": 201,
"name": "Error Rate",
"unit": "%",
"type": "percent",
"description": "Rate of errors occurring in a unit of time. Expressed as a percentage."
},
{
"id": 202,
"name": "Ingest Hits",
"type": "count",
"description": "Total number of requests made to the entry point posting objects."
},
{
"id": 203,
"name": "2xx Ingest Hits",
"type": "count",
"description": "Number of requests made to the entry point posting objects that returned response codes - 200 to 299 (Successful)"
},
{
"id": 204,
"name": "3xx Ingest Hits",
"type": "count",
"description": "Number of requests made to the entry point posting objects that returned response codes - 300 to 399 (Redirection)"
},
{
"id": 205,
"name": "4xx Ingest Hits",
"type": "count",
"description": "Number of requests made to the entry point posting objects that returned response codes - 400 to 499 (Client Error)"
},
{
"id": 206,
"name": "5xx Ingest Hits",
"type": "count",
"description": "Number of requests made to the entry point posting objects that returned response codes - 500 to 599 (Server Error)"
},
{
"id": 207,
"name": "Avg Latency",
"unit": "ms",
"type": "time",
"description": "Indicates the delay between encoder and entry point when sending a unit of media payload."
},
{
"id": 208,
"name": "Avg Packet Loss",
"unit": "%",
"type": "percent",
"description": "Measures the quality of connection between encoder and entry Point. Provides connection level ratio of data packets(bytes) lost to the data packets(bytes) sent by the encoder."
},
{
"id": 209,
"name": "Ingest Hits",
"type": "count",
"description": "Total number of requests made to the entry point posting objects."
},
{
"id": 210,
"name": "Success Ingest Hits",
"type": "count",
"description": "Success Hits"
},
{
"id": 212,
"name": "Error Rate",
"unit": "%",
"type": "percent",
"description": "Rate of errors occurring in a unit of time. Expressed as a percentage."
},
{
"id": 213,
"name": "Avg Path Time",
"unit": "ms",
"type": "time",
"description": "Average time taken from source to destination."
},
{
"id": 214,
"name": "Avg Bit rate",
"unit": "kbps",
"type": "bandwidth",
"description": "Average amount of data transferred in a unit of time, calculated in bits per second. Expressed in kbps, Mbps, Gbps etc."
},
{
"id": 215,
"name": "2xx Ingest Hits",
"type": "count",
"description": "Number of requests made to the entry point posting objects that returned response codes - 200 to 299 (Successful)"
},
{
"id": 216,
"name": "3xx Ingest Hits",
"type": "count",
"description": "Number of requests made to the entry point posting objects that returned response codes - 300 to 399 (Redirection)"
},
{
"id": 217,
"name": "4xx Ingest Hits",
"type": "count",
"description": "Number of requests made to the entry point posting objects that returned response codes - 400 to 499 (Client Error)"
},
{
"id": 218,
"name": "5xx Ingest Hits",
"type": "count",
"description": "Number of requests made to the entry point posting objects that returned response codes - 500 to 599 (Server Error)"
}
]
Step 3: retrieve data
You can retrieve data for a given CP code using the API call shown below.
The sample request and response below shows how to generate a Media Services Live 4 ingest report. The first GET line represents the URL template syntax. The second GET line represents an actual sample URL. For more information, see (Get Media Services Live 4 data):
GET:
/media-reports/v1/media-services-live/http-ingest/data(?startDate,endDate,aggregation,dimensions,metrics,cpcodes,ipVersion,limit,offset,filterParams,sortParams,deliveryOption,deliveryFormat,deliveryType)
Assume that the dimension ID 100
represents Time
and the metric ID
200
represents the metric Avg Bit rate
. The sample URL below
reports on average bit rate by time for a period starting
12/01/2015:00:00
to 12/01/2015:05:00
for a CP code 12345
:
GET:
/media-reports/v1/media-services-live/http-ingest/data?startDate=12/01/2015:00:00&endDate=12/01/2015:05:00&cpcodes=12345&ipVersion=ipv4&limit=1000&offset=0&deliveryOption=http&deliveryFormat=hls&deliveryType=live&dimensions=1&metrics=107
{
"columns": [
{
"type": "dimension",
"name": "Time",
"description": "Indicates the consumption time of the content. Akamai sets this dimension automatically.",
"index": 0
},
{
"type": "metric",
"name": "Avg Bit rate",
"id": 200,
"description": "Average amount of data transferred in a unit of time, calculated in bits per second. Expressed in kbps, Mbps, Gbps etc.",
"index": 1,
"unit": "kbps"
}
],
"rows": [
[
"1529891640",
"1605.884392"
],
[
"1529891760",
"1618.015465"
],
[
"1529891880",
"1596.447969"
]
],
"metaData": {
"startTimeInEpoch": 1529891640,
"offset": 0,
"limit": 300,
"timeZone": "GMT",
"hasMoreData": false,
"aggregation": 120,
"endTimeInEpoch": 1529898840
}
}
Concepts
Here’s a list of the conceptual objects you deal with when interacting with the Media Reports API:
Media Services Live 4 reports: Reports on ingest quality and availability for Media Services Live 4 Streams. The reports also provide information on accelerated streams.
Media Services Live Origin Shield Monitoring reports: Reports on ingest quality and availability of content across many CDNs and accounts.
Media Services Live HLS/HDS/DASH Ingest reports: Reports on ingest quality and availability of HLS/HDS/DASH Ingest (HTTP-based) streams. The reports also provide information on accelerated streams.
Media Streaming Live Stream Packaging reports: Reports on ingest quality and availability of RTMP streams that this product converted to HLS or HDS.
RTMP Streaming reports: Reports on ingest quality and delivery details for both Media Services Live and Media Services On Demand RTMP streams.
Progressive Media Delivery reports: Reports on ingest quality and delivery details for Progressive Media Delivery streams.
Data stores: A collection of dimensions and metrics stored in a database that you can use to create reports.
Entry point switching: An Akamai ingest server that receives streams from a source. Entry point switching occurs when the ingest server experiences connectivity issues and Akamai routes the stream to another server.
Resources
This section provides details on the API’s operations.
API summary
Download the RAML descriptors for this API.
Operation | Method | Endpoint |
---|---|---|
Media Services Live 4 | ||
List Media Services Live 4 dimensions | GET | /media-reports/ |
List Media Services Live 4 metrics | GET | /media-reports/ |
Get Media Services Live 4 data | POST | /media-reports/ |
Get Media Services Live 4 data stores | GET | /media-reports/ |
Get a Media Services Live 4 data store | GET | /media-reports/ |
Get Media Services Live 4 entry point switch information | GET | /media-reports/ |
List Media Services Live 4 Origin Shield dimensions | GET | /media-reports/ |
List Media Services Live 4 Origin Shield metrics | GET | /media-reports/ |
Get Media Services Live 4 Origin Shield data | POST | /media-reports/ |
Media Services Live Stream Packaging | ||
List Media Services Live Stream Packaging dimensions | GET | /media-reports/ |
List Media Services Live Stream Packaging metrics | GET | /media-reports/ |
Get Media Services Live Stream Packaging data | POST | /media-reports/ |
Get Media Services Live Stream Packaging entry point switching information | GET | /media-reports/ |
Media Services Live HLS/HDS/DASH Ingest | ||
List Media Services Live HLS/HDS/DASH Ingest metrics | GET | /media-reports/ |
List Media Services Live HLS/HDS/DASH Ingest dimensions | GET | /media-reports/ |
List Media Services Live HLS/HDS/DASH Ingest data | GET | /media-reports/ |
List Media Services Live HLS/HDS/DASH Ingest active streams delivery data | GET | /media-reports/ |
List Media Services Live HLS/HDS/DASH Ingest active streams ingest data | GET | /media-reports/ |
List Media Services Live HLS/HDS/DASH Ingest data stores | GET | /media-reports/ |
Get a Media Services Live HLS/HDS/DASH Ingest data store | GET | /media-reports/ |
Media Services Live RTMP | ||
List Media Services Live RTMP metrics | GET | /media-reports/ |
List Media Services Live RTMP dimensions | GET | /media-reports/ |
List Media Services Live RTMP active streams delivery data | GET | /media-reports/ |
List Media Services Live RTMP active streams ingest data | GET | /media-reports/ |
List Media Services Live RTMP data | GET | /media-reports/ |
List Media Services Live RTMP data stores | GET | /media-reports/ |
Get a Media Services Live RTMP data store | GET | /media-reports/ |
Media Services On Demand RTMP | ||
List Media Services On Demand RTMP dimensions | GET | /media-reports/ |
List Media Services On Demand RTMP metrics | GET | /media-reports/ |
List Media Service On Demand RTMP data | GET | /media-reports/ |
Progressive Media Delivery | ||
List Progressive Media Delivery dimensions | GET | /media-reports/ |
List Progressive Media Delivery metrics | GET | /media-reports/ |
List Progressive Media Delivery data | GET | /media-reports/ |
List Media Services Live 4 dimensions
Retrieves all of the dimensions available for HTTP Ingest (Media Services Live 4).
GET /media-reports/
Status 200
application/json
Download schema: dimensions.json
Response body:
[
{
"id": 99,
"name": "Source Type",
"description": "Source type - IAT or Encoder."
},
{
"id": 100,
"name": "Time",
"description": "Indicates the consumption time of the content. This dimension is set automatically."
},
{
"id": 101,
"name": "CP Code",
"description": "Identifier assigned to a contract associated with a particular stream."
},
{
"id": 102,
"name": "Stream ID",
"description": "Unique identifier associated with a stream generated by the Akamai provisioning workflow."
},
{
"id": 103,
"name": "Unique End Point",
"description": "The URL path after the Stream ID in the ingest URL. For manifest Files, the file name is part of the unique end point. For segment requests, the file name (last path element) is omitted. Also indicates the bit rate of the stream."
},
{
"id": 104,
"name": "File Type",
"description": "File type of the ingested object."
},
{
"id": 105,
"name": "Encoder IP",
"description": "IP address of encoder generating the stream."
},
{
"id": 106,
"name": "Entry Point",
"description": "IP address of the entry point at which stream is ingested."
},
{
"id": 107,
"name": "Stream Type",
"description": "Type of stream - Primary or Backup."
},
{
"id": 108,
"name": "Source IP",
"description": "Source IP or Source IAT IP"
},
{
"id": 109,
"name": "File Type",
"description": "File type of the object requested. This is extracted from the URL of the requested object."
},
{
"id": 111,
"name": "File Extension",
"description": "File Extension of the ingested object. This is extracted from the URL of the ingested object."
}
]
List Media Services Live 4 metrics
Retrieves all of the metrics available for HTTP Ingest (Media Services Live 4).
GET /media-reports/
Status 200
application/json
Download schema: metrics.json
Response body:
[
{
"id": 200,
"name": "Avg Bit rate",
"unit": "kbps",
"type": "bandwidth",
"description": "Average amount of data transferred in a unit of time, calculated in terms of bits per second. Expressed in kbps, Mbps, Gbps etc."
},
{
"id": 201,
"name": "Error Rate",
"unit": "%",
"type": "percent",
"description": "Rate of errors occurring in a unit of time. Expressed as a percentage."
},
{
"id": 202,
"name": "Ingest Hits",
"type": "count",
"description": "Total number of requests made to the entry point posting objects."
},
{
"id": 203,
"name": "2xx Ingest Hits",
"type": "count",
"description": "Number of requests made to the entry point posting objects that returned response codes - 200 to 299 (Successful)."
},
{
"id": 204,
"name": "3xx Ingest Hits",
"type": "count",
"description": "Number of requests made to the entry point posting objects that returned response codes - 300 to 399 (Redirection)."
},
{
"id": 205,
"name": "4xx Ingest Hits",
"type": "count",
"description": "Number of requests made to the entry point posting objects that returned response codes - 400 to 499 (Client Error)."
},
{
"id": 206,
"name": "5xx Ingest Hits",
"type": "count",
"description": "Number of requests made to the entry point posting objects that returned response codes - 500 to 599 (Server Error)."
},
{
"id": 207,
"name": "Avg Latency",
"unit": "ms",
"type": "time",
"description": "Indicates the delay between encoder and entry point when sending a unit of media payload."
},
{
"id": 208,
"name": "Avg Packet Loss",
"unit": "%",
"type": "percent",
"description": "Measures the quality of connection between encoder and entry point. Provides connection level ratio of data packets(bytes) lost to the data packets(bytes) sent by the encoder."
},
{
"id": 209,
"name": "Ingest Hits",
"type": "count",
"description": "Total number of requests made to the entry point posting objects."
},
{
"id": 210,
"name": "Success Ingest Hits",
"type": "count",
"description": "Total number of OK requests made to the entry point posting objects."
},
{
"id": 212,
"name": "Error Rate",
"unit": "%",
"type": "percent",
"description": "Rate of errors occurring in a unit of time. Expressed as a percentage."
},
{
"id": 213,
"name": "Avg Path Time",
"unit": "ms",
"type": "time",
"description": "Average time taken from source to destination."
},
{
"id": 214,
"name": "Avg Bit rate",
"unit": "kbps",
"type": "bandwidth",
"description": "Average amount of data transferred in a unit of time, calculated in terms of bits per second. Expressed in kbps, Mbps, Gbps etc."
},
{
"id": 215,
"name": "2xx Ingest Hits",
"type": "count",
"description": "Number of requests made to the entry point posting objects that returned response codes - 200 to 299 (Successful)"
},
{
"id": 216,
"name": "3xx Ingest Hits",
"type": "count",
"description": "Number of requests made to the entry point posting objects that returned response codes - 300 to 399 (Redirection)."
},
{
"id": 217,
"name": "4xx Ingest Hits",
"type": "count",
"description": "Number of requests made to the entry point posting objects that returned response codes - 400 to 499 (Client Error)."
},
{
"id": 218,
"name": "5xx Ingest Hits",
"type": "count",
"description": "Number of requests made to the entry point posting objects that returned response codes - 500 to 599 (Server Error)."
}
]
Get Media Services Live 4 data
Retrieves Media Services Live 4 data for the given parameters.
POST /media-reports/
Sample: /media-reports/
Parameter | Type | Sample | Description |
---|---|---|---|
Required query parameters | |||
dimensions |
String | 1,2,3 |
Identifies dimensions with comma-separated IDs. |
endDate |
String | 2014-03-23T15:30Z |
The timestamp string in ISO 8601 format yyyy-MM-ddTHH:mmZ or yyyy-MM-ddTHH:mm+HH:mm . |
metrics |
String | 1,2,3 |
Identifies metrics with comma-separated IDs. |
startDate |
String | 2014-03-22T15:30Z |
The timestamp string in ISO 8601 format yyyy-MM-ddTHH:mmZ or yyyy-MM-ddTHH:mm+HH:mm . |
Optional query parameters | |||
aggregation |
Number | 1440 |
The time period in which to group each data record, expressed as number of seconds. |
cpcodes |
String | 12345,67890 |
Use to limit report data to specific CP codes. Comma-separate multiple values. |
filterParams |
String | [{"type":"dimension","values":["GB"],"id":4,"condition":"in"},{"type":"metric","values":[16],"id":155,"condition":"gt"}] |
A UTF–8, URL-encoded JSON object representing filter parameters that limit reported data. See the FilterParams object for details on its structure. |
limit |
Number | 300 |
The number of rows to return from 1 to 10000 . The default value is 300 . |
offset |
Number | 0 |
The offset of the row for the start of data. Use this to request progressive batches of data. For example, you can make 10 requests for 1000 records by setting the overall limit to 100 , then setting the offset to 0 , 100 , 200 , and so on for each request. |
sortParams |
String | [{"type":"metric", "order":"asc", "id":40}] |
A UTF–8, URL-encoded JSON object representing sort parameters that rearrange reported data. See the SortParams object for details on its structure. |
streams |
String | 12345,67890 |
Identifies a set of reported streams as comma-separated ID values. |
Status 200
application/json
Object type: Report
Download schema: mediaServicesData.json
Response body:
{
"columns": [
{
"type": "dimension",
"name": "Time",
"description": "Indicates the consumption time of the content.",
"index": 0
},
{
"type": "metric",
"name": "Hits",
"description": "Total number of requests made to the entry point posting objects.",
"index": 1,
"aggregate": "46055"
}
],
"rows": [
[
"1471737600",
"158"
],
[
"1471737720",
"138"
],
[
"1471737840",
"183"
],
[
"1471737960",
"158"
],
[
"1471738080",
"163"
],
[
"1471738200",
"155"
]
],
"metaData": {
"startTimeInEpoch": 1471737600,
"offset": 0,
"limit": 300,
"timeZone": "GMT",
"hasMoreData": true,
"aggregation": 120,
"endTimeInEpoch": 1471860000
}
}
Get Media Services Live 4 data stores
Retrieves Media Services Live 4 data stores for the specified parameters.
GET /media-reports/
Status 200
application/json
Download schema: dataStore.json
Response body:
[
{
"id": 102,
"name": "iatstreams_-_F_time",
"type": "standard",
"description": "iatstreams_-_F_time",
"dimensions": [
{
"id": 100,
"name": "Time",
"description": "Indicates the time at which the content was consumed. This dimension is set automatically.",
"helpText": "Indicates the time at which content was consumed. This dimension is set automatically.",
"dataType": "TIME",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 101,
"name": "CP Code",
"description": "Unique identifier for the contract associated with a particular stream, used for billing purposes.",
"helpText": "Unique identifier for the contract associated with a particular stream, used for billing purposes.",
"dataType": "CPCODE",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 102,
"name": "Stream ID",
"description": "Unique identifier that is generated when the stream is initially configured.",
"helpText": "Unique identifier that is generated when the stream is initially configured.",
"dataType": "STREAM",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 103,
"name": "Unique End Point",
"description": "The URL path after the Stream ID in the ingest URL. For manifest files, the filename is part of the Unique End Point. For segment requests, the filename is omitted. Also indicates the bit rate of the stream.",
"helpText": "The URL path after the Stream ID in the ingest URL. For manifest files, the filename is part of the Unique End Point. For segment requests, the filename is omitted. Also indicates the bit rate of the stream.",
"dataType": "STRING",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 106,
"name": "Entry Point",
"description": "IP address of the Entry Point on which stream is ingested.",
"helpText": "IP address of the Entry Point on which stream is ingested.",
"dataType": "STRING",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 108,
"name": "Source IP",
"description": "Source IP/IAT IP",
"dataType": "STRING",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 109,
"name": "File Type",
"description": "File extension of the requested object as extracted from the URL.",
"helpText": "File extension of the requested object as extracted from the URL.",
"dataType": "STRING",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 111,
"name": "File Extension",
"description": "File Extension of the ingested object as extracted from the URL.",
"helpText": "File Extension of the ingested object as extracted from the URL.",
"dataType": "STRING",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
}
],
"metrics": [
{
"id": 208,
"name": "Avg Packet Loss",
"unit": "%",
"type": "percent",
"description": "Measures the quality of the connection between the Encoder and the Entry Point. Provides connection level ratio of data packets (bytes) lost to the data packets (bytes) sent by the Encoder.",
"dataType": "PERCENT",
"helpText": "Measures the quality of the connection between the Encoder and the Entry Point. Provides connection level ratio of data packets (bytes) lost to the data packets (bytes) sent by the Encoder.",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 210,
"name": "Success Ingest Hits",
"type": "count",
"description": "Success Hits",
"dataType": "COUNT",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 212,
"name": "Error Rate",
"unit": "%",
"type": "percent",
"description": "Percentage rate of errors occurring in a given time period.",
"dataType": "PERCENT",
"helpText": "Percentage rate of errors occurring in a given time period.",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 213,
"name": "Avg Path Time",
"unit": "ms",
"type": "time",
"description": "Average time taken from source to destination.",
"dataType": "TIME",
"helpText": "Average time taken from source to destination.",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 215,
"name": "2xx Ingest Hits",
"type": "count",
"description": "Number of requests made to the entry point posting objects that returned successful response codes in the 200 to 299 range.",
"dataType": "COUNT",
"helpText": "Number of requests made to the entry point posting objects that returned successful response codes in the 200 to 299 range.",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 200,
"name": "Avg Bitrate",
"unit": "Kbps",
"type": "bandwidth",
"description": "Average amount of data transferred in a time period, calculated in terms of bits per second. Expressed in kbps, Mbps, Gbps etc.",
"dataType": "BANDWIDTH",
"helpText": "Average amount of data transferred in a time period, calculated in terms of bits per second. Expressed in kbps, Mbps, Gbps etc.",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 202,
"name": "Ingest Hits",
"type": "count",
"description": "Total number of requests made to the entry point posting objects.",
"dataType": "COUNT",
"helpText": "Total number of requests made to the entry point posting objects.",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 204,
"name": "3xx Ingest Hits",
"type": "count",
"description": "Number of requests made to the entry point posting objects that returned redirect response codes in the 300 to 399 range.",
"dataType": "COUNT",
"helpText": "Number of requests made to the entry point posting objects that returned redirect response codes in the 300 to 399 range.",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 205,
"name": "4xx Ingest Hits",
"type": "count",
"description": "Number of requests made to the entry point posting objects that returned client error response codes in the 400 to 499 range.",
"dataType": "COUNT",
"helpText": "Number of requests made to the entry point posting objects that returned client error response codes in the 400 to 499 range.",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 206,
"name": "5xx Ingest Hits",
"type": "count",
"description": "Number of requests made to the entry point posting objects that returned server error response codes in the 500 to 599 range.",
"dataType": "COUNT",
"helpText": "Number of requests made to the entry point posting objects that returned server error response codes in the 500 to 599 range.",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 207,
"name": "Avg Latency",
"unit": "ms",
"type": "time",
"description": "Indicates the delay between Encoder and Entry Point when sending a unit of media payload.",
"dataType": "TIME",
"helpText": "Indicates the delay between Encoder and Entry Point when sending a unit of media payload.",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
}
],
"aggregationInSeconds": 120,
"purgeIntervalInDays": 30,
"maxQueryDurationInMinutes": 43200,
"reportType": ""
},
{
"id": 101,
"name": "iattraffic_-_F_time",
"type": "standard",
"description": "iattraffic_-_F_time",
"dimensions": [
{
"id": 100,
"name": "Time",
"description": "Indicates the time at which content was consumed. This dimension is set automatically.",
"helpText": "Indicates the time at which content was consumed. This dimension is set automatically.",
"dataType": "TIME",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 101,
"name": "CP Code",
"description": "Identifier assigned to a contract associated with a particular stream.",
"helpText": "Identifier assigned to a contract associated with a particular stream.",
"dataType": "CPCODE",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 102,
"name": "Stream ID",
"description": "Unique identifier that is generated when the stream is initially configured.",
"helpText": "Unique identifier that is generated when the stream is initially configured.",
"dataType": "STREAM",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 103,
"name": "Unique End Point",
"description": "The URL path after the Stream ID in the ingest URL. For the manifest files, the filename is part of the Unique End Point. For segment requests, the filename is omitted. Also indicates the bit rate of the stream.",
"helpText": "The URL path after the Stream ID in the ingest URL. For manifest Files, the filename is part of the Unique End Point. For segment requests, the filename is omitted. Also indicates the bit rate of the stream.",
"dataType": "STRING",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 106,
"name": "Entry Point",
"description": "IP address of the Entry Point on which stream is ingested.",
"helpText": "IP address of the Entry Point on which stream is ingested.",
"dataType": "STRING",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 108,
"name": "Source IP",
"description": "Source IP/IAT IP",
"dataType": "STRING",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 109,
"name": "File Type",
"description": "File extension of the requested object as extracted from the URL.",
"helpText": "File extension of the requested object as extracted from the URL.",
"dataType": "STRING",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
}
],
"metrics": [
{
"id": 208,
"name": "Avg Packet Loss",
"unit": "%",
"type": "percent",
"description": "Measures the quality of the connection between the Encoder and the Entry Point. Provides connection level ratio of data packets (bytes) lost to the data packets (bytes) sent by the Encoder.",
"dataType": "PERCENT",
"helpText": "Measures the quality of the connection between the Encoder and the Entry Point. Provides connection level ratio of data packets (bytes) lost to the data packets (bytes) sent by the Encoder.",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 210,
"name": "Success Ingest Hits",
"type": "count",
"description": "Success Hits",
"dataType": "COUNT",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 212,
"name": "Error Rate",
"unit": "%",
"type": "percent",
"description": "Percentage rate of errors occurring in a given time period.",
"dataType": "PERCENT",
"helpText": "Percentage rate of errors occurring in a given time period.",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 213,
"name": "Avg Path Time",
"unit": "ms",
"type": "time",
"description": "Average time taken from source to destination.",
"dataType": "TIME",
"helpText": "Average time taken from source to destination.",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 215,
"name": "2xx Ingest Hits",
"type": "count",
"description": "Number of requests made to the entry point posting objects that returned successful response codes in the 200 to 299 range.",
"dataType": "COUNT",
"helpText": "Number of requests made to the entry point posting objects that returned successful response codes in the 200 to 299 range.",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 200,
"name": "Avg Bitrate",
"unit": "Kbps",
"type": "bandwidth",
"description": "Average amount of data transferred in a time period, calculated in terms of bits per second. Expressed in kbps, Mbps, Gbps, etc.",
"dataType": "BANDWIDTH",
"helpText": "Average amount of data transferred in a time period, calculated in terms of bits per second. Expressed in kbps, Mbps, Gbps, etc.",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 202,
"name": "Ingest Hits",
"type": "count",
"description": "Total number of requests made to the entry point posting objects.",
"dataType": "COUNT",
"helpText": "Total number of requests made to the entry point posting objects.",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 204,
"name": "3xx Ingest Hits",
"type": "count",
"description": "Number of requests made to the entry point posting objects that returned redirect response codes in the 300 to 399 range.",
"dataType": "COUNT",
"helpText": "Number of requests made to the entry point posting objects that returned response codes in the 300 to 399 range.",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 205,
"name": "4xx Ingest Hits",
"type": "count",
"description": "Number of requests made to the entry point posting objects that returned client error response codes in the 400 to 499 range.",
"dataType": "COUNT",
"helpText": "Number of requests made to the entry point posting objects that returned client error response codes in the 400 to 499 range.",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 206,
"name": "5xx Ingest Hits",
"type": "count",
"description": "Number of requests made to the entry point posting objects that returned server error response codes in the 500 to 599 range.",
"dataType": "COUNT",
"helpText": "Number of requests made to the entry point posting objects that returned server error response codes in the 500 to 599 range.",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 207,
"name": "Avg Latency",
"unit": "ms",
"type": "time",
"description": "Indicates the delay between Encoder and Entry Point when sending a unit of media payload.",
"dataType": "TIME",
"helpText": "Indicates the delay between Encoder and Entry Point when sending a unit of media payload.",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
}
],
"aggregationInSeconds": 120,
"purgeIntervalInDays": 30,
"maxQueryDurationInMinutes": 43200,
"reportType": ""
},
{
"id": 100,
"name": "ingesttraffic_-_F_time",
"type": "standard",
"description": "ingesttraffic_-_F_time",
"dimensions": [
{
"id": 99,
"name": "Source Type",
"description": "Source type - IAT or Encoder.",
"helpText": "Source type of stream",
"dataType": "STRING",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 100,
"name": "Time",
"description": "Indicates the time at which content was consumed.This dimension is set automatically.",
"helpText": "Indicates the time at which content was consumed.This dimension is set automatically.",
"dataType": "TIME",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 101,
"name": "CP Code",
"description": "Identifier assigned to a contract associated with a particular stream.",
"helpText": "Identifier assigned to a contract associated with a particular stream.",
"dataType": "CPCODE",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 102,
"name": "Stream ID",
"description": "Unique identifier that is generated when the stream is initially configured.",
"helpText": "Unique identifier that is generated when the stream is initially configured.",
"dataType": "STREAM",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 103,
"name": "Unique End Point",
"description": "The URL path after the Stream ID in the ingest URL. For manifest Files, the filename is part of the Unique End Point. For segment requests, the filename (last path element) is omitted. Also indicates the bit rate of the stream.",
"helpText": "The URL path after the Stream ID in the ingest URL. For manifest Files, the filename is part of the Unique End Point. For segment requests, the filename (last path element) is omitted. Also indicates the bit rate of the stream.",
"dataType": "STRING",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 104,
"name": "File Type",
"description": "File type of the ingested object.",
"helpText": "File type of the ingested object.",
"dataType": "STRING",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 105,
"name": "Encoder IP",
"description": "IP address of the encoder generating the stream.",
"helpText": "IP address of the encoder generating the stream.",
"dataType": "STRING",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 106,
"name": "Entry Point",
"description": "IP address of the Entry Point on which stream is ingested.",
"helpText": "IP address of the Entry Point on which stream is ingested.",
"dataType": "STRING",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 107,
"name": "Stream Type",
"description": "Type of stream - Primary or Backup.",
"helpText": "Type of stream - Primary or Backup.",
"dataType": "STRING",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 111,
"name": "File Extension",
"description": "File Extension of the ingested object as extracted from the URL.",
"helpText": "File Extension of the ingested object as extracted from the URL.",
"dataType": "STRING",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
}
],
"metrics": [
{
"id": 200,
"name": "Avg Bitrate",
"unit": "Kbps",
"type": "bandwidth",
"description": "Average amount of data transferred in a given time period, calculated in terms of bits per second. Expressed in kbps, Mbps, Gbps etc.",
"dataType": "BANDWIDTH",
"helpText": "Average amount of data transferred in a given time period, calculated in terms of bits per second. Expressed in kbps, Mbps, Gbps etc.",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 201,
"name": "Error Rate",
"unit": "%",
"type": "percent",
"description": "Percentage rate of errors occurring within a given time period.",
"dataType": "PERCENT",
"helpText": "Percentage rate of errors occurring within a given time period.",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 202,
"name": "Ingest Hits",
"type": "count",
"description": "Total number of requests made to the entry point posting objects.",
"dataType": "COUNT",
"helpText": "Total number of requests made to the entry point posting objects.",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 203,
"name": "2xx Ingest Hits",
"type": "count",
"description": "Number of requests made to the entry point posting objects that returned successful response codes in the 200 to 299 range.",
"dataType": "COUNT",
"helpText": "Number of requests made to the entry point posting objects that returned successful response codes in the 200 to 299 range.",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 204,
"name": "3xx Ingest Hits",
"type": "count",
"description": "Number of requests made to the entry point posting objects that returned redirect response codes in the 300 to 399 range.",
"dataType": "COUNT",
"helpText": "Number of requests made to the entry point posting objects that returned redirect response codes in the 300 to 399 range.",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 205,
"name": "4xx Ingest Hits",
"type": "count",
"description": "Number of requests made to the entry point posting objects that returned client error response codes in the 400 to 499 range.",
"dataType": "COUNT",
"helpText": "Number of requests made to the entry point posting objects that returned client error response codes in the 400 to 499 range.",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 206,
"name": "5xx Ingest Hits",
"type": "count",
"description": "Number of requests made to the entry point posting objects that returned server error response codes in the 500 to 599 range.",
"dataType": "COUNT",
"helpText": "Number of requests made to the entry point posting objects that returned server error response codes in the 500 to 599 range.",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
}
],
"aggregationInSeconds": 120,
"purgeIntervalInDays": 30,
"maxQueryDurationInMinutes": 43200,
"reportType": ""
}
]
Get a Media Services Live 4 data store
Retrieves a specific Media Services Live 4 data store, based on
the dataStoreId
.
GET /media-reports/
Sample: /media-reports/
Parameter | Type | Sample | Description |
---|---|---|---|
URL path parameters | |||
dataStoreId |
Integer | 102 |
The unique dataStoreId value for the data store. |
Status 200
application/json
Download schema: dataStore.json
Response body:
{
"id": 102,
"name": "iatstreams_-_F_time",
"type": "standard",
"description": "iatstreams_-_F_time",
"dimensions": [
{
"id": 100,
"name": "Time",
"description": "Indicates the time at which content was consumed. This dimension is set automatically.",
"helpText": "Indicates the time at which content was consumed. This dimension is set automatically.",
"dataType": "TIME",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 101,
"name": "CP Code",
"description": "Unique identifier for the contract associated with a particular stream, used for billing purposes.",
"helpText": "Unique identifier for the contract associated with a particular stream, used for billing purposes.",
"dataType": "CPCODE",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 102,
"name": "Stream ID",
"description": "Unique identifier for the stream that is generated when the stream is initially configured.",
"helpText": "Unique identifier for the stream that is generated when the stream is initially configured.",
"dataType": "STREAM",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 103,
"name": "Unique End Point",
"description": "The URL path after the Stream ID in the ingest URL. For manifest files, the file name is part of the Unique End Point. For segment requests, the file name is omitted. Also indicates the bit rate of the stream.",
"helpText": "The URL path after the Stream ID in the ingest URL. For manifest files, the file name is part of the Unique End Point. For segment requests, the file name is omitted. Also indicates the bit rate of the stream.",
"dataType": "STRING",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 106,
"name": "Entry Point",
"description": "IP address of the Entry Point on which stream is ingested.",
"helpText": "IP address of the Entry Point on which stream is ingested.",
"dataType": "STRING",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 108,
"name": "Source IP",
"description": "Source IP/IAT IP",
"dataType": "STRING",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 109,
"name": "File Type",
"description": "File extension of the requested object as extracted from the URL.",
"helpText": "File extension of the requested object as extracted from the URL.",
"dataType": "STRING",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 111,
"name": "File Extension",
"description": "File Extension of the ingested object as extracted from the URL.",
"helpText": "File Extension of the ingested object as extracted from the URL.",
"dataType": "STRING",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
}
],
"metrics": [
{
"id": 208,
"name": "Avg Packet Loss",
"unit": "%",
"type": "percent",
"description": "Measures the quality of the connection between the Encoder and the Entry Point. Provides connection level ratio of data packets (bytes) lost to the data packets (bytes) sent by the Encoder.",
"dataType": "PERCENT",
"helpText": "Measures the quality of the connection between the Encoder and the Entry Point. Provides connection level ratio of data packets (bytes) lost to the data packets (bytes) sent by the Encoder.",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 210,
"name": "Success Ingest Hits",
"type": "count",
"description": "Success Hits",
"dataType": "COUNT",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 212,
"name": "Error Rate",
"unit": "%",
"type": "percent",
"description": "Percentage rate of errors occurring in a given time period.",
"dataType": "PERCENT",
"helpText": "Percentage rate of errors occurring in a given time period.",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 213,
"name": "Avg Path Time",
"unit": "ms",
"type": "time",
"description": "Average time taken from source to destination.",
"dataType": "TIME",
"helpText": "Average time taken from source to destination.",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 215,
"name": "2xx Ingest Hits",
"type": "count",
"description": "Number of requests made to the entry point posting objects that returned successful response codes in the 200 to 299 range.",
"dataType": "COUNT",
"helpText": "Number of requests made to the entry point posting objects that returned successful response codes in the 200 to 299 range.",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 200,
"name": "Avg Bitrate",
"unit": "Kbps",
"type": "bandwidth",
"description": "Average amount of data transferred in a time period, calculated in terms of bits per second. Expressed in kbps, Mbps, Gbps etc.",
"dataType": "BANDWIDTH",
"helpText": "Average amount of data transferred in a time period, calculated in terms of bits per second. Expressed in kbps, Mbps, Gbps etc.",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 202,
"name": "Ingest Hits",
"type": "count",
"description": "Total number of requests made to the entry point posting objects.",
"dataType": "COUNT",
"helpText": "Total number of requests made to the entry point posting objects.",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 204,
"name": "3xx Ingest Hits",
"type": "count",
"description": "Number of requests made to the entry point posting objects that returned redirect response codes in the 300 to 399 range.",
"dataType": "COUNT",
"helpText": "Number of requests made to the entry point posting objects that returned redirect response codes in the 300 to 399 range.",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 205,
"name": "4xx Ingest Hits",
"type": "count",
"description": "Number of requests made to the entry point posting objects that returned client error response codes in the 400 to 499 range.",
"dataType": "COUNT",
"helpText": "Number of requests made to the entry point posting objects that returned client error response codes in the 400 to 499 range.",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 206,
"name": "5xx Ingest Hits",
"type": "count",
"description": "Number of requests made to the entry point posting objects that returned server error response codes in the 500 to 599 range.",
"dataType": "COUNT",
"helpText": "Number of requests made to the entry point posting objects that returned server error response codes in the 500 to 599 range.",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 207,
"name": "Avg Latency",
"unit": "ms",
"type": "time",
"description": "Indicates the delay between Encoder and Entry Point when sending a unit of media payload.",
"dataType": "TIME",
"helpText": "Indicates the delay between Encoder and Entry Point when sending a unit of media payload.",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
}
],
"aggregationInSeconds": 120,
"purgeIntervalInDays": 30,
"maxQueryDurationInMinutes": 43200,
"reportType": ""
}
Get Media Services Live 4 entry point switch information
Retrieves information about the entry point switches that occurred in a given time period.
GET /media-reports/
Sample: /media-reports/
Parameter | Type | Sample | Description |
---|---|---|---|
Required query parameters | |||
endDate |
String | 2014-03-23T15:30Z |
The timestamp string in ISO 8601 format yyyy-MM-ddTHH:mmZ or yyyy-MM-ddTHH:mm+HH:mm . |
startDate |
String | 2014-03-22T15:30Z |
The timestamp string in ISO 8601 format yyyy-MM-ddTHH:mmZ or yyyy-MM-ddTHH:mm+HH:mm . |
Optional query parameters | |||
cpcodes |
String | 12345,67890 |
Use to limit report data to specific CP codes. Comma-separate multiple values. |
limit |
Number | 300 |
The number of rows to return from 1 to 10000 . The default value is 300 . |
offset |
Number | 0 |
The offset of the row for the start of data. Use this to request progressive batches of data. For example, you can make 10 requests for 1000 records by setting the overall limit to 100 , then setting the offset to 0 , 100 , 200 , and so on for each request. |
streams |
String | 12345,67890 |
Identifies a set of reported streams as comma-separated ID values. |
Status 200
application/json
Download schema: entryPointSwitchData.json
Response body:
{
"columns": [
{
"index": 0,
"name": "Current Time",
"type": "dimension"
},
{
"index": 1,
"name": "Stream ID",
"type": "dimension"
},
{
"index": 2,
"name": "Entry Point Switch Time",
"type": "dimension"
},
{
"index": 3,
"name": "Old Entry Point",
"type": "dimension"
},
{
"index": 4,
"name": "New Entry Point",
"type": "dimension"
},
{
"index": 5,
"name": "Stream Type",
"type": "dimension"
}
],
"metaData": {
"aggregation": 120,
"endTimeInEpoch": 1487833200,
"hasMoreData": false,
"limit": 300,
"offset": 0,
"startTimeInEpoch": 1487826000,
"timeZone": "GMT"
},
"rows": [
[
"1487829360",
"266583",
"1487829240",
"198.18.52.238",
"198.18.52.240",
"Primary"
],
[
"1487830080",
"266583",
"1487829960",
"198.18.52.240",
"198.18.52.238",
"Primary"
],
[
"1487832120",
"266583",
"1487831520",
"198.18.52.238",
"198.18.52.240",
"Primary"
]
]
}
List Media Services Live 4 Origin Shield dimensions
Retrieves all of the dimensions available for HTTP Ingest (Media Services Live 4).
GET /media-reports/
Status 200
application/json
Download schema: dimensions.json
Response body:
[
{
"id": 5511,
"name": "ASN Name",
"description": "Name of the Autonomous System Number (ASN)."
},
{
"id": 5505,
"name": "CDN",
"description": "Name of the CDN provider."
},
{
"id": 5501,
"name": "CPCode",
"description": "Content provider code (CP code) is an identifier assigned to a contract and used for reporting, billing, and monitoring traffic served."
},
{
"id": 5507,
"name": "Client ASN",
"description": "Autonomous system number of an ISP."
},
{
"id": 5506,
"name": "Client Country",
"description": "Origin country of CDN."
},
{
"id": 5504,
"name": "Format",
"description": "Delivery format of the stream."
},
{
"id": 5509,
"name": "Origin Hostname",
"description": "CDN Hostname."
},
{
"id": 5508,
"name": "Publishing Geo",
"description": "GEO location of CDN host."
},
{
"id": 5502,
"name": "Stream Id",
"description": "Unique identifier associated with a stream."
},
{
"id": 5503,
"name": "Stream Type",
"description": "Type of stream - Primary or Backup."
},
{
"id": 5500,
"name": "Time",
"description": "Indicates the time at which the content was ingested."
}
]
List Media Services Live 4 Origin Shield metrics
Retrieves all of the metrics available for Media Services Live 4 (HLS/HDS/DASH).
GET /media-reports/
Status 200
application/json
Download schema: metrics.json
Response body:
[
{
"id": 5525,
"name": "2xx Hits",
"type": "count",
"description": "Number of hits that returned response codes - 200 to 299 (Successful)."
},
{
"id": 5526,
"name": "3xx Hits",
"type": "count",
"description": "Number of hits that returned response codes - 300 to 399 (Redirection)."
},
{
"id": 5527,
"name": "4xx Hits",
"type": "count",
"description": "Number of hits that returned response codes - 400 to 499 (Client Error)."
},
{
"id": 5528,
"name": "5xx Hits",
"type": "count",
"description": "Number of hits that returned response codes - 500 to 599 (Server Error)."
},
{
"id": 5531,
"name": "Avg Download Time",
"unit": "seconds",
"type": "time",
"description": "The average time to download media based on bandwidth, file size, and connection speed."
},
{
"id": 5533,
"name": "Avg Throughput",
"unit": "Mbps",
"description": "The rate of successful delivery of media. The system calculates this as the total bytes delivered, divided by the total time taken to serve the request."
},
{
"id": 5523,
"name": "Bandwidth",
"unit": "Mbps",
"description": "Total bandwidth usage including all HTTP response codes."
},
{
"id": 5522,
"name": "Bytes",
"description": "Total bytes transferred."
},
{
"id": 5520,
"name": "Hits",
"type": "count",
"description": "Total number of requests."
},
{
"id": 5545,
"name": "Hits [Download Time 0-2 Sec]",
"type": "count",
"description": "Total number of requests that took a download time of 0-2 seconds."
},
{
"id": 5546,
"name": "Hits [Download Time 2-4 Sec]",
"type": "count",
"description": "Total number of requests that took a download time of 2-4 seconds."
},
{
"id": 5547,
"name": "Hits [Download Time 4-6 Sec]",
"type": "count",
"description": "Total number of requests that took a download time of 4-6 seconds."
},
{
"id": 5548,
"name": "Hits [Download Time 6-8 Sec]",
"type": "count",
"description": "Total number of requests that took a download time of 6-8 seconds."
},
{
"id": 5549,
"name": "Hits [Download Time 8-10 Sec] ",
"type": "count",
"description": "Total number of requests that took a download time of 8-10 seconds."
},
{
"id": 5550,
"name": "Hits [Download Time > 10 Sec]",
"type": "count",
"description": "Total number of requests that took a download time of greater than 10 seconds."
},
{
"id": 5537,
"name": "Hits [Throughput 0-2 Mbps]",
"type": "count",
"description": "Total number of requests that had a throughput of 0-2 seconds."
},
{
"id": 5540,
"name": "Hits [Throughput 10-12 Mbps]",
"type": "count",
"description": "Total number of requests that had a throughput of 10-12 Mbps."
},
{
"id": 5541,
"name": "Hits [Throughput 12-15 Mbps]",
"type": "count",
"description": "Total number of requests that had a throughput of 12-15 Mbps."
},
{
"id": 5542,
"name": "Hits [Throughput 15-17 Mbps]",
"type": "count",
"description": "Total number of requests that had a throughput of 15-17 Mbps."
},
{
"id": 5543,
"name": "Hits [Throughput 17-20 Mbps]",
"type": "count",
"description": "Total number of requests that had a throughput of 17-20 Mbps."
},
{
"id": 5538,
"name": "Hits [Throughput 2-5 Mbps]",
"type": "count",
"description": "Total number of requests that had a throughput of 2-5 Mbps."
},
{
"id": 5539,
"name": "Hits [Throughput 5-10 Mbps]",
"type": "count",
"description": "Total number of requests that had a throughput of 5-10 Mbps."
},
{
"id": 5544,
"name": "Hits [Throughput > 20 Mbps]",
"type": "count",
"description": "Total number of requests that had a throughput of over 20 Mbps."
},
{
"id": 5521,
"name": "Hits/sec",
"type": "count",
"description": "Number of hits per second."
},
{
"id": 5534,
"name": "Line Count",
"type": "count",
"description": "Line Count"
},
{
"id": 5529,
"name": "Other Hits",
"type": "count",
"description": "Number of requests that return responses that do not belong to the categories: 2xx, 3xx, 4xx, or 5xx. "
},
{
"id": 5535,
"name": "Success Bytes",
"unit": "bytes",
"type": "volume",
"description": "Volume of total bytes transferred in successful hits."
},
{
"id": 5532,
"name": "Throughput",
"description": "The rate of successful delivery of content. The system calculates this as the total bytes delivered, divided by the total time taken to serve the request."
},
{
"id": 5524,
"name": "Volume",
"unit": "MB",
"description": "Total number of megabytes transferred at the entry point."
},
{
"id": 5536,
"name": "Weighted Average Throughput",
"unit": "Mbps",
"description": "Rate of successful delivery of content weighted by daily bytes delivered."
}
]
Get Media Services Live 4 Origin Shield data
Retrieves HTTP Ingest Origin Shield data for the given parameters. You can query data collected at a one minute aggregation with ten percent sampling frequency and a purge window of seven days. The maximum duration is two minutes per query.
POST /media-reports/
Sample: /media-reports/
Parameter | Type | Sample | Description |
---|---|---|---|
Required query parameters | |||
dimensions |
String | 1,2,3 |
Identifies dimensions with comma-separated IDs. |
endDate |
String | 2014-03-23T15:30Z |
The timestamp string in ISO 8601 format yyyy-MM-ddTHH:mmZ or yyyy-MM-ddTHH:mm+HH:mm . |
metrics |
String | 1,2,3 |
Identifies metrics with comma-separated IDs. |
startDate |
String | 2014-03-22T15:30Z |
The timestamp string in ISO 8601 format yyyy-MM-ddTHH:mmZ or yyyy-MM-ddTHH:mm+HH:mm . |
Optional query parameters | |||
aggregation |
Number | 1440 |
The time period in which to group each data record, expressed as number of seconds. |
cpcodes |
String | 12345,67890 |
Use to limit report data to specific CP codes. Comma-separate multiple values. |
filterParams |
String | [{"type":"dimension","values":["GB"],"id":4,"condition":"in"},{"type":"metric","values":[16],"id":155,"condition":"gt"}] |
A UTF–8, URL-encoded JSON object representing filter parameters that limit reported data. See the FilterParams object for details on its structure. |
limit |
Number | 300 |
The number of rows to return from 1 to 10000 . The default value is 300 . |
offset |
Number | 0 |
The offset of the row for the start of data. Use this to request progressive batches of data. For example, you can make 10 requests for 1000 records by setting the overall limit to 100 , then setting the offset to 0 , 100 , 200 , and so on for each request. |
sortParams |
String | [{"type":"metric", "order":"asc", "id":40}] |
A UTF–8, URL-encoded JSON object representing sort parameters that rearrange reported data. See the SortParams object for details on its structure. |
streams |
String | 12345,67890 |
Identifies a set of reported streams as comma-separated ID values. |
Status 200
application/json
Download schema: origin-shieldData.json
Response body:
{
"columns": [
{
"type": "dimension",
"name": "CPCode",
"description": "Identifier assigned to a contract and used for reporting, billing, and monitoring traffic served.",
"index": 0
},
{
"type": "dimension",
"name": "Stream Id",
"description": "Unique identifier associated with a stream generated by the Akamai provisioning workflow.",
"index": 1
},
{
"type": "metric",
"name": "Hits",
"description": "Total number of requests made to the entry point posting objects.",
"index": 2,
"aggregate": "88"
},
{
"type": "metric",
"name": "Hits/sec",
"description": "Number of hits per second to entry point servers.",
"index": 3,
"aggregate": "1.47"
},
{
"type": "metric",
"name": "Bandwidth",
"description": "Total bandwidth usage at the entry point, including all HTTP response codes.",
"index": 3,
"aggregate": "8.67",
"unit": "Mbps"
}
],
"rows": [
"686645",
"12345",
"88",
"1.47",
"8.67"
],
"metaData": {
"startTimeInEpoch": 1522980000,
"offset": 0,
"limit": 300,
"timeZone": "GMT",
"hasMoreData": false,
"aggregation": 60,
"endTimeInEpoch": 1522984260
}
}
List Media Services Live Stream Packaging dimensions
Retrieves all of the dimensions available for Media Services Live Stream Packaging.
GET /media-reports/
Status 200
application/json
Download schema: dimensions.json
Response body:
[
{
"id": 209,
"name": "Stream Type",
"description": "Type of stream - Primary (actual) or Backup."
},
{
"id": 210,
"name": "Source Type",
"description": "Source type - IAT or Encoder."
},
{
"id": 200,
"name": "Time",
"description": "Indicates the consumption time of the content. This dimension is set automatically."
},
{
"id": 201,
"name": "CP Code",
"description": "Identifier assigned to a contract associated with a particular stream."
},
{
"id": 202,
"name": "Stream ID",
"description": "Unique identifier associated with a stream generated by the Akamai provisioning workflow."
},
{
"id": 203,
"name": "Unique End Point",
"description": "The URL path after Stream ID in the ingest URL. Indicates bit rate of the stream."
},
{
"id": 204,
"name": "Encoder IP",
"description": "IP address of encoder generating the stream."
},
{
"id": 205,
"name": "Authentication Scheme",
"description": "Stream authentication scheme used. Values displayed can be Adobe, Akamai, or Octoshape."
},
{
"id": 206,
"name": "Entry Point",
"description": "IP address of the entry point at which stream is ingested."
},
{
"id": 207,
"name": "File Type",
"description": "File type of the ingested stream."
},
{
"id": 208,
"name": "Encoder IP",
"description": "IP address of encoder generating the stream."
}
]
List Media Services Live Stream Packaging metrics
Retrieves all of the metrics available for Media Services Live RTMP Ingest.
GET /media-reports/
Status 200
application/json
Download schema: metrics.json
Response body:
[
{
"id": 230,
"name": "Avg Bit rate",
"unit": "kbps",
"type": "bandwidth",
"description": "Average amount of data transferred in a unit of time; calculated in terms of bits per second; and expressed in kbps, Mbps, Gbps etc."
},
{
"id": 231,
"name": "Query Agg",
"type": "count",
"description": "Query Agg"
},
{
"id": 232,
"name": "Avg Latency",
"unit": "ms",
"type": "time",
"description": "Indicates the delay between encoder and entry point when sending a unit of media payload."
},
{
"id": 233,
"name": "Avg Packet Loss",
"unit": "%",
"type": "percent",
"description": "Measures the quality of connection between encoder and entry point. Provides connection level ratio of data packets (bytes) lost to the data packets(bytes) sent by Encoder."
},
{
"id": 234,
"name": "Bytes Transferred",
"unit": "kbps",
"type": "bandwidth",
"description": "Bytes Transferred"
},
{
"id": 235,
"name": "Avg Bit rate",
"unit": "kbps",
"type": "bandwidth",
"description": "Average amount of data transferred in a unit of time; calculated in terms of bits per second; and expressed in kbps, Mbps, Gbps etc."
},
{
"id": 236,
"name": "Avg Path Time",
"unit": "ms",
"type": "time",
"description": "Average time taken from source to destination."
}
]
Get Media Services Live Stream Packaging data
Retrieves Media Services Live Stream Packaging data for the given parameters.
POST /media-reports/
Sample: /media-reports/
Parameter | Type | Sample | Description |
---|---|---|---|
Required query parameters | |||
dimensions |
String | 1,2,3 |
Identifies dimensions with comma-separated IDs. |
endDate |
String | 2014-03-23T15:30Z |
The timestamp string in ISO 8601 format yyyy-MM-ddTHH:mmZ or yyyy-MM-ddTHH:mm+HH:mm . |
metrics |
String | 1,2,3 |
Identifies metrics with comma-separated IDs. |
startDate |
String | 2014-03-22T15:30Z |
The timestamp string in ISO 8601 format yyyy-MM-ddTHH:mmZ or yyyy-MM-ddTHH:mm+HH:mm . |
Optional query parameters | |||
aggregation |
Number | 1440 |
The time period in which to group each data record, expressed as number of seconds. |
cpcodes |
String | 12345,67890 |
Use to limit report data to specific CP codes. Comma-separate multiple values. |
filterParams |
String | [{"type":"dimension","values":["GB"],"id":4,"condition":"in"},{"type":"metric","values":[16],"id":155,"condition":"gt"}] |
A UTF–8, URL-encoded JSON object representing filter parameters that limit reported data. See the FilterParams object for details on its structure. |
limit |
Number | 300 |
The number of rows to return from 1 to 10000 . The default value is 300 . |
offset |
Number | 0 |
The offset of the row for the start of data. Use this to request progressive batches of data. For example, you can make 10 requests for 1000 records by setting the overall limit to 100 , then setting the offset to 0 , 100 , 200 , and so on for each request. |
sortParams |
String | [{"type":"metric", "order":"asc", "id":40}] |
A UTF–8, URL-encoded JSON object representing sort parameters that rearrange reported data. See the SortParams object for details on its structure. |
streams |
String | 12345,67890 |
Identifies a set of reported streams as comma-separated ID values. |
Status 200
application/json
Object type: Report
Download schema: mediaServicesData.json
Response body:
{
"columns": [
{
"type": "dimension",
"name": "Time",
"description": "Indicates the consumption time of the content. This dimension is set automatically.",
"index": 0
},
{
"type": "metric",
"name": "Hits",
"description": "Total number of requests made to the entry point posting objects.",
"index": 1,
"aggregate": "46055"
}
],
"rows": [
[
"1471737600",
"158"
],
[
"1471737720",
"138"
],
[
"1471737840",
"183"
],
[
"1471737960",
"158"
],
[
"1471738080",
"163"
],
[
"1471738200",
"155"
]
],
"metaData": {
"startTimeInEpoch": 1471737600,
"offset": 0,
"limit": 300,
"timeZone": "GMT",
"hasMoreData": true,
"aggregation": 120,
"endTimeInEpoch": 1471860000
}
}
Get Media Services Live Stream Packaging entry point switching information
Retrieves information about all of the entry point switches that occurred in a given period.
GET /media-reports/
Sample: /media-reports/
Parameter | Type | Sample | Description |
---|---|---|---|
Required query parameters | |||
dimensions |
String | 1,2,3 |
Identifies dimensions with comma-separated IDs. |
endDate |
String | 2014-03-23T15:30Z |
The timestamp string in ISO 8601 format yyyy-MM-ddTHH:mmZ or yyyy-MM-ddTHH:mm+HH:mm . |
metrics |
String | 1,2,3 |
Identifies metrics with comma-separated IDs. |
startDate |
String | 2014-03-22T15:30Z |
The timestamp string in ISO 8601 format yyyy-MM-ddTHH:mmZ or yyyy-MM-ddTHH:mm+HH:mm . |
Optional query parameters | |||
cpcodes |
String | 12345,67890 |
Use to limit report data to specific CP codes. Comma-separate multiple values. |
filterParams |
String | [{"type":"dimension","values":["GB"],"id":4,"condition":"in"},{"type":"metric","values":[16],"id":155,"condition":"gt"}] |
A UTF–8, URL-encoded JSON object representing filter parameters that limit reported data. See the FilterParams object for details on its structure. |
limit |
Number | 300 |
The number of rows to return from 1 to 10000 . The default value is 300 . |
offset |
Number | 0 |
The offset of the row for the start of data. Use this to request progressive batches of data. For example, you can make 10 requests for 1000 records by setting the overall limit to 100 , then setting the offset to 0 , 100 , 200 , and so on for each request. |
sortParams |
String | [{"type":"metric", "order":"asc", "id":40}] |
A UTF–8, URL-encoded JSON object representing sort parameters that rearrange reported data. See the SortParams object for details on its structure. |
streams |
String | 12345,67890 |
Identifies a set of reported streams as comma-separated ID values. |
Status 200
application/json
Download schema: entryPointSwitchData.json
Response body:
{
"columns": [
{
"index": 0,
"name": "Current Time",
"type": "dimension"
},
{
"index": 1,
"name": "Stream ID",
"type": "dimension"
},
{
"index": 2,
"name": "Entry Point Switch Time",
"type": "dimension"
},
{
"index": 3,
"name": "Old Entry Point",
"type": "dimension"
},
{
"index": 4,
"name": "New Entry Point",
"type": "dimension"
},
{
"index": 5,
"name": "Stream Type",
"type": "dimension"
}
],
"metaData": {
"aggregation": 120,
"endTimeInEpoch": 1487833200,
"hasMoreData": false,
"limit": 300,
"offset": 0,
"startTimeInEpoch": 1487826000,
"timeZone": "GMT"
},
"rows": [
[
"1487829360",
"266583",
"1487829240",
"198.18.52.238",
"198.18.52.240",
"Primary"
],
[
"1487830080",
"266583",
"1487829960",
"198.18.52.240",
"198.18.52.238",
"Primary"
],
[
"1487832120",
"266583",
"1487831520",
"198.18.52.238",
"198.18.52.240",
"Primary"
]
]
}
List Media Services Live HLS/HDS/DASH Ingest metrics
Retrieves all of the metrics available for HLS/HDS/DASH Ingest.
GET /media-reports/
Status 200
application/json
Download schema: metrics.json
Response body:
[
{
"id": 123456,
"name": "Average Bit rate",
"unit": "count",
"type": "count",
"description": "Average amount of data transferred"
},
{
"id": 123457,
"name": "Average Buffer Time",
"type": "count",
"description": "Average Buffer Time"
},
{
"id": 123458,
"name": "Average Client Bandwidth",
"type": "bandwidth",
"description": "Average client Bandwidth"
}
]
List Media Services Live HLS/HDS/DASH Ingest dimensions
Retrieves all of the dimensions available for Media Services Live HLS/HDS/DASH Ingest.
GET /media-reports/
Status 200
application/json
Download schema: dimensions.json
Response body:
[
{
"id": 12345,
"name": "CP Code",
"description": "Identifier assigned to a contract associated with a particular stream."
},
{
"id": 12346,
"name": "Canadian Province",
"description": "Canadian Province"
}
]
List Media Services Live HLS/HDS/DASH Ingest data
Retrieves ingest data for Media Services Live HLS/HDS/DASH Ingest.
GET /media-reports/
Sample: /media-reports/
Parameter | Type | Sample | Description |
---|---|---|---|
Required query parameters | |||
endDate |
String | 2014-03-23T15:30Z |
The timestamp string in ISO 8601 format yyyy-MM-ddTHH:mmZ or yyyy-MM-ddTHH:mm+HH:mm . |
startDate |
String | 2014-03-22T15:30Z |
The timestamp string in ISO 8601 format yyyy-MM-ddTHH:mmZ or yyyy-MM-ddTHH:mm+HH:mm . |
Optional query parameters | |||
cpcodes |
String | 12345,67890 |
Use to limit report data to specific CP codes. Comma-separate multiple values. |
enableCpCodeName |
Boolean | true |
When enabled, includes the name of the CP code in the output. |
ignorePutPost |
Boolean | true |
Specifies if the API should ignore ingest data when generating the response. |
Status 200
application/json
Download schema: Msl3RtmpData.json
Response body:
{
"columns": [
{
"type": "dimension",
"name": "Time",
"description": "Indicates the consumption time of the content. This dimension is set automatically.",
"index": 0
},
{
"type": "metric",
"name": "Concurrent Streams",
"id": 123456,
"description": "Sum of Average concurrent streams",
"index": 1,
"aggregate": "3141454.39"
}
],
"rows": [
[
"1543674600",
"186575.959"
],
[
"1543761000",
"185988.34"
],
[
"1543847400",
"184741.378"
],
[
"1543933800",
"180774.639"
],
[
"1544020200",
"181598.317"
],
[
"1544106600",
"184538.753"
],
[
"1544193000",
"190988.807"
],
[
"1544279400",
"187612.032"
],
[
"1544365800",
"179426.637"
],
[
"1544452200",
"178335.044"
],
[
"1544538600",
"183263.786"
],
[
"1544625000",
"183384.385"
],
[
"1544711400",
"183790.081"
],
[
"1544797800",
"189211.628"
],
[
"1544884200",
"186208.98"
],
[
"1544970600",
"189176.899"
],
[
"1545057000",
"185838.721"
]
],
"metaData": {
"startTimeInEpoch": 1543674600,
"offset": 0,
"dasTable": "strconcur_live_F_time",
"limit": 300,
"timeZone": "GMT",
"hasMoreData": false,
"messages": [
"Estimated data begins at 19/Dec/2018 02:00:00 GMT"
],
"aggregation": 86400,
"endTimeInEpoch": 1545143400
}
}
List Media Services Live HLS/HDS/DASH Ingest active streams delivery data
Retrieves all delivery data for active streams using Media Services Live HLS/HDS/DASH Ingest.
GET /media-reports/
Sample: /media-reports/
Parameter | Type | Sample | Description |
---|---|---|---|
Optional query parameters | |||
cpcodes |
String | 12345,67890 |
Use to limit report data to specific CP codes. Comma-separate multiple values. |
Status 200
application/json
Download schema: Msl3RtmpData.json
Response body:
{
"columns": [
{
"type": "dimension",
"name": "Stream ID",
"description": "Unique identifier associated with a stream generated by the Akamai provisioning workflow.",
"index": 0
},
{
"type": "dimension",
"name": "Stream Name",
"description": "Name associated with a stream generated by the Akamai provisioning workflow for Stream Packaging",
"index": 1
},
{
"type": "dimension",
"name": "CP Code",
"description": "Content Provider Code (CPCode) is an identifier assigned to a contract and used for reporting, billing and monitoring traffic served.",
"index": 2
},
{
"type": "metric",
"name": "Viewers",
"id": 12053,
"description": "Viewers for Delivery",
"index": 3,
"aggregate": "1961.62",
"dataType": "count"
},
{
"type": "metric",
"name": "Egress Bit Rate",
"id": 12052,
"description": "Bit Rate Delivered",
"index": 4,
"aggregate": "1027.96",
"unit": "Mbps",
"dataType": "bandwidth"
}
],
"rows": [
[
"196305",
"cbsnewsFusion",
"306714",
"481.066667",
"3.8"
],
[
"682874",
"KPIX3_ULS",
"219526",
"2.02",
"4.6"
]
],
"metaData": {
"startTimeInEpoch": 1551432600,
"offset": 0,
"limit": 10000,
"timeZone": "GMT",
"hasMoreData": false,
"dataStore": null,
"aggregation": 300,
"endTimeInEpoch": 1551432900
}
}
List Media Services Live HLS/HDS/DASH Ingest active streams ingest data
Retrieves all ingest data for active streams using Media Services Live HLS/HDS/DASH Ingest.
GET /media-reports/
Sample: /media-reports/
Parameter | Type | Sample | Description |
---|---|---|---|
Optional query parameters | |||
cpcodes |
String | 12345,67890 |
Use to limit report data to specific CP codes. Comma-separate multiple values. |
Status 200
application/json
Download schema: Msl3RtmpData.json
Response body:
{
"columns": [
{
"type": "dimension",
"name": "Stream ID",
"description": "Unique identifier associated with a stream generated by the Akamai provisioning workflow.",
"index": 0
},
{
"type": "dimension",
"name": "Stream Name",
"description": "Name associated with a stream generated by the Akamai provisioning workflow for Stream Packaging",
"index": 1
},
{
"type": "dimension",
"name": "CP Code",
"description": "Content Provider Code (CPCode) is an identifier assigned to a contract and used for reporting, billing and monitoring traffic served.",
"index": 2
},
{
"type": "metric",
"name": "Ingest bit rate",
"id": 12050,
"description": "Ingest bit rate",
"index": 3,
"aggregate": "336084.6",
"unit": "kbps",
"dataType": "bandwidth"
}
],
"rows": [
[
"811888",
"bigbro2019_day1",
"569190",
"106608.136"
],
[
"574118",
"241065",
"33818.136"
]
],
"metaData": {
"startTimeInEpoch": 1551432900,
"offset": 0,
"limit": 10000,
"timeZone": "GMT",
"hasMoreData": false,
"dataStore": null,
"aggregation": 300,
"endTimeInEpoch": 1551433200
}
}
List Media Services Live HLS/HDS/DASH Ingest data stores
Retrieves all data stores for Media Services Live HLS/HDS/DASH Ingest.
GET /media-reports/
Status 200
application/json
Download schema: dataStore.json
Response body:
[
{
"id": 10021,
"name": "us_live_D_geoid",
"type": "standard",
"description": "Table for user location US graph",
"dimensions": [
{
"id": 10000,
"name": "Time",
"description": "Indicates the consumption time of the content. This dimension is set automatically.",
"helpText": "Indicates the consumption time of the content. This dimension is set automatically.",
"dataType": "TIME",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 10001,
"name": "CP Code",
"description": "Identifier assigned to a contract associated with a particular stream.",
"helpText": "Identifier assigned to a contract associated with a particular stream.",
"dataType": "CPCODE",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 10020,
"name": "State",
"description": "The geographic region ID (state, territory or province) based on the associated country.",
"helpText": "The geographic region ID (state, territory or province) based on the associated country.",
"dataType": "NUMBER",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
}
],
"metrics": [
{
"id": 10401,
"name": "OK Hits",
"type": "count",
"description": "OK hits",
"dataType": "COUNT",
"displayName": "OK hits 2",
"helpText": "OK hits",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 10402,
"name": "OK Volume",
"unit": "MB",
"type": "volume",
"description": "OK Volume",
"dataType": "VOLUME",
"displayName": "OK Volume",
"helpText": "OK Volume",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
}
],
"aggregationInSeconds": 86400,
"purgeIntervalInDays": 90,
"maxQueryDurationInMinutes": 44640
},
{
"id": 10007,
"name": "us_live_D_hit",
"type": "standard",
"description": "Table for Visitor graph",
"dimensions": [
{
"id": 10001,
"name": "CP Code",
"description": "Identifier assigned to a contract associated with a particular stream.",
"helpText": "Identifier assigned to a contract associated with a particular stream.",
"dataType": "CPCODE",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 10020,
"name": "State",
"description": "The geographic region ID (state, territory or province) based on the associated country.",
"helpText": "The geographic region ID (state, territory or province) based on the associated country.",
"dataType": "NUMBER",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
}
],
"metrics": [
{
"id": 10105,
"name": "Hits",
"type": "count",
"description": "Total Hits",
"dataType": "COUNT",
"displayName": "Hits 1",
"helpText": "Total Hits",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 10106,
"name": "Volume",
"unit": "MB",
"type": "volume",
"description": "Total Bandwidth",
"dataType": "VOLUME",
"displayName": "Volume 1",
"helpText": "Total Bandwidth",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 10110,
"name": "Hits",
"type": "count",
"description": "Total Hits",
"dataType": "COUNT",
"displayName": "Hits 2",
"helpText": "Total Hits",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 10111,
"name": "Volume",
"unit": "MB",
"type": "volume",
"description": "Total Bandwidth",
"dataType": "VOLUME",
"displayName": "Volume 2",
"helpText": "Total Bandwidth",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
}
],
"aggregationInSeconds": 86400,
"purgeIntervalInDays": 90,
"maxQueryDurationInMinutes": 44640
}
]
Get a Media Services Live HLS/HDS/DASH Ingest data store
Retrieve a specific HLS/HDS/DASH Ingest data store, using
its unique dataStoreId
.
GET /media-reports/
Sample: /media-reports/
Parameter | Type | Sample | Description |
---|---|---|---|
URL path parameters | |||
dataStoreId |
Integer | 10021 |
The unique dataStoreId value associated with the desired data store. |
Status 200
application/json
Download schema: dataStore.json
Response body:
{
"id": 10021,
"name": "us_live_D_geoid",
"type": "standard",
"description": "Table for user location US graph",
"dimensions": [
{
"id": 10000,
"name": "Time",
"description": "Indicates the consumption time of the content. This dimension is set automatically.",
"helpText": "Indicates the consumption time of the content. This dimension is set automatically.",
"dataType": "TIME",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 10001,
"name": "CP Code",
"description": "Identifier assigned to a contract associated with a particular stream.",
"helpText": "Identifier assigned to a contract associated with a particular stream.",
"dataType": "CPCODE",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 10020,
"name": "State",
"description": "The geographic region (state, territory or province) based on the associated country.",
"helpText": "The geographic region (state, territory or province) based on the associated country.",
"dataType": "NUMBER",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
}
],
"metrics": [
{
"id": 10401,
"name": "OK Hits",
"type": "count",
"description": "OK hits",
"dataType": "COUNT",
"displayName": "OK hits 1",
"helpText": "OK hits",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 10402,
"name": "OK Volume",
"unit": "MB",
"type": "volume",
"description": "OK Volume",
"dataType": "VOLUME",
"displayName": "OK Volume 1",
"helpText": "OK Volume",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
}
],
"aggregationInSeconds": 86400,
"purgeIntervalInDays": 90,
"maxQueryDurationInMinutes": 44640
}
List Media Services Live RTMP metrics
Retrieves all of the metrics available for Media Services Live RTMP.
GET /media-reports/
Status 200
application/json
Download schema: metrics.json
Response body:
[
{
"id": 123456,
"name": "Average Bit rate",
"unit": "count",
"type": "count",
"description": "Average amount of data transferred"
},
{
"id": 123457,
"name": "Average Buffer Time",
"type": "count",
"description": "Average Buffer Time"
},
{
"id": 123458,
"name": "Average Client Bandwidth",
"type": "bandwidth",
"description": "Average client Bandwidth"
}
]
List Media Services Live RTMP dimensions
Retrieves all of the dimensions available for Media Services Live RTMP.
GET /media-reports/
Status 200
application/json
Download schema: dimensions.json
Response body:
[
{
"id": 12345,
"name": "CP Code",
"description": "Identifier assigned to a contract associated with a particular stream."
},
{
"id": 12346,
"name": "Canadian Province",
"description": "Canadian Province"
}
]
List Media Services Live RTMP active streams delivery data
Retrieves delivery data for all active Media Services Live RTMP streams.
GET /media-reports/
Sample: /media-reports/
Parameter | Type | Sample | Description |
---|---|---|---|
Optional query parameters | |||
cpcodes |
String | 12345,67890 |
Use to limit report data to specific CP codes. Comma-separate multiple values. |
Status 200
application/json
Download schema: Msl3RtmpData.json
Response body:
{
"columns": [
{
"type": "dimension",
"name": "Unique End Point",
"description": "Stream Port Value",
"index": 0
},
{
"type": "dimension",
"name": "Stream ID",
"description": "The Stream Identifier",
"index": 1
},
{
"type": "dimension",
"name": "Stream Name",
"description": "Stream Port Value for Stream Name",
"index": 2
},
{
"type": "dimension",
"name": "CP Code",
"description": "CPCode Mapping to Stream ID",
"index": 3
},
{
"type": "metric",
"name": "Viewers",
"id": 10301,
"description": "Concurrent Viewers",
"index": 4,
"aggregate": "2328.6",
"unit": "count",
"dataType": "count"
},
{
"type": "metric",
"name": "Egress Bit rate",
"id": 10305,
"description": "Egress Bit rate",
"index": 5,
"aggregate": "1415.15",
"unit": "Mbps",
"dataType": "bandwidth"
}
],
"rows": [
[
"BBLIVE092219_xANZM_1_3500@811888",
"811888",
"bigbro2019_day1",
"844950",
"2",
"410.32"
],
[
"CBSNHD_7_2200@199302",
"199302",
"cbsnews101",
"306714",
"1",
"353.547"
]
],
"metaData": {
"startTimeInEpoch": 1551408300,
"offset": 0,
"limit": 10000,
"timeZone": "GMT",
"hasMoreData": false,
"dataStore": null,
"aggregation": 300,
"endTimeInEpoch": 1551408600
}
}
List Media Services Live RTMP active streams ingest data
Retrieves ingest data for all active Media Services Live RTMP streams.
GET /media-reports/
Sample: /media-reports/
Parameter | Type | Sample | Description |
---|---|---|---|
Optional query parameters | |||
cpcodes |
String | 12345,67890 |
Use to limit report data to specific CP codes. Comma-separate multiple values. |
Status 200
application/json
Download schema: Msl3RtmpData.json
Response body:
{
"columns": [
{
"type": "dimension",
"name": "Unique End Point",
"description": "Stream Port Value for Bit Rate or Unique End Point.",
"index": 0
},
{
"type": "dimension",
"name": "Stream ID",
"description": "Stream Port Value for Stream ID.",
"index": 1
},
{
"type": "dimension",
"name": "Stream Name",
"description": "Stream Port Value for Stream Name.",
"index": 2
},
{
"type": "dimension",
"name": "Stream Type",
"description": "Stream Port Value for Stream Type.",
"index": 3
},
{
"type": "dimension",
"name": "CP Code",
"description": "Filename to process for CP Code.",
"index": 4
},
{
"type": "dimension",
"name": "Encoder IP",
"description": "Encoder IP address",
"index": 5
},
{
"type": "dimension",
"name": "Entry Point",
"description": "The server through which a live stream enters the streaming network.",
"index": 6
},
{
"type": "metric",
"name": "Average Bit rate",
"id": 10300,
"description": "Average amount of data transferred.",
"index": 7,
"aggregate": "88136.2",
"unit": "kbps",
"dataType": "bandwidth"
}
],
"rows": [
[
"sportssnappytv@424150",
"424150",
"sportssnappytv",
"PRIMARY",
"504985",
"170.20.11.12",
"23.210.212.54",
"9.8 Mbps"
],
[
"cbsnstream_2@50982",
"50982",
"CBSnews5_live_800",
"PRIMARY",
"56371",
"170.20.11.13",
"23.194.200.41",
"2.52"
]
],
"metaData": {
"startTimeInEpoch": 1551408300,
"offset": 0,
"limit": 10000,
"timeZone": "GMT",
"hasMoreData": false,
"dataStore": null,
"aggregation": 300,
"endTimeInEpoch": 1551408600
}
}
List Media Services Live RTMP data
Retrieves data for Media Services Live RTMP.
GET /media-reports/
Sample: /media-reports/
Parameter | Type | Sample | Description |
---|---|---|---|
Required query parameters | |||
endDate |
String | 2014-03-23T15:30Z |
The timestamp string in ISO 8601 format yyyy-MM-ddTHH:mmZ or yyyy-MM-ddTHH:mm+HH:mm . |
startDate |
String | 2014-03-22T15:30Z |
The timestamp string in ISO 8601 format yyyy-MM-ddTHH:mmZ or yyyy-MM-ddTHH:mm+HH:mm . |
Optional query parameters | |||
cpcodes |
String | 12345,67890 |
Use to limit report data to specific CP codes. Comma-separate multiple values. |
enableCpCodeName |
Boolean | true |
When enabled, includes the name of the CP code in the output. |
ignoreEdgeFlash |
Boolean | true |
Limits data to ignore edge flash data. |
Status 200
application/json
Download schema: Msl3RtmpData.json
Response body:
{
"columns": [
{
"type": "dimension",
"name": "Time",
"description": "Indicates the consumption time of the content. This dimension is set automatically.",
"index": 0
},
{
"type": "metric",
"name": "Concurrent Streams",
"id": 123456,
"description": "Sum of Average concurrent streams",
"index": 1,
"aggregate": "3141454.39"
}
],
"rows": [
[
"1543674600",
"186575.959"
],
[
"1543761000",
"185988.34"
],
[
"1543847400",
"184741.378"
],
[
"1543933800",
"180774.639"
],
[
"1544020200",
"181598.317"
],
[
"1544106600",
"184538.753"
],
[
"1544193000",
"190988.807"
],
[
"1544279400",
"187612.032"
],
[
"1544365800",
"179426.637"
],
[
"1544452200",
"178335.044"
],
[
"1544538600",
"183263.786"
],
[
"1544625000",
"183384.385"
],
[
"1544711400",
"183790.081"
],
[
"1544797800",
"189211.628"
],
[
"1544884200",
"186208.98"
],
[
"1544970600",
"189176.899"
],
[
"1545057000",
"185838.721"
]
],
"metaData": {
"startTimeInEpoch": 1543674600,
"offset": 0,
"dasTable": "strconcur_live_F_time",
"limit": 300,
"timeZone": "GMT",
"hasMoreData": false,
"messages": [
"Estimated data begins at 19/Dec/2018 02:00:00 GMT"
],
"aggregation": 86400,
"endTimeInEpoch": 1545143400
}
}
List Media Services Live RTMP data stores
Retrieves all data stores for Media Services Live RTMP.
GET /media-reports/
Status 200
application/json
Download schema: dataStore.json
Response body:
[
{
"id": 10021,
"name": "us_live_D_geoid",
"type": "standard",
"description": "Table for user location US graph",
"dimensions": [
{
"id": 10000,
"name": "Time",
"description": "Indicates the consumption time of the content. This dimension is set automatically.",
"helpText": "Indicates the consumption time of the content. This dimension is set automatically.",
"dataType": "TIME",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 10001,
"name": "CP Code",
"description": "Identifier assigned to a contract associated with a particular stream.",
"helpText": "Identifier assigned to a contract associated with a particular stream.",
"dataType": "CPCODE",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 10020,
"name": "State",
"description": "The geographic region ID (state, territory or province) based on the associated country.",
"helpText": "The geographic region ID (state, territory or province) based on the associated country.",
"dataType": "NUMBER",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
}
],
"metrics": [
{
"id": 10401,
"name": "OK Hits",
"type": "count",
"description": "OK hits",
"dataType": "COUNT",
"displayName": "OK hits 2",
"helpText": "OK hits",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 10402,
"name": "OK Volume",
"unit": "MB",
"type": "volume",
"description": "OK Volume",
"dataType": "VOLUME",
"displayName": "OK Volume",
"helpText": "OK Volume",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
}
],
"aggregationInSeconds": 86400,
"purgeIntervalInDays": 90,
"maxQueryDurationInMinutes": 44640
},
{
"id": 10007,
"name": "us_live_D_hit",
"type": "standard",
"description": "Table for Visitor graph",
"dimensions": [
{
"id": 10001,
"name": "CP Code",
"description": "Identifier assigned to a contract associated with a particular stream.",
"helpText": "Identifier assigned to a contract associated with a particular stream.",
"dataType": "CPCODE",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 10020,
"name": "State",
"description": "The geographic region ID (state, territory or province) based on the associated country.",
"helpText": "The geographic region ID (state, territory or province) based on the associated country.",
"dataType": "NUMBER",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
}
],
"metrics": [
{
"id": 10105,
"name": "Hits",
"type": "count",
"description": "Total Hits",
"dataType": "COUNT",
"displayName": "Hits 1",
"helpText": "Total Hits",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 10106,
"name": "Volume",
"unit": "MB",
"type": "volume",
"description": "Total Bandwidth",
"dataType": "VOLUME",
"displayName": "Volume 1",
"helpText": "Total Bandwidth",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 10110,
"name": "Hits",
"type": "count",
"description": "Total Hits",
"dataType": "COUNT",
"displayName": "Hits 2",
"helpText": "Total Hits",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 10111,
"name": "Volume",
"unit": "MB",
"type": "volume",
"description": "Total Bandwidth",
"dataType": "VOLUME",
"displayName": "Volume 2",
"helpText": "Total Bandwidth",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
}
],
"aggregationInSeconds": 86400,
"purgeIntervalInDays": 90,
"maxQueryDurationInMinutes": 44640
}
]
Get a Media Services Live RTMP data store
Retrieve a
specific RTMP data store, using its unique dataStoreId
.
GET /media-reports/
Sample: /media-reports/
Parameter | Type | Sample | Description |
---|---|---|---|
URL path parameters | |||
dataStoreId |
Integer | 10028 |
The unique dataStoreId value associated with the desired data store. |
Status 200
application/json
Download schema: dataStore.json
Response body:
{
"id": 10021,
"name": "us_live_D_geoid",
"type": "standard",
"description": "Table for user location US graph",
"dimensions": [
{
"id": 10000,
"name": "Time",
"description": "Indicates the consumption time of the content. This dimension is set automatically.",
"helpText": "Indicates the consumption time of the content. This dimension is set automatically.",
"dataType": "TIME",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 10001,
"name": "CP Code",
"description": "Identifier assigned to a contract associated with a particular stream.",
"helpText": "Identifier assigned to a contract associated with a particular stream.",
"dataType": "CPCODE",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 10020,
"name": "State",
"description": "The geographic region (state, territory or province) based on the associated country.",
"helpText": "The geographic region (state, territory or province) based on the associated country.",
"dataType": "NUMBER",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
}
],
"metrics": [
{
"id": 10401,
"name": "OK Hits",
"type": "count",
"description": "OK hits",
"dataType": "COUNT",
"displayName": "OK hits 1",
"helpText": "OK hits",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
},
{
"id": 10402,
"name": "OK Volume",
"unit": "MB",
"type": "volume",
"description": "OK Volume",
"dataType": "VOLUME",
"displayName": "OK Volume 1",
"helpText": "OK Volume",
"group": [
{
"id": -1,
"name": "OTHERS",
"description": "OTHERS"
}
]
}
],
"aggregationInSeconds": 86400,
"purgeIntervalInDays": 90,
"maxQueryDurationInMinutes": 44640
}
List Media Services On Demand RTMP dimensions
Retrieves all of the dimensions available for Media Services On Demand RTMP.
GET /media-reports/
Status 200
application/json
Download schema: dimensions.json
Response body:
[
{
"id": 19001,
"name": "CP Code",
"description": "Identifier assigned to a contract associated with a particular stream."
},
{
"id": 19011,
"name": "Canadian Province",
"description": "Canadian Province"
},
{
"id": 19009,
"name": "Country",
"description": "Country"
},
{
"id": 19004,
"name": "Domain",
"description": "domain"
},
{
"id": 19005,
"name": "IP",
"description": "clientip"
},
{
"id": 19008,
"name": "Language",
"description": "Browser"
},
{
"id": 19501,
"name": "Level",
"description": "Level"
},
{
"id": 19006,
"name": "OS",
"description": "OS"
},
{
"id": 19003,
"name": "Player",
"description": "Player"
},
{
"id": 19007,
"name": "Player Id",
"description": "playerid"
},
{
"id": 19010,
"name": "State",
"description": "State"
},
{
"id": 19500,
"name": "Subdirectories",
"description": "Subdirectories"
},
{
"id": 19000,
"name": "Time",
"description": "Indicates the consumption time of the content. This dimension is set automatically."
},
{
"id": 19012,
"name": "URL",
"description": "URL"
}
]
List Media Services On Demand RTMP metrics
Retrieves all of the metrics available for Media Services On Demand RTMP.
GET /media-reports/
Status 200
application/json
Download schema: metrics.json
Response body:
[
{
"id": 19509,
"name": "0xx",
"type": "count",
"description": "0xx"
},
{
"id": 19213,
"name": "200",
"type": "count",
"description": "200"
},
{
"id": 19214,
"name": "206",
"type": "count",
"description": "206"
},
{
"id": 19510,
"name": "2xx",
"type": "count",
"description": "2xx"
},
{
"id": 19216,
"name": "302",
"type": "count",
"description": "302"
},
{
"id": 19217,
"name": "304",
"type": "count",
"description": "304"
},
{
"id": 19511,
"name": "3xx",
"type": "count",
"description": "3xx"
},
{
"id": 19221,
"name": "401",
"type": "count",
"description": "401"
},
{
"id": 19219,
"name": "404",
"type": "count",
"description": "404"
},
{
"id": 19222,
"name": "408",
"type": "count",
"description": "408"
},
{
"id": 19512,
"name": "4xx",
"type": "count",
"description": "4xx"
},
{
"id": 19513,
"name": "5xx",
"type": "count",
"description": "5xx"
},
{
"id": 19514,
"name": "6xx",
"type": "count",
"description": "6xx"
},
{
"id": 19107,
"name": "Average Buffer Time",
"type": "count",
"description": "Average Buffer Time"
},
{
"id": 19102,
"name": "Average Client Bandwidth",
"type": "bandwidth",
"description": "Average client Bandwidth"
},
{
"id": 19101,
"name": "Average Client Bandwidth in kilobits/sec",
"unit": "kbps",
"type": "bandwidth",
"description": "Average client bandwidth in kbps"
},
{
"id": 19109,
"name": "Average Clip Play Time",
"type": "count",
"description": "Average Play Time"
},
{
"id": 19108,
"name": "Average Packet Loss",
"type": "count",
"description": "Average Packet Loss"
},
{
"id": 19016,
"name": "Average Play Time",
"unit": "seconds",
"type": "time",
"description": "Average Play Time"
},
{
"id": 19001,
"name": "Avg Concurrent Streams",
"type": "count",
"description": "Sum of Average concurrent streams"
},
{
"id": 19507,
"name": "Avg Sec",
"unit": "sec",
"type": "count",
"description": "Avg Sec"
},
{
"id": 19210,
"name": "Avg Secs.",
"type": "count",
"description": "Avg. Secs."
},
{
"id": 19522,
"name": "Avg. Secs. Per Day",
"type": "count",
"description": "Avg. Secs. Per Day"
},
{
"id": 19007,
"name": "Client Disconnect Hits",
"type": "count",
"description": "Client Disconnect [408]"
},
{
"id": 19011,
"name": "Client-Abort Hits",
"unit": "count",
"type": "count",
"description": "No Status"
},
{
"id": 19002,
"name": "Edge Bandwidth",
"unit": "Mbps",
"type": "bandwidth",
"description": "Edge Bandwidth"
},
{
"id": 19005,
"name": "Edge Traffic in hits/sec",
"unit": "count",
"type": "count",
"description": "Sum Egress per second"
},
{
"id": 19017,
"name": "Edge Volume",
"unit": "MB",
"type": "volume",
"description": "Edge Volume"
},
{
"id": 19201,
"name": "Error Hits",
"type": "count",
"description": "Error hits"
},
{
"id": 19503,
"name": "Error Volume",
"unit": "MB",
"type": "volume",
"description": "Error Volume"
},
{
"id": 19517,
"name": "Error Volume Per Day",
"unit": "MB",
"type": "volume",
"description": "Error Volume Per Day"
},
{
"id": 19209,
"name": "GUIDs",
"type": "count",
"description": "Guids"
},
{
"id": 19521,
"name": "GUIDs Per Day",
"type": "count",
"description": "GUIDs Per Day"
},
{
"id": 19506,
"name": "Guids",
"type": "count",
"description": "Guids"
},
{
"id": 19105,
"name": "Hits",
"type": "count",
"description": "Hits"
},
{
"id": 19505,
"name": "IPs",
"type": "count",
"description": "Ips"
},
{
"id": 19520,
"name": "Ips Per Day",
"type": "count",
"description": "Ips Per Day"
},
{
"id": 19000,
"name": "Max Concurrent Streams",
"type": "count",
"description": "Sum of Max concurrent streams"
},
{
"id": 19008,
"name": "Not-Found Hits",
"type": "count",
"description": "Not Found [404]"
},
{
"id": 19401,
"name": "OK Hits",
"type": "count",
"description": "OK hits"
},
{
"id": 19402,
"name": "OK Volume",
"unit": "MB",
"type": "volume",
"description": "OK Volume"
},
{
"id": 19518,
"name": "OK volume per day",
"unit": "MB",
"type": "volume",
"description": "OK volume per day"
},
{
"id": 19012,
"name": "Other Hits",
"type": "count",
"description": "Other [ All other status codes]"
},
{
"id": 19504,
"name": "Peak Conn.",
"type": "count",
"description": "Peak Conn."
},
{
"id": 19519,
"name": "Peak Conn. Per Day",
"type": "count",
"description": "Peak Conn. Per Day"
},
{
"id": 19009,
"name": "Permission Hits",
"type": "count",
"description": "Permission [400|401|403|433|434]"
},
{
"id": 19508,
"name": "Secs",
"type": "count",
"description": "Secs"
},
{
"id": 19523,
"name": "Secs Per Day",
"type": "count",
"description": "Secs Per Day"
},
{
"id": 19013,
"name": "Server-Disconnect Hits",
"type": "count",
"description": "Server-Disconnect Hits"
},
{
"id": 19010,
"name": "Server-Source-Error Hits",
"type": "count",
"description": "Server Error"
},
{
"id": 19516,
"name": "SubDirectories hits per day",
"type": "count",
"description": "SubDirectories hits by date"
},
{
"id": 19004,
"name": "Total Hits",
"type": "count",
"description": "Total Hits"
},
{
"id": 19015,
"name": "Total Play Time",
"unit": "seconds",
"type": "time",
"description": "Play Time Interval"
},
{
"id": 19003,
"name": "Total Volume",
"unit": "MB",
"type": "volume",
"description": "Total Volume"
},
{
"id": 19515,
"name": "Total Volume Per Day",
"unit": "MB",
"type": "volume",
"description": "Total Volume Per Day"
},
{
"id": 19226,
"name": "URL hits per day",
"type": "count",
"description": "URL hits by date"
},
{
"id": 19524,
"name": "URL hits per day for 0xx status code",
"type": "count",
"description": "Total URL hits for 0xx status code"
},
{
"id": 19235,
"name": "URL hits per day for 200 status code",
"type": "count",
"description": "URL hits by date for 200 status code"
},
{
"id": 19236,
"name": "URL hits per day for 206 status code",
"type": "count",
"description": "Total URL hits for 206 status code"
},
{
"id": 19525,
"name": "URL hits per day for 2xx status code",
"type": "count",
"description": "Total URL hits for 2xx status code"
},
{
"id": 19238,
"name": "URL hits per day for 302 status code",
"type": "count",
"description": "URL hits by date for 302 status code"
},
{
"id": 19239,
"name": "URL hits per day for 304 status code",
"type": "count",
"description": "URL hits by date for 304 status code"
},
{
"id": 19526,
"name": "URL hits per day for 3xx status code",
"type": "count",
"description": "Total URL hits for 3xx status code"
},
{
"id": 19243,
"name": "URL hits per day for 401 status code",
"type": "count",
"description": "Total URL hits for 401 status code"
},
{
"id": 19241,
"name": "URL hits per day for 404 status code",
"type": "count",
"description": "URL hits by date for 404 status code"
},
{
"id": 19244,
"name": "URL hits per day for 408 status code",
"type": "count",
"description": "URL hits by date for 408 status code"
},
{
"id": 19527,
"name": "URL hits per day for 4xx status code",
"type": "count",
"description": "Total URL hits for 4xx status code"
},
{
"id": 19528,
"name": "URL hits per day for 5xx status code",
"type": "count",
"description": "URL hits by date for 5xx status code"
},
{
"id": 19529,
"name": "URL hits per day for 6xx status code",
"type": "count",
"description": "Total URL hits for 6xx status code"
},
{
"id": 19103,
"name": "Unique Client IP",
"type": "count",
"description": "Unique Client IP"
},
{
"id": 19112,
"name": "Unique ClientIPs",
"type": "count",
"description": "Unique ClientIPs"
},
{
"id": 19104,
"name": "Unique Player ID",
"type": "count",
"description": "Unique Player ID"
},
{
"id": 19100,
"name": "Unique Visitor",
"type": "count",
"description": "Visitors"
},
{
"id": 19106,
"name": "Volume",
"unit": "MB",
"type": "volume",
"description": "Total Bandwidth"
}
]
List Media Service On Demand RTMP data
Retrieves all data for Media Services On Demand RTMP.
GET /media-reports/
Sample: /media-reports/
Parameter | Type | Sample | Description |
---|---|---|---|
Required query parameters | |||
endDate |
String | 2014-03-23T15:30Z |
The timestamp string in ISO 8601 format yyyy-MM-ddTHH:mmZ or yyyy-MM-ddTHH:mm+HH:mm . |
startDate |
String | 2014-03-22T15:30Z |
The timestamp string in ISO 8601 format yyyy-MM-ddTHH:mmZ or yyyy-MM-ddTHH:mm+HH:mm . |
Optional query parameters | |||
cpcodes |
String | 12345,67890 |
Use to limit report data to specific CP codes. Comma-separate multiple values. |
ignoreEdgeFlash |
Boolean | true |
Limits data to ignore edge flash data. |
ignorePutPost |
Boolean | true |
Specifies if the API should ignore ingest data when generating the response. |
Status 200
application/json
Download schema: OnDemand-RTMP.json
Response body:
{
"columns": [
{
"type": "dimension",
"name": "Time",
"description": "Indicates the consumption time of the content. This dimension is set automatically.",
"index": 0
},
{
"type": "metric",
"name": "Avg Concurrent Streams",
"id": 19001,
"description": "Sum of Average concurrent streams",
"index": 1
}
],
"rows": [
[
"1543674600",
"0.494"
],
[
"1543761000",
"0.7"
],
[
"1543847400",
"0.296"
],
[
"1543933800",
"0.967"
],
[
"1544020200",
"1.586"
],
[
"1544106600",
"0.863"
],
[
"1544193000",
"0.19"
],
[
"1544279400",
"0.303"
],
[
"1544365800",
"20.581"
],
[
"1544452200",
"1.088"
],
[
"1544538600",
"0.715"
],
[
"1544625000",
"396.926"
],
[
"1544711400",
"1151.529"
],
[
"1544797800",
"1227.751"
],
[
"1544884200",
"1240.823"
],
[
"1544970600",
"1258.008"
],
[
"1545057000",
"755.61"
]
],
"metaData": {
"startTimeInEpoch": 1543674600,
"offset": 0,
"dasTable": "strconcur_vod_F_time",
"limit": 300,
"timeZone": "GMT",
"hasMoreData": false,
"messages": [
"Estimated data begins at 18/Dec/2018 05:00:00 GMT"
],
"aggregation": 86400,
"endTimeInEpoch": 1545143400
}
}
List Progressive Media Delivery dimensions
Retrieves all of the dimensions available for Progressive Media Delivery.
GET /media-reports/
Status 200
application/json
Download schema: dimensions.json
Response body:
[
{
"id": 22005,
"name": "Browser",
"description": "Browser"
},
{
"id": 22002,
"name": "CP Code",
"description": "Content Provider Code (CPCode) is an identifier assigned to a contract and used for reporting, billing and monitoring traffic served."
},
{
"id": 22011,
"name": "Canadian Province",
"description": "Canadian Province"
},
{
"id": 22009,
"name": "Country",
"description": "Country"
},
{
"id": 22006,
"name": "Domain",
"description": "domain"
},
{
"id": 22004,
"name": "IP",
"description": "client_ip"
},
{
"id": 22008,
"name": "OS",
"description": "OS"
},
{
"id": 22010,
"name": "State",
"description": "State"
},
{
"id": 22003,
"name": "Status Code",
"description": "Response status code."
},
{
"id": 22001,
"name": "Time",
"description": "Indicates the consumption time of the content. This dimension is set automatically."
},
{
"id": 22012,
"name": "URL",
"description": "URL"
},
{
"id": 22007,
"name": "User Agent",
"description": "user_agent"
}
]
List Progressive Media Delivery metrics
Retrieves all of the metrics available for Progressive Media Delivery.
GET /media-reports/
Status 200
application/json
Download schema: metrics.json
Response body:
[
{
"id": 22206,
"name": "0xx",
"type": "count",
"description": "0xx"
},
{
"id": 22221,
"name": "0xx Hits",
"type": "count",
"description": "0xx Hits"
},
{
"id": 22208,
"name": "200",
"type": "count",
"description": "200"
},
{
"id": 22209,
"name": "206",
"type": "count",
"description": "206"
},
{
"id": 22223,
"name": "206 Hits",
"type": "count",
"description": "206 Hits"
},
{
"id": 22207,
"name": "2xx",
"type": "count",
"description": "2xx"
},
{
"id": 22222,
"name": "2xx Hits",
"type": "count",
"description": "2xx Hits"
},
{
"id": 22211,
"name": "302",
"type": "count",
"description": "302"
},
{
"id": 22225,
"name": "302 Hits",
"type": "count",
"description": "302 Hits"
},
{
"id": 22212,
"name": "304",
"type": "count",
"description": "304"
},
{
"id": 22226,
"name": "304 Hits",
"type": "count",
"description": "304 Hits"
},
{
"id": 22210,
"name": "3xx",
"type": "count",
"description": "3xx"
},
{
"id": 22224,
"name": "3xx Hits",
"type": "count",
"description": "3xx Hits"
},
{
"id": 22214,
"name": "404",
"type": "count",
"description": "404"
},
{
"id": 22228,
"name": "404 Hits",
"type": "count",
"description": "404 Hits"
},
{
"id": 22213,
"name": "4xx",
"type": "count",
"description": "4xx"
},
{
"id": 22227,
"name": "4xx Hits",
"type": "count",
"description": "4xx Hits"
},
{
"id": 22220,
"name": "All Error Hits",
"type": "count",
"description": "All Error Hits"
},
{
"id": 22218,
"name": "All Hits",
"type": "count",
"description": "All Hits"
},
{
"id": 22219,
"name": "All OK Hits",
"type": "count",
"description": "All OK Hits"
},
{
"id": 22028,
"name": "Edge 403 Hits",
"unit": "count",
"type": "count",
"description": "Edge 403 Hits"
},
{
"id": 22029,
"name": "Edge 404 Hits",
"unit": "count",
"type": "count",
"description": "Edge 404 Hits"
},
{
"id": 22021,
"name": "Edge Bandwidth",
"unit": "Mbps",
"type": "bandwidth",
"description": "Edge Bandwidth"
},
{
"id": 22027,
"name": "Edge Client Abort Hits",
"unit": "count",
"type": "count",
"description": "Edge Client Abort Hits [000]"
},
{
"id": 22103,
"name": "Edge Hits",
"type": "count",
"description": "Edge hits"
},
{
"id": 22026,
"name": "Edge Redirect Hits",
"unit": "count",
"type": "count",
"description": "Edge Redirect Hits [301|302]"
},
{
"id": 22002,
"name": "Edge Response",
"unit": "MB",
"type": "volume",
"description": "Edge Response"
},
{
"id": 22006,
"name": "Edge Traffic in hits/sec",
"unit": "count",
"type": "count",
"description": "Sum Egress per second"
},
{
"id": 22102,
"name": "Edge Volume",
"unit": "MB",
"type": "volume",
"description": "Edge volume"
},
{
"id": 22205,
"name": "Error Volume",
"unit": "MB",
"type": "volume",
"description": "Error Volume"
},
{
"id": 22202,
"name": "Error hits",
"type": "count",
"description": "Error hits"
},
{
"id": 22013,
"name": "Forbidden Hits",
"unit": "count",
"type": "count",
"description": "Forbidden [403]"
},
{
"id": 22014,
"name": "Forbidden Hits Traffic",
"unit": "Mbps",
"type": "bandwidth",
"description": "Forbidden [403] Traffic"
},
{
"id": 22025,
"name": "Hits",
"type": "count",
"description": "Hits"
},
{
"id": 22022,
"name": "Midgress Bandwidth",
"unit": "Mbps",
"type": "bandwidth",
"description": "Midgress Bandwidth"
},
{
"id": 22004,
"name": "Midgress Responses",
"unit": "MB",
"type": "volume",
"description": "Midgress Responses"
},
{
"id": 22034,
"name": "Not-Found: 404 Traffic",
"unit": "Mbps",
"type": "bandwidth",
"description": "Not-Found: 404 Traffic"
},
{
"id": 22009,
"name": "Not-Modified Hits",
"unit": "count",
"type": "count",
"description": "Not-Modified [304]"
},
{
"id": 22203,
"name": "OK hits",
"type": "count",
"description": "OK hits"
},
{
"id": 22215,
"name": "Offloaded Hits",
"type": "count",
"description": "Offloaded Hits"
},
{
"id": 22204,
"name": "OK Edge Volume",
"unit": "MB",
"type": "volume",
"description": "OK Edge Volume"
},
{
"id": 22017,
"name": "OK Hits",
"unit": "count",
"type": "count",
"description": "OK [200|206|210]"
},
{
"id": 22036,
"name": "OK Hits/sec",
"unit": "count",
"type": "count",
"description": "OK [200|206|210]"
},
{
"id": 22104,
"name": "OK Volume",
"unit": "MB",
"type": "volume",
"description": "OK Volume"
},
{
"id": 22031,
"name": "Origin 304 Hits",
"unit": "count",
"type": "count",
"description": "Origin 304 Hits"
},
{
"id": 22030,
"name": "Origin 404 Hits",
"unit": "count",
"type": "count",
"description": "Origin 404 Hits"
},
{
"id": 22038,
"name": "Origin 404 Hits/sec",
"unit": "count",
"type": "count",
"description": "Origin 404 Hits"
},
{
"id": 22015,
"name": "Origin Bandwidth",
"unit": "Mbps",
"type": "bandwidth",
"description": "Origin Bandwidth"
},
{
"id": 22020,
"name": "Origin Bandwidth Offload",
"unit": "Mbps",
"type": "bandwidth",
"description": "Sum Origin Bandwidth Offload per second"
},
{
"id": 22216,
"name": "Origin Hits",
"type": "count",
"description": "Origin Hits"
},
{
"id": 22032,
"name": "Origin Redirect: 301/302 Hits",
"unit": "count",
"type": "count",
"description": "Origin Redirect: 301/302 Hits"
},
{
"id": 22039,
"name": "Origin Redirect: 301/302 Hits/sec",
"unit": "count",
"type": "count",
"description": "Origin Redirect: 301/302 Hits"
},
{
"id": 22003,
"name": "Origin Response",
"unit": "MB",
"type": "volume",
"description": "Origin Response"
},
{
"id": 22040,
"name": "Origin Server Error Hits/sec",
"unit": "count",
"type": "count",
"description": "Origin Server Error Hits: 500/501/502/503/504"
},
{
"id": 22033,
"name": "Origin Server Error Hits: 500/501/502/503/504",
"unit": "count",
"type": "count",
"description": "Origin Server Error Hits: 500/501/502/503/504"
},
{
"id": 22023,
"name": "Origin Traffic hits",
"unit": "count",
"type": "count",
"description": "Sum Origin traffic per second"
},
{
"id": 22016,
"name": "Origin Traffic in hits/sec",
"type": "count",
"description": "Sum Origin traffic per second"
},
{
"id": 22035,
"name": "Origin Volume",
"unit": "MB",
"type": "volume",
"description": "Origin Volume"
},
{
"id": 22019,
"name": "Other Hits",
"unit": "count",
"type": "count",
"description": "Other [ All other status codes]"
},
{
"id": 22041,
"name": "Other Hits/sec",
"unit": "count",
"type": "count",
"description": "Other [ All other status codes]"
},
{
"id": 22018,
"name": "Permission Hits",
"unit": "count",
"type": "count",
"description": "Permission [401|403|415]"
},
{
"id": 22037,
"name": "Permission Hits/sec",
"unit": "count",
"type": "count",
"description": "Permission [401|403|415]"
},
{
"id": 22005,
"name": "Requests",
"unit": "MB",
"type": "volume",
"description": "Requests"
},
{
"id": 22011,
"name": "Server Error Hits",
"unit": "count",
"type": "count",
"description": "Server Error [500|501|502|503|504]"
},
{
"id": 22000,
"name": "Total Bandwidth",
"unit": "Mbps",
"type": "bandwidth",
"description": "Total Bandwidth"
},
{
"id": 22001,
"name": "Total Volume",
"unit": "MB",
"type": "volume",
"description": "Total Volume"
},
{
"id": 22101,
"name": "Visitors",
"type": "count",
"description": "Visitors"
}
]
List Progressive Media Delivery data
Retrieves all data for Progressive Media Delivery.
GET /media-reports/
Sample: /media-reports/
Parameter | Type | Sample | Description |
---|---|---|---|
Required query parameters | |||
endDate |
String | 2014-03-23T15:30Z |
The timestamp string in ISO 8601 format yyyy-MM-ddTHH:mmZ or yyyy-MM-ddTHH:mm+HH:mm . |
startDate |
String | 2014-03-22T15:30Z |
The timestamp string in ISO 8601 format yyyy-MM-ddTHH:mmZ or yyyy-MM-ddTHH:mm+HH:mm . |
Optional query parameters | |||
cpcodes |
String | 12345,67890 |
Use to limit report data to specific CP codes. Comma-separate multiple values. |
deliveryOption |
Enumeration | non-secure |
Limits data to the type of traffic: non-secure for non-secure traffic, secure-shared for secure shared-certificate traffic, secure-standard for standard secure customer-certificate traffic, secure-premium for premium secure customer-certificate traffic, or the default all . |
ignorePutPost |
Boolean | true |
Specifies if the API should ignore ingest data when generating the response. |
Status 200
application/json
Download schema: progressiveMediaDelivery.json
Response body:
{
"columns": [
{
"type": "dimension",
"name": "CP Code",
"description": "Content Provider Code (CPCode) is an identifier assigned to a contract and used for reporting, billing and monitoring traffic served.",
"index": 0
},
{
"type": "metric",
"name": "Requests Volume",
"id": 22005,
"description": "Requests",
"index": 1,
"aggregate": "1.82",
"unit": "MB"
}
],
"rows": [
[
"759977",
"1.824443"
]
],
"metaData": {
"startTimeInEpoch": 1543674600,
"offset": 0,
"dasTable": "trafficsummary_-_F_time",
"limit": 300,
"timeZone": "GMT",
"hasMoreData": false,
"messages": [
"Estimated data begins at 17/Dec/2018 20:00:00 GMT"
],
"aggregation": 300,
"endTimeInEpoch": 1545143400
}
}
Data
This section describes Media Reports API’s various data structures.
Download the JSON schemas for this API.
This section’s data schema tables list membership requirements as follows:
✓ | Member is required in requests, or always present in responses, even if its value is empty or null . |
○ | Member is optional, and may be omitted in some cases. |
Report
Encapsulates a media data report for various products.
Download schema:
mediaServicesData.json
Sample GET response:
{
"columns": [
{
"type": "dimension",
"name": "Time",
"description": "Indicates the consumption time of the content.",
"index": 0
},
{
"type": "metric",
"name": "Hits",
"description": "Total number of requests made to the entry point posting objects.",
"index": 1,
"aggregate": "46055"
}
],
"rows": [
[
"1471737600",
"158"
],
[
"1471737720",
"138"
],
[
"1471737840",
"183"
],
[
"1471737960",
"158"
],
[
"1471738080",
"163"
],
[
"1471738200",
"155"
]
],
"metaData": {
"startTimeInEpoch": 1471737600,
"offset": 0,
"limit": 300,
"timeZone": "GMT",
"hasMoreData": true,
"aggregation": 120,
"endTimeInEpoch": 1471860000
}
}
Report members
Member | Type | Required | Description |
---|---|---|---|
Report : Encapsulates a media data report for various products. |
|||
columns |
Report. |
✓ | Provides context for each element listed within corresponding rows . |
metaData |
Report. |
✓ | Reflects the set of parameter values included in the request that determines this report’s results. |
rows |
Array | ✓ | Encapsulates the report’s two-dimensional table data. If there is no data to report, the array is empty. |
Report.columns[] : Provides context for each element listed within corresponding rows . |
|||
aggregate |
String | ○ | Provides an aggregate value for the dimension or metric expressed in string format. For example, for type : metric and name : Hits , the information returned would be the number of hits for each row of data. |
description |
String | ✓ | Provides information about the relevant dimension or metric. |
index |
Number | ✓ | Positions each column within the table. |
name |
String | ✓ | Depending on the type , provides the name of the relevant dimension or metric. |
type |
Enumeration | ✓ | Type of data: dimension or metric . |
Report.metaData : Reflects the set of parameter values included in the request that determines this report’s results. |
|||
aggregation |
Number | ✓ | The time span included in each record, expressed in seconds. |
dataCompleteTill |
Number | ○ | The epoch time to indicate the time till which the data is complete. This attribute is only available on non real-time API requests. |
endTimeInEpoch |
Number | ✓ | The end of the requested time range, in epoch seconds. |
hasMoreData |
Boolean | ✓ | Indicates that a constrained set of requested data does not represent the entire set. |
limit |
Number | ✓ | The maximum number of requested data rows . |
offset |
Number | ✓ | The offset of the row from which the data should start. Used with overall limit , it reflects where a batch of data starts. For example, setting both offset and limit to 100 selects rows 101–200 from the overall results. |
startTimeInEpoch |
Number | ✓ | The start of the requested time range, in epoch seconds. |
timeZone |
String | ✓ | Identifies the time zone from which the request was made. |
FilterParams
Encapsulates filtering parameters that are wrapped in an array, URL-encoded, and passed in with GET requests using the filterParams
query parameter.
Download schema:
filter-params.json
Sample non-encoded parameter value, expanded:
[
{
"condition": "in",
"id": 4,
"type": "dimension",
"values": [
"GB"
]
},
{
"condition": "gt",
"id": 155,
"type": "metric",
"values": [
16
]
}
]
FilterParams members
Member | Type | Required | Description |
---|---|---|---|
FilterParams : Encapsulates filtering parameters that are wrapped in an array, URL-encoded, and passed in with GET requests using the filterParams query parameter. |
|||
condition |
Enumeration | ✓ | The condition specifier. For dimensions: in , nin (in or not in), contains , ncontains (does or doesn’t contain), starts , nstarts (does or doesn’t start with), ends , nends (does or doesn’t end with). For metrics: eq , neq (equal or not), gt (greater than), gte (greater than or equal), lt (less than), lte (less than or equal). |
id |
Integer | ✓ | Identifies each dimension or metric filtering entity. |
type |
Enumeration | ✓ | Specifies whether the provided id parameter is a dimension or a metric . |
values |
Array | ✓ | List of values used to filter the result. Values represent either inclusions or exclusions, depending on what the condition parameter specifies. |
SortParams
Encapsulates sorting parameters that are wrapped in an array, URL-encoded, and passed in with GET requests using the sortParams
query parameter.
Download schema:
sort-params.json
Sample non-encoded parameter value, expanded:
[
{
"id": 40,
"order": "asc",
"type": "metric"
}
]
SortParams members
Member | Type | Required | Description |
---|---|---|---|
SortParams : Encapsulates sorting parameters that are wrapped in an array, URL-encoded, and passed in with GET requests using the sortParams query parameter. |
|||
id |
Integer | ✓ | The ID of the sorting entity. The sorting entity should also be part of the query parameter metrics or dimensions . |
order |
Enumeration | ✓ | Either asc for ascending or desc for descending sort order. |
type |
Enumeration | ✓ | Indicates if the id parameter is a dimension or a metric . |
Errors
This section provides details on the format of error response objects the Media Reports API generates. It also lists the range of HTTP response codes for both error and success cases.
Error response codes
API endpoints routinely respond with failure codes to a wide range of
problems with the integrity of the data. The API returns HTTP response
codes that correspond to the httpStatus
element in the JSON
response, eliminating the need to query the header for the response
code. For all non–2xx HTTPS status codes, the API responds with a JSON
object such as the following:
{
"httpStatus": 400,
"instance": "49046f42-f51f-403b-be60-6fb8179aa1d2",
"detail": "Start date and End date are same",
"title": "Bad Request"
}
HTTP status codes
The API produces the following set of HTTP status codes for both success and failure scenarios:
Code | Description |
---|---|
200 | OK. If the report yields an empty data set, the response yields an empty set of rows. |
400 | Bad input parameter. The Error detail should identify the cause. |
401 | Authentication failure. |
403 | Authorization failure. |
404 | Resource not found. |
405 | Request method not expected (generally should be GET). |
409 | Conflict. |
410 | Requested resource is no longer available. |
411 | Content-Length header not specified. |
413 | Request body exceeds maximum allowable size. |
423 | Requested resource is locked. |
429 | Too many requests. |
500 | Internal server error; unexpected condition. |
501 | Not supported. |
503 | Too many requests; service is temporarily unavailable. |
507 | Data size is over allowable limit. |