Accounts-accountId-dedicatedServers-serverId-statistics-traffic:GET

(Difference between revisions)
Jump to: navigation, search
m (1 revision: Release 111)
(URI Parameters)
Line 17: Line 17:
 
; scope
 
; scope
 
: ''(required)''
 
: ''(required)''
: The scope defines whether we want statistics for inbound or outbound traffic. Possible values: '''receive''' and '''transmit'''.
+
: The scope defines whether we want statistics for inbound or outbound traffic. Possible values: '''receive''', '''transmit''' and '''total''' (receive plus transmit values).
  
 
; startDate
 
; startDate

Revision as of 08:46, 7 October 2015

GET /accounts/{accountId}/dedicatedServers/{serverId}/statistics/traffic

Get traffic statistics by specific time range for a dedicated server.

Contents


Request

GET /accounts/{accountId}/dedicatedServers/{serverId}/statistics/traffic?scope={scope}&startDate={startDate}&endDate={endDate}&period={period}&method={method}

URI Parameters

accountId - string
(required)
The account Id of the dedicated server owner.
serverId
(required)
The specified dedicated server Id.
scope
(required)
The scope defines whether we want statistics for inbound or outbound traffic. Possible values: receive, transmit and total (receive plus transmit values).
startDate
(required)
Start date that represents the beginning of the requested statistical time frame. The format should be yyyy-mm-dd.
endDate
(required)
End date that represents the end of the requested statistical time frame. The format should be yyyy-mm-dd.
period
(required)
Represents the granularity of the returned data sets for the requested time frame. Possible values: hourly or daily.
method
(required)
Statistics method used. Possible values: avg,sum,min and max.

Request Headers

Authorization - HTTP Authorization header [1]
The Authentication credentials of the client application.
Accept - HTTP Accept header [2]
Possible values are application/json, text/csv. If omitted json will be returned.

Date Format

All dates are interpreted and represented in UTC with ISO 8601 format

Response

Status Codes

200 OK
Success
400 Bad Request
Incorrect URI parameters.
401 Unauthorized
The supplied credentials are invalid or do not provide permissions for this operation.
403 Forbidden
The authorized user does not have permissions to access the resource or the requested time frame exceeds the maximum limit for the API.
The current limit is 500 data sets per response entity, regardless of the period granularity.
404 Not Found
The dedicated server or account does not exist.

Response Body

 [
    {
       "count": {count}, 
       "date": "{date}", 
       "values": {values}
    }
 ]

Parameters

count - integer
The count of traffic operations for the specified period.
date - string
The date time stamp for the specified period.
values - float
The actual traffic value represented for the specified period.

Examples

Successful response for total daily inbound traffic statistics

GET /accounts/{accountId}/dedicatedServers/{serverId}/statistics/traffic?scope=receive&startDate=2015-05-05&endDate=2012-05-07&period=daily&method=sum

Response Code:

HTTP/1.1 200 OK

Response Body:

 [
    {
       "count": 143, 
       "date": "2015-05-05 00:00:00", 
       "values": 344130.30069930002
    }, 
    {
       "count": 144, 
       "date": "2015-05-07 00:00:00", 
       "values": 658.34027777777999
    },
 ]

Failure while trying to get traffic statistics and the number of returned data sets exceeds the maximum limit

GET /accounts/{accountId}/dedicatedServers/{serverId}/statistics/traffic?scope=receive&startDate=2015-01-01&endDate=2015-05-05&period=daily&method=sum

Response Code:

HTTP/1.1 403 Forbidden

Response Body:

{
    "overLimit": {
        "message": "GET data error",
        "code": 403,
        "details": "The (startDate, endDate) range is too large. Maximum number of returned data sets exceeded."
    }
}


Failure while trying to get traffic statistics and the start date is before the create date (2015-01-01) of the dedicated server

GET /accounts/{accountId}/dedicatedServers/{serverId}/statistics/traffic?scope=receive&startDate=2011-01-01&endDate=2015-05-05&period=daily&method=sum

Response Code:

HTTP/1.1 400 Bad Request

Response Body:

{
    "badRequest": {
        "message": "GET data error",
        "code": 400,
        "details": {
            "startDate": "2011-01-01 is less than minimum value 2015-01-01"
        }
    }
}
Personal tools
Namespaces
Variants
Actions
APIs
Navigation
Toolbox