list-distributions-by-anycast-ip-list-id

Описание

Выводит список распределений в вашей учетной записи, связанных с указанным AnycastIpListId.

См. также: Документацию API AWS

Синтаксис

  list-distributions-by-anycast-ip-list-id
[--marker <value>]
[--max-items <value>]
--anycast-ip-list-id <value>
[--cli-input-json | --cli-input-yaml]
[--generate-cli-skeleton <value>]
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]
[--cli-binary-format <value>]
[--no-cli-pager]
[--cli-auto-prompt]
[--no-cli-auto-prompt]

Параметры

--marker (строка)

Используйте этот параметр при постраничном выводе результатов, чтобы указать, с какой позиции начинать список. Ответ включает элементы списка, следующие за маркером. Чтобы получить следующую страницу списка, установите значение этого параметра в значение NextMarker из ответа текущей страницы.

--max-items (строка)

Максимальное количество распределений, которые должны быть возвращены в ответе.

--anycast-ip-list-id (строка)

Идентификатор списка статических IP-адресов Anycast.

--cli-input-json | --cli-input-yaml (строка) Считывает аргументы из предоставленной JSON-строки. JSON-строка следует формату, предоставленному --generate-cli-skeleton. Если другие аргументы предоставлены в командной строке, эти значения переопределят значения, предоставленные в JSON. Невозможно передавать произвольные двоичные значения с помощью значения, предоставленного в JSON, так как строка будет взята буквально. Это не может быть указано вместе с --cli-input-yaml.

--generate-cli-skeleton (строка) Выводит JSON-скелет в стандартный вывод без отправки запроса к API. При отсутствии значения или значении input выводит пример JSON-ввода, который можно использовать в качестве аргумента для --cli-input-json. Аналогично, при предоставлении yaml-input он выведет пример YAML-ввода, который можно использовать с --cli-input-yaml. При предоставлении значения output он проверит входные данные команды и вернёт пример JSON-вывода для этой команды. Сгенерированный JSON-скелет нестабилен между версиями AWS CLI, и нет гарантий обратной совместимости в сгенерированном JSON-скелете.

Глобальные параметры

--debug (логическое)

Включить отладочную запись журнала.

--endpoint-url (строка)

Переопределить URL по умолчанию команды указанным URL.

--no-verify-ssl (логическое)

По умолчанию AWS CLI использует SSL при общении с AWS-сервисами. Для каждого SSL-соединения AWS CLI будет проверять SSL-сертификаты. Этот параметр переопределяет поведение проверки SSL-сертификатов по умолчанию.

--no-paginate (логическое)

Отключить автоматическую постраничность. Если автоматическая постраничность отключена, AWS CLI выполнит только один вызов для первой страницы результатов.

--output (строка)

Стиль форматирования вывода команды.

json
text
table
yaml
yaml-stream

--query (строка)

Запрос JMESPath для фильтрации данных ответа.

--profile (строка)

Использовать определённый профиль из файла параметров.

--region (строка)

Регион для использования. Переопределяет параметры конфигурации/окружения.

--version (строка)

Отобразить версию этого инструмента.

--color (строка)

Включить/выключить цветной вывод.

on
off
auto

--no-sign-request (логическое)

Не подписывать запросы. Кредиты не будут загружены, если этот аргумент предоставлен.

--ca-bundle (строка)

Набор сертификатов CA для использования при проверке SSL-сертификатов. Переопределяет параметры конфигурации/окружения.

--cli-read-timeout (целое число)

Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет блокирующим и не будет иметь таймаута. Значение по умолчанию составляет 60 секунд.

--cli-connect-timeout (целое число)

Максимальное время подключения к сокету в секундах. Если значение установлено в 0, подключение к сокету будет блокирующим и не будет иметь таймаута. Значение по умолчанию составляет 60 секунд.

--cli-binary-format (строка)

Стиль форматирования, используемый для двоичных блоков. Формат по умолчанию — base64. Формат base64 ожидает, что двоичные блоки будут предоставлены как строка в кодировке base64. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI V1, и двоичные значения должны передаваться буквально. При предоставлении содержимого из файла, сопоставленного с двоичным блоком, fileb:// всегда будет обрабатываться как двоичный и использовать содержимое файла напрямую независимо от настройки cli-binary-format. При использовании file:// содержимое файла должно быть должным образом отформатировано для настроенного cli-binary-format.

base64
raw-in-base64-out

--no-cli-pager (логическое)

Отключить пейджер CLI для вывода.

--cli-auto-prompt (логическое)

Автоматически запрашивать параметры ввода CLI.

--no-cli-auto-prompt (логическое)

Отключить автоматическое запросить параметры ввода CLI.

Вывод

DistributionList -> (структура)

Список распределений.

Marker -> (строка)

Значение, предоставленное вами для параметра запроса Marker.

NextMarker -> (строка)

Если IsTruncated равно true, этот элемент присутствует и содержит значение, которое вы можете использовать для параметра запроса Marker, чтобы продолжить перечисление ваших распределений с места, где они остановились.

MaxItems -> (целое число)

Значение, предоставленное вами для параметра запроса MaxItems.

IsTruncated -> (логическое)

Флаг, указывающий, есть ли ещё распределения для перечисления. Если результаты были обрезаны, вы можете выполнить последующий запрос постраничного вывода с использованием параметра запроса Marker для получения дополнительных распределений в списке.

Quantity -> (целое число)

Количество распределений, созданных текущей учетной записью Amazon Web Services.

Items -> (список)

Составной тип, содержащий по одному элементу DistributionSummary для каждого распределения, созданного текущей учетной записью Amazon Web Services.

(структура)

Резюме информации о распределении CloudFront.

Id -> (строка)

Идентификатор распределения. Например: EDFDVBD632BHDS5.

ARN -> (строка)

ARN (Amazon Resource Name) для распределения. Например: arn:aws:cloudfront::123456789012:distribution/EDFDVBD632BHDS5, где 123456789012 — идентификатор вашей учетной записи Amazon Web Services.

ETag -> (строка)

Текущая версия распределения.

Status -> (строка)

Текущий статус распределения. Когда статус равен Deployed, информация о распределении распространяется на все расположения кромки CloudFront.

LastModifiedTime -> (отметка времени)

Дата и время последнего изменения распределения.

DomainName -> (строка)

Доменное имя, соответствующее распределению, например, d111111abcdef8.cloudfront.net.

Aliases -> (структура)

Составной тип, содержащий информацию о CNAME (альтернативных доменных именах), если таковые имеются, для данного распределения.

Quantity -> (целое число)

Количество CNAME-псевдонимов, если таковые имеются, которые вы хотите связать с этим распределением.

Items -> (список)

Составной тип, содержащий CNAME-псевдонимы, если таковые имеются, которые вы хотите связать с этим распределением.

(строка)

Origins -> (структура)

Сложный тип, содержащий информацию о происхождении этого распределения.

Количество -> (целое число)

Количество источников для этого распределения.

Элементы -> (список)

Список источников.

(структура)

Источник.

Источник — это место, где хранится контент, и откуда CloudFront получает контент для предоставления пользователям. Для указания источника:

Используйте S3OriginConfig, чтобы указать ведро Amazon S3, которое не настроено для размещения статических веб-сайтов.
Используйте VpcOriginConfig, чтобы указать источник VPC.
Используйте CustomOriginConfig, чтобы указать все другие типы источников, включая:
- Ведро Amazon S3, настроенное для размещения статических веб-сайтов
- Балансировщик нагрузки Elastic Load Balancing
- Конечная точка Elemental MediaPackage
- Контейнер Elemental MediaStore
- Любой другой HTTP-сервер, работающий на экземпляре Amazon EC2 или любом другом хосте

Для получения текущего максимального количества источников, которое можно указать на распределение, см. Общие квоты на веб-распределения в Руководстве разработчика Amazon CloudFront (ранее квоты назывались ограничениями).

Id -> (строка)

Уникальный идентификатор источника. Это значение должно быть уникальным в пределах распределения.

Используйте это значение для указания TargetOriginId в CacheBehavior или DefaultCacheBehavior.

DomainName -> (строка)

Доменное имя источника.

Для получения дополнительной информации см. Доменное имя источника в Руководстве разработчика Amazon CloudFront.

OriginPath -> (строка)

Необязательный путь, который CloudFront добавляет к доменному имени источника, когда CloudFront запрашивает контент из источника.

Для получения дополнительной информации см. Путь источника в Руководстве разработчика Amazon CloudFront.

CustomHeaders -> (структура)

Список имен и значений HTTP-заголовков, которые CloudFront добавляет к запросам, отправляемым источнику.

Для получения дополнительной информации см. Добавление пользовательских заголовков к запросам источника в Руководстве разработчика Amazon CloudFront.

Количество -> (целое число)

Количество пользовательских заголовков, если таковые имеются, для этого распределения.

