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_actions в результатах задачи. Используйте обратный вызов aws_resource_action, чтобы вывести полный список, выполненный во время выполнения сценария. Переменная среды ANSIBLE_DEBUG_BOTOCORE_LOGS также может использоваться.
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. [сообщество]

Авторы

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.9/modules/cloudfront_invalidation_module.html