ec2_vpc_nacl_facts - Сбор фактов о правилах доступа к сети в VPC AWS

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

Краткое описание
Требования (для хоста, на котором выполняется модуль)
Параметры
Примеры
Возвращаемые значения
Примечания
- Статус

Краткое описание

Сбор фактов о правилах доступа к сети в VPC AWS

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

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
ec2_url	нет			URL для подключения к EC2 или вашему облаку Eucalyptus (по умолчанию модуль использует конечные точки EC2). Игнорируется для модулей, где требуется регион. Должен быть указан для всех остальных модулей, если регион не используется. Если не задан, используется значение переменной окружения EC2_URL, если она есть.
filters	нет			Словарь фильтров для применения. Каждый элемент словаря состоит из ключа фильтра и значения фильтра. См. http://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeNetworkAcls.html для возможных фильтров. Имена и значения фильтров чувствительны к регистру.
nacl_ids	нет			Список идентификаторов правил доступа к сети, для которых нужно получить данные.
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
validate_certs (добавлен в 1.5)	нет	да	да нет	При значении "нет", сертификаты SSL не будут проверены для версий boto >= 2.6.0.

Примеры

# Note: These examples do not set authentication details, see the AWS Guide for details.

# Gather facts about all Network ACLs:
- name: Get All NACLs
  register: all_nacls
  ec2_vpc_nacl_facts:
    region: us-west-2

# Retrieve default Network ACLs:
- name: Get Default NACLs
  register: default_nacls
  ec2_vpc_nacl_facts:
    region: us-west-2
    filters:
      'default': 'true'

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

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

имя

описание

возвращается

тип

пример

nacl

Возвращает массив сложных объектов, как описано ниже.

успех

сложный

содержит:

имя	описание	возвращается	тип
is_default	True, если NACL является по умолчанию для своей VPC.	всегда	булево
subnets	Список идентификаторов подсетей, связанных с NACL.	всегда	список строк
ingress	Список правил NACL для входящего трафика.	всегда	список списков
egress	Список правил NACL для исходящего трафика.	всегда	список списков
tags	Словарь тегов, связанных с NACL.	всегда	словарь
vpc_id	Идентификатор VPC, к которому прикреплен NACL.	всегда	строка
nacl_id	Идентификатор списка управления сетевым доступом.	всегда	строка

Примечания

Примечание

По умолчанию модуль возвращает все правила доступа к сети.
Если параметры не заданы в модуле, можно использовать следующие переменные среды в порядке убывания приоритета 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

Статус

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

Для помощи в разработке модулей, если вам это интересно, прочитайте Информация о сообществе и вклад, Тестирование Ansible и Разработка модулей.

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