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
debug_botocore_endpoint_logs логический добавлено в 2.8	Варианты: нет ← да	Использование логгера botocore.endpoint для анализа уникальных (а не общих) API-вызовов "resource:action" во время задачи, выводя набор в ключ resource_actions результатов задачи. Используйте обратный вызов aws_resource_action для вывода общего списка, сделанного во время игры.
ec2_url строка		URL для подключения к EC2 или вашему облаку Eucalyptus (по умолчанию модуль будет использовать конечные точки EC2). Игнорируется для модулей, где требуется регион. Должен быть указан для всех остальных модулей, если регион не используется. Если не задан, используется значение переменной окружения EC2_URL, если таковая имеется.
filters -		Словарь фильтров для применения. Каждый элемент словаря состоит из ключа фильтра и значения фильтра. См. https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeNetworkInterfaces.html для возможных фильтров.
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 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. [community]

Авторы

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