- tocdepth
2
Управление кешем
Предзагрузка или удаление файлов из кеша, а также полный сброс кеша.
Данные операции выполняются асинхронно и в ответе возвращается 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": ""
}
для Dev & Test