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": ""
}
Запустили Evolution free tier
для Dev & Test
Получить