Spec-Zone.ru › Ansible

Модуль community.aws.cloudfront_distribution — создание, обновление и удаление дистрибутивов AWS CloudFront

Примечание

Этот модуль входит в коллекцию community.aws (версия 10.1.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Чтобы установить её, используйте: ansible-galaxy collection install community.aws. Для использования этого модуля требуются дополнительные компоненты; подробности см. в разделе Требования.

Чтобы использовать модуль в плейбуке, укажите: community.aws.cloudfront_distribution.

Добавлено в community.aws 1.0.0

  • Обзор
  • Требования
  • Параметры
  • Примечания
  • Примеры
  • Возвращаемые значения

Обзор

  • Позволяет легко создавать, обновлять и удалять дистрибутивы CloudFront.

Требования

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

  • python >= 3.6
  • boto3 >= 1.34.0
  • botocore >= 1.34.0

Параметры

Параметр

Комментарии

access_key

aliases: aws_access_key_id, aws_access_key

string

Идентификатор ключа доступа AWS.

Дополнительные сведения о токенах доступа см. в документации AWS: https://docs.aws.amazon.com/general/latest/gr/aws-sec-cred-types.html#access-keys-and-secret-access-keys.

Также можно использовать переменные среды AWS_ACCESS_KEY_ID или AWS_ACCESS_KEY в порядке убывания приоритета.

Параметры aws_access_key и profile нельзя использовать одновременно.

Псевдоним aws_access_key_id добавлен в выпуске 5.1.0 для единообразия с AWS botocore SDK.

alias

string

Имя псевдонима (CNAME), используемого в дистрибутиве. Это позволяет обращаться к дистрибутиву по его псевдониму, поскольку один псевдоним можно использовать только для одного дистрибутива в учетной записи AWS. Благодаря этому параметру не нужно указывать distribution_id вместе с e_tag или caller_reference существующего дистрибутива.

aliases

list / elements=string

Список псевдонимов доменных имен (CNAME) в виде строк, используемых для дистрибутива.

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

По умолчанию: []

aws_ca_bundle

path

Путь к пакету центров сертификации (CA), используемому при проверке SSL-сертификатов.

Также можно использовать переменную среды AWS_CA_BUNDLE.

aws_config

dictionary

Словарь для изменения конфигурации botocore.

Параметры описаны в документации AWS: https://botocore.amazonaws.com/v1/documentation/api/latest/reference/config.html#botocore.config.Config.

cache_behaviors

list / elements=dictionary

Список словарей с описанием поведения кэширования для дистрибутива.

Порядок элементов списка сохраняется при последующих запусках, если не включен параметр purge_cache_behaviors.

allowed_methods

dictionary

Словарь, определяющий, какие методы HTTP обрабатывает и пересылает CloudFront.

cached_methods

list / elements=string

Список методов HTTP, для которых CloudFront должен выполнять кэширование.

Это может быть [GET,HEAD] или [GET,HEAD,OPTIONS].

items

list / elements=string

Список методов HTTP, которые CloudFront должен обрабатывать и пересылать.

cache_policy_id

string

добавлен в community.aws 7.1.0

Идентификатор политики кэширования, которую CloudFront должен использовать для данного поведения кэширования.

Для поведения следует указать либо параметр cache_policy_id, либо forwarded_values.

Дополнительные сведения см. в документации CloudFront: https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/controlling-the-cache-key.html

compress

boolean

Нужно ли CloudFront автоматически сжимать файлы.

Варианты:

  • false
  • true

default_ttl

integer

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

field_level_encryption_id

string

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

forwarded_values

dictionary

Словарь, определяющий способ обработки строк запроса и файлов cookie в CloudFront.

Для поведения следует указать либо параметр cache_policy_id, либо forwarded_values.

cookies

dictionary

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

forward

string

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

Допустимые значения: all, none или whitelist.

whitelisted_names

list / elements=string

Список файлов cookie, пересылаемых источнику для данного поведения кэширования.

headers

list / elements=string

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

Чтобы пересылать все заголовки, используйте список с одним элементом «*» (['*'])

query_string

boolean

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

Варианты:

  • false
  • true

query_string_cache_keys

list / elements=string

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

lambda_function_associations

list / elements=dictionary

Список связей с функциями Lambda, используемых для данного поведения кэширования.

event_type

string

Указывает тип события, запускающего вызов функции Lambda.

Допустимые значения: viewer-request, origin-request, origin-response или viewer-response.

lambda_function_arn

string

ARN функции Lambda.

max_ttl

integer

Максимальное время, в течение которого объекты должны храниться в кэшах CloudFront.

min_ttl

integer

Минимальное время, в течение которого объекты должны храниться в кэшах CloudFront.

origin_request_policy_id

string

добавлен в community.aws 7.1.0

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

Дополнительные сведения см. в документации CloudFront: https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/controlling-origin-requests.html

path_pattern

string

Шаблон, определяющий, к каким запросам применяется это поведение.

response_headers_policy_id

string

Идентификатор политики заголовков, которые CloudFront добавляет к ответам, отправляемым зрителям.

smooth_streaming

boolean

Нужно ли распространять медиафайлы в формате Microsoft Smooth Streaming.

Варианты:

  • false
  • true

target_origin_id

string

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

trusted_signers

dictionary

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

enabled

boolean

Нужно ли требовать от зрителей использовать подписанные URL-адреса для доступа к файлам, указанным параметрами path_pattern и target_origin_id.

Варианты:

  • false
  • true

items

list / elements=string

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

viewer_protocol_policy

string

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

Допустимые значения: allow-all, redirect-to-https и https-only.

caller_reference

string

Уникальный идентификатор для создания и обновления дистрибутивов CloudFront.

Ссылка вызывающей стороны должна быть уникальной для всех дистрибутивов. Например, ссылку, используемую для веб-дистрибутива, нельзя повторно использовать для потокового дистрибутива. Этот параметр можно использовать вместо distribution_id для ссылки на существующий дистрибутив. Если параметр не указан, по умолчанию используется временная метка в формате YYYY-MM-DDTHH:MM:SS.ffffff.

comment

string

Комментарий с описанием дистрибутива CloudFront.

Если параметр не указан, по умолчанию используется общее сообщение о том, что дистрибутив создан с помощью Ansible, и временная метка.

custom_error_responses

list / elements=dictionary

Элемент конфигурации — это list[] сложных пользовательских ответов об ошибках, заданных для дистрибутива.

Этот атрибут настраивает пользовательские сообщения об ошибках HTTP, возвращаемые пользователю.

error_caching_min_ttl

integer

Время (в секундах), в течение которого CloudFront кэширует коды состояния.

error_code

integer

Код ошибки, для которого предназначена пользовательская страница ошибки.

response_code

integer

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

response_page_path

string

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

debug_botocore_endpoint_logs

boolean

Используйте регистратор botocore.endpoint для анализа уникальных (а не общего числа) вызовов API "resource:action", выполненных во время задачи, и вывода их списка в ключ resource_actions результатов задачи. Используйте обработчик обратного вызова aws_resource_action для вывода общего списка вызовов, выполненных в рамках плейбука.

Также можно использовать переменную среды ANSIBLE_DEBUG_BOTOCORE_LOGS.

Варианты:

  • false ← (по умолчанию)
  • true

default_cache_behavior

dictionary

Словарь с описанием поведения кэширования по умолчанию для дистрибутива.

Если параметр не указан, значение target_origin_id задается по значению target_origin_id первого допустимого элемента cache_behavior в cache_behaviors с настройками по умолчанию.

allowed_methods

dictionary

Словарь, определяющий, какие методы HTTP обрабатывает и пересылает CloudFront.

cached_methods

list / elements=string

Список методов HTTP, для которых CloudFront должен выполнять кэширование.

Это может быть [GET,HEAD] или [GET,HEAD,OPTIONS].

items

list / elements=string

Список методов HTTP, которые CloudFront должен обрабатывать и пересылать.

cache_policy_id

string

добавлен в community.aws 7.1.0

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

Для поведения следует указать либо параметр cache_policy_id, либо forwarded_values.

Дополнительные сведения см. в документации CloudFront: https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/controlling-the-cache-key.html

compress

boolean

Нужно ли CloudFront автоматически сжимать файлы.

Варианты:

  • false
  • true

default_ttl

integer

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

field_level_encryption_id

string

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

forwarded_values

dictionary

Словарь, определяющий способ обработки строк запроса и файлов cookie в CloudFront.

Для поведения следует указать либо параметр cache_policy_id, либо forwarded_values.

cookies

dictionary

Словарь, указывающий, нужно ли CloudFront пересылать файлы cookie источнику и, если нужно, какие именно.

forward

string

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

Допустимые значения: all, none или whitelist.

whitelisted_names

list / elements=string

Список файлов cookie, которые следует пересылать источнику для этого поведения кэша.

headers

list / elements=string

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

Чтобы пересылать все заголовки, используйте список с одним элементом «*» (['*'])

query_string

boolean

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

Варианты:

  • false
  • true

query_string_cache_keys

list / elements=string

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

lambda_function_associations

list / elements=dictionary

Список ассоциаций функций Lambda для использования с этим поведением кэша.

event_type

string

Указывает тип события, которое запускает вызов функции Lambda.

Это может быть viewer-request, origin-request, origin-response или viewer-response.

lambda_function_arn

string

ARN функции Lambda.

max_ttl

integer

Максимальное время хранения объектов в кэшах CloudFront.

min_ttl

integer

Минимальное время хранения объектов в кэшах CloudFront.

origin_request_policy_id

string

добавлено в community.aws 7.1.0

Идентификатор политики запросов к источнику, которую CloudFront будет использовать для поведения кэша по умолчанию.

Дополнительную информацию см. в документации CloudFront: https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/controlling-origin-requests.html

response_headers_policy_id

string

Идентификатор политики заголовков, которые CloudFront добавляет к ответам, отправляемым пользователям.

smooth_streaming

boolean

Нужно ли распространять медиафайлы в формате Microsoft Smooth Streaming.

Варианты:

  • false
  • true

target_origin_id

string

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

trusted_signers

dictionary

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

enabled

boolean

Нужно ли требовать от пользователей подписанные URL-адреса для доступа к файлам, указанным в target_origin_id

Варианты:

  • false
  • true

items

list / elements=string

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

viewer_protocol_policy

string

Протокол, который пользователи могут использовать для доступа к файлам в источнике, указанном в target_origin_id.

Допустимые значения: allow-all, redirect-to-https и https-only.

default_origin_domain_name

string

Имя домена, используемое для источника, если параметр origins не задан.

Этот параметр следует использовать только при первом создании дистрибутива, но не при последующих запусках.

Не следует использовать вместе с distribution_id, caller_reference или alias.

default_origin_path

string

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

default_root_object

string

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

Например, если указано значение «index.html», при обращении пользователя к www.example.com будет запрошен www.example.com/index.html.

Это предотвращает доступ к корню всего источника дистрибутива.

distribution_id

string

Идентификатор дистрибутива CloudFront.

Этот параметр можно заменить параметром alias или caller_reference; он используется вместе с e_tag.

e_tag

string

Уникальный идентификатор измененного или существующего дистрибутива. Используется вместе с distribution_id.

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

enabled

boolean

Логическое значение, указывающее, включен или отключен дистрибутив.

По умолчанию: false.

Варианты:

  • false
  • true

endpoint_url

псевдонимы: aws_endpoint_url

string

URL-адрес для подключения вместо конечных точек AWS по умолчанию. Хотя его можно использовать для подключения к другим совместимым с AWS службам, коллекции amazon.aws и community.aws тестируются только с AWS.

Также можно использовать переменную окружения AWS_URL.

http_version

string

Версия протокола HTTP для дистрибутива.

AWS задает значение по умолчанию http2.

Допустимые значения: http1.1, http2, http3 и http2and3.

ipv6_enabled

boolean

Определяет, включена ли поддержка IPv6.

По умолчанию: false.

Варианты:

  • false
  • true

logging

dictionary

Элемент конфигурации — сложный объект, задающий ведение журналов для дистрибутива.

bucket

string

Бакет S3 для хранения журнала.

enabled

boolean

Если enabled=true, CloudFront будет записывать сведения о доступе в бакет S3.

Варианты:

  • false
  • true

include_cookies

boolean

Если include_cookies=true, CloudFront будет включать файлы cookie в журналы.

Варианты:

  • false
  • true

prefix

string

Префикс, добавляемый к именам объектов S3.

origins

list / elements=dictionary

Элемент конфигурации — список сложных объектов источников, задаваемых для дистрибутива. Используется для создания и обновления дистрибутивов.

connection_attempts

integer

добавлено в community.aws 6.0.0

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

По умолчанию: 3

connection_timeout

integer

добавлено в community.aws 6.0.0

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

По умолчанию: 10

custom_headers

list / elements=dictionary

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

Дополнительную информацию см. в документации CloudFront: https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/forward-custom-headers.html.

header_name

string

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

header_value

string

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

custom_origin_config

dictionary

Сведения о подключении к источнику.

http_port

integer

Порт HTTP, который использует пользовательский источник.

https_port

integer

Порт HTTPS, который использует пользовательский источник.

origin_keepalive_timeout

integer

Тайм-аут keep-alive (в секундах).

origin_protocol_policy

string

Политика протокола источника, применяемая к вашему источнику.

origin_read_timeout

integer

Тайм-аут (в секундах) при чтении данных из вашего источника.

origin_ssl_protocols

list / elements=string

Список протоколов SSL/TLS, которые CloudFront будет использовать при обмене данными с источником по HTTPS.

domain_name

string

Имя домена, к которому CloudFront будет обращаться как к источнику.

Дополнительную информацию см. в документации CloudFront: https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-web-values-specify.html#DownloadDistValuesDomainName

id

string

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

origin_path

string

Указывает CloudFront запрашивать содержимое из каталога в вашем бакете Amazon S3 или пользовательском источнике.

origin_shield

dictionary

добавлено в community.aws 6.0.0

Задайте параметры Origin Shield для источника.

enabled

boolean

Указывает, нужно ли включить Origin Shield для источника.

Варианты:

  • false
  • true

origin_shield_region

string

Укажите регион AWS, который будет использоваться для Origin Shield. Обязательный параметр, если Origin Shield включен.

s3_origin_access_identity_enabled

boolean

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

Если параметр s3_origin_config не задан, удостоверение будет создано автоматически.

См. также https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/PrivateContent.html.

Варианты:

  • false
  • true

s3_origin_config

dictionary

Укажите удостоверение доступа к источнику для источников S3.

origin_access_identity

string

Существующая идентификация доступа к источнику в формате origin-access-identity/cloudfront/OID_ID.

price_class

string

Строка, задающая класс цен для дистрибутива. См. https://aws.amazon.com/cloudfront/pricing/

price_class=PriceClass_100 включает регионы США, Канаду и Европу.

price_class=PriceClass_200 включает регионы США, Канаду, Европу, Японию, Индию, Гонконг, Филиппины, Южную Корею, Сингапур и Тайвань.

price_class=PriceClass_All включает регионы США, Канаду, Европу, Японию, Индию, Южную Америку, Австралию, Гонконг, Филиппины, Южную Корею, Сингапур и Тайвань.

AWS использует значение по умолчанию PriceClass_All.

Допустимые значения: PriceClass_100, PriceClass_200 и PriceClass_All

profile

aliases: aws_profile

string

Именованный профиль AWS, используемый для аутентификации.

Дополнительные сведения об именованных профилях см. в документации AWS: https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-profiles.html.

Также можно использовать переменную окружения AWS_PROFILE.

Параметр profile несовместим с параметрами aws_access_key, aws_secret_key и session_token.

purge_aliases

boolean

Указывает, нужно ли удалить существующие псевдонимы перед добавлением новых.

Если purge_aliases=true, существующие псевдонимы удаляются, а aliases добавляются.

Варианты:

  • false ← (по умолчанию)
  • true

purge_cache_behaviors

boolean

Удалять ли все правила кэширования, не указанные в cache_behaviors.

Этот параметр также позволяет изменить порядок cache_behaviors.

Варианты:

  • false ← (по умолчанию)
  • true

purge_custom_error_responses

boolean

Удалять ли все пользовательские ответы об ошибках, не указанные в custom_error_responses.

Варианты:

  • false ← (по умолчанию)
  • true

purge_origins

boolean

Удалять ли все источники, не указанные в origins.

Варианты:

  • false ← (по умолчанию)
  • true

purge_tags

boolean

Если задано значение purge_tags=true и установлен параметр tags, существующие теги ресурса будут удалены, чтобы в точности соответствовать значениям, заданным параметром tags.

Если параметр tags не задан, теги не изменяются, даже если установлено purge_tags=True.

Ключи тегов, начинающиеся с aws:, зарезервированы Amazon и не могут быть изменены. Поэтому они игнорируются при обработке параметра purge_tags. Дополнительные сведения см. в документации Amazon: https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html#tag-conventions.

Варианты:

  • false
  • true ← (по умолчанию)

region

aliases: aws_region

string

Регион AWS, который следует использовать.

Для глобальных служб, таких как IAM, Route53 и CloudFront, параметр region игнорируется.

Также можно использовать переменную окружения AWS_REGION.

Дополнительные сведения см. в документации Amazon AWS: http://docs.aws.amazon.com/general/latest/gr/rande.html#ec2_region.

restrictions

dictionary

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

geo_restriction

dictionary

Применить ограничение на основе местоположения запрашивающей стороны.

items

list / elements=string

Список двухбуквенных кодов стран ISO 3166-1 (Alpha 2), к которым следует применить ограничение.

Полный список кодов см. на сайте ISO: https://www.iso.org/obp/ui/#search/code/.

restriction_type

string

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

Допустимые значения: none, whitelist, blacklist.

secret_key

aliases: aws_secret_access_key, aws_secret_key

string

Секретный ключ доступа AWS.

Дополнительные сведения о ключах доступа см. в документации AWS: https://docs.aws.amazon.com/general/latest/gr/aws-sec-cred-types.html#access-keys-and-secret-access-keys.

Также можно использовать переменные окружения AWS_SECRET_ACCESS_KEY или AWS_SECRET_KEY в порядке убывания приоритета.

Параметры secret_key и profile несовместимы.

Псевдоним aws_secret_access_key добавлен в выпуске 5.1.0 для согласованности с AWS SDK botocore.

session_token

aliases: aws_session_token

string

Токен сеанса AWS STS для использования с временными учетными данными.

Дополнительные сведения о ключах доступа см. в документации AWS: https://docs.aws.amazon.com/general/latest/gr/aws-sec-cred-types.html#access-keys-and-secret-access-keys.

Также можно использовать переменную окружения AWS_SESSION_TOKEN.

Параметры session_token и profile несовместимы.

state

string

Требуемое состояние дистрибутива.

state=present создает новый дистрибутив или обновляет существующий.

state=absent удаляет существующий дистрибутив.

Варианты:

  • "present" ← (по умолчанию)
  • "absent"

tags

aliases: resource_tags

dictionary

Словарь тегов, которые следует применить к ресурсу.

Если параметр tags не задан, теги не изменяются.

validate_certs

boolean

Если задано значение false, SSL-сертификаты не будут проверяться при взаимодействии с API AWS.

Настоятельно не рекомендуется устанавливать validate_certs=false; вместо этого рассмотрите возможность указать aws_ca_bundle.

Варианты:

  • false
  • true ← (по умолчанию)

viewer_certificate

dictionary

Словарь, задающий параметры шифрования дистрибутива.

acm_certificate_arn

string

Идентификатор сертификата, хранящегося в ACM и используемого для HTTPS-подключений.

Если задан acm_certificate_id, необходимо также указать ssl_support_method.

cloudfront_default_certificate

boolean

Если для дистрибутива используется доменное имя CloudFront, например 123456789abcde.cloudfront.net, задайте cloudfront_default_certificate=true.

Если задано cloudfront_default_certificate=true, не указывайте ssl_support_method.

Варианты:

  • false
  • true

iam_certificate_id

string

Идентификатор сертификата, хранящегося в IAM и используемого для HTTPS-подключений.

Если задан iam_certificate_id, необходимо также указать ssl_support_method.

minimum_protocol_version

string

Политика безопасности, которую CloudFront будет использовать для HTTPS-подключений.

Список поддерживаемых политик безопасности см. по адресу https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/secure-connections-supported-viewer-protocols-ciphers.html.

ssl_support_method

string

Способ предоставления SSL-сертификатов CloudFront.

Допустимое значение для SNI — sni-only; используйте vip, если CloudFront настроен на использование выделенного IP-адреса для вашего содержимого.

wait

boolean

Указывает, должен ли модуль ожидать завершения обработки создания или обновления дистрибутива.

Варианты:

  • false ← (по умолчанию)
  • true

wait_timeout

integer

Задает время ожидания в секундах до истечения срока ожидания создания или обновления CloudFront.

По умолчанию: 1800

web_acl_id

string

Идентификатор списка контроля доступа (ACL) межсетевого экрана веб-приложений (WAF).

Примечания

Примечание

  • Внимание: Для модулей переменные окружения и файлы конфигурации считываются из контекста «хоста» Ansible, а не из контекста «контроллера». Поэтому файлы, возможно, потребуется явно скопировать на «хост». Для плагинов поиска и подключения переменные окружения и файлы конфигурации считываются из контекста «контроллера» Ansible, а не из контекста «хоста».
  • Используемый Ansible пакет AWS SDK (boto3) также может считывать значения по умолчанию для учетных данных и других параметров, например региона, из файлов конфигурации в контексте «хоста» Ansible (обычно ~/.aws/credentials). Дополнительные сведения см. по адресу https://boto3.amazonaws.com/v1/documentation/api/latest/guide/credentials.html.

Примеры

- name: create a basic distribution with defaults and tags
  community.aws.cloudfront_distribution:
    state: present
    default_origin_domain_name: www.my-cloudfront-origin.com
    tags:
      Name: example distribution
      Project: example project
      Priority: '1'

- name: update a distribution comment by distribution_id
  community.aws.cloudfront_distribution:
    state: present
    distribution_id: E1RP5A2MJ8073O
    comment: modified by ansible cloudfront.py

- name: update a distribution comment by caller_reference
  community.aws.cloudfront_distribution:
    state: present
    caller_reference: my cloudfront distribution 001
    comment: modified by ansible cloudfront.py

- name: update a distribution's aliases and comment using the distribution_id as a reference
  community.aws.cloudfront_distribution:
    state: present
    distribution_id: E1RP5A2MJ8073O
    comment: modified by cloudfront.py again
    aliases:
      - 'www.my-distribution-source.com'
      - 'zzz.aaa.io'

- name: update a distribution's aliases and comment using an alias as a reference
  community.aws.cloudfront_distribution:
    state: present
    caller_reference: my test distribution
    comment: modified by cloudfront.py again
    aliases:
      - www.my-distribution-source.com
      - zzz.aaa.io

- name: update a distribution's comment and aliases and tags and remove existing tags
  community.aws.cloudfront_distribution:
    state: present
    distribution_id: E15BU8SDCGSG57
    comment: modified by cloudfront.py again
    aliases:
      - tested.com
    tags:
      Project: distribution 1.2
    purge_tags: true

- name: create a distribution with an origin, logging and default cache behavior
  community.aws.cloudfront_distribution:
    state: present
    caller_reference: unique test distribution ID
    origins:
      - id: 'my test origin-000111'
        domain_name: www.example.com
        origin_path: /production
        custom_headers:
          - header_name: MyCustomHeaderName
            header_value: MyCustomHeaderValue
    default_cache_behavior:
      target_origin_id: 'my test origin-000111'
      forwarded_values:
        query_string: true
        cookies:
          forward: all
        headers:
          - '*'
      viewer_protocol_policy: allow-all
      smooth_streaming: true
      compress: true
      allowed_methods:
        items:
          - GET
          - HEAD
        cached_methods:
          - GET
          - HEAD
    logging:
      enabled: true
      include_cookies: false
      bucket: mylogbucket.s3.amazonaws.com
      prefix: myprefix/
    enabled: false
    comment: this is a CloudFront distribution with logging

- name: delete a distribution
  community.aws.cloudfront_distribution:
    state: absent
    caller_reference: replaceable distribution

Возвращаемые значения

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

Ключ

Описание

active_trusted_key_groups

complex

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

Возвращается: всегда

elements

list / elements=string

добавлено в community.aws 10.1.0

Список групп ключей.

Возвращается: если есть доверенные подписывающие стороны

enabled

boolean

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

Возвращается: всегда

Пример: false

items

list / elements=string

Список групп ключей.

Это возвращаемое значение устарело и будет удалено в одном из выпусков после 2026-12-16. Вместо него используйте active_trusted_key_groups.elements.

Возвращается: если есть доверенные подписывающие стороны

quantity

integer

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

Возвращается: всегда

Пример: 1

active_trusted_signers

complex

Идентификаторы пар ключей, которые CloudFront знает для каждой доверенной подписывающей стороны.

Возвращается: всегда

elements

list / elements=string

добавлено в community.aws 10.1.0

Список доверенных подписывающих сторон.

Возвращается: если есть доверенные подписывающие стороны

Пример: ["key_pair_id"]

enabled

boolean

Используются ли доверенные подписывающие стороны.

Возвращается: всегда

Пример: false

items

list / elements=string

Список доверенных подписывающих сторон.

Это возвращаемое значение устарело и будет удалено в одном из выпусков после 2026-12-16. Вместо него используйте active_trusted_signers.elements.

Возвращается: если есть доверенные подписывающие стороны

Пример: ["key_pair_id"]

quantity

integer

Количество доверенных подписывающих сторон.

Возвращается: всегда

Пример: 1

aliases

complex

Псевдонимы, указывающие на дистрибутив.

Возвращается: всегда

elements

list / elements=string

добавлено в community.aws 10.1.0

Список псевдонимов.

Возвращается: всегда

Пример: ["test.example.com"]

items

list / elements=string

Список псевдонимов.

Это возвращаемое значение устарело и будет удалено в одном из выпусков после 2026-12-16. Вместо него используйте aliases.elements.

Возвращается: всегда

Пример: ["test.example.com"]

quantity

integer

Количество псевдонимов.

Возвращается: всегда

Пример: 1

arn

string

Имя ресурса Amazon (ARN) дистрибутива.

Возвращается: всегда

Пример: "arn:aws:cloudfront::123456789012:distribution/E1234ABCDEFGHI"

cache_behaviors

complex

Поведение кэша CloudFront.

Возвращается: всегда

elements

complex

добавлено в community.aws 10.1.0

Список вариантов поведения кэша.

Возвращается: всегда

allowed_methods

complex

Методы, разрешённые для данного варианта поведения кэша.

Возвращается: всегда

cached_methods

complex

Методы, кэшируемые при данном варианте поведения кэша.

Возвращается: всегда

elements

list / elements=string

Список кэшируемых методов.

Возвращается: всегда

Пример: ["HEAD", "GET"]

quantity

integer

Количество кэшируемых методов.

Возвращается: всегда

Пример: 2

elements

list / elements=string

Список методов, разрешённых для данного варианта поведения кэша.

Возвращается: всегда

Пример: ["HEAD", "GET"]

quantity

integer

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

Возвращается: всегда

Пример: 2

compress

boolean

Включено ли сжатие для данного варианта поведения кэша.

Возвращается: всегда

Пример: false

default_ttl

integer

Время жизни (TTL) по умолчанию для данного варианта поведения кэша.

Возвращается: всегда

Пример: 86400

forwarded_values

complex

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

Возвращается: всегда

cookies

complex

Файлы cookie, пересылаемые источнику.

Возвращается: всегда

forward

string

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

Возвращается: всегда

Пример: "none"

whitelisted_names

complex

Имена файлов cookie, пересылаемых источнику для данного варианта поведения кэша.

Возвращается: если forward=whitelist

elements

list / elements=string

Список файлов cookie для пересылки.

Возвращается: если список не пуст

Пример: ["my_cookie"]

quantity

integer

Количество файлов cookie для пересылки.

Возвращается: всегда

Пример: 1

headers

complex

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

Возвращается: всегда

elements

list / elements=string

Список заголовков для варьирования.

Возвращается: если список не пуст

Пример: ["Host"]

quantity

integer

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

Возвращается: всегда

Пример: 1

query_string

boolean

Используется ли строка запроса при поиске в кэше.

Возвращается: всегда

Пример: false

query_string_cache_keys

complex

Ключи строки запроса, используемые при поиске в кэше.

Возвращается: всегда

elements

list / elements=string

Список ключей строки запроса, используемых при поиске в кэше.

Возвращается: если список не пуст

quantity

integer

Количество ключей строки запроса, используемых при поиске в кэше.

Возвращается: всегда

Пример: 1

lambda_function_associations

complex

Связи с функциями Lambda для варианта поведения кэша.

Возвращается: всегда

elements

list / elements=string

Список связей с функциями Lambda.

Возвращается: если список не пуст

Пример: [{"event_type": "viewer-response", "lambda_function_arn": "arn:aws:lambda:123456789012:us-east-1/lambda/lambda-function"}]

quantity

integer

Количество связей с функциями Lambda.

Возвращается: всегда

Пример: 1

max_ttl

integer

Максимальное время жизни.

Возвращается: всегда

Пример: 31536000

min_ttl

integer

Минимальное время жизни.

Возвращается: всегда

Пример: 0

path_pattern

string

Шаблон пути, определяющий этот вариант поведения кэша.

Возвращается: всегда

Пример: "/path/to/files/*"

smooth_streaming

boolean

Включена ли плавная потоковая передача.

Возвращается: всегда

Пример: false

target_origin_id

string

Идентификатор источника, на который ссылается данный вариант поведения кэша.

Возвращается: всегда

Пример: "origin_abcd"

trusted_signers

complex

Доверенные подписывающие стороны.

Возвращается: всегда

enabled

boolean

Включены ли доверенные подписанты для этого поведения кэша.

Возвращается: всегда

Пример: false

quantity

integer

Количество доверенных подписантов.

Возвращается: всегда

Пример: 1

viewer_protocol_policy

string

Политика обработки http/https.

Возвращается: всегда

Пример: "redirect-to-https"

items

complex

Список поведений кэша.

Это возвращаемое значение объявлено устаревшим и будет удалено в одном из выпусков после 2026-12-16. Вместо него используйте cache_behaviors.elements.

Возвращается: всегда

allowed_methods

complex

Методы, разрешённые поведением кэша.

Возвращается: всегда

cached_methods

complex

Методы, кэшируемые поведением кэша.

Возвращается: всегда

items

list / elements=string

Список кэшируемых методов.

Возвращается: всегда

Пример: ["HEAD", "GET"]

quantity

integer

Количество кэшируемых методов.

Возвращается: всегда

Пример: 2

items

list / elements=string

Список методов, разрешённых поведением кэша.

Это возвращаемое значение объявлено устаревшим и будет удалено в одном из выпусков после 2026-12-16. Вместо него используйте cache_behaviors.elements.allowed_methods.elements.

Возвращается: всегда

Пример: ["HEAD", "GET"]

quantity

integer

Количество методов, разрешённых поведением кэша.

Возвращается: всегда

Пример: 2

compress

boolean

Включено ли сжатие для поведения кэша.

Возвращается: всегда

Пример: false

default_ttl

integer

Время жизни по умолчанию для поведения кэша.

Возвращается: всегда

Пример: 86400

forwarded_values

complex

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

Возвращается: всегда

cookies

complex

Файлы cookie, передаваемые источнику.

Возвращается: всегда

forward

string

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

Возвращается: всегда

Пример: "none"

whitelisted_names

complex

Названия файлов cookie, передаваемых источнику для этого поведения кэша.

Возвращается: если forward=whitelist

items

list / elements=string

Список файлов cookie для передачи.

Это возвращаемое значение объявлено устаревшим и будет удалено в одном из выпусков после 2026-12-16. Вместо него используйте cache_behaviors.elements.forwarded_values.cookies.whitelisted_names.elements.

Возвращается: если список не пуст

Пример: ["my_cookie"]

quantity

integer

Количество файлов cookie для передачи.

Возвращается: всегда

Пример: 1

headers

complex

Заголовки, по которым различаются записи кэша.

Возвращается: всегда

items

list / elements=string

Список заголовков, по которым различаются записи кэша.

Это возвращаемое значение объявлено устаревшим и будет удалено в одном из выпусков после 2026-12-16. Вместо него используйте cache_behaviors.elements.forwarded_values.headers.elements.

Возвращается: если список не пуст

Пример: ["Host"]

quantity

integer

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

Возвращается: всегда

Пример: 1

query_string

boolean

Используется ли строка запроса при поиске в кэше.

Возвращается: всегда

Пример: false

query_string_cache_keys

complex

Ключи строки запроса, используемые при поиске в кэше.

Возвращается: всегда

items

list / elements=string

Список ключей строки запроса, используемых при поиске в кэше.

Это возвращаемое значение объявлено устаревшим и будет удалено в одном из выпусков после 2026-12-16. Вместо него используйте cache_behaviors.elements.forwarded_values.query_string_cache_keys.elements.

Возвращается: если список не пуст

quantity

integer

Количество ключей строки запроса, используемых при поиске в кэше.

Возвращается: всегда

Пример: 1

lambda_function_associations

complex

Связи функций Lambda с поведением кэша.

Возвращается: всегда

items

list / elements=string

Список связей функций Lambda.

Это возвращаемое значение объявлено устаревшим и будет удалено в одном из выпусков после 2026-12-16. Вместо него используйте cache_behaviors.elements.lambda_function_associations.elements.

Возвращается: если список не пуст

Пример: [{"event_type": "viewer-response", "lambda_function_arn": "arn:aws:lambda:123456789012:us-east-1/lambda/lambda-function"}]

quantity

integer

Количество связей функций Lambda.

Возвращается: всегда

Пример: 1

max_ttl

integer

Максимальное время жизни.

Возвращается: всегда

Пример: 31536000

min_ttl

integer

Минимальное время жизни.

Возвращается: всегда

Пример: 0

path_pattern

string

Шаблон пути, определяющий это поведение кэша.

Возвращается: всегда

Пример: "/path/to/files/*"

smooth_streaming

boolean

Включена ли плавная потоковая передача.

Возвращается: всегда

Пример: false

target_origin_id

string

Идентификатор источника, на который ссылается это поведение кэша.

Возвращается: всегда

Пример: "origin_abcd"

trusted_signers

complex

Доверенные подписанты.

Возвращается: всегда

enabled

boolean

Включены ли доверенные подписанты для этого поведения кэша.

Возвращается: всегда

Пример: false

quantity

integer

Количество доверенных подписантов.

Возвращается: всегда

Пример: 1

viewer_protocol_policy

string

Политика обработки http/https.

Возвращается: всегда

Пример: "redirect-to-https"

quantity

integer

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

Возвращается: всегда

Пример: 1

caller_reference

string

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

Возвращается: всегда

Пример: "1484796016700"

comment

string

Любые комментарии о дистрибутиве, которые вы хотите добавить.

Возвращается: всегда

Пример: "my first CloudFront distribution"

custom_error_responses

complex

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

Возвращается: всегда

elements

complex

добавлено в community.aws 10.1.0

Список пользовательских ответов на ошибки.

Возвращается: всегда

error_caching_min_ttl

integer

Минимальное время кэширования этого ответа на ошибку.

Возвращается: всегда

Пример: 300

error_code

integer

Код ответа источника, вызывающий этот ответ на ошибку.

Возвращается: всегда

Пример: 500

response_code

string

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

Возвращается: всегда

Пример: "500"

response_page_path

string

Путь к странице ошибки, которую нужно отобразить.

Возвращается: всегда

Пример: "/errors/5xx.html"

items

complex

Список пользовательских ответов об ошибках.

Это возвращаемое значение устарело и будет удалено в одном из выпусков после 2026-12-16. Вместо него используйте custom_error_responses.elements.

Возвращается: всегда

error_caching_min_ttl

integer

Минимальное время кэширования этого ответа об ошибке.

Возвращается: всегда

Пример: 300

error_code

integer

Код ответа источника, вызывающий этот ответ об ошибке.

Возвращается: всегда

Пример: 500

response_code

string

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

Возвращается: всегда

Пример: "500"

response_page_path

string

Путь к странице с ошибкой, которую нужно отобразить.

Возвращается: всегда

Пример: "/errors/5xx.html"

quantity

integer

Количество пользовательских ответов об ошибках

Возвращается: всегда

Пример: 1

default_cache_behavior

complex

Поведение кэша по умолчанию.

Возвращается: всегда

allowed_methods

complex

Методы, разрешённые поведением кэша.

Возвращается: всегда

cached_methods

complex

Методы, кэшируемые поведением кэша.

Возвращается: всегда

elements

list / elements=string

добавлено в community.aws 10.1.0

Список кэшируемых методов.

Возвращается: всегда

Пример: ["HEAD", "GET"]

items

list / elements=string

Список кэшируемых методов.

Это возвращаемое значение устарело и будет удалено в одном из выпусков после 2026-12-16. Вместо него используйте default_cache_behavior.allowed_methods.cached_methods.elements.

Возвращается: всегда

Пример: ["HEAD", "GET"]

quantity

integer

Количество кэшируемых методов.

Возвращается: всегда

Пример: 2

elements

list / elements=string

добавлено в community.aws 10.1.0

Список методов, разрешённых поведением кэша.

Возвращается: всегда

Пример: ["HEAD", "GET"]

items

list / elements=string

Список методов, разрешённых поведением кэша.

Это возвращаемое значение устарело и будет удалено в одном из выпусков после 2026-12-16. Вместо него используйте default_cache_behavior.allowed_methods.elements.

Возвращается: всегда

Пример: ["HEAD", "GET"]

quantity

integer

Количество методов, разрешённых поведением кэша.

Возвращается: всегда

Пример: 2

compress

boolean

Включено ли сжатие для поведения кэша.

Возвращается: всегда

Пример: false

default_ttl

integer

Время жизни по умолчанию для поведения кэша.

Возвращается: всегда

Пример: 86400

forwarded_values

complex

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

Возвращается: всегда

cookies

complex

Файлы cookie, передаваемые источнику.

Возвращается: всегда

forward

string

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

Возвращается: всегда

Пример: "none"

whitelisted_names

complex

Имена файлов cookie, передаваемых источнику для этого поведения кэша.

Возвращается: если forward=whitelist

elements

list / elements=string

добавлено в community.aws 10.1.0

Список файлов cookie для передачи.

Это возвращаемое значение устарело и будет удалено в одном из выпусков после 2026-12-16. Вместо него используйте default_cache_behavior.forwarded_values.cookies.whitelisted_names.elements.

Возвращается: если список не пуст

Пример: ["my_cookie"]

items

list / elements=string

Список файлов cookie для передачи.

Возвращается: если список не пуст

Пример: ["my_cookie"]

quantity

integer

Количество файлов cookie для передачи.

Возвращается: всегда

Пример: 1

headers

complex

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

Возвращается: всегда

elements

list / elements=string

добавлено в community.aws 10.1.0

Список заголовков для вариации.

Возвращается: если список не пуст

Пример: ["Host"]

items

list / elements=string

Список заголовков для вариации.

Это возвращаемое значение устарело и будет удалено в одном из выпусков после 2026-12-16. Вместо него используйте default_cache_behavior.forwarded_values.headers.elements.

Возвращается: если список не пуст

Пример: ["Host"]

quantity

integer

Количество заголовков для вариации.

Возвращается: всегда

Пример: 1

query_string

boolean

Используется ли строка запроса при поиске в кэше.

Возвращается: всегда

Пример: false

query_string_cache_keys

complex

Ключи строки запроса, используемые при поиске в кэше.

Возвращается: всегда

elements

list / elements=string

добавлено в community.aws 10.1.0

Список ключей кэша строки запроса, используемых при поиске в кэше.

Возвращается: если список не пуст

items

list / elements=string

Список ключей кэша строки запроса, используемых при поиске в кэше.

Это возвращаемое значение устарело и будет удалено в одном из выпусков после 2026-12-16. Вместо него используйте default_cache_behavior.forwarded_values.query_string_cache_keys.elements.

Возвращается: если список не пуст

quantity

integer

Количество ключей кэша строки запроса, используемых при поиске в кэше.

Возвращается: всегда

Пример: 1

lambda_function_associations

complex

Связи функций Lambda с поведением кэша.

Возвращается: всегда

elements

list / elements=string

добавлено в community.aws 10.1.0

Список связей функций Lambda.

Возвращается: если список не пуст

Пример: [{"event_type": "viewer-response", "lambda_function_arn": "arn:aws:lambda:123456789012:us-east-1/lambda/lambda-function"}]

items

list / elements=string

Список связей функций Lambda.

Это возвращаемое значение устарело и будет удалено в одном из выпусков после 2026-12-16. Вместо него используйте default_cache_behavior.lambda_function_associations.elements.

Возвращается: если список не пуст

Пример: [{"event_type": "viewer-response", "lambda_function_arn": "arn:aws:lambda:123456789012:us-east-1/lambda/lambda-function"}]

quantity

integer

Количество связей функций Lambda.

Возвращается: всегда

Пример: 1

max_ttl

integer

Максимальное время жизни.

Возвращается: всегда

Пример: 31536000

min_ttl

integer

Минимальное время жизни.

Возвращается: всегда

Пример: 0

path_pattern

string

Шаблон пути, определяющий это поведение кэша.

Возвращается: всегда

Пример: "/path/to/files/*"

smooth_streaming

boolean

Включена ли плавная потоковая передача.

Возвращается: всегда

Пример: false

target_origin_id

string

Идентификатор источника, на который ссылается это поведение кэша.

Возвращается: всегда

Пример: "origin_abcd"

trusted_signers

complex

Доверенные подписанты.

Возвращается: всегда

enabled

boolean

Включены ли доверенные подписанты для этого поведения кэша.

Возвращается: всегда

Пример: false

quantity

integer

Количество доверенных подписантов.

Возвращается: всегда

Пример: 1

viewer_protocol_policy

string

Политика обработки HTTP/HTTPS.

Возвращается: всегда

Пример: "redirect-to-https"

default_root_object

string

Объект, который CloudFront должен запрашивать у источника (например, index.html), когда пользователь запрашивает корневой URL вашего дистрибутива.

Возвращается: всегда

Пример: ""

diff

dictionary

Разница между предыдущей и новой конфигурацией.

Возвращается: всегда

Пример: {}

domain_name

string

Доменное имя дистрибутива CloudFront.

Возвращается: всегда

Пример: "d1vz8pzgurxosf.cloudfront.net"

enabled

boolean

Указывает, включен ли дистрибутив CloudFront.

Возвращается: всегда

Пример: true

http_version

string

Версия HTTP, поддерживаемая дистрибутивом.

Возвращается: всегда

Пример: "http2"

id

string

Идентификатор дистрибутива CloudFront.

Возвращается: всегда

Пример: "E123456ABCDEFG"

in_progress_invalidation_batches

integer

Количество выполняющихся в данный момент пакетов инвалидации.

Возвращается: всегда

Пример: 0

is_ipv6_enabled

boolean

Указывает, включен ли IPv6.

Возвращается: всегда

Пример: true

last_modified_time

string

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

Возвращается: всегда

Пример: "2017-10-13T01:51:12.656000+00:00"

logging

complex

Сведения о журналировании.

Возвращается: всегда

bucket

string

Целевой бакет S3 для журналов.

Возвращается: всегда

Пример: "logs-example-com.s3.amazonaws.com"

enabled

boolean

Указывает, включено ли журналирование.

Возвращается: всегда

Пример: true

include_cookies

boolean

Указывает, следует ли записывать файлы cookie в журнал.

Возвращается: всегда

Пример: false

prefix

string

Префикс, добавляемый к именам объектов журналов.

Возвращается: всегда

Пример: "cloudfront/test"

origins

complex

Источники в дистрибутиве CloudFront.

Возвращается: всегда

elements

complex

добавлено в community.aws 10.1.0

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

Возвращается: всегда

connection_attempts

integer

Количество попыток CloudFront подключиться к источнику.

Возвращается: всегда

Пример: 3

connection_timeout

integer

Количество секунд, в течение которых CloudFront ожидает установления соединения с источником.

Возвращается: всегда

Пример: 10

custom_headers

complex

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

Возвращается: всегда

quantity

integer

Количество заголовков.

Возвращается: всегда

Пример: 1

custom_origin_config

complex

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

Возвращается: всегда

http_port

integer

Порт, на котором прослушиваются HTTP-подключения.

Возвращается: всегда

Пример: 80

https_port

integer

Порт, на котором прослушиваются HTTPS-подключения.

Возвращается: всегда

Пример: 443

origin_keepalive_timeout

integer

Тайм-аут постоянного соединения.

Возвращается: всегда

Пример: 5

origin_protocol_policy

string

Политика поддерживаемых протоколов.

Возвращается: всегда

Пример: "https-only"

origin_read_timeout

integer

Тайм-аут чтения данных из источника.

Возвращается: всегда

Пример: 30

origin_ssl_protocols

complex

Протоколы SSL, разрешенные для источника.

Возвращается: всегда

elements

list / elements=string

Список протоколов SSL.

Возвращается: всегда

Пример: ["TLSv1", "TLSv1.1", "TLSv1.2"]

quantity

integer

Количество протоколов SSL.

Возвращается: всегда

Пример: 3

domain_name

string

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

Возвращается: всегда

Пример: "test-origin.example.com"

id

string

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

Возвращается: всегда

Пример: "test-origin.example.com"

origin_path

string

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

Возвращается: всегда

Пример: ""

origin_shield

complex

добавлено в community.aws 6.0.0

Конфигурация Origin Shield для источника.

Возвращается: всегда

enabled

boolean

Указывает, включен ли Origin Shield.

Возвращается: всегда

Пример: false

origin_shield_region

string

Регион, используемый Origin Shield.

Возвращается: если enabled имеет значение true

Пример: "us-east-1"

s3_origin_config

dictionary

Конфигурация идентификатора доступа к источнику S3.

Возвращается: если s3_origin_access_identity_enabled имеет значение true

origin_access_identity

string

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

Возвращается: при успешном выполнении

Пример: "origin-access-identity/cloudfront/EXAMPLEID"

items

complex

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

Это возвращаемое значение устарело и будет удалено в одном из выпусков после 2026-12-16. Вместо него используйте origins.elements.

Возвращается: всегда

connection_attempts

integer

Количество попыток CloudFront подключиться к источнику.

Возвращается: всегда

Пример: 3

connection_timeout

integer

Количество секунд, в течение которых CloudFront ожидает установления соединения с источником.

Возвращается: всегда

Пример: 10

custom_headers

complex

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

Возвращается: всегда

quantity

integer

Количество заголовков.

Возвращается: всегда

Пример: 1

custom_origin_config

complex

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

Возвращается: всегда

http_port

integer

Порт, на котором прослушиваются HTTP-подключения.

Возвращается: всегда

Пример: 80

https_port

integer

Порт, на котором прослушиваются HTTPS-подключения.

Возвращается: всегда

Пример: 443

origin_keepalive_timeout

integer

Тайм-аут постоянного соединения.

Возвращается: всегда

Пример: 5

origin_protocol_policy

string

Политика поддерживаемых протоколов.

Возвращается: всегда

Пример: "https-only"

origin_read_timeout

integer

Тайм-аут чтения данных с источника.

Возвращается: всегда

Пример: 30

origin_ssl_protocols

complex

Протоколы SSL, разрешённые источником.

Возвращается: всегда

items

list / elements=string

Список протоколов SSL.

Это возвращаемое значение устарело и будет удалено в выпуске после 2026-12-16. Вместо него используйте origins.elements.custom_origin_config.origin_ssl_protocols.elements.

Возвращается: всегда

Пример: ["TLSv1", "TLSv1.1", "TLSv1.2"]

quantity

integer

Количество протоколов SSL.

Возвращается: всегда

Пример: 3

domain_name

string

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

Возвращается: всегда

Пример: "test-origin.example.com"

id

string

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

Возвращается: всегда

Пример: "test-origin.example.com"

origin_path

string

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

Возвращается: всегда

Пример: ""

origin_shield

complex

добавлено в community.aws 6.0.0

Конфигурация Origin Shield для источника.

Возвращается: всегда

enabled

boolean

Включён ли Origin Shield.

Возвращается: всегда

Пример: false

origin_shield_region

string

Регион, используемый Origin Shield.

Возвращается: если enabled равно true

Пример: "us-east-1"

s3_origin_config

dictionary

Конфигурация идентификатора доступа к источнику для источника S3.

Возвращается: если s3_origin_access_identity_enabled равно true

origin_access_identity

string

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

Возвращается: при успешном выполнении

Пример: "origin-access-identity/cloudfront/EXAMPLEID"

quantity

integer

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

Возвращается: всегда

Пример: 1

price_class

string

Ценовой класс дистрибутива CloudFront.

Возвращается: всегда

Пример: "PriceClass_All"

restrictions

complex

Ограничения, применяемые CloudFront.

Возвращается: всегда

geo_restriction

complex

Определяет страны, в которых распространяется ваш контент.

Возвращается: всегда

elements

list / elements=string

добавлено в community.aws 10.1.0

Список кодов стран, распространение в которых разрешено или запрещено.

Возвращается: всегда

Пример: ["xy"]

items

list / elements=string

Список кодов стран, распространение в которых разрешено или запрещено.

Это возвращаемое значение устарело и будет удалено в выпуске после 2026-12-16. Вместо него используйте restrictions.geo_restriction.elements.

Возвращается: всегда

Пример: ["xy"]

quantity

integer

Количество ограничений.

Возвращается: всегда

Пример: 1

restriction_type

string

Тип ограничения.

Возвращается: всегда

Пример: "blacklist"

status

string

Состояние дистрибутива CloudFront.

Возвращается: всегда

Пример: "InProgress"

tags

dictionary

Теги дистрибутива.

Возвращается: всегда

Пример: {"Hello": "World"}

viewer_certificate

complex

Сертификат, используемый дистрибутивом CloudFront.

Возвращается: всегда

acm_certificate_arn

string

ARN сертификата ACM.

Возвращается: если сертификат получен из ACM

Пример: "arn:aws:acm:us-east-1:123456789012:certificate/abcd1234-1234-1234-abcd-123456abcdef"

certificate

string

Ссылка на сертификат.

Возвращается: всегда

Пример: "arn:aws:acm:us-east-1:123456789012:certificate/abcd1234-1234-1234-abcd-123456abcdef"

certificate_source

string

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

Возвращается: всегда

Пример: "acm"

minimum_protocol_version

string

Минимальная версия протокола SSL/TLS, поддерживаемая этим дистрибутивом.

Возвращается: всегда

Пример: "TLSv1"

ssl_support_method

string

Поддержка браузеров, не поддерживающих SNI.

Возвращается: всегда

Пример: "sni-only"

web_acl_id

string

Идентификатор списка управления доступом к веб-ресурсам (из службы WAF).

Возвращается: всегда

Пример: "abcd1234-1234-abcd-abcd-abcd12345678"

Авторы

  • Willem van Ketwich (@wilvk)
  • Will Thames (@willthames)

Ссылки на коллекцию

  • Отслеживание проблем
  • Репозиторий (исходный код)
  • Связь

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/community/aws/cloudfront_distribution_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API