[Документация Yandex Cloud](../../index.md) > [Yandex Cloud CDN](../index.md) > [Концепции](index.md) > Ресурс

# CDN-ресурс

_Ресурс_ — это основная логическая сущность сервиса Yandex Cloud CDN, позволяющая настраивать и управлять распространением контента с [источников](origins.md) через CDN. Распространение контента осуществляется через [точки присутствия](points-of-presence.md).

Чтобы начать распространять контент через CDN, нужно создать ресурс по [инструкции](../operations/resources/create-resource.md), указав в нем:

* источник или группу источников, которые содержат контент;
* [доменные имена для раздачи контента](#hostnames);
* основные настройки обмена данными [между клиентами и CDN](clients-to-servers.md) и [между CDN и источниками](servers-to-origins.md).

После создания ресурса в нем также можно настроить:

* [кеширование](caching.md);
* HTTP-заголовки и методы с помощью [инструкции](../operations/resources/configure-http.md);
* обработку [кросс-доменных запросов (CORS)](cors.md);
* [сжатие](compression.md) и [сегментирование](slicing.md) контента.
* [нестандартные HTTP-ответы](../operations/resources/configure-response.md).

Доступ к ресурсу можно ограничить с помощью [защищенных токенов](secure-tokens.md) и [политики доступа по IP-адресам](ip-address-acl.md).

Можно настроить [перенаправление запросов](http-rewrite.md) от CDN-ресурса к источнику, изменив [URI](https://ru.wikipedia.org/wiki/URI) запроса с помощью [правила](http-rewrite.md#rewrite-rule) `Rewrite`.

Настройки ресурса [начинают действовать через некоторое время](#delay) после создания или изменения ресурса. На это может потребоваться до 15 минут.


## Доменные имена для раздачи контента {#hostnames}

_Доменные имена для раздачи контента_ используются в запросах клиентов к CDN-серверам. Например, чтобы файл `styles/common.css` был доступен по адресу `cdn.example.com/styles/common.css`, нужно указать доменное имя `cdn.example.com`.  

В Cloud CDN поддерживаются любые доменные имена, в том числе [IDN](https://ru.wikipedia.org/wiki/IDN) с символами национальных алфавитов не из ASCII, например кириллическими. Такие имена можно указывать в исходном виде (`пример.рф`) или преобразовывать в [Punycode](https://ru.wikipedia.org/wiki/Punycode) с добавлением префиксов `xn--` (`xn--e1afmkfd.xn--p1ai`). В информации о ресурсе в [консоли управления](https://kz.console.yandex.cloud) IDN будут отображаться в исходном виде, без преобразования в Punycode.

При создании ресурса нужно указать хотя бы одно доменное имя. Первое имя является основным, его нельзя изменить после создания ресурса.

Для корректной работы ресурса у вас должны быть:

* Права на все указанные доменные имена.
* Доступ к настройкам [DNS](../../glossary/dns.md) для имен. 

  Для каждого имени в настройках вашего DNS-хостинга нужно создать CNAME-запись, связывающую это имя с доменным именем CDN-балансировщика вида `e1b83ae3********.topology.gslb.yccdn.kz`. Оно отображается при создании ресурса и на странице уже созданного ресурса в консоли управления. Например, так может выглядеть запись для доменного имени `cdn.example.com`:

  ``` 
  cdn.example.com. CNAME e1b83ae3********.topology.gslb.yccdn.kz
  ```

{% note info %}

Нельзя на одном домене второго уровня иметь и CDN-ресурс, и почтовый сервер. Рекомендуем создать два домена:

* Для контента, распространяемого через CDN. Обратите внимание, что Cloud CDN следует использовать только с ресурсными записями [CNAME](../../dns/concepts/resource-record.md#cname), поскольку при использовании записи [ANAME](../../dns/concepts/resource-record.md#aname) конечный пользователь получит ответ, не зависящий от его геолокации. Подробнее о CNAME-записях и их [ограничениях](https://www.rfc-editor.org/rfc/rfc1912#section-2.4) в [RFC-1035](https://www.ietf.org/rfc/rfc1035.html#section-3.3.1).
* Для легковесного контента и почтового сервера. В этом случае вы можете использовать ресурсные записи ANAME и [MX](../../dns/concepts/resource-record.md#mx).

{% endnote %}


## Время, требуемое на применение настроек {#delay}

CDN-ресурс начинает корректно работать через некоторое время после создания или изменения: 

* Новый ресурс начнет корректно работать после того, как запись CNAME, которую вы создали в своем DNS-хостинге (смотрите [раздел о доменных именах для раздачи контента](resource.md#hostnames)), распространится по серверам DNS. На это может потребоваться несколько часов.
* Чтобы новые настройки существующего ресурса применились к CDN-серверам, может потребоваться до 15 минут. После этого рекомендуется [очистить кеш ресурса](../operations/resources/purge-cache.md).


## Статусы ресурса {#status}

Ресурс Cloud CDN может быть в одном из статусов:

* `Active`, если контент доступен всем (или станет доступен [после применения настроек](#delay));
* `Not active`, если контент недоступен никому.

Для переключения используется опция **Доступ конечных пользователей к контенту** в основных настройках ресурса.

Если к ресурсу в течение 90 дней нет пользовательских запросов, он переходит в статус `Not active`.

## Статистика использования ресурса {#stats}

Cloud CDN предоставляет метрики использования ресурса за последние 30 дней:

* **Загружено из источников** — объем трафика, загруженного CDN-серверами из источников.
* **Отправлено клиентам** — объем трафика, отправленного с CDN-серверов клиентам.
* **Весь трафик** — сумма метрик **Загружено из источников** и **Отправлено клиентам**.
* **Запросы от клиентов** — количество запросов клиентов к CDN.
* **Ответы из кеша** — количество запросов клиентов, в ответ на которые CDN-серверы отправили [кешированные](caching.md) копии файлов, не запрашивая их у источников (если кеширование на CDN-серверах включено).
* **Ответы с запросами к источникам** — количество запросов клиентов, в ответ на которые CDN-серверы не смогли отправить кешированные копии файлов (например, кеширование отключено, файл еще не кешировался сервером или [время жизни кеша](caching.md#server-side-cache-age) истекло) и обратились за ними к источникам.
* **Снижение нагрузки на источники** — доля трафика, отправленного с CDN-серверов клиентам, за которым не потребовалось обращаться к источникам. Рассчитывается по формуле `(1 − (Загружено из источников / Отправлено клиентам)) × 100%`.
* **Загружено экранирующим сервером** — объем трафика, загруженного экранирующим сервером из источников (если [экранирование](origins-shielding.md) включено).
* **Ответы с кодами 2xx**, **3xx**, **4xx**, **5xx** — количество ответов, отправленных CDN-серверами клиентам, с соответствующими HTTP-кодами состояния.

Посмотреть статистику можно на странице ресурса в [консоли управления](https://kz.console.yandex.cloud).

## Метрики Monitoring {#resource-stats}

Cloud CDN автоматически отправляет метрики работы ресурсов в сервис [Yandex Monitoring](../../monitoring/index.md).

Вы можете посмотреть статистику работы на [странице ресурса](../operations/resources/get-stats.md#cdn-ui) или в [интерфейсе Monitoring](../operations/resources/get-stats.md#monitoring).

Метрики Cloud CDN обновляются в среднем раз в 3 минуты. 

При просмотре метрик в [интерфейсе Monitoring](https://kz.monitoring.yandex.cloud) временные значения метрик соответствуют реальным.

Список метрик, передаваемых в Monitoring, представлен в [справочнике](../metrics-yc.md).


## Примеры использования {#examples}

* [Миграция в Yandex Cloud CDN из стороннего CDN-провайдера](../tutorials/migrate-to-yc-cdn.md)
* [Публикация обновлений для игр с помощью Yandex Cloud CDN](../tutorials/prefetch.md)
* [Организация сине-зеленого и канареечного развертывания версий веб-сервиса](../tutorials/blue-green-canary-deployment.md)
* [Интеграция L7-балансировщика с Cloud CDN и Object Storage](../tutorials/cdn-storage-integration/index.md)
* [Организация защищенного доступа к контенту в Cloud CDN](../tutorials/protected-access-to-content/index.md)


#### Полезные ссылки {#see-also}

* [Инструкции по работе с ресурсами](../operations/index.md#resources).
* [Инструкция по работе с основными настройками ресурса](../operations/resources/configure-basics.md).