CDN

Управление кешем

Предзагрузка или удаление файлов из кеша, а также полный сброс кеша.

Данные операции выполняются асинхронно и в ответе возвращается task_id — идентификатор задачи. При наличии task_id можно проверить статус задачи (описано ниже).

Внимание

Ограничение на количество запросов к API управления кешем: не больше 125 обращений в минуту.

На этой странице

Удалить файл

URL: https://api.cdn.sber.cloud/app/cache/v2/objects?cdn_url=http://<domain>/path/to/file

В качестве <domain> может использоваться либо выделенный CDN-домен <resource_id>.a.trbcdn.net, либо CNAME.

Тип запроса: DELETE
Заголовки: CDN-AUTH-TOKEN
Тип данных ответа: JSON Object

Параметры строки запроса:

Имя параметра	Тип значения	Обязательный
cdn_url	Текст	Да

Возможные коды ответа:

Код ответа	Данные ответа	Формат ответа	Описание
202	task_id: тип string	JSON	ОК
400	None	None	Неверный запрос
401	None	None	Доступ запрещен
503	None	None	Сервис недоступен

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

curl   -X   DELETE   \ 
       -H   "CDN-AUTH-TOKEN:  $TOKEN "   \ 
 'https://api.cdn.sber.cloud/app/cache/v2/objects?cdn_url=http://lajjncnn6d.a.trbcdn.net/aloha/cdn/sample_03.flv' 

{ 
    "task_id" :   "f0f9601e75b2415db0e2219ea07d8fde" 
 } 

Сбросить весь кеш

URL: https://api.cdn.sber.cloud/app/cache/v2/objects?cdn_url=http://<domain>/path/to/file&all

В качестве <domain> может использоваться либо выделенный CDN-домен <resource_id>.a.trbcdn.net, либо CNAME.

Тип запроса: DELETE
Заголовки: CDN-AUTH-TOKEN
Тип данных ответа: JSON Object

Параметры строки запроса:

Имя параметра	Тип значения	Обязательный
cdn_url	Текст	Да
all	Значение отсутствует	Да

Возможные коды ответа:

Код ответа	Данные ответа	Формат ответа	Описание
202	task_id: тип string	JSON	ОК
400	None	None	Неверный запрос
401	None	None	Доступ запрещен
503	None	None	Сервис недоступен

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

curl   -X   DELETE   \ 
       -H   "CDN-AUTH-TOKEN:  $TOKEN "   \ 
 'https://api.cdn.sber.cloud/app/cache/v2/objects?cdn_url=http://lajjncnn6d.a.trbcdn.net/aloha/cdn/sample_03.flv&all' 

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

{ 
    "task_id" :   "ccf82df380a34fe7a4992ca810ccfee4" 
 } 

Предзагрузить файл

URL: https://api.cdn.sber.cloud/app/cache/v2/objects?cdn_url=http://origin:port/path/to/file

Тип запроса: PUT
Заголовки: CDN-AUTH-TOKEN
Тип данных ответа: JSON Object

Параметры строки запроса:

Имя параметра	Тип значения	Обязательный
cdn_url	Текст	Да

Возможные коды ответа:

Код ответа	Данные ответа	Формат ответа	Описание
202	task_id: тип string	JSON	ОК
400	None	None	Неверный запрос
401	None	None	Доступ запрещен
503	None	None	Сервис недоступен

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

curl   -X   PUT   \ 
       -H   "CDN-AUTH-TOKEN:  $TOKEN "   \ 
 'https://api.cdn.sber.cloud/app/cache/v2/objects?cdn_url=http://cache-cdntest.cdn.sber.cloud/aloha/cdn/sample_03.flv' 

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

{ 
    "task_id" :   "7a14702e80ec4b99ba5792ca9d781b3d" 
 } 

Проверить статус задачи

URL: https://api.cdn.sber.cloud/app/cache/v2/tasks?id=<task_id>

Тип запроса: GET
Заголовки: CDN-AUTH-TOKEN
Тип данных ответа: JSON Object

Возможные коды ответа:

Код ответа	Данные ответа	Формат ответа	Описание
200	task_description: тип string, status: тип string, date_started: тип string, message: тип string	JSON	ОК
400	None	None	Неверный запрос
401	None	None	Доступ запрещен
404	None	None	Не найдено
503	None	None	Сервис недоступен

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

curl   -X   GET   \ 
       -H   "CDN-AUTH-TOKEN:  $TOKEN "   \ 
 'https://api.cdn.sber.cloud/app/cache/v2/tasks?id=7a14702e80ec4b99ba5792ca9d781b3d' 

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

{ 
    "task_description" :   "PRELOAD http://cache-cdntest.cdn.sber.cloud/aloha/cdn/sample_03.flv" , 
    "status" :   "completed" , 
    "date_started" :   "2018-11-27T09:55:11" , 
    "message" :   "" 
 } 

Была ли статья полезной ?

Предыдущая статья

API для Restream-ресурса

Следующая статья

SSL Certificate API