Элементы -> (список)

Необязательно : список, содержащий по одному элементу OriginCustomHeader для каждого пользовательского заголовка, который вы хотите, чтобы CloudFront передавал источнику. Если Quantity равно 0 , опустите Items.

(структура)

Сложный тип, содержащий HeaderName и HeaderValue элементы, если таковые имеются, для этого распределения.

HeaderName -> (строка)

Имя заголовка, который вы хотите, чтобы CloudFront отправлял вашему источнику. Для получения дополнительной информации см. Добавление пользовательских заголовков к запросам источника в Руководстве разработчика Amazon CloudFront.

HeaderValue -> (строка)

Значение заголовка, указанного в поле HeaderName.

S3OriginConfig -> (структура)

Используйте этот тип для указания источника, который является ведром Amazon S3, которое не настроено для размещения статических веб-сайтов. Для указания любого другого типа источника, включая ведро Amazon S3, настроенное для размещения статических веб-сайтов, используйте тип CustomOriginConfig вместо этого.

OriginAccessIdentity -> (строка)

Примечание

Если вы используете контроль доступа к источнику (OAC) вместо идентификатора доступа к источнику, укажите пустой OriginAccessIdentity элемент. Для получения дополнительной информации см. Ограничение доступа к Amazon Web Services в Руководстве разработчика Amazon CloudFront.

Идентификатор доступа к источнику CloudFront, который нужно связать с источником. Используйте идентификатор доступа к источнику, чтобы настроить источник таким образом, чтобы пользователи могли только получать доступ к объектам в ведре Amazon S3 через CloudFront. Формат значения:

origin-access-identity/cloudfront/ID-of-origin-access-identity

`` ID-of-origin-access-identity `` — это значение, возвращенное CloudFront в элементе ID при создании идентификатора доступа к источнику.

Если вы хотите, чтобы пользователи могли получать доступ к объектам как через URL CloudFront, так и через URL Amazon S3, укажите пустой OriginAccessIdentity элемент.

Чтобы удалить идентификатор доступа к источнику из существующего распределения, обновите конфигурацию распределения и включите пустой OriginAccessIdentity элемент.

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

Дополнительную информацию об идентификаторе доступа к источнику см. в разделе Предоставление доступа к закрытому контенту через CloudFront в Руководстве разработчика Amazon CloudFront.

CustomOriginConfig -> (структура)

Используйте этот тип для указания источника, который не является ведром Amazon S3, с одним исключением. Если ведро Amazon S3 настроено для размещения статических веб-сайтов, используйте этот тип. Если ведро Amazon S3 не настроено для размещения статических веб-сайтов, используйте тип S3OriginConfig вместо этого.

HTTPPort -> (целое число)

HTTP-порт, который CloudFront использует для подключения к источнику. Укажите HTTP-порт, на котором слушает источник.

HTTPSPort -> (целое число)

HTTPS-порт, который CloudFront использует для подключения к источнику. Укажите HTTPS-порт, на котором слушает источник.

OriginProtocolPolicy -> (строка)

Указывает протокол (HTTP или HTTPS), который CloudFront использует для подключения к источнику. Допустимые значения:

http-only — CloudFront всегда использует HTTP для подключения к источнику.
match-viewer — CloudFront подключается к источнику с использованием того же протокола, что и пользователь для подключения к CloudFront.
https-only — CloudFront всегда использует HTTPS для подключения к источнику.

OriginSslProtocols -> (структура)

Указывает минимальный протокол SSL/TLS, который CloudFront использует при подключении к вашему источнику по HTTPS. Допустимые значения включают SSLv3 , TLSv1 , TLSv1.1 и TLSv1.2.

Для получения дополнительной информации см. Минимальный протокол SSL источника в Руководстве разработчика Amazon CloudFront.

Количество -> (целое число)

Количество протоколов SSL/TLS, которые вы хотите разрешить CloudFront использовать при установлении HTTPS-соединения с этим источником.

Элементы -> (список)

Список разрешенных протоколов SSL/TLS для этого распределения.

(строка)

OriginReadTimeout -> (целое число)

Указывает время, в секундах, которое CloudFront ожидает ответа от источника. Это также известно как время ожидания ответа от источника. Минимальное время ожидания составляет 1 секунду, максимальное — 60 секунд, а по умолчанию (если вы ничего не укажете) — 30 секунд.

Для получения дополнительной информации см. Время ожидания ответа (только для настраиваемых источников) в Руководстве разработчика Amazon CloudFront.

OriginKeepaliveTimeout -> (целое число)

Указывает время, в секундах, на которое CloudFront сохраняет соединение с источником. Минимальное время ожидания составляет 1 секунду, максимальное — 60 секунд, а по умолчанию (если вы ничего не укажете) — 5 секунд.

Для получения дополнительной информации см. Время ожидания keep-alive (только для настраиваемых источников) в Руководстве разработчика Amazon CloudFront.

VpcOriginConfig -> (структура)

Конфигурация источника VPC.

VpcOriginId -> (строка)

Идентификатор источника VPC.

OriginReadTimeout -> (целое число)

OriginKeepaliveTimeout -> (целое число)

ConnectionAttempts -> (целое число)

Количество попыток подключения CloudFront к источнику. Минимальное количество — 1, максимальное — 3, а по умолчанию (если вы ничего не укажете) — 3.

Для настраиваемого источника (включая ведро Amazon S3, настроенное для размещения статических веб-сайтов) это значение также определяет количество попыток CloudFront получить ответ от источника в случае времени ожидания ответа от источника.

Для получения дополнительной информации см. Попытки подключения к источнику в Руководстве разработчика Amazon CloudFront.

ConnectionTimeout -> (целое число)

Количество секунд, которое CloudFront ожидает при попытке установить соединение с источником. Минимальное время ожидания составляет 1 секунду, максимальное — 10 секунд, а по умолчанию (если вы ничего не укажете) — 10 секунд.

Для получения дополнительной информации см. Время ожидания подключения к источнику в Руководстве разработчика Amazon CloudFront.

OriginShield -> (структура)

CloudFront Origin Shield. Использование Origin Shield может помочь уменьшить нагрузку на ваш источник.

Для получения дополнительной информации см. Использование Origin Shield в Руководстве разработчика Amazon CloudFront.

Enabled -> (булево)

Флаг, указывающий, включен ли Origin Shield.

При включенном значении CloudFront направляет все запросы через Origin Shield, что может помочь защитить ваш источник. При отключенном значении CloudFront может отправлять запросы непосредственно вашему источнику с нескольких узлов по краям или региональных кэшей по краям.

OriginShieldRegion -> (строка)

Регион Amazon Web Services для Origin Shield.

Укажите регион Amazon Web Services с наименьшей задержкой до вашего источника. Укажите код региона, а не имя региона. Например, укажите регион США — Восточный (Огайо) как us-east-2.

При включении CloudFront Origin Shield необходимо указать регион Amazon Web Services для Origin Shield. Список регионов Amazon Web Services, которые вы можете указать, а также помощь в выборе лучшего региона для вашего источника см. в разделе Выбор региона Amazon Web Services для Origin Shield в Руководстве разработчика Amazon CloudFront.

OriginAccessControlId -> (строка)

Уникальный идентификатор контроля доступа к источнику для этого источника.

Для получения дополнительной информации см. Ограничение доступа к источнику Amazon S3 в Руководстве разработчика Amazon CloudFront.

OriginGroups -> (структура)

Сложный тип, содержащий информацию о группах источников для данного распределения.

Количество -> (целое число)

Количество групп источников.

Элементы -> (список)

Элементы (группы источников) в распределении.

(структура)

Группа источников включает два источника (основной источник и резервный источник для переключения) и критерии переключения, которые вы задаете. Вы создаете группу источников для поддержки переключения источников в CloudFront. При создании или обновлении распределения вы можете указать группу источников вместо одного источника, и CloudFront будет переключаться с основного источника на резервный источник в соответствии с выбранными вами условиями переключения.

Необязательно, вы можете выбрать критерии выбора для своей группы источников, чтобы указать, как ваши источники выбираются, когда ваше распределение обрабатывает запросы зрителей.

Идентификатор -> (строка)

Идентификатор группы источников.

Критерии переключения -> (структура)

Сложный тип, содержащий информацию о критериях переключения для группы источников.

Коды состояния -> (структура)

Коды состояния, которые, если возвращаются основным источником, приведут к переключению CloudFront на резервный источник.

Количество -> (целое число)

Количество кодов состояния.

Элементы -> (список)

Элементы (коды состояния) для группы источников.

(целое число)

Члены -> (структура)

Сложный тип, содержащий информацию об источниках в группе источников.

Количество -> (целое число)

Количество источников в группе источников.

Элементы -> (список)

Элементы (источники) в группе источников.

(структура)

Источник в группе источников.

Идентификатор источника -> (строка)

