Модуль amazon.aws.ec2_metadata_facts – Сбор фактов (метаданных экземпляра) о удалённых хостах в EC2
Примечание
Этот модуль входит в коллекцию amazon.aws (версия 8.2.1).
Эта коллекция, возможно, уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install amazon.aws.
Чтобы использовать его в плейбуке, укажите: amazon.aws.ec2_metadata_facts.
Добавлена в amazon.aws 1.0.0
Описание
- Этот модуль извлекает данные из конечной точки метаданных экземпляра в EC2, согласно https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-metadata.html.
- Модуль должен вызываться непосредственно внутри экземпляра EC2.
- Модуль настроен на использование ориентированного на сессии сервиса метаданных экземпляра v2 (IMDSv2) https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/configuring-instance-metadata-service.html.
- Если для экземпляра EC2 параметр HttpEndpoint https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_ModifyInstanceMetadataOptions.html#API_ModifyInstanceMetadataOptions_RequestParameters установлен в значение «выключено», модуль вернёт ошибку при получении токена сессии.
Параметры
Параметр | Комментарии |
|---|---|
metadata_token_ttl_seconds целое число добавлено в amazon.aws 8.2.0 | Укажите значение для заголовка Значение должно находиться в диапазоне от По умолчанию: |
Примечания
Примечание
- Параметры для фильтрации ec2_metadata_facts могут быть добавлены позднее.
Примеры
# Gather EC2 metadata facts
- amazon.aws.ec2_metadata_facts:
# Set a bigger value for X-aws-ec2-metadata-token-ttl-seconds header
- amazon.aws.ec2_metadata_facts:
metadata_token_ttl_seconds: 240
- debug:
msg: "This instance is a t1.micro"
when: ansible_ec2_instance_type == "t1.micro"
Возвращаемые факты
Факты, возвращаемые этим модулем, добавляются/обновляются в фактах хоста hostvars и могут быть использованы по имени, как и любой другой факт хоста. Их не нужно регистрировать для использования.
Ключ | Описание |
|---|---|
ansible_ec2_ami_id string | Идентификатор AMI, используемый для запуска экземпляра. Возвращается: success Пример: |
ansible_ec2_ami_launch_index string | Если вы запустили несколько экземпляров одновременно, это значение указывает порядок запуска экземпляра. Значение первого запущенного экземпляра равно 0. Возвращается: success Пример: |
ansible_ec2_ami_manifest_path string | Путь к файлу манифеста AMI в Amazon S3. Если вы использовали AMI на основе Amazon EBS для запуска экземпляра, возвращаемый результат неизвестен. Возвращается: success Пример: |
ansible_ec2_ancestor_ami_ids string | Идентификаторы AMI любых экземпляров, которые были переупакованы для создания этого AMI. Это значение будет существовать только в том случае, если файл манифеста AMI содержал ключ ancestor-amis. Возвращается: success Пример: |
ansible_ec2_block_device_mapping_ami string | Виртуальное устройство, содержащее корневую/загрузочную файловую систему. Возвращается: success Пример: |
ansible_ec2_block_device_mapping_ebsN string | Виртуальные устройства, связанные с томами Amazon EBS, если таковые имеются. Тома Amazon EBS доступны в метаданных только в том случае, если они присутствовали во время запуска или при последнем запуске экземпляра. N указывает индекс тома Amazon EBS (например, ebs1 или ebs2). Возвращается: success Пример: |
ansible_ec2_block_device_mapping_ephemeralN string | Виртуальные устройства, связанные с эфемерными устройствами, если таковые имеются. N указывает индекс эфемерного тома. Возвращается: success Пример: |
ansible_ec2_block_device_mapping_root string | Виртуальные устройства или разделы, связанные с корневыми устройствами или разделами на виртуальном устройстве, где корневая файловая система (/ или C) связана с данным экземпляром. Возвращается: success Пример: |
ansible_ec2_block_device_mapping_swap string | Виртуальные устройства, связанные со свопом. Не всегда присутствует. Возвращается: success Пример: |
ansible_ec2_fws_instance_monitoring string | Значение, показывающее, включил ли клиент подробный мониторинг с частотой одна минута в CloudWatch. Возвращается: success Пример: |
ansible_ec2_hostname string | Частное имя хоста IPv4 экземпляра. В случаях, когда присутствуют несколько сетевых интерфейсов, это относится к устройству eth0 (устройство, номер устройства которого равен 0). Возвращается: success Пример: |
ansible_ec2_iam_info complex | Если с экземпляром связана роль IAM, содержит информацию о последнем обновлении профиля экземпляра, включая дату последнего обновления экземпляра LastUpdated, InstanceProfileArn и InstanceProfileId. В противном случае отсутствует. Возвращается: success Пример: |
|
InstanceProfileArn string |
ARN профиля экземпляра, связанного с экземпляром. Возвращается: success |
|
InstanceProfileId string |
Идентификатор профиля экземпляра, связанного с экземпляром. Возвращается: success |
|
LastUpdated string |
Последнее время изменения связи профиля экземпляра с экземпляром. Возвращается: success |
ansible_ec2_iam_info_instanceprofilearn string | ARN профиля IAM для экземпляра. Возвращено: success Пример: |
ansible_ec2_iam_info_instanceprofileid string | ID профиля IAM для экземпляра. Возвращено: success Пример: |
ansible_ec2_iam_info_lastupdated string | Время последнего обновления информации IAM. Возвращено: success Пример: |
ansible_ec2_iam_instance_profile_role string | Роль IAM для профиля экземпляра. Возвращено: success Пример: |
ansible_ec2_iam_security_credentials_role_name string | Если экземпляру назначена роль IAM, role-name — это имя роли, содержащее временные учетные данные безопасности, связанные с ролью. В противном случае, отсутствует. Возвращено: success Пример: |
ansible_ec2_iam_security_credentials_role_name_accesskeyid string | ID ключа доступа к роли IAM. Возвращено: success Пример: |
ansible_ec2_iam_security_credentials_role_name_code string | Код IAM. Возвращено: success Пример: |
ansible_ec2_iam_security_credentials_role_name_expiration string | Время истечения срока действия учетных данных роли IAM. Возвращено: success Пример: |
ansible_ec2_iam_security_credentials_role_name_lastupdated string | Время последнего обновления роли IAM. Возвращено: success Пример: |
ansible_ec2_iam_security_credentials_role_name_secretaccesskey string | Секретный ключ доступа к роли IAM. Возвращено: success Пример: |
ansible_ec2_iam_security_credentials_role_name_token string | Токен роли IAM. Возвращено: success Пример: |
ansible_ec2_iam_security_credentials_role_name_type string | Тип роли IAM. Возвращено: success Пример: |
ansible_ec2_instance_action string | Уведомляет экземпляр, что он должен перезапуститься для подготовки к упаковке. Возвращено: success Пример: |
ansible_ec2_instance_id string | ID этого экземпляра. Возвращено: success Пример: |
ansible_ec2_instance_identity_document string | JSON, содержащий атрибуты экземпляра, такие как instance-id, частный IP-адрес и т. д. Возвращено: success Пример: |
ansible_ec2_instance_identity_document_accountid string | Возвращено: success Пример: |
ansible_ec2_instance_identity_document_architecture string | Системная архитектура экземпляра. Возвращено: success Пример: |
ansible_ec2_instance_identity_document_availabilityzone string | Зона доступности, в которой был запущен экземпляр. Возвращено: success Пример: |
ansible_ec2_instance_identity_document_billingproducts string | Тарификационные продукты для этого экземпляра. Возвращено: success Пример: |
ansible_ec2_instance_identity_document_devpayproductcodes string | Коды продуктов для запущенного образа AMI. Возвращено: success Пример: |
ansible_ec2_instance_identity_document_imageid string | Идентификатор AMI, использованный для запуска экземпляра. Возвращено: success Пример: |
ansible_ec2_instance_identity_document_instanceid string | Идентификатор этого экземпляра. Возвращено: success Пример: |
ansible_ec2_instance_identity_document_instancetype string | Тип экземпляра. Возвращено: success Пример: |
ansible_ec2_instance_identity_document_kernelid string | Идентификатор ядра, запущенного с этим экземпляром, если применимо. Возвращено: success Пример: |
ansible_ec2_instance_identity_document_pendingtime string | Время ожидания экземпляра. Возвращено: success Пример: |
ansible_ec2_instance_identity_document_privateip string | Приватный IPv4-адрес экземпляра. В случаях наличия нескольких сетевых интерфейсов, это относится к устройству eth0 (устройство с номером устройства 0). Возвращено: success Пример: |
ansible_ec2_instance_identity_document_ramdiskid string | Идентификатор RAM-диска, указанного во время запуска, если применимо. Возвращено: success Пример: |
ansible_ec2_instance_identity_document_region string | Регион, в котором был запущен экземпляр. Возвращено: success Пример: |
ansible_ec2_instance_identity_document_version string | Версия идентификационного документа. Возвращено: success Пример: |
ansible_ec2_instance_identity_pkcs7 string | Используется для проверки подлинности документа и его содержимого по подписи. Возвращено: success Пример: |
ansible_ec2_instance_identity_rsa2048 string | Используется для проверки подлинности документа и его содержимого по подписи. Возвращено: success Пример: |
ansible_ec2_instance_identity_signature string | Данные, которые могут быть использованы другими сторонами для проверки их происхождения и подлинности. Возвращено: success Пример: |
ansible_ec2_instance_life_cycle string | Вариант приобретения экземпляра. Возвращено: success Пример: |
ansible_ec2_instance_tags_keys list / elements=string added in amazon.aws 5.5.0 | Список ключей тегов экземпляра. Возвращает пустой список, если доступ к тегам (InstanceMetadataTags) в метаданных экземпляра не включен. Возвращено: success Пример: |
ansible_ec2_instance_type string | Тип экземпляра. Возвращено: success Пример: |
ansible_ec2_local_hostname string | Частное имя хоста IPv4 DNS экземпляра. В случаях, когда присутствуют несколько сетевых интерфейсов, это относится к устройству eth0 (устройство, номер которого равен 0). Возвращено: success Пример: |
ansible_ec2_local_ipv4 string | Частный IPv4-адрес экземпляра. В случаях, когда присутствуют несколько сетевых интерфейсов, это относится к устройству eth0 (устройство, номер которого равен 0). Возвращено: success Пример: |
ansible_ec2_mac string | MAC-адрес экземпляра. В случаях, когда присутствуют несколько сетевых интерфейсов, это относится к устройству eth0 (устройство, номер которого равен 0). Возвращено: success Пример: |
ansible_ec2_metrics_vhostmd string | Метрики; больше недоступны. Возвращено: success Пример: |
ansible_ec2_network_interfaces_macs_mac_address_device_number string | Уникальный номер устройства, связанный с этим интерфейсом. Номер устройства соответствует имени устройства; например, номер устройства 2 соответствует устройству eth2. Эта категория соответствует полям DeviceIndex и device-index, которые используются API Amazon EC2 и командами EC2 для AWS CLI. Возвращено: success Пример: |
ansible_ec2_network_interfaces_macs_mac_address_interface_id string | Идентификатор эластичного сетевого интерфейса. Возвращено: success Пример: |
ansible_ec2_network_interfaces_macs_mac_address_ipv4_associations_ip_address string | Частные IPv4-адреса, связанные с каждым общедоступным IP-адресом и назначенные этому интерфейсу. Возвращено: success Пример: |
ansible_ec2_network_interfaces_macs_mac_address_ipv6s string | IPv6-адреса, связанные с интерфейсом. Возвращается только для экземпляров, запущенных в VPC. Возвращено: success Пример: |
ansible_ec2_network_interfaces_macs_mac_address_local_hostname string | Локальное имя хоста интерфейса. Возвращено: success Пример: |
ansible_ec2_network_interfaces_macs_mac_address_local_ipv4s string | Частные IPv4-адреса, связанные с интерфейсом. Возвращено: success Пример: |
ansible_ec2_network_interfaces_macs_mac_address_mac string | MAC-адрес экземпляра. Возвращено: success Пример: |
ansible_ec2_network_interfaces_macs_mac_address_owner_id string | Идентификатор владельца сетевого интерфейса. В средах с несколькими интерфейсами интерфейс может быть подключен третьей стороной, например, Elastic Load Balancing. Трафик на интерфейсе всегда оплачивается владельцем интерфейса. Возвращено: success Пример: |
ansible_ec2_network_interfaces_macs_mac_address_public_hostname string | Общедоступное DNS-имя (IPv4) интерфейса. Если экземпляр находится в VPC, эта категория возвращается только в том случае, если атрибут enableDnsHostnames установлен в true. Возвращено: success Пример: |
ansible_ec2_network_interfaces_macs_mac_address_public_ipv4s string | IP-адреса Elastic IP, связанные с интерфейсом. На экземпляре может быть несколько IPv4-адресов. Возвращено: success Пример: |
ansible_ec2_network_interfaces_macs_mac_address_security_group_ids string | Идентификаторы групп безопасности, к которым принадлежит сетевой интерфейс. Возвращается только для экземпляров, запущенных в VPC. Возвращено: success Пример: |
ansible_ec2_network_interfaces_macs_mac_address_security_groups string | Группы безопасности, к которым принадлежит сетевой интерфейс. Возвращается только для экземпляров, запущенных в VPC. Возвращено: success Пример: |
ansible_ec2_network_interfaces_macs_mac_address_subnet_id string | Идентификатор подсети, в которой находится интерфейс. Возвращается только для экземпляров, запущенных в VPC. Возвращено: success Пример: |
ansible_ec2_network_interfaces_macs_mac_address_subnet_ipv4_cidr_block string | IPv4 CIDR-блок подсети, в которой находится интерфейс. Возвращается только для экземпляров, запущенных в VPC. Возвращено: success Пример: |
ansible_ec2_network_interfaces_macs_mac_address_subnet_ipv6_cidr_blocks string | IPv6 CIDR-блок подсети, в которой находится интерфейс. Возвращается только для экземпляров, запущенных в VPC. Возвращено: success Пример: |
ansible_ec2_network_interfaces_macs_mac_address_vpc_id string | Идентификатор VPC, в котором находится интерфейс. Возвращается только для экземпляров, запущенных в VPC. Возвращено: success Пример: |
ansible_ec2_network_interfaces_macs_mac_address_vpc_ipv4_cidr_block string | IPv4 CIDR-блок VPC, в котором находится интерфейс. Возвращается только для экземпляров, запущенных в VPC. Возвращено: success Пример: |
ansible_ec2_network_interfaces_macs_mac_address_vpc_ipv4_cidr_blocks string | IPv4 CIDR-блок VPC, в котором находится интерфейс. Возвращается только для экземпляров, запущенных в VPC. Возвращено: success Пример: |
ansible_ec2_network_interfaces_macs_mac_address_vpc_ipv6_cidr_blocks string | IPv6 CIDR-блок VPC, в котором находится интерфейс. Возвращается только для экземпляров, запущенных в VPC. Возвращено: success Пример: |
ansible_ec2_placement_availability_zone string | Зона доступности, в которой был запущен экземпляр. Возвращено: success Пример: |
ansible_ec2_placement_region строка | Регион, в котором запущен экземпляр. Возвращено: success Пример: |
ansible_ec2_product_codes строка | Коды продуктов, связанные с экземпляром, если таковые имеются. Возвращено: success Пример: |
ansible_ec2_profile строка | Профили аппаратного обеспечения экземпляра EC2. Возвращено: success Пример: |
ansible_ec2_public_hostname строка | Общедоступный DNS-адрес экземпляра. Если экземпляр находится в VPC, эта категория возвращается только в том случае, если атрибут enableDnsHostnames установлен в значение true. Возвращено: success Пример: |
ansible_ec2_public_ipv4 строка | Общедоступный IPv4-адрес. Если экземпляру назначен Elastic IP-адрес, возвращаемое значение — Elastic IP-адрес. Возвращено: success Пример: |
ansible_ec2_public_key строка | Общедоступный ключ. Доступен только в случае, если он был указан при запуске экземпляра. Возвращено: success Пример: |
ansible_ec2_ramdisk_id строка | Идентификатор RAM-диска, указанный при запуске, если применимо. Возвращено: success Пример: |
ansible_ec2_reservation_id строка | Идентификатор бронирования. Возвращено: success Пример: |
ansible_ec2_security_groups строка | Названия групп безопасности, применённые к экземпляру. После запуска можно изменить только группы безопасности экземпляров, работающих в VPC. Эти изменения отражаются здесь и в network/interfaces/macs/mac/security-groups. Возвращено: success Пример: |
ansible_ec2_services_domain строка | Домен AWS-ресурсов для региона; например, amazonaws.com для us-east-1. Возвращено: success Пример: |
ansible_ec2_services_partition строка | Раздел, в котором находится ресурс. Для стандартных AWS-регионов раздел — aws. Если у вас есть ресурсы в других разделах, раздел — aws-partitionname. Например, раздел для ресурсов в регионе Китай (Пекин) — aws-cn. Возвращено: success Пример: |
ansible_ec2_spot_termination_time строка | Приблизительное время (в формате UTC), когда операционная система вашего Spot-экземпляра получит сигнал о завершении работы. Этот элемент присутствует и содержит временное значение только в том случае, если Spot-экземпляр был помечен Amazon EC2 для завершения работы. Элемент termination-time не устанавливается, если вы завершили работу Spot-экземпляра самостоятельно. Возвращено: success Пример: |
ansible_ec2_user_data строка | Данные пользователя экземпляра. Возвращено: success Пример: |
Ссылки на коллекцию
© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/amazon/aws/ec2_metadata_facts_module.html
