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 -	Значение по умолчанию: "Текущая метка даты и времени"	Уникальный идентификатор для путей недействительности.
debug_botocore_endpoint_logs логический тип добавлен в 2.8	Варианты: нет ← да	Использование логирования botocore.endpoint для анализа уникальных (а не общих) API-вызовов «resource:action» во время задачи, вывод набора в ключ resource_actions в результатах задачи. Используйте обратный вызов aws_resource_action для вывода полного списка, выполненного во время воспроизведения.
distribution_id -		Идентификатор распределения cloudfront, для которого требуется сделать пути недействительными. Может быть указан вместо псевдонима.
ec2_url строка		URL для подключения к EC2 или вашему облаку Eucalyptus (по умолчанию модуль будет использовать конечные точки EC2). Игнорируется для модулей, где требуется регион. Должен быть указан для всех остальных модулей, если регион не используется. Если не задан, используется значение переменной окружения EC2_URL, если оно есть.
profile строка		Использует профиль 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 строка		Токен безопасности AWS STS. Если не задан, используется значение переменной окружения AWS_SECURITY_TOKEN или EC2_SECURITY_TOKEN. алиасы: access_token
target_paths - / обязательно		Список путей на распределении, которые нужно сделать недействительными. Каждый путь должен начинаться с '/'. Разрешены подстановочные знаки. Пример: '/foo/bar/*'
validate_certs логический тип	Варианты: нет да ←	При установке в «нет», сертификаты 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), если учетные данные не предоставлены. См. https://boto.readthedocs.io/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. [сообщество]

Авторы

Виллем ван Кетвич (@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.8/modules/cloudfront_invalidation_module.html