Идентификатор источника в группе источников.

Критерии выбора -> (строка)

Критерии выбора для группы источников. Дополнительную информацию см. в разделе «Создание группы источников» в руководстве разработчика Amazon CloudFront.

Поведение кэша по умолчанию -> (структура)

Сложный тип, описывающий поведение кэша по умолчанию, если вы не указали элемент CacheBehavior или файлы не соответствуют ни одному из значений PathPattern в элементах CacheBehavior. Вы должны создать ровно одно поведение кэша по умолчанию.

TargetOriginId -> (строка)

Значение ID для источника, к которому CloudFront должен направлять запросы при использовании поведения кэша по умолчанию.

TrustedSigners -> (структура)

Предупреждение

Рекомендуется использовать TrustedKeyGroups вместо TrustedSigners.

Список идентификаторов учетных записей Amazon Web Services, чьи открытые ключи CloudFront может использовать для проверки подписанных URL-адресов или подписанных файлов cookie.

Когда поведение кэша содержит доверенных подписантов, CloudFront требует подписанных URL-адресов или подписанных файлов cookie для всех запросов, соответствующих поведению кэша. URL-адреса или файлы cookie должны быть подписаны с помощью закрытого ключа пары ключей CloudFront в учетной записи Amazon Web Services доверенного подписанта. Подписанный URL-адрес или файл cookie содержит информацию о том, какой открытый ключ CloudFront должен использовать для проверки подписи. Дополнительные сведения см. в разделе «Сервирование контента без доступа в руководстве разработчика Amazon CloudFront».

Enabled -> (булево)

Это поле true, если хотя бы одна из учетных записей Amazon Web Services в списке настроена как доверенный подписант. В противном случае это поле false.

Quantity -> (целое число)

Количество учетных записей Amazon Web Services в списке.

Items -> (список)

Список идентификаторов учетных записей Amazon Web Services.

(строка)

TrustedKeyGroups -> (структура)

Список групп ключей, которые CloudFront может использовать для проверки подписанных URL-адресов или подписанных файлов cookie.

Когда поведение кэша содержит доверенные группы ключей, CloudFront требует подписанных URL-адресов или подписанных файлов cookie для всех запросов, соответствующих поведению кэша. URL-адреса или файлы cookie должны быть подписаны с помощью закрытого ключа, соответствующий открытый ключ которого находится в группе ключей. Подписанный URL-адрес или файл cookie содержит информацию о том, какой открытый ключ CloudFront должен использовать для проверки подписи. Дополнительные сведения см. в разделе «Сервирование контента без доступа в руководстве разработчика Amazon CloudFront».

Enabled -> (булево)

Это поле true, если какие-либо из групп ключей в списке имеют открытые ключи, которые CloudFront может использовать для проверки подписей подписанных URL-адресов и файлов cookie. В противном случае это поле false.

Quantity -> (целое число)

Количество групп ключей в списке.

Items -> (список)

Список идентификаторов групп ключей.

(строка)

ViewerProtocolPolicy -> (строка)

Протокол, который просматривающие могут использовать для доступа к файлам в источнике, указанном в TargetOriginId, когда запрос соответствует шаблону пути в PathPattern. Вы можете указать следующие варианты:

allow-all: Пользователи могут использовать HTTP или HTTPS.
redirect-to-https: Если пользователь отправляет запрос HTTP, CloudFront возвращает пользователю код состояния HTTP 301 (Перемещено постоянно) вместе с URL-адресом HTTPS. Пользователь затем повторно отправляет запрос, используя новый URL-адрес.
https-only: Если пользователь отправляет запрос HTTP, CloudFront возвращает код состояния HTTP 403 (Запрещено).

Дополнительные сведения о требовании к протоколу HTTPS см. в разделе «Требование HTTPS между просматривающими и CloudFront в руководстве разработчика Amazon CloudFront».

Примечание

Единственный способ гарантировать, что пользователи получат объект, полученный из источника с помощью HTTPS, — никогда не использовать другие протоколы для извлечения объекта. Если вы недавно перешли с HTTP на HTTPS, рекомендуется очистить кэш объектов, потому что кешированные объекты независимы от протокола. Это означает, что расположение на краю вернет объект из кэша независимо от того, соответствует ли текущий протокол запроса протоколу, используемому ранее. Дополнительные сведения см. в разделе «Управление сроком действия кэша в руководстве разработчика Amazon CloudFront».

AllowedMethods -> (структура)

Сложный тип, который управляет HTTP-методами, которые CloudFront обрабатывает и передает в ваш Amazon S3-ведро или в ваш пользовательский источник. Есть три варианта:

CloudFront передает только запросы GET и HEAD.
CloudFront передает только запросы GET, HEAD и OPTIONS.
CloudFront передает запросы GET, HEAD, OPTIONS, PUT, PATCH, POST и DELETE.

Если вы выберете третий вариант, вам может потребоваться ограничить доступ к вашему Amazon S3-ведру или вашему пользовательскому источнику, чтобы пользователи не могли выполнять операции, которые вы не хотите, чтобы они выполняли. Например, вы можете не разрешать пользователям удалять объекты из источника.

Quantity -> (целое число)

Количество HTTP-методов, которые вы хотите, чтобы CloudFront передавал в ваш источник. Допустимые значения: 2 (для запросов GET и HEAD), 3 (для запросов GET, HEAD и OPTIONS) и 7 (для запросов GET, HEAD, OPTIONS, PUT, PATCH, POST и DELETE).

Items -> (список)

Сложный тип, содержащий HTTP-методы, которые вы хотите, чтобы CloudFront обрабатывал и передавал в ваш источник.

(строка)

CachedMethods -> (структура)

Сложный тип, который управляет тем, кэширует ли CloudFront ответ на запросы с помощью указанных HTTP-методов. Есть два варианта:

CloudFront кэширует ответы на запросы GET и HEAD.
CloudFront кэширует ответы на запросы GET, HEAD и OPTIONS.

Если вы выберете второй вариант для вашего источника Amazon S3, вам может потребоваться передать заголовки Access-Control-Request-Method, Access-Control-Request-Headers и Origin для правильного кэширования ответов.

Quantity -> (целое число)

Количество HTTP-методов, для которых вы хотите, чтобы CloudFront кэшировал ответы. Допустимые значения: 2 (для кэширования ответов на запросы GET и HEAD) и 3 (для кэширования ответов на запросы GET, HEAD и OPTIONS).

Items -> (список)

Сложный тип, содержащий HTTP-методы, для которых вы хотите, чтобы CloudFront кэшировал ответы. Допустимые значения для CachedMethods включают GET, HEAD и OPTIONS, в зависимости от выбранного варианта кэширования. Дополнительные сведения см. в предыдущем разделе.

(строка)

SmoothStreaming -> (булево)

Указывает, хотите ли вы распределить медиафайлы в формате Microsoft Smooth Streaming, используя источник, связанный с этим поведением кэша. В этом случае укажите true; в противном случае укажите false. Если вы укажете true для SmoothStreaming, вы все равно можете распределить другой контент, используя это поведение кэша, если контент соответствует значению PathPattern.

Compress -> (булево)

Хотите ли вы, чтобы CloudFront автоматически сжимал определенные файлы для этого поведения кэша. Если да, укажите true; если нет, укажите false. Дополнительные сведения см. в разделе «Сервирование сжатых файлов в руководстве разработчика Amazon CloudFront».

LambdaFunctionAssociations -> (структура)

Сложный тип, содержащий ноль или более ассоциаций функций Lambda@Edge для поведения кэша.

Quantity -> (целое число)

Количество ассоциаций функций Lambda@Edge для данного поведения кэша.

Items -> (список)

Необязательно: сложный тип, содержащий элементы LambdaFunctionAssociation для данного поведения кэша. Если Quantity является 0, вы можете опустить Items.

(структура)

Сложный тип, содержащий ассоциацию функции Lambda@Edge.

LambdaFunctionARN -> (строка)

ARN функции Lambda@Edge. Вы должны указать ARN версии функции; вы не можете указать псевдоним или $LATEST.

EventType -> (строка)

Указывает тип события, который запускает вызов функции Lambda@Edge. Вы можете указать следующие значения:

viewer-request: Функция выполняется, когда CloudFront получает запрос от просматривающего и прежде чем проверить, находится ли запрашиваемый объект в кэше на краю.
origin-request: Функция выполняется только когда CloudFront отправляет запрос в ваш источник. Когда запрашиваемый объект находится в кэше на краю, функция не выполняется.
origin-response: Функция выполняется после того, как CloudFront получит ответ от источника и перед тем, как добавить объект в ответ в кэш. Когда запрашиваемый объект находится в кэше на краю, функция не выполняется.
viewer-response: Функция выполняется перед тем, как CloudFront вернет запрашиваемый объект просматривающему. Функция выполняется независимо от того, был ли объект уже в кэше на краю. Если источник возвращает код состояния HTTP, отличный от HTTP 200 (OK), функция не выполняется.

