aws_waf_info – Получение информации о правилах, условиях и фильтрах WAF ACL

Новая версия 2.4.

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

Обзор

Получение информации о правилах, условиях и фильтрах WAF ACL.
Этот модуль назывался aws_waf_facts до Ansible 2.9. Использование не изменилось.

Псевдонимы: aws_waf_facts

Требования

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

boto
boto3
python >= 2.6

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
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
debug_botocore_endpoint_logs логическое значение добавлено в 2.8	Варианты: нет ← да	Использовать логгер botocore.endpoint для анализа уникальных (а не общих) API-вызовов «ресурс:действие», выполняемых во время задачи, вывода набора в ключ resource_actions результатов задачи. Используйте обратный вызов aws_resource_action для вывода общего списка, выполненного во время выполнения книги сценариев. Также может быть использована переменная окружения ANSIBLE_DEBUG_BOTOCORE_LOGS.
ec2_url строка		URL для подключения к EC2 или вашему облаку Eucalyptus (по умолчанию модуль будет использовать конечные точки EC2). Игнорируется для модулей, где требуется регион. Должен быть указан для всех остальных модулей, если регион не используется. Если не задан, используется значение переменной окружения EC2_URL, если таковое имеется.
name -		Имя межсетевого экрана веб-приложений
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
validate_certs логическое значение	Варианты: нет да ←	Если установлено в «нет», сертификаты SSL не будут проверяться для версий boto >= 2.6.0.
waf_regional логическое значение добавлено в 2.9	Варианты: нет ← да	Использовать модуль waf_regional. По умолчанию значение - true

Примечания

Примечание

Если параметры не установлены в модуле, следующие переменные окружения могут быть использованы в порядке убывания приоритета 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: obtain all WAF information
  aws_waf_info:

- name: obtain all information for a single WAF
  aws_waf_info:
    name: test_waf

- name: obtain all information for a single WAF Regional
  aws_waf_info:
    name: test_waf
    waf_regional: true

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

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

Ключ			Возвращаемое значение	Описание
wafs сложное			успешно	WAF, соответствующие переданным аргументам
	default_action целое число		всегда	Действие, выполняемое, если ни одно из правил, содержащихся в WebACL, не соответствует. Пример: БЛОКИРОВАТЬ
	metric_name строка		всегда	Дружественное имя или описание метрик для этого WebACL Пример: test_waf_metric
	name строка		всегда	Дружественное имя или описание WebACL Пример: test_waf
	rules сложное		всегда	Массив, содержащий действие для каждого правила в WebACL, а также приоритет правила
		action строка	всегда	Действие, выполняемое, если правило соответствует Пример: БЛОКИРОВАТЬ
		metric_name строка	всегда	Дружественное имя или описание метрик для этого правила Пример: ipblockrule
		name строка	всегда	Дружественное имя или описание правила Пример: ip_block_rule
		predicates список	всегда	Список Predicates содержит Predicate для каждого объекта ByteMatchSet, IPSet, SizeConstraintSet, SqlInjectionMatchSet или XssMatchSet в правиле Пример: [{'byte_match_set_id': '47b822b5-abcd-1234-faaf-1234567890', 'byte_match_tuples': [{'field_to_match': {'type': 'QUERY_STRING'}, 'positional_constraint': 'STARTS_WITH', 'target_string': 'bobbins', 'text_transformation': 'NONE'}], 'name': 'bobbins', 'negated': False, 'type': 'ByteMatch'}]

Статус

Этот модуль не гарантирует обратную совместимость интерфейса. [превью]
Этот модуль поддерживается сообществом Ansible. [сообщество]

Авторы

Mike Mochan (@mmochan)
Will Thames (@willthames)

END_OF_DOCUMENT_MARKER

Подсказка

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

© 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/aws_waf_info_module.html