Принудительная загрузка файлов в кеш CDN-серверов

Статья создана

Улучшена

Обновлена 22 апреля 2026 г.

В настройках CDN-ресурса вы можете включить кеширование контента — временное хранение копий файлов из источников на CDN-серверах.

При этом вы можете принудительно загрузить файлы из источников в кеш CDN-серверов. Вручную в кеш рекомендуется загружать большие файлы размером от 200 МБ.

Чтобы принудительно загрузить контент CDN-ресурса в кеш CDN-серверов:

Важно

Принудительно загрузить в кеш можно только контент, которого еще нет на CDN-серверах. Чтобы обновить в кеше уже имеющиеся там файлы, необходимо предварительно очистить кеш.

Консоль управления

CLI

API

В консоли управления выберите каталог, в котором расположен ресурс.
Перейдите в сервис Cloud CDN.
Нажмите на имя необходимого ресурса.
Перейдите на вкладку Контент.
В правом верхнем углу экрана нажмите кнопку и выберите Предзагрузить контент.
В поле Пути к файлам укажите имена нужных файлов.
Нажмите кнопку Предзагрузить контент.

Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.

По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>. Также для любой команды вы можете указать другой каталог с помощью параметров --folder-name или --folder-id. Если вы обращаетесь к ресурсу по имени, поиск будет выполнен в каталоге по умолчанию. Если вы обращаетесь к ресурсу по идентификатору, поиск будет выполнен глобально — во всех каталогах с учетом прав доступа.

Посмотрите описание команды CLI для редактирования ресурсов:
```
yc cdn resource update --help
```

Получите список всех ресурсов в каталоге по умолчанию:

yc cdn resource list --format yaml

Результат:

id: s0me1dkfjq********
folder_id: s0mef01der7p********
cname: testexample.com
created_at: "2022-01-19T09:23:57.921365Z"
updated_at: "2022-01-19T10:55:30.305141Z"
active: true
options:
  edge_cache_settings:
    enabled: true
    default value: "345600"
  cache_http_headers:
    enabled: true
    value:
    - content-type
    - content-length
    - connection
    - server
    - date
    - test
  stale:
    enabled: true
    value:
    - error
    - updating
  allowed_http_methods:
    value:
    - GET
    - POST
    - HEAD
    - OPTIONS
origin_group_id: "89783"
origin_group_name: My origins group
origin_protocol: HTTP
ssl_certificate:
  type: DONT_USE
  status: READY

Укажите через запятую без пробелов пути к файлам, которые хотите загрузить в кеш CDN-серверов:
```
yc cdn cache prefetch --resource-id <идентификатор_ресурса> \
  --path <пути_к_файлам>
```
Подробнее о команде yc cdn cache prefetch см. в справочнике CLI.

Воспользуйтесь методом REST API prefetch для ресурса Cache или вызовом gRPC API CacheService/Prefetch.

Принудительная загрузка файлов в кеш CDN-серверов

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