cloudfront_invalidation - создание недействительных данных для дистрибутивов aws cloudfront

Новое в версии 2.5.

Обзор
- Требования
Параметры
Примечания
Примеры
Возвращаемые значения
Статус
Техническое обслуживание
- Автор

Обзор

Позволяет сделать недействительной группу путей для дистрибутива CloudFront.

Требования

Ниже приведены требования, необходимые на хосте, который выполняет этот модуль.

boto
boto3 >= 1.0.0
python >= 2.6

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
alias		Псевдоним дистрибутива cloudfront, для которого требуется сделать недействительными пути. Может быть указан вместо distribution_id.
aws_access_key		Ключ доступа AWS. Если не задан, используется значение переменной среды AWS_ACCESS_KEY_ID, AWS_ACCESS_KEY или EC2_ACCESS_KEY. Псевдонимы: ec2_access_key, access_key
aws_secret_key		Секретный ключ AWS. Если не задан, используется значение переменной среды AWS_SECRET_ACCESS_KEY, AWS_SECRET_KEY или EC2_SECRET_KEY. Псевдонимы: ec2_secret_key, secret_key
caller_reference	По умолчанию: "текущая метка даты и времени"	Уникальный идентификатор для путей, которые требуется сделать недействительными.
distribution_id		Идентификатор дистрибутива cloudfront, для которого требуется сделать недействительными пути. Может быть указан вместо псевдонима.
ec2_url		URL, используемый для подключения к EC2 или вашему облаку Eucalyptus (по умолчанию модуль использует конечные точки EC2). Игнорируется для модулей, где требуется регион. Должен быть указан для всех других модулей, если регион не используется. Если не задан, используется значение переменной среды EC2_URL, если таковая имеется.
profile (добавлено в 1.6)		Использует профиль boto. Работает только с boto >= 2.24.0.
region		Регион AWS для использования. Если не указан, используется значение переменной среды AWS_REGION или EC2_REGION, если таковая имеется. См. http://docs.aws.amazon.com/general/latest/gr/rande.html#ec2_region Псевдонимы: aws_region, ec2_region
security_token (добавлено в 1.6)		Токен безопасности AWS STS. Если не задан, используется значение переменной среды AWS_SECURITY_TOKEN или EC2_SECURITY_TOKEN. Псевдонимы: access_token
target_paths обязательно		Список путей на дистрибутиве, которые требуется сделать недействительными. Каждый путь должен начинаться с '/'. Разрешены подстановочные знаки. Например, '/foo/bar/*'
validate_certs bool (добавлено в 1.5)	Варианты: нет да ←	При установке в значение "нет", сертификаты SSL не будут проверяться для версий boto >= 2.6.0.

Примечания

Примечание

не поддерживает режим проверки
Если параметры не заданы в модуле, можно использовать следующие переменные среды в порядке убывания приоритета AWS_URL или EC2_URL, AWS_ACCESS_KEY_ID или AWS_ACCESS_KEY или EC2_ACCESS_KEY, AWS_SECRET_ACCESS_KEY или AWS_SECRET_KEY или EC2_SECRET_KEY, AWS_SECURITY_TOKEN или EC2_SECURITY_TOKEN, AWS_REGION или EC2_REGION
Ansible использует конфигурационный файл boto (обычно ~/.boto), если учетные данные не предоставлены. См. http://boto.readthedocs.org/en/latest/boto_config_tut.html
AWS_REGION или EC2_REGION обычно используется для указания региона AWS при необходимости, но это также можно настроить в конфигурационном файле boto

Примеры

- name: create a batch of invalidations using a distribution_id for a reference
  cloudfront_invalidation:
    distribution_id: E15BU8SDCGSG57
    caller_reference: testing 123
    target_paths:
      - /testpathone/test1.css
      - /testpathtwo/test2.js
      - /testpaththree/test3.ss

- name: create a batch of invalidations using an alias as a reference and one path using a wildcard match
  cloudfront_invalidation:
    alias: alias.test.com
    caller_reference: testing 123
    target_paths:
      - /testpathone/test4.css
      - /testpathtwo/test5.js
      - /testpaththree/*

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

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

Ключ				Возвращаемое значение	Описание
invalidation сложное				всегда	Информация о недействительности.
	create_time строка			всегда	Дата и время, когда был сделан запрос на недействительность. Пример: 2018-02-01T15:50:41.159000+00:00
	id строка			всегда	Идентификатор запроса на недействительность. Пример: I2G9MOWJZFV612
	invalidation_batch сложное			всегда	Текущая информация о недействительности для запроса на пакет.
		caller_reference строка		всегда	Значение, используемое для уникальной идентификации запроса на недействительность. Пример: testing 123
		paths сложное		всегда	Словарь, содержащий информацию об объектах, которые требуется сделать недействительными.
			items список	всегда	Список путей, которые требуется сделать недействительными. Пример: ['/testpathtwo/test2.js', '/testpathone/test1.css', '/testpaththree/test3.ss']
			quantity целое число	всегда	Количество объектов, которые требуется сделать недействительными. Пример: 3
	status строка			всегда	Статус запроса на недействительность. Пример: Завершено
location строка				всегда	Полный URI дистрибутива и запроса на пакет недействительности. Пример: https://cloudfront.amazonaws.com/2017-03-25/distribution/E1ZID6KZJECZY7/invalidation/I2G9MOWJZFV622

Статус

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

Техническое обслуживание

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

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

Автор

Willem van Ketwich (@wilvk)

Подсказка

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

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.6/modules/cloudfront_invalidation_module.html