IncludeBody -> (булево)

Флаг, который позволяет функции Lambda@Edge иметь доступ для чтения к содержимому тела. Дополнительные сведения см. в руководстве разработчика Amazon CloudFront.

FunctionAssociations -> (структура)

Список функций CloudFront, которые связаны с этим поведением кэша. Ваши функции должны быть опубликованы в стадии LIVE, чтобы связать их с поведением кэша.

Quantity -> (целое число)

Количество функций CloudFront в списке.

Items -> (список)

Функции CloudFront, которые связаны с поведением кэша в распределении CloudFront. Ваши функции должны быть опубликованы в стадии LIVE, чтобы связать их с поведением кэша.

(структура)

Функция CloudFront, связанная с поведением кэша в распределении CloudFront.

FunctionARN -> (строка)

Amazon Resource Name (ARN) функции.

EventType -> (строка)

Тип события функции, либо viewer-request, либо viewer-response. Вы не можете использовать типы событий, ориентированные на источник (origin-request и origin-response) с функцией CloudFront.

```

FieldLevelEncryptionId -> (string)

Значение ID для конфигурации шифрования на уровне поля, которую вы хотите, чтобы CloudFront использовал для шифрования определенных полей данных для поведения кэширования по умолчанию.

RealtimeLogConfigArn -> (string)

Идентификатор ресурса Amazon (ARN) конфигурации журнала в реальном времени, прикрепленной к данному поведению кэширования. Дополнительную информацию см. в разделе Журналы в реальном времени в Руководстве разработчика Amazon CloudFront.

CachePolicyId -> (string)

Уникальный идентификатор политики кэширования, прикрепленной к поведению кэширования по умолчанию. Дополнительную информацию см. в разделах Создание политик кэширования или Использование управляемых политик кэширования в Руководстве разработчика Amazon CloudFront.

DefaultCacheBehavior должна содержать либо CachePolicyId, либо ForwardedValues. Рекомендуется использовать CachePolicyId.

OriginRequestPolicyId -> (string)

Уникальный идентификатор политики запроса к источнику, прикрепленной к поведению кэширования по умолчанию. Дополнительную информацию см. в разделах Создание политик запросов к источнику или Использование управляемых политик запросов к источнику в Руководстве разработчика Amazon CloudFront.

ResponseHeadersPolicyId -> (string)

Идентификатор политики заголовков ответа.

GrpcConfig -> (structure)

Конфигурация gRPC для вашего поведения кэширования.

Enabled -> (boolean)

Включает возможность вашей распределенной системы CloudFront принимать запросы gRPC и проксировать их напрямую к вашим источникам.

ForwardedValues -> (structure)

Это поле устарело. Рекомендуется использовать политику кэширования или политику запроса к источнику вместо этого поля. Дополнительную информацию см. в разделе Работа с политиками в Руководстве разработчика Amazon CloudFront.

Если вы хотите включить значения в ключ кэша, используйте политику кэширования. Дополнительную информацию см. в разделах Создание политик кэширования или Использование управляемых политик кэширования в Руководстве разработчика Amazon CloudFront.

Если вы хотите отправить значения источнику, но не включать их в ключ кэша, используйте политику запроса к источнику. Дополнительную информацию см. в разделах Создание политик запросов к источнику или Использование управляемых политик запросов к источнику в Руководстве разработчика Amazon CloudFront.

DefaultCacheBehavior должна содержать либо CachePolicyId, либо ForwardedValues. Рекомендуется использовать CachePolicyId.

Сложный тип, который определяет, как CloudFront обрабатывает строки запросов, файлы cookie и заголовки HTTP.

QueryString -> (boolean)

Это поле устарело. Рекомендуется использовать политику кэширования или политику запроса к источнику вместо этого поля.

Если вы хотите включить строки запроса в ключ кэша, используйте политику кэширования. Дополнительную информацию см. в разделе Создание политик кэширования в Руководстве разработчика Amazon CloudFront.

Если вы хотите отправить строки запроса источнику, но не включать их в ключ кэша, используйте политику запроса к источнику. Дополнительную информацию см. в разделе Создание политик запросов к источнику в Руководстве разработчика Amazon CloudFront.

Указывает, хотите ли вы, чтобы CloudFront передавал строки запроса источнику, связанному с этим поведением кэширования, и кэшировал на основе параметров строки запроса. Поведение CloudFront зависит от значения QueryString и от указанных значений для QueryStringCacheKeys, если таковые имеются:

Если вы укажете значение true для QueryString и не укажете никаких значений для QueryStringCacheKeys, CloudFront передает все параметры строки запроса источнику и кэширует на основе всех параметров строки запроса. В зависимости от количества параметров и значений строки запроса это может негативно сказаться на производительности, поскольку CloudFront должен передавать больше запросов источнику.

Если вы укажете значение true для QueryString и укажете одно или несколько значений для QueryStringCacheKeys, CloudFront передает все параметры строки запроса источнику, но кэширует только на основе указанных параметров строки запроса.

Если вы укажете значение false для QueryString, CloudFront не передает никаких параметров строки запроса источнику и не кэширует на основе параметров строки запроса.

Дополнительную информацию см. в разделе Настройка CloudFront для кэширования на основе параметров строки запроса в Руководстве разработчика Amazon CloudFront.

Cookies -> (structure)

Если вы хотите включить файлы cookie в ключ кэша, используйте политику кэширования. Дополнительную информацию см. в разделе Создание политик кэширования в Руководстве разработчика Amazon CloudFront.

Если вы хотите отправить файлы cookie источнику, но не включать их в ключ кэша, используйте политику запроса к источнику. Дополнительную информацию см. в разделе Создание политик запросов к источнику в Руководстве разработчика Amazon CloudFront.

Сложный тип, который определяет, хотите ли вы, чтобы CloudFront передавал файлы cookie источнику, и, если да, какие именно. Дополнительную информацию о передаче файлов cookie источнику см. в разделе Как CloudFront передает, кэширует и регистрирует файлы cookie в Руководстве разработчика Amazon CloudFront.

Forward -> (string)

Определяет, какие файлы cookie передавать источнику для этого поведения кэширования: все, ни одного, или список файлов cookie, указанный в сложном типе WhitelistedNames.

Amazon S3 не обрабатывает файлы cookie. Когда поведение кэширования передает запросы источнику Amazon S3, укажите none для элемента Forward.

WhitelistedNames -> (structure)

Требуется, если вы указали whitelist для значения Forward. Сложный тип, который определяет количество различных файлов cookie, которые вы хотите, чтобы CloudFront передавал источнику для этого поведения кэширования, и, если вы хотите передать выбранные файлы cookie, имена этих файлов cookie.

Если вы укажете all или none для значения Forward, опустите WhitelistedNames. Если вы измените значение Forward с whitelist на all или none и не удалите элемент WhitelistedNames и его дочерние элементы, CloudFront автоматически удалит их.

Для текущего ограничения количества имён файлов cookie, которые можно включить в список для каждого поведения кэширования, см. Ограничения CloudFront в Общей справке Amazon Web Services.

Quantity -> (integer)

Количество имён файлов cookie в списке Items.

Items -> (list)

Список имён файлов cookie.

(string)

Headers -> (structure)

Если вы хотите включить заголовки в ключ кэша, используйте политику кэширования. Дополнительную информацию см. в разделе Создание политик кэширования в Руководстве разработчика Amazon CloudFront.

Если вы хотите отправить заголовки источнику, но не включать их в ключ кэша, используйте политику запроса к источнику. Дополнительную информацию см. в разделе Создание политик запросов к источнику в Руководстве разработчика Amazon CloudFront.

Сложный тип, который определяет заголовки, которые вы хотите, чтобы CloudFront передавал источнику для этого поведения кэширования (заголовки в белом списке). Для указанных заголовков CloudFront также кэширует отдельные версии указанного объекта, основанные на значениях заголовков в запросах зрителей.

Дополнительную информацию см. в разделе Кэширование контента на основе заголовков запроса в Руководстве разработчика Amazon CloudFront.

Quantity -> (integer)

Количество имён заголовков в списке Items.

Items -> (list)

Список имён HTTP-заголовков.

(string)

QueryStringCacheKeys -> (structure)

Сложный тип, содержащий информацию о параметрах строки запроса, которые вы хотите, чтобы CloudFront использовал для кэширования для данного поведения кэширования.

Quantity -> (integer)

Количество whitelisted параметров строки запроса для поведения кэширования.

Items -> (list)

Список, содержащий параметры строки запроса, которые вы хотите, чтобы CloudFront использовал в качестве основы для кэширования для поведения кэширования. Если Quantity равно 0, вы можете опустить Items.

(string)

MinTTL -> (long)

Это поле устарело. Рекомендуется использовать поле MinTTL в политике кэширования вместо этого поля. Дополнительную информацию см. в разделах Создание политик кэширования или Использование управляемых политик кэширования в Руководстве разработчика Amazon CloudFront.

Минимальное время, в течение которого вы хотите, чтобы объекты оставались в кэшах CloudFront, прежде чем CloudFront направит еще один запрос вашему источнику, чтобы определить, был ли объект обновлен. Дополнительную информацию см. в разделе Управление временем хранения контента в кэше Edge (срок действия) в Руководстве разработчика Amazon CloudFront.

Вы должны указать 0 для MinTTL, если вы настроили CloudFront на передачу всех заголовков вашему источнику (в рамках Headers, если вы укажете 1 для Quantity и * для Name).

DefaultTTL -> (long)

Это поле устарело. Рекомендуется использовать поле DefaultTTL в политике кэширования вместо этого поля. Дополнительную информацию см. в разделе Создание политик кэширования или Использование управляемых политик кэширования в руководстве Amazon CloudFront Developer Guide.

Указанное количество времени, в течение которого объекты должны храниться в кэшах CloudFront, прежде чем CloudFront перенаправит еще один запрос к вашему источнику, чтобы определить, был ли объект обновлен. Указанное значение применяется только в том случае, если ваш источник не добавляет такие HTTP-заголовки, как Cache-Control max-age , Cache-Control s-maxage и Expires к объектам. Дополнительную информацию см. в разделе Управление временем хранения контента в кэше на границе (Истечение срока действия) в руководстве Amazon CloudFront Developer Guide.

MaxTTL -> (long)

Это поле устарело. Рекомендуется использовать поле MaxTTL в политике кэширования вместо этого поля. Дополнительную информацию см. в разделе Создание политик кэширования или Использование управляемых политик кэширования в руководстве Amazon CloudFront Developer Guide.

Максимальное время, в течение которого объекты должны храниться в кэшах CloudFront, прежде чем CloudFront перенаправит еще один запрос к вашему источнику, чтобы определить, был ли объект обновлен. Указанное значение применяется только в том случае, если ваш источник добавляет такие HTTP-заголовки, как Cache-Control max-age , Cache-Control s-maxage и Expires к объектам. Дополнительную информацию см. в разделе Управление временем хранения контента в кэше на границе (Истечение срока действия) в руководстве Amazon CloudFront Developer Guide.

CacheBehaviors -> (structure)

Сложный тип, содержащий ноль или более элементов CacheBehavior.

Количество -> (целое число)

Количество поведений кэширования для этого распределения.

Элементы -> (список)

Необязательный: сложный тип, содержащий поведения кэширования для этого распределения. Если Quantity является 0, вы можете опустить Items.

(структура)

Сложный тип, описывающий, как CloudFront обрабатывает запросы.

Вы должны создать по крайней мере столько же поведений кэширования (включая поведение кэширования по умолчанию), сколько у вас есть источников, если вы хотите, чтобы CloudFront обслуживал объекты со всех источников. Каждое поведение кэширования указывает один источник, из которого CloudFront должен получать объекты. Если у вас два источника и только поведение кэширования по умолчанию, поведение кэширования по умолчанию заставит CloudFront получить объекты из одного из источников, но другой источник никогда не используется.

О текущем квоте (ранее известной как лимит) на количество поведений кэширования, которые можно добавить к распределению, см. раздел «Квоты» в руководстве разработчика Amazon CloudFront.

Если вы не хотите указывать какие-либо поведения кэширования, включите только пустой элемент CacheBehaviors. Не указывайте пустой отдельный элемент CacheBehavior, так как это некорректно. Для получения дополнительной информации см. CacheBehaviors.

Чтобы удалить все поведения кэширования в существующем распределении, обновите конфигурацию распределения и включите только пустой элемент CacheBehaviors.

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

Дополнительную информацию о поведении кэширования см. в разделе «Настройки поведения кэширования» в руководстве разработчика Amazon CloudFront.

Шаблон пути -> (строка)

Шаблон (например, images/*.jpg), определяющий, к каким запросам следует применить поведение. Когда CloudFront получает запрос от пользователя, запрошенный путь сравнивается с шаблонами путей в том порядке, в котором поведения кэширования перечислены в распределении.

Примечание

Вы можете необязательно включить слеш (/) в начале шаблона пути. Например, /images/*.jpg. Поведение CloudFront одинаково с ведущим / или без него.

Шаблон пути для поведения кэширования по умолчанию — *, и его нельзя изменить. Если запрос на объект не соответствует шаблону пути ни для одного поведения кэширования, CloudFront применяет поведение по умолчанию.

Дополнительную информацию см. в разделе «Шаблон пути» в руководстве разработчика Amazon CloudFront.

Идентификатор целевого источника -> (строка)

Значение ID для источника, к которому CloudFront должен перенаправлять запросы, когда они соответствуют этому поведению кэширования.

Подтвержденные подписывающие стороны -> (структура)

Предупреждение

Рекомендуется использовать TrustedKeyGroups вместо TrustedSigners.

Список идентификаторов учетных записей Amazon Web Services, открытые ключи которых CloudFront может использовать для проверки подписанных URL-адресов или подписанных файлов cookie.

Когда поведение кэширования содержит подтвержденные подписывающие стороны, CloudFront требует подписанных URL-адресов или подписанных файлов cookie для всех запросов, соответствующих поведению кэширования. URL-адреса или файлы cookie должны быть подписаны приватным ключом пары ключей CloudFront в учетной записи Amazon Web Services подтвержденной подписывающей стороны. Подписанный URL-адрес или файл cookie содержит информацию о том, какой открытый ключ CloudFront должен использовать для проверки подписи. Дополнительную информацию см. в разделе «Обслуживание частного контента» в руководстве разработчика Amazon CloudFront.

Включено -> (булево)

Это поле true, если какая-либо из учетных записей Amazon Web Services в списке настроена как подтвержденная подписывающая сторона. В противном случае это поле false.

Количество -> (целое число)

Количество учетных записей Amazon Web Services в списке.

Элементы -> (список)

Список идентификаторов учетных записей Amazon Web Services.

(строка)

Подтвержденные группы ключей -> (структура)

Когда поведение кэширования содержит подтвержденные группы ключей, CloudFront требует подписанных URL-адресов или подписанных файлов cookie для всех запросов, соответствующих поведению кэширования. URL-адреса или файлы cookie должны быть подписаны приватным ключом, соответствующий открытый ключ которого находится в группе ключей. Подписанный URL-адрес или файл cookie содержит информацию о том, какой открытый ключ CloudFront должен использовать для проверки подписи. Дополнительную информацию см. в разделе «Обслуживание частного контента» в руководстве разработчика Amazon CloudFront.

Включено -> (булево)

Это поле true, если какие-либо из групп ключей в списке содержат открытые ключи, которые CloudFront может использовать для проверки подписей подписанных URL-адресов и файлов cookie. В противном случае это поле false.

Количество -> (целое число)

Количество групп ключей в списке.

Элементы -> (список)

Список идентификаторов групп ключей.

(строка)

Политика протокола зрителя -> (строка)

Протокол, который зрители могут использовать для доступа к файлам в источнике, указанном в TargetOriginId, когда запрос соответствует шаблону пути в PathPattern. Вы можете указать следующие варианты:

allow-all: Зрители могут использовать HTTP или HTTPS.
redirect-to-https: Если зритель отправляет запрос HTTP, CloudFront возвращает HTTP-код состояния 301 (Постоянно перемещено) зрителю вместе с HTTPS-URL. Затем зритель повторно отправляет запрос с использованием нового URL-адреса.
https-only: Если зритель отправляет запрос HTTP, CloudFront возвращает HTTP-код состояния 403 (Запрещено).

Дополнительную информацию о требовании к протоколу HTTPS см. в разделе «Требование к протоколу HTTPS между зрителями и CloudFront» в руководстве разработчика Amazon CloudFront.

Примечание

Единственный способ гарантировать, что зрители получат объект, который был получен из источника с использованием HTTPS, — это никогда не использовать любой другой протокол для получения объекта. Если вы недавно перешли с HTTP на HTTPS, рекомендуется очистить кэш ваших объектов, так как кэшированные объекты не зависят от протокола. Это означает, что узловой узел вернёт объект из кэша независимо от того, соответствует ли текущий протокол запроса протоколу, используемому ранее. Дополнительную информацию см. в разделе «Управление сроком действия кэша» в руководстве разработчика Amazon CloudFront.

Разрешенные методы -> (структура)

Сложный тип, управляющий HTTP-методами, которые CloudFront обрабатывает и пересылает вашему хранилищу Amazon S3 или вашему пользовательскому источнику. Существует три варианта:

CloudFront пересылает только запросы GET и HEAD.
CloudFront пересылает только запросы GET, HEAD и OPTIONS.
CloudFront пересылает запросы GET, HEAD, OPTIONS, PUT, PATCH, POST и DELETE.

Если вы выберете третий вариант, вам может потребоваться ограничить доступ к вашему хранилищу Amazon S3 или вашему пользовательскому источнику, чтобы пользователи не могли выполнять операции, которых вы не хотите. Например, вы, возможно, не захотите, чтобы пользователи имели разрешения на удаление объектов из вашего источника.

Количество -> (целое число)

Количество HTTP-методов, которые вы хотите, чтобы CloudFront передавал вашему источнику. Допустимые значения: 2 (для запросов GET и HEAD), 3 (для запросов GET, HEAD и OPTIONS) и 7 (для запросов GET, HEAD, OPTIONS, PUT, PATCH, POST и DELETE).

Элементы -> (список)

Сложный тип, содержащий HTTP-методы, которые вы хотите, чтобы CloudFront обрабатывал и пересылал вашему источнику.

(строка)

Кэшируемые методы -> (структура)

Сложный тип, управляющий тем, кэширует ли CloudFront ответ на запросы, используя указанные HTTP-методы. Существует два варианта:

CloudFront кэширует ответы на запросы GET и HEAD.
CloudFront кэширует ответы на запросы GET, HEAD и OPTIONS.

Количество -> (целое число)

Элементы -> (список)

Сложный тип, содержащий HTTP-методы, для которых вы хотите, чтобы CloudFront кэшировал ответы. Допустимые значения для CachedMethods включают GET, HEAD и OPTIONS, в зависимости от выбранного варианта кэширования. Дополнительную информацию см. в предыдущем разделе.

(строка)

SmoothStreaming -> (булево)

Указывает, хотите ли вы распределить медиафайлы в формате Microsoft Smooth Streaming с помощью источника, связанного с этим поведением кэширования. В таком случае укажите true; в противном случае укажите false. Если вы укажите true для SmoothStreaming, вы по-прежнему можете распределять другой контент с помощью этого поведения кэширования, если контент соответствует значению PathPattern.

Сжать -> (булево)

Хотите ли вы, чтобы CloudFront автоматически сжимал определенные файлы для этого поведения кэширования. Если да, укажите true; если нет, укажите false. Дополнительную информацию см. в разделе «Обслуживание сжатых файлов» в руководстве разработчика Amazon CloudFront.

Связанные функции Lambda -> (структура)

Сложный тип, содержащий ноль или более ассоциаций функций Lambda@Edge для поведения кэша.

Количество -> (целое число)

Количество ассоциаций функций Lambda@Edge для данного поведения кэша.

Элементы -> (список)

Необязательно : Сложный тип, содержащий LambdaFunctionAssociation элементы для данного поведения кэша. Если Quantity является 0, вы можете опустить Items.

(структура)

Сложный тип, содержащий ассоциацию функции Lambda@Edge.

LambdaFunctionARN -> (строка)

ARN функции Lambda@Edge. Вы должны указать ARN версии функции; вы не можете указать псевдоним или $LATEST.

EventType -> (строка)

Указывает тип события, который запускает вызов функции Lambda@Edge. Вы можете указать следующие значения:

viewer-request : Функция выполняется, когда CloudFront получает запрос от зрителя и перед проверкой наличия запрошенного объекта в кэше на границе.
origin-request : Функция выполняется только тогда, когда CloudFront отправляет запрос в ваш источник. Когда запрошенный объект находится в кэше на границе, функция не выполняется.
origin-response : Функция выполняется после получения CloudFront ответа от источника и перед сохранением объекта в кэше в ответе. Когда запрошенный объект находится в кэше на границе, функция не выполняется.
viewer-response : Функция выполняется перед тем, как CloudFront возвращает запрошенный объект зрителю. Функция выполняется независимо от того, был ли объект уже в кэше на границе. Если источник возвращает код состояния HTTP, отличный от HTTP 200 (OK), функция не выполняется.

IncludeBody -> (булево)

Флаг, который позволяет функции Lambda@Edge иметь доступ для чтения к содержимому тела. Для получения дополнительной информации см. Доступ к телу запроса, выбрав параметр Включить тело в руководстве разработчика Amazon CloudFront.

FunctionAssociations -> (структура)

Список функций CloudFront, связанных с этим поведением кэша. Функции CloudFront должны быть опубликованы в стадии LIVE, чтобы связать их с поведением кэша.

Количество -> (целое число)

Количество функций CloudFront в списке.

Элементы -> (список)

Функции CloudFront, связанные с поведением кэша в распределении CloudFront. Ваши функции должны быть опубликованы в стадии LIVE, чтобы связать их с поведением кэша.

(структура)

Функция CloudFront, связанная с поведением кэша в распределении CloudFront.

FunctionARN -> (строка)

Amazon Resource Name (ARN) функции.

EventType -> (строка)

FieldLevelEncryptionId -> (строка)

Значение ID для конфигурации шифрования на уровне поля, которую вы хотите использовать для шифрования определенных полей данных для данного поведения кэша.

RealtimeLogConfigArn -> (строка)

Amazon Resource Name (ARN) конфигурации журнала в реальном времени, присоединенной к данному поведению кэша. Для получения дополнительной информации см. Журналы в реальном времени в руководстве разработчика Amazon CloudFront.

CachePolicyId -> (строка)

Уникальный идентификатор политики кэширования, присоединенной к данному поведению кэша. Для получения дополнительной информации см. Создание политик кэширования или Использование управляемых политик кэширования в руководстве разработчика Amazon CloudFront.

CacheBehavior должна содержать либо CachePolicyId, либо ForwardedValues. Рекомендуется использовать CachePolicyId.

OriginRequestPolicyId -> (строка)

Уникальный идентификатор политики запроса к источнику, присоединенной к данному поведению кэша. Для получения дополнительной информации см. Создание политик запросов к источнику или Использование управляемых политик запросов к источнику в руководстве разработчика Amazon CloudFront.

ResponseHeadersPolicyId -> (строка)

Идентификатор политики заголовков ответа.

GrpcConfig -> (структура)

Конфигурация gRPC для вашего поведения кэша.

Enabled -> (булево)

Включает возможность вашего распределения CloudFront принимать запросы gRPC и проксировать их напрямую в ваши источники.

ForwardedValues -> (структура)

Это поле устарело. Мы рекомендуем использовать политику кэширования или политику запроса к источнику вместо этого поля. Дополнительную информацию см. в руководстве разработчика Amazon CloudFront в разделе «Работа с политиками».

Если вы хотите включить значения в ключ кэша, используйте политику кэширования. Дополнительную информацию см. в руководстве разработчика Amazon CloudFront в разделах «Создание политик кэширования» или «Использование управляемых политик кэширования».

Если вы хотите отправить значения источнику, но не включать их в ключ кэша, используйте политику запроса к источнику. Дополнительную информацию см. в руководстве разработчика Amazon CloudFront в разделах «Создание политик запроса к источнику» или «Использование управляемых политик запроса к источнику».

Тип CacheBehavior должен содержать либо CachePolicyId, либо ForwardedValues. Мы рекомендуем использовать CachePolicyId.

Сложный тип, который определяет, как CloudFront обрабатывает строки запроса, куки и HTTP-заголовки.

QueryString -> (boolean)

Это поле устарело. Мы рекомендуем использовать политику кэширования или политику запроса к источнику вместо этого поля.

Если вы хотите включить строки запроса в ключ кэша, используйте политику кэширования. Дополнительную информацию см. в руководстве разработчика Amazon CloudFront в разделе «Создание политик кэширования».

Если вы хотите отправить строки запроса источнику, но не включать их в ключ кэша, используйте политику запроса к источнику. Дополнительную информацию см. в руководстве разработчика Amazon CloudFront в разделе «Создание политик запроса к источнику».

Указывает, хотите ли вы, чтобы CloudFront пересылал строки запроса источнику, связанному с этим поведением кэша и кэшировал на основе параметров строки запроса. Поведение CloudFront зависит от значения QueryString и от указанных вами значений для QueryStringCacheKeys, если таковые имеются:

Если вы укажете значение true для QueryString и не укажете никаких значений для QueryStringCacheKeys, CloudFront пересылает все параметры строки запроса источнику и кэширует на основе всех параметров строки запроса. В зависимости от количества параметров и значений строки запроса это может отрицательно сказаться на производительности, поскольку CloudFront должен пересылать больше запросов источнику.

Если вы укажете значение true для QueryString и укажете одно или несколько значений для QueryStringCacheKeys, CloudFront пересылает все параметры строки запроса источнику, но кэширует только на основе параметров строки запроса, которые вы указали.

Если вы укажете значение false для QueryString, CloudFront не пересылает никакие параметры строки запроса источнику и не кэширует на основе параметров строки запроса.

Дополнительную информацию см. в руководстве разработчика Amazon CloudFront в разделе «Настройка CloudFront для кэширования на основе параметров строки запроса».

Cookies -> (structure)

Если вы хотите включить куки в ключ кэша, используйте политику кэширования. Дополнительную информацию см. в руководстве разработчика Amazon CloudFront в разделе «Создание политик кэширования».

Если вы хотите отправить куки источнику, но не включать их в ключ кэша, используйте политику запроса к источнику. Дополнительную информацию см. в руководстве разработчика Amazon CloudFront в разделе «Создание политик запроса к источнику».

Сложный тип, который определяет, хотите ли вы, чтобы CloudFront пересылал куки источнику, и, если да, то какие. Дополнительную информацию о пересылке куки источнику см. в руководстве разработчика Amazon CloudFront в разделе «Как CloudFront пересылает, кэширует и регистрирует куки».

Forward -> (string)

Определяет, какие куки пересылать источнику для этого поведения кэша: все, ни одного или список куки, указанных в сложном типе WhitelistedNames.

Amazon S3 не обрабатывает куки. Если поведение кэша пересылает запросы в источник Amazon S3, укажите none для элемента Forward.

WhitelistedNames -> (structure)

Требуется, если вы укажете whitelist для значения Forward. Сложный тип, который определяет количество различных куки, которые вы хотите, чтобы CloudFront пересылал источнику для этого поведения кэша и, если вы хотите пересылать выбранные куки, имена этих куки.

См. пределы CloudFront в справке Amazon Web Services General Reference для текущего ограничения на количество имен куки, которые можно добавить в белый список для каждого поведения кэша.

Quantity -> (integer)

Количество имен куки в списке Items.

Items -> (list)

Список имен куки.

(string)

Headers -> (structure)

Если вы хотите включить заголовки в ключ кэша, используйте политику кэширования. Дополнительную информацию см. в руководстве разработчика Amazon CloudFront в разделе «Создание политик кэширования».

Если вы хотите отправить заголовки источнику, но не включать их в ключ кэша, используйте политику запроса к источнику. Дополнительную информацию см. в руководстве разработчика Amazon CloudFront в разделе «Создание политик запроса к источнику».

Сложный тип, который определяет заголовки, которые вы хотите, чтобы CloudFront пересылал источнику для данного поведения кэша (заголовки в белом списке). Для указанных заголовков CloudFront также кэширует отдельные версии указанного объекта, основанные на значениях заголовков в запросах зрителей.

Дополнительную информацию см. в руководстве разработчика Amazon CloudFront в разделе «Кэширование содержимого на основе заголовков запроса».

Quantity -> (integer)

Количество имён заголовков в списке Items.

Items -> (list)

Список имён HTTP-заголовков.

(string)

QueryStringCacheKeys -> (structure)

Сложный тип, содержащий информацию о параметрах строки запроса, которые вы хотите использовать CloudFront для кэширования для этого поведения кэша.

Quantity -> (integer)

Количество параметров строки запроса whitelisted для поведения кэша.

Items -> (list)

Список, содержащий параметры строки запроса, которые вы хотите использовать CloudFront в качестве основы для кэширования для поведения кэша. Если Quantity равно 0, вы можете опустить Items.

(string)

MinTTL -> (long)

Это поле устарело. Мы рекомендуем использовать поле MinTTL в политике кэширования вместо этого поля. Дополнительную информацию см. в руководстве разработчика Amazon CloudFront в разделах «Создание политик кэширования» или «Использование управляемых политик кэширования».

Минимальное время, в течение которого вы хотите, чтобы объекты оставались в кэшах CloudFront, прежде чем CloudFront направит другой запрос вашему источнику, чтобы определить, был ли объект обновлен. Дополнительную информацию см. в руководстве разработчика Amazon CloudFront в разделе «Управление сроком хранения содержимого в кэше края (срок действия)».

Вы должны указать 0 для MinTTL, если вы настроили CloudFront на пересылку всех заголовков вашему источнику (в Headers, если вы укажете 1 для Quantity и * для Name).

DefaultTTL -> (long)

Это поле устарело. Мы рекомендуем использовать поле DefaultTTL в политике кэширования вместо этого поля. Дополнительную информацию см. в руководстве разработчика Amazon CloudFront в разделах «Создание политик кэширования» или «Использование управляемых политик кэширования».

Значение по умолчанию, в течение которого вы хотите, чтобы объекты оставались в кэшах CloudFront, прежде чем CloudFront отправит другой запрос вашему источнику, чтобы определить, был ли объект обновлен. Это значение применяется только тогда, когда ваш источник не добавляет HTTP-заголовки, такие как Cache-Control max-age, Cache-Control s-maxage и Expires к объектам. Дополнительную информацию см. в руководстве разработчика Amazon CloudFront в разделе «Управление сроком хранения содержимого в кэше края (срок действия)».

MaxTTL -> (long)

Это поле устарело. Мы рекомендуем использовать поле MaxTTL в политике кэширования вместо этого поля. Дополнительную информацию см. в руководстве разработчика Amazon CloudFront в разделах «Создание политик кэширования» или «Использование управляемых политик кэширования».

Максимальное время, в течение которого вы хотите, чтобы объекты оставались в кэшах CloudFront, прежде чем CloudFront направит другой запрос вашему источнику, чтобы определить, был ли объект обновлен. Это значение применяется только тогда, когда ваш источник добавляет HTTP-заголовки, такие как Cache-Control max-age, Cache-Control s-maxage и Expires, к объектам. Дополнительную информацию см. в руководстве разработчика Amazon CloudFront в разделе «Управление сроком хранения содержимого в кэше края (срок действия)».

CustomErrorResponses -> (structure)

Сложный тип, содержащий ноль или более элементов CustomErrorResponses.

Количество -> (целое число)

Количество кодов состояния HTTP, для которых вы хотите указать пользовательскую страницу ошибки и/или время кэширования. Если Quantity равно 0, вы можете опустить Items.

Элементы -> (список)

Сложный тип, содержащий элемент CustomErrorResponse для каждого кода состояния HTTP, для которого вы хотите указать пользовательскую страницу ошибки и/или время кэширования.

(структура)

Сложный тип, который управляет:

Замещает ли CloudFront коды состояния HTTP в диапазоне 4xx и 5xx пользовательскими сообщениями об ошибках перед отправкой ответа просмотру.
Сколько времени CloudFront кэширует коды состояния HTTP в диапазоне 4xx и 5xx.

Дополнительную информацию о пользовательских страницах ошибок см. в разделе «Настройка ответов на ошибки» в руководстве разработчика Amazon CloudFront.

КодОшибки -> (целое число)

Код состояния HTTP, для которого вы хотите указать пользовательскую страницу ошибки и/или время кэширования.

ПутьКСтраницеОтвета -> (строка)

Путь к пользовательской странице ошибки, которую CloudFront должен вернуть просмотру, когда ваш источник возвращает код состояния HTTP, указанный в ErrorCode, например, /4xx-errors/403-forbidden.html. Если вы хотите хранить свои объекты и пользовательские страницы ошибок в разных местах, ваша распределение должна включать поведение кэша, для которого справедливо следующее:

Значение PathPattern соответствует пути к вашим пользовательским сообщениям об ошибках. Например, предположим, что вы сохранили пользовательские страницы ошибок для ошибок 4xx в ведре Amazon S3 в каталоге с именем /4xx-errors. Ваша распределение должна включать поведение кэша, для которого шаблон пути направляет запросы на ваши пользовательские страницы ошибок в это место, например, /4xx-errors/*.
Значение TargetOriginId указывает значение элемента ID для источника, содержащего ваши пользовательские страницы ошибок.

Если вы укажете значение для ResponsePagePath, вы также должны указать значение для ResponseCode.

Рекомендуется хранить пользовательские страницы ошибок в ведре Amazon S3. Если вы храните пользовательские страницы ошибок на HTTP-сервере, и сервер начинает возвращать ошибки 5xx, CloudFront не сможет получить файлы, которые вы хотите вернуть просмотру, потому что исходный сервер недоступен.

КодОтвета -> (строка)

Код состояния HTTP, который CloudFront должен вернуть просмотру вместе с пользовательской страницей ошибки. Существует множество причин, по которым вы можете захотеть, чтобы CloudFront возвращал код состояния, отличный от кода состояния, который ваш источник вернул CloudFront, например:

Некоторые интернет-устройства (например, некоторые брандмауэры и корпоративные прокси) перехватывают HTTP 4xx и 5xx и не позволяют возвращать ответ просмотру. Если вы замените 200, ответ обычно не будет перехвачен.
Если вы не заботитесь о различении между разными клиентскими ошибками или ошибками сервера, вы можете указать 400 или 500 в качестве ResponseCode для всех ошибок 4xx или 5xx.
Возможно, вы захотите вернуть код состояния 200 (OK) и статическую страницу сайта, чтобы ваши клиенты не знали, что ваш сайт не работает.

Если вы укажете значение для ResponseCode, вы также должны указать значение для ResponsePagePath.

МинимумКэшированияОшибок -> (длинное целое)

Минимальное время в секундах, которое CloudFront должен кэшировать код состояния HTTP, указанный в ErrorCode. После истечения этого периода CloudFront обращается к вашему источнику, чтобы проверить, была ли решена проблема, вызвавшая ошибку, и запрашиваемый объект теперь доступен.

Дополнительную информацию см. в разделе «Настройка ответов на ошибки» в руководстве разработчика Amazon CloudFront.

Комментарий -> (строка)

Комментарий, изначально указанный при создании этого распределения.

КлассЦен -> (строка)

Сложный тип, содержащий информацию о классе цен для этого потокового распределения.

Включено -> (булево)

Включено ли распределение для приема пользовательских запросов на контент.

СертификатПросмотра -> (структура)

Сложный тип, определяющий конфигурацию SSL/TLS распределения для связи со зрителями.

СертификатCloudFrontПоУмолчанию -> (булево)

Если распределение использует домен CloudFront, такой как d111111abcdef8.cloudfront.net, установите это поле в true.

Если распределение использует Aliases (альтернативные доменные имена или CNAME), установите это поле в false и укажите значения для следующих полей:

ACMCertificateArn или IAMCertificateId (укажите значение для одного, а не для обоих)
MinimumProtocolVersion
SSLSupportMethod

IAMCertificateId -> (строка)

Если распределение использует Aliases (альтернативные доменные имена или CNAME), а сертификат SSL/TLS хранится в Identity and Access Management (IAM), укажите идентификатор сертификата IAM.

Если вы укажете идентификатор сертификата IAM, вы также должны указать значения для MinimumProtocolVersion и SSLSupportMethod.

ACMCertificateArn -> (строка)

Если распределение использует Aliases (альтернативные доменные имена или CNAME), а сертификат SSL/TLS хранится в Certificate Manager (ACM), укажите Amazon Resource Name (ARN) сертификата ACM. CloudFront поддерживает только сертификаты ACM в регионе США (северо-восточная Вирджиния) (us-east-1).

Если вы укажете ARN сертификата ACM, вы также должны указать значения для MinimumProtocolVersion и SSLSupportMethod.

МетодПоддержкиSSL -> (строка)

Если распределение использует Aliases (альтернативные доменные имена или CNAME), укажите, от каких зрителей распределение принимает подключения HTTPS.

sni-only – Распределение принимает подключения HTTPS только от зрителей, поддерживающих указание имени сервера (SNI). Это рекомендуется. Большинство браузеров и клиентов поддерживают SNI.
vip – Распределение принимает подключения HTTPS от всех зрителей, включая тех, кто не поддерживает SNI. Это не рекомендуется и влечет дополнительные ежемесячные расходы со стороны CloudFront.
static-ip - Не указывайте это значение, если ваша распределение не была включена для этой функции командой CloudFront. Если вам требуется использование статических IP-адресов для распределения, свяжитесь с CloudFront через центр поддержки Amazon Web Services.

Если распределение использует домен CloudFront, например, d111111abcdef8.cloudfront.net, не устанавливайте значение для этого поля.

МинимальнаяВерсияПротокола -> (строка)

Если распределение использует Aliases (альтернативные доменные имена или CNAME), укажите политику безопасности, которую CloudFront должен использовать для HTTPS-соединений со зрителями. Политика безопасности определяет два параметра:

Минимальный протокол SSL/TLS, который CloudFront может использовать для связи со зрителями.
Шифры, которые CloudFront может использовать для шифрования контента, который он возвращает просмотру.

Дополнительную информацию см. в разделе «Политика безопасности и поддерживаемые протоколы и шифры между зрителями и CloudFront» в руководстве разработчика Amazon CloudFront.

Примечание

В консоли CloudFront этот параметр называется Политика безопасности.

При использовании только SNI (вы устанавливаете SSLSupportMethod в sni-only), вы должны указать TLSv1 или выше.

Если распределение использует домен CloudFront, например, d111111abcdef8.cloudfront.net (вы устанавливаете CloudFrontDefaultCertificate в true), CloudFront автоматически устанавливает политику безопасности в TLSv1 независимо от значения, которое вы установили здесь.

Сертификат -> (строка)

Это поле устарело. Используйте вместо него одно из следующих полей:

ACMCertificateArn
IAMCertificateId
CloudFrontDefaultCertificate

ИсточникСертификата -> (строка)

Это поле устарело. Используйте вместо него одно из следующих полей:

ACMCertificateArn
IAMCertificateId
CloudFrontDefaultCertificate

Ограничения -> (структура)

Сложный тип, определяющий способы ограничения распространения вашего контента.

ГеографическоеОграничение -> (структура)

Сложный тип, который управляет странами, в которых распространяется ваш контент. CloudFront определяет местоположение ваших пользователей, используя базы данных GeoIP.

ТипОграничения -> (строка)

Метод, который вы хотите использовать для ограничения распространения вашего контента по странам:

none: Географические ограничения не включены, это означает, что доступ к контенту не ограничен географическим положением клиента.
blacklist: Элементы Location указывают страны, в которых вы не хотите, чтобы CloudFront распространял ваш контент.
whitelist: Элементы Location указывают страны, в которых вы хотите, чтобы CloudFront распространял ваш контент.

Количество -> (целое число)

При включенном географическом ограничении это количество стран в вашем whitelist или blacklist. В противном случае, если оно не включено, Quantity равно 0, и вы можете опустить Items.

Элементы -> (список)

Сложный тип, содержащий элемент Location для каждой страны, в которой вы хотите, чтобы CloudFront либо распространял ваш контент (whitelist), либо не распространял ваш контент (blacklist).

Элемент Location представляет собой двухбуквенный код страны в верхнем регистре для страны, которую вы хотите включить в ваше blacklist или whitelist. Включите по одному элементу Location для каждой страны.

CloudFront и MaxMind оба используют коды стран ISO 3166. Для текущего списка стран и соответствующих кодов см. ISO 3166-1-alpha-2 на сайте Международной организации по стандартизации. Вы также можете обратиться к списку стран в консоли CloudFront, который включает как названия стран, так и коды.

(строка)

IdWebACL -> (строка)

Идентификатор Web ACL (при наличии), связанный с распределением.

ВерсияHttp -> (строка)

Укажите максимальную версию HTTP, которую вы хотите использовать для связи просмотрующих с CloudFront. Значение по умолчанию для новых веб-распределений — http2. Просмотрующие, которые не поддерживают HTTP/2, автоматически будут использовать более раннюю версию.

IsIPV6Enabled -> (boolean)

Указывает, отвечает ли CloudFront на запросы DNS IPv6 с адресом IPv6 для вашего распределения.

AliasICPRecordals -> (list)

Клиентам Amazon Web Services в Китае необходимо подать заявку на регистрацию интернет-провайдера (ICP), если они хотят публиковать контент по альтернативному доменному имени, также известному как CNAME, добавленному в CloudFront. AliasICPRecordal предоставляет статус регистрации ICP для CNAME, связанных с распределениями.

Дополнительную информацию о регистрации ICP см. в разделе «Регистрация, учетные записи и учетные данные» в руководстве Начало работы с услугами Amazon Web Services в Китае.

(structure)

CNAME -> (string)

Доменное имя, связанное с распределением.

ICPRecordalStatus -> (string)

Статус регистрации интернет-провайдера (ICP) для CNAME. Статус ICPRecordalStatus установлен в APPROVED для всех CNAME (псевдонимов) в регионах Amazon Web Services за пределами Китая.

Возможные значения статуса:

APPROVED указывает, что у связанного CNAME есть действительный номер регистрации ICP. К одному распределению может быть привязано несколько CNAME, и CNAME могут соответствовать разным регистрационным номерам ICP. Для получения статуса APPROVED (т. е. для использования в регионах Китая) CNAME должен иметь один связанный номер регистрации ICP.
SUSPENDED указывает, что у связанного CNAME нет действительного номера регистрации ICP.
PENDING указывает, что CloudFront не может определить статус регистрации ICP для CNAME, связанного с распределением, потому что при попытке определить статус произошла ошибка. Вы можете повторить попытку, чтобы проверить, устранена ли ошибка, в этом случае CloudFront вернёт статус APPROVED или SUSPENDED.

Staging -> (boolean)

Логическое значение, указывающее, является ли это тестовым распределением. Если значение равно true, это тестовое распределение. Если значение равно false, это не тестовое распределение.

ConnectionMode -> (string)

Режим соединения для фильтрации распределений.

AnycastIpListId -> (string)

ID списка статических IP-адресов Anycast, связанных с распределением.

END_OF_DOCUMENT_MARKER