srv-img CDN

API статистики партнерских CDN

В этом разделе описан способ получения статистики по раздаче в дополнительных зонах.

К таким зонам относятся:

  • EMEA (Европа, Ближний Восток и Африка);

  • APAC (Азиатско-Тихоокеанский регион и Япония);

  • AM (Америка).

Статистика по трафику

Данный метод используются для получения количественных значений трафика в определенные интервалы времени.

URL: https://api.cdn.sber.cloud/app/stat-ext-1/v1/p1/traffic?account=<account>&hostname=<hostname>&area=<area>&startdate=<start_date>&enddate=<end_date>&granularity=<granularity>

  • Тип запроса: GET

  • Заголовки: CDN-AUTH-TOKEN

  • GET-параметры (* — обязательные):

    • account — название аккаунта;

    • hostname — домен;

    • area — регион (apac/am/emea);

    • startdate * — дата и время начала интервала в формате 'YYYY-MM-DDTHH:mm:ssZ' (UTC);

    • enddate — дата и время окончания интервала 'YYYY-MM-DDTHH:mm:ssZ' (UTC). Если данный параметр не указан, то отдаются интервалы, для которых начало = startdate;

    • granularity — гранулярность по времени, размер интервалов в выдаче, задается в секундах.

  • Тип данных ответа: JSON Object.

    Количественное значение трафика выдается как значение ключа value (в байтах).

Код ответа Данные ответа Формат ответа Описание
200 Статистика по трафику JSON ОК
400 None None Плохой запрос
401 None None Нет доступа
404 None None Не найдено
405 None None Метод не поддерживается
500 None None Внутренняя ошибка сервера
503 None None Сервис недоступен

Пример запроса

curl   -H   "CDN-AUTH-TOKEN:  $TOKEN " 
https://api.cdn.sber.cloud/app/stat-ext-1/v1/p1/traffic?account = paejgjuv & startdate = 2019 -10-01T16:40:00Z & enddate = 2019 -10-01T17:00:00Z & granularity = 300

Пример успешного ответа

{   "response" :   [ 
      [ 
          { 
           "account" :   "paejgjuv" , 
           "intervals" :   [ 
             { 
               "start" :   "2019-10-01T16:40:00Z" , 
               "end" :   "2019-10-01T16:45:00Z" , 
               "value" :   648877 
             }, 
             { 
               "start" :   "2019-10-01T16:45:00Z" , 
               "end" :   "2019-10-01T16:50:00Z" , 
               "value" :   2551568 
             }, 
             { 
               "start" :   "2019-10-01T16:50:00Z" , 
               "end" :   "2019-10-01T16:55:00Z" , 
               "value" :   6860538 
             }, 
             { 
               "start" :   "2019-10-01T16:55:00Z" , 
               "end" :   "2019-10-01T17:00:00Z" , 
               "value" :   5786 
             } 
           ] 
         } 
       ] 
     ] 
   }

Пример неуспешного ответа

{ 
      "error" :   { 
      "message" :   "API access denied: invalid token" , 
      "code" :   401 
    } 
 }

Статистика по полосе

Данный метод используются для получения количественных значений полосы в определенные интервалы времени.

URL: https://api.cdn.sber.cloud/app/stat-ext-1/v1/p1/bandwidth?account=<account>&hostname=<hostname>&area=<area>&startdate=<start_date>&enddate=<end_date>&granularity=<granularity>

  • Тип запроса: GET

  • Заголовки: CDN-AUTH-TOKEN

  • GET-параметры (* — обязательные):

    • account — название аккаунта;

    • hostname — домен;

    • area — регион (apac/am/emea);

    • startdate * — дата и время начала интервала в формате 'YYYY-MM-DDTHH:mm:ssZ' (UTC);

    • enddate — дата и время окончания интервала 'YYYY-MM-DDTHH:mm:ssZ' (UTC). Если данный параметр не указан, то отдаются интервалы, для которых начало = startdate;

    • granularity — гранулярность по времени, размер интервалов в выдаче. Задается в секундах.

  • Тип данных ответа: JSON Object.

    Количественное значение полосы выдается как значение ключа value (в Мбит/c).

Код ответа Данные ответа Формат ответа Описание
200 Статистика по полосе JSON ОК
400 None None Плохой запрос
401 None None Нет доступа
404 None None Не найдено
405 None None Метод не поддерживается
500 None None Внутренняя ошибка сервера
503 None None Сервис недоступен

Пример запроса

curl   -H   "CDN-AUTH-TOKEN:  $TOKEN " 
 'https://api.cdn.sber.cloud/app/stat-ext-1/v1/p1/bandwidth?account=paejgjuv&area=apac&startdate=2019-10-01T16:40:00Z&enddate=2019-10-01T17:00:00Z&granularity=300'

Пример успешного ответа

{ 
    "response" :   [ 
      [ 
        { 
          "account" :   "paejgjuv" , 
          "intervals" :   [ 
            { 
              "start" :   "2019-10-01T16:40:00Z" , 
              "end" :   "2019-10-01T16:45:00Z" , 
              "value" :   0.07571 
            }, 
            { 
              "start" :   "2019-10-01T16:45:00Z" , 
              "end" :   "2019-10-01T16:50:00Z" , 
              "value" :   0.01729 
            }, 
            { 
              "start" :   "2019-10-01T16:50:00Z" , 
              "end" :   "2019-10-01T16:55:00Z" , 
              "value" :   0.42443 
            }, 
            { 
              "start" :   "2019-10-01T16:55:00Z" , 
              "end" :   "2019-10-01T17:00:00Z" , 
              "value" :   0.06633 
            } 
          ], 
          "area" :   "apac" 
        } 
      ] 
    ] 
 }

Пример неуспешного ответа

{ 
       "error" :   { 
       "message" :   "Not authorized to request account paejgjuv" , 
       "code" :   401 
     } 
 }
Была ли статья полезной ?
Предыдущая статья
API статистики по потокам
Следующая статья
API realtime статистики по полосе
/ DOCS
Evolution