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

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

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

Обзор

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

Состояние

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

Техническое обслуживание

Этот модуль помечен как сообщество, что означает, что он поддерживается сообществом Ansible. Подробнее см. в поддержке и обслуживании модулей.

Список других модулей, также поддерживаемых сообществом Ansible, см. здесь.

Автор

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.6/modules/ec2_eni_facts_module.html