ec2_eni_facts - Сбор фактов о интерфейсах ec2 ENI в AWS

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

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

Обзор

Сбор фактов об интерфейсах ec2 ENI в AWS

Требования

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

boto
boto3
python >= 2.6

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
aws_access_key	Значение по умолчанию: None	Ключ доступа AWS. Если не задан, используется значение переменной среды AWS_ACCESS_KEY_ID, AWS_ACCESS_KEY или EC2_ACCESS_KEY. Псевдонимы: ec2_access_key, access_key
aws_secret_key	Значение по умолчанию: None	Секретный ключ AWS. Если не задан, используется значение переменной среды AWS_SECRET_ACCESS_KEY, AWS_SECRET_KEY или EC2_SECRET_KEY. Псевдонимы: ec2_secret_key, secret_key
ec2_url	Значение по умолчанию: None	URL для подключения к EC2 или вашему облаку Eucalyptus (по умолчанию модуль использует конечные точки EC2). Игнорируется для модулей, где требуется регион. Должен быть указан для всех других модулей, если не используется регион. Если не задан, используется значение переменной среды EC2_URL, если таковое есть.
filters	Значение по умолчанию: None	Словарь фильтров для применения. Каждый элемент словаря содержит ключ фильтра и значение фильтра. См. http://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeNetworkInterfaces.html для возможных фильтров.
profile (добавлено в 1.6)	Значение по умолчанию: None	Использует профиль 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)	Значение по умолчанию: None	Токен безопасности AWS STS. Если не задан, используется значение переменной среды AWS_SECURITY_TOKEN или EC2_SECURITY_TOKEN. Псевдонимы: access_token
validate_certs (добавлено в 1.5)	Варианты: no да ←	При значении "no" сертификаты 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), если учетные данные не предоставлены. См. http://boto.readthedocs.org/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 facts about all ENIs
- ec2_eni_facts:

# Gather facts about a particular ENI
- ec2_eni_facts:
    filters:
      network-interface-id: eni-xxxxxxx

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

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

Ключ		Возвращаемое значение	Описание
network_interfaces сложное		всегда	Список соответствующих эластичных сетевых интерфейсов
	status строка	всегда	Указывает, подключен ли сетевой интерфейс к экземпляру или нет Пример: в использовании
	description строка	всегда	Текстовое описание ENI Пример: Мой любимый сетевой интерфейс
	availability_zone строка	всегда	Зона доступности ENI Пример: us-east-1b
	interface_type строка	всегда	Тип сетевого интерфейса Пример: интерфейс
	ipv6_addresses список	всегда	Список адресов IPv6 для этого интерфейса
	requester_managed булево	всегда	Указывает, управляется ли сетевой интерфейс службой AWS.
	groups список	всегда	Список присоединённых групп безопасности Пример: [{'group_id': 'sg-26d0f1234', 'group_name': 'my_ec2_security_group'}]
	requester_id строка	всегда	Идентификатор сущности, запустившей ENI Пример: AIDAIONYVJQNIAZFT3ABC
	association словарь	всегда, пустой словарь, если ассоциации нет	Информация об ассоциированном эластичном IP-адресе (EIP) Пример: {'public_dns_name': 'ec2-52-1-0-63.compute-1.amazonaws.com', 'association_id': 'eipassoc-8sdf123', 'ip_owner_id': '4415120123456', 'public_ip': '52.1.0.63', 'allocation_id': 'eipalloc-5sdf123'}
	id строка	всегда	Идентификатор ENI (псевдоним для network_interface_id) Пример: eni-392fsdf
	source_dest_check булево	всегда	Указывает, выполняет ли сетевой интерфейс проверку источника/назначения.
	private_dns_name строка	всегда	Имя частного DNS для ENI Пример: ip-172-16-1-180.ec2.internal
	subnet_id строка	всегда	Идентификатор подсети, в которой находится ENI Пример: subnet-7bbf01234
	tag_set словарь	всегда	Словарь тегов, добавленных к ENI
	network_interface_id строка	всегда	Идентификатор ENI Пример: eni-392fsdf
	attachment словарь	всегда, пустой словарь, если ENI не подключен	Информация о подключённом экземпляре ec2 Пример: {'status': 'подключен', 'instance_id': 'i-15b8d3cadbafa1234', 'attachment_id': 'eni-attach-149d21234', 'attach_time': '2017-08-05T15:25:47+00:00', 'instance_owner_id': '4415120123456', 'device_index': 1, 'delete_on_termination': false}
	private_ip_addresses список	всегда	Список частных IP-адресов, прикрепленных к ENI
	mac_address строка	всегда	MAC-адрес сетевого интерфейса Пример: 0a:f8:10:2f:ab:a1
	private_ip_address строка	всегда	Частный IP-адрес для ENI Пример: 172.16.1.180
	vpc_id строка	всегда	Идентификатор VPC, к которому принадлежит сетевой интерфейс Пример: vpc-b3f1f123
	owner_id строка	всегда	Идентификатор учётной записи AWS владельца ENI Пример: 4415120123456

Состояние

Этот модуль помечен как превью, что означает, что он не гарантирует обратную совместимость.

Автор

Rob White (@wimnat)

Подсказка

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

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