ec2_vpc_nacl_info – Сбор информации о правилах доступа к сети в AWS VPC

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

Описание

Сбор информации о правилах доступа к сети в AWS VPC
Этот модуль назывался ec2_vpc_nacl_facts до Ansible 2.9. Способ использования не изменился.

Псевдонимы: ec2_vpc_nacl_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, если она есть.
filters -	Значение по умолчанию: {}	Словарь фильтров для применения. Каждый элемент словаря состоит из ключа фильтра и значения фильтра. См. https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeNetworkAcls.html для возможных фильтров. Названия и значения фильтров чувствительны к регистру.
nacl_ids -	Значение по умолчанию: []	Список идентификаторов правил доступа к сети для получения информации. Псевдонимы: nacl_id
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.

Примечания

Примечание

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

Примеры

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

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

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

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

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

Ключ		Возвращаемое значение	Описание
nacls сложный		успешно	Возвращает массив сложных объектов, как описано ниже.
	egress список списков	всегда	Список правил выхода NACL в следующем формате. `[rule no, protocol, allow/deny, v4 or v6 cidr, icmp_type, icmp_code, port from, port to]` Пример: [[100, 'all', 'allow', '0.0.0.0/0', None, None, None, None]]
	ingress список списков	всегда	Список правил входа NACL в следующем формате. `[rule no, protocol, allow/deny, v4 or v6 cidr, icmp_type, icmp_code, port from, port to]` Пример: [[100, 'tcp', 'allow', '0.0.0.0/0', None, None, 22, 22]]
	is_default булево	всегда	True, если NACL является значением по умолчанию для его VPC.
	nacl_id строка	всегда	Идентификатор правила доступа к сети.
	subnets список строк	всегда	Список идентификаторов подсетей, связанных с NACL.
	tags словарь	всегда	Словарь тегов, связанных с NACL.
	vpc_id строка	всегда	Идентификатор VPC, к которому подключен NACL.

Статус

Этот модуль гарантированно будет иметь изменения, обратные совместимости, в будущем. [stableinterface]
Этот модуль поддерживается сообществом Ansible. [community]

Авторы

Brad Davidson (@brandond)

Подсказка

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

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