[Документация Yandex Cloud](../../../index.md) > [Yandex Cloud CDN](../../index.md) > [Пошаговые инструкции](../index.md) > Ресурсы > Настроить кеширование ресурса # Настройка кеширования ресурса В настройках [CDN-ресурса](../../concepts/resource.md) вы можете включить [кеширование контента](../../concepts/caching.md) — временное хранение копий файлов из [источников](../../concepts/origins.md) на [CDN-серверах](../../concepts/points-of-presence.md). Если для ресурса включено кеширование на CDN-серверах, файлы копируются из [источников](../../concepts/origins.md) в кеш серверов при следующих событиях: * Пользователь запросил у [CDN-ресурса](../../concepts/resource.md) файл, который в текущий момент не закеширован отвечающим сервером. * [Время жизни](../../concepts/caching.md#server-side-cache-age) кеш-копии файла на CDN-сервере истекло, а файл в источнике за это время изменился (иначе время жизни продлевается на тот же период). * Вы [принудительно загрузили](../../concepts/caching.md#prefetch) файлы из источников в кеш CDN-серверов в настройках CDN-ресурса. Чтобы настроить параметры кеширования для ресурса: {% list tabs group=instructions %} - Консоль управления {#console} 1. В [консоли управления](https://kz.console.yandex.cloud) выберите каталог, в котором расположен ресурс. 1. [Перейдите](https://kz.console.yandex.cloud/link/cdn) в сервис **Cloud CDN**. 1. Нажмите на имя необходимого ресурса. 1. Перейдите на вкладку **Кеширование**. 1. В правом верхнем углу нажмите кнопку ![image](../../../_assets/console-icons/pencil.svg) **Редактировать**. 1. Выберите и настройте нужные варианты кеширования: * В блоке **CDN**: * Включите опцию **Кеширование в CDN**. * Выберите тип настроек: `Как у источника` или `Свои настройки`. * Выберите время жизни кеша из списка. * (Опционально) Для типа настроек `Свои настройки` задайте время жизни кеша для нужных HTTP-кодов ответа. * В блоке **Браузер**: * Включите опцию **Кеширование в браузере**. 1. (Опционально) В блоке **Дополнительно**: * Выберите опцию игнорирования Cookie. * Выберите опцию игнорирования Query-параметров. 1. Нажмите кнопку **Сохранить**. - CLI {#cli} Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), [установите и инициализируйте его](../../../cli/quickstart.md#install). По умолчанию используется каталог, указанный при [создании](../../../cli/operations/profile/profile-create.md) профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду `yc config set folder-id <идентификатор_каталога>`. Также для любой команды вы можете указать другой каталог с помощью параметров `--folder-name` или `--folder-id`. Если вы обращаетесь к ресурсу по имени, поиск будет выполнен в каталоге по умолчанию. Если вы обращаетесь к ресурсу по идентификатору, поиск будет выполнен глобально — во всех каталогах с учетом прав доступа. 1. Посмотрите описание команды CLI для редактирования ресурсов: ```bash yc cdn resource update --help ``` 1. Получите список всех ресурсов в каталоге по умолчанию: ```bash yc cdn resource list --format yaml ``` Результат: ```text 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 ``` 1. Чтобы изменить время жизни кеша, выполните: ```bash yc cdn resource update <идентификатор_ресурса> \ --cache-expiration-time <время> \ --browser-cache-expiration-time <время> \ --ignore-cookie true \ --ignore-query-string ``` Где: * `--cache-expiration-time` — время жизни кеша в секундах. * `--browser-cache-expiration-time` — время жизни кеша браузера в секундах. * `--ignore-cookie` со значением `true` включает игнорирование Cookie. * `--ignore-query-string` включает игнорирование Query-параметров. Подробнее о команде `yc cdn resource update` в [справочнике CLI](../../../cli/cli-ref/cdn/cli-ref/resource/update.md). - Terraform {#tf} Если у вас еще нет Terraform, [установите его и настройте провайдер Yandex Cloud](../../../tutorials/infrastructure-management/terraform-quickstart.md#install-terraform). Чтобы управлять инфраструктурой с помощью Terraform от имени сервисного аккаунта или пользовательских аккаунтов: аккаунта на Яндексе, федеративного аккаунта и локального пользователя, [аутентифицируйтесь](../../../terraform/authentication.md) соответствующим способом. 1. Опишите в конфигурационном файле параметры создаваемого CDN-ресурса `yandex_cdn_resource`: ```hcl resource "yandex_cdn_resource" "my_resource" { cname = "cdn1.yandex-example.ru" active = false origin_protocol = "https" secondary_hostnames = ["cdn-example-1.yandex.ru", "cdn-example-2.yandex.ru"] origin_group_id = yandex_cdn_origin_group.my_group.id options { edge_cache_settings = "345600" browser_cache_settings = "1800" ignore_cookie = true ignore_query_params = false } } ``` Где: * `cname` — основное доменное имя для раздачи контента. Обязательный параметр. * `active` — флаг, указывающий на доступ к контенту для конечных пользователей. `True` — контент из CDN будет доступен клиентам. Необязательный параметр, значение по умолчанию: `true`. * `origin_protocol` — протокол для источников. Необязательный параметр, значение по умолчанию: `http`. * `secondary_hostnames` — дополнительные доменные имена. Необязательный параметр. * `origin_group_id` — идентификатор [группы источников](../../concepts/origins.md). Обязательный параметр. Используйте идентификатор из описания группы источников в ресурсе `yandex_cdn_origin_group`. * Блок `options` содержит дополнительные параметры CDN-ресурсов: * `browser_cache_settings` — время жизни кеша в браузере в секундах. Необязательный параметр, значение по умолчанию: `0`. * `edge_cache_settings` — время жизни кеша для кодов ответа в секундах. Необязательный параметр, значение по умолчанию: `345600`. * `ignore_query_params` — игнорировать query-параметры. Необязательный параметр, значение по умолчанию: `false`. * `ignore_cookie` — игнорировать cookie. Необязательный параметр, значение по умолчанию: `false`. Подробнее о параметрах `yandex_cdn_resource` в Terraform в [документации провайдера](../../../terraform/resources/cdn_resource.md). 1. В командной строке перейдите в папку, где расположен конфигурационный файл Terraform. 1. Проверьте конфигурацию командой: ``` terraform validate ``` Если конфигурация является корректной, появится сообщение: ``` Success! The configuration is valid. ``` 1. Выполните команду: ``` terraform plan ``` В терминале будет выведен список ресурсов с параметрами. На этом этапе изменения не будут внесены. Если в конфигурации есть ошибки, Terraform на них укажет. 1. Примените изменения конфигурации: ``` terraform apply ``` 1. Подтвердите изменения: введите в терминал слово `yes` и нажмите **Enter**. Проверить изменение CDN-ресурса можно в [консоли управления](https://kz.console.yandex.cloud) или с помощью команды [CLI](../../../cli/quickstart.md): ``` yc cdn resource list ``` - API {#api} Воспользуйтесь методом REST API [update](../../api-ref/Resource/update.md) для ресурса [Resource](../../api-ref/Resource/index.md) или вызовом gRPC API [ResourceService/Update](../../api-ref/grpc/Resource/update.md). {% endlist %} Чтобы новые настройки существующего ресурса применились к CDN-серверам, может потребоваться до 15 минут. После этого рекомендуется [очистить кеш ресурса](purge-cache.md).