Live Stream Acceleration Domain Concurrency Report - GET /api/report/{domain-id}/concurrency
Get the total number of concurrent connections per minute for your Live Stream Acceleration domain. Domain-id is a unique ID representing one of your Live Stream Acceleration domains. QUANTIL Support can provide you the IDs of your domains. Specify multiple domains by entering their IDs separated only by commas. Request parameters allow you to specify a time period and timezone for the output.
Header |
Description |
Required |
Authorization |
Authorization string for the request |
Yes |
Host |
URI for the QUANTIL SDK (i.e., api.quantil.com) |
Yes |
Date |
The date and time of the request. |
Yes |
Accept |
Indicates the accepted format (i.e., application/xml) |
Yes |
Parameter |
Description |
Required |
datefrom |
RFC3339 formatted date indicating the starting date. Example: 2013-01-01T22:30:00+08:00 |
Yes |
dateto |
RFC3339 formatted date indicating the ending date. Example: 2013-01-01T22:30:00+08:00 |
Yes |
timezone |
Indicates the timezone for the report data. It must be relative to GMT and specified in the format GMT+n where -12<= n <= 12. For example, timezone=GMT-7 and timezone=GMT+8. If the parameter is unspecified, results will be in the GMT timezone. |
No |
This request does not include an XML document in the request body.
GET /api/report/{domain-id}/concurrency/ HTTP/1.1
Authorization: <authorization string>
Host: api.quantil.com
Date: <date>
Accept: application/xml
Here is the structure of a request using the curl utility.
curl -i --url https://api.quantil.com/api/report/{domain-ID}/concurrency ?datefrom = {date from} & dateto = {date to}& timezone = {timezone}
-X GET
-u {user}: {password}
-H 'Date: Fri, 26 Oct 2012 06:33:26 GMT'
-H 'Accept: application/xml'
curl -i --url 'https://api.quantil.com/api/report/1234/concurrency?datefrom=2014-09-11T00:00:00%2D08:00&dateto=2014-09-20T23:59:59%2D08:00&timezone=GMT%2B08' -u apiuser:XP9Df3yl42255HQty4IFy3JfVUVs= -H 'Date: Wed, 08 Oct 2014 18:07:46 PDT' -H 'Accept: application/xml'
HTTP/1.1 200 OK
Date: <date>
Content-Type: application/xml; charset = utf-8
x-cnc-request-id: {id string auto generated by the QUANTIL server}
Element |
Description |
concurrency-report |
container for concurrency information. It will contain zero or more <concurrency-data> child elements indicating concurrent connections at different times. |
concurrency-data |
this container object contains a <timestamp> element and a <concurrency> element describing the concurrent connections at a particular time. |
timestamp |
indicates the date and time |
concurrency |
number of concurrent connections |
The following shows daily page view data.
HTTP/1.1 200 OK
Date: Thu, 09 Oct 2014 01:07:44 GMT
Accept-Ranges: bytes
Server: WS-web-server
x-cnc-request-id: 3922739
ContentType: application/xml;charset=UTF-8
Content-Type: application/xml;charset=UTF-8
Content-Length: 523
<concurrency-report>
<concurrency-data>
<timestamp>2014-07-31 23:00:00</timestamp>
<concurrency>100</concurrency >
</concurrency-data>
<concurrency-data>
<timestamp>2014-07-31 23:01:00</timestamp>
<concurrency>110</concurrency >
</concurrency-data>
<concurrency-data>
<timestamp>2014-07-31 23:02:00</timestamp>
<concurrency>120</concurrency >
</concurrency-data>
<concurrency-data>
<timestamp>2014-07-31 23:03:00</timestamp>
<concurrency>130</concurrency >
</concurrency-data>
</concurrency-report
Error |
Description |
HTTP status code |
DateSpanError |
The time span exceeds the limit. |
400 |
InvalidDatePeriod |
The date specified is invalid. |
400 |