Spec-Zone.ru › Ansible 2.4

ec2_metadata_facts - Сбор фактов (метаданных экземпляра) о удалённых хостах в ec2

  • Краткое описание
  • Примеры
  • Возвращаемые значения
  • Примечания
    • Статус
    • Информация о техническом обслуживании

Краткое описание

  • Этот модуль извлекает данные из конечной точки метаданных экземпляра в ec2 в соответствии с http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-metadata.html. Модуль должен вызываться изнутри самого экземпляра EC2.

Примеры

# Gather EC2 metadata facts
- ec2_metadata_facts:

- debug:
    msg: "This instance is a t1.micro"
  when: ansible_ec2_instance_type == "t1.micro"

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

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

Имя Описание Возвращаемое Тип Пример
ansible_facts
Словарь новых фактов, представляющих обнаруженные свойства экземпляра EC2.
изменено сложный
содержит:
Имя Описание Возвращаемое значение Тип Пример
ansible_ec2_ami_launch_index
Если вы запустили более одной инстанции одновременно, это значение указывает на порядок запуска инстанции. Значение первой запущенной инстанции равно 0.
строка 0
ansible_ec2_services_partition
Раздел, в котором находится ресурс. Для стандартных регионов AWS раздел — aws. Если у вас есть ресурсы в других разделах, раздел — aws-partitionname. Например, раздел для ресурсов в регионе Китай (Пекин) — aws-cn.
строка aws
ansible_ec2_iam_security_credentials__accesskeyid
ID ключа доступа роли IAM.
строка
ansible_ec2_iam_security_credentials__lastupdated
Время последнего обновления роли IAM.
строка 2017-05-12T02:40:44Z
ansible_ec2_spot_termination_time
Приблизительное время (в формате UTC), когда операционная система вашей инстанции Spot получит сигнал на отключение. Этот элемент присутствует и содержит значение времени только в том случае, если инстанция Spot была помечена Amazon EC2 для завершения работы. Элемент termination-time не устанавливается во времени, если вы сами завершили работу инстанции Spot.
строка 2015-01-05T18:02:00Z
ansible_ec2_iam_instance_profile_role
Роль профиля инстанции IAM.
строка role_name
ansible_ec2_security_groups
Имена применённых к инстанции групп безопасности. После запуска вы можете изменить группы безопасности только для инстанций, работающих в VPC. Такие изменения отражаются здесь и в network/interfaces/macs/mac/security-groups.
строка securitygroup1,securitygroup2
ansible_ec2_network_interfaces_macs__vpc_id
ID VPC, в котором находится интерфейс. Возвращается только для инстанций, запущенных в VPC.
строка vpc-0123456
ansible_ec2_network_interfaces_macs__public_ipv4s
Указанные Elastic IP-адреса, связанные с интерфейсом. На инстанции может быть несколько IPv4-адресов.
строка 1.2.3.4
ansible_ec2_instance_identity_document_ramdiskid
ID диска RAM, указанного во время запуска (если применимо).
строка
ansible_ec2_profile
Профиль аппаратного обеспечения инстанции EC2.
строка default-hvm
ansible_ec2_network_interfaces_macs__vpc_ipv4_cidr_blocks
IPv4 CIDR-блок VPC, в котором находится интерфейс. Возвращается только для инстанций, запущенных в VPC.
строка 10.0.0.0/16
ansible_ec2_placement_region
Регион, в котором запущена инстанция.
строка us-east-1
ansible_ec2_ami_id
AMI ID, используемый для запуска инстанции.
строка ami-XXXXXXXX
ansible_ec2_reservation_id
ID резервации.
строка r-0123456789abcdef0
ansible_ec2_block_device_mapping_root
Виртуальные устройства или разделы, связанные с корневыми устройствами или разделами виртуального устройства, где корневая файловая система (/ или C) связана с данной инстанцией.
строка /dev/sda1
ansible_ec2_instance_identity_document_kernelid
ID ядра, запущенного с этой инстанцией (если применимо).
строка
ansible_ec2_instance_identity_document_instanceid
ID этой инстанции.
строка i-0123456789abcdef0
ansible_ec2_local_hostname
Имя хоста частного IPv4 DNS инстанции. В случаях, когда присутствует несколько сетевых интерфейсов, это относится к устройству eth0 (устройство с номером устройства 0).
строка ip-10-0-0-1.ec2.internal
ansible_ec2_block_device_mapping_swap
Виртуальные устройства, связанные со свопом. Не всегда присутствует.
строка /dev/sda2
ansible_ec2_placement_availability_zone
Зона доступности, в которой запущена инстанция.
строка us-east-1a
ansible_ec2_network_interfaces_macs__owner_id
ID владельца сетевого интерфейса. В средах с несколькими интерфейсами интерфейс может быть подключен третьей стороной, например, Elastic Load Balancing. Трафик по интерфейсу всегда оплачивается владельцем интерфейса.
строка 01234567890
ansible_ec2_instance_identity_document_accountid строка 012345678901
ansible_ec2_hostname
Имя хоста частного IPv4 DNS инстанции. В случаях, когда присутствует несколько сетевых интерфейсов, это относится к устройству eth0 (устройство с номером устройства 0).
строка ip-10-0-0-1.ec2.internal
ansible_ec2_network_interfaces_macs__security_groups
Группы безопасности, к которым принадлежит сетевой интерфейс. Возвращается только для инстанций, запущенных в VPC.
строка secgroup1,secgroup2
ansible_ec2_iam_info_instanceprofileid
ID профиля инстанции IAM.
строка
ansible_ec2_network_interfaces_macs__subnet_ipv6_cidr_blocks
IPv6 CIDR-блок подсети, в которой находится интерфейс. Возвращается только для инстанций, запущенных в VPC.
строка
ansible_ec2_instance_identity_signature
Данные, которые могут быть использованы другими сторонами для проверки происхождения и подлинности.
строка
ansible_ec2_instance_identity_document
JSON, содержащий атрибуты инстанции, такие как идентификатор инстанции, частный IP-адрес и т. д.
строка
ansible_ec2_fws_instance_monitoring
Значение, показывающее, включил ли клиент подробное мониторинг в CloudWatch с частотой в одну минуту.
строка enabled
ansible_ec2_public_ipv4
Публичный IPv4-адрес. Если с инстанцией связан Elastic IP-адрес, возвращаемое значение — Elastic IP-адрес.
строка 1.2.3.4
ansible_ec2_iam_info_lastupdated
Время последнего обновления информации IAM.
строка 2017-05-12T02:42:27Z
ansible_ec2_network_interfaces_macs__vpc_ipv4_cidr_block
IPv4 CIDR-блок VPC, в котором находится интерфейс. Возвращается только для инстанций, запущенных в VPC.
строка 10.0.0.0/16
ansible_ec2_public_hostname
Публичный DNS инстанции. Если инстанция находится в VPC, эта категория возвращается только в том случае, если атрибут enableDnsHostnames установлен в значение true.
строка ec2-1-2-3-4.compute-1.amazonaws.com
ansible_ec2_network_interfaces_macs__local_ipv4s
Частные IPv4-адреса, связанные с интерфейсом.
строка
ansible_ec2_instance_identity_document_version
Версия документа идентификации.
строка 2010-08-31
ansible_ec2_instance_identity_document_pendingtime
Время ожидания инстанции.
строка 2017-05-11T20:51:20Z
ansible_ec2_network_interfaces_macs__ipv6s
IPv6-адреса, связанные с интерфейсом. Возвращается только для инстанций, запущенных в VPC.
строка
ansible_ec2_iam_info_instanceprofilearn
ARN профиля инстанции IAM.
строка arn:aws:iam:::instance-profile/
ansible_ec2_services_domain
Домен для ресурсов AWS в регионе; например, amazonaws.com для us-east-1.
строка amazonaws.com
ansible_ec2_instance_identity_document_privateip
Частный IPv4-адрес инстанции. В случаях, когда присутствует несколько сетевых интерфейсов, это относится к устройству eth0 (устройство с номером устройства 0).
строка 10.0.0.1
ansible_ec2_ramdisk_id
ID диска RAM, указанного во время запуска (если применимо).
строка
ansible_ec2_iam_security_credentials__type
Тип роли IAM.
строка AWS-HMAC
ansible_ec2_user_data
Данные пользователя экземпляра.
строка #!/bin/bash
ansible_ec2_iam_info
Если с экземпляром связан IAM-роль, содержит информацию о последнем обновлении профиля экземпляра, включая дату LastUpdated, InstanceProfileArn и InstanceProfileId. В противном случае отсутствует.
сложный
ansible_ec2_iam_security_credentials__code
Код IAM.
строка Успешно
ansible_ec2_block_device_mapping_ami
Виртуальное устройство, содержащее корневую/загрузочную файловую систему.
строка /dev/sda1
ansible_ec2_instance_identity_document_availabilityzone
Зона доступности, в которой запущен экземпляр.
строка us-east-1a
ansible_ec2_instance_identity_document_region
Регион, в котором запущен экземпляр.
строка us-east-1
ansible_ec2_ami_manifest_path
Путь к файлу манифеста AMI в Amazon S3. Если для запуска экземпляра использовался AMI на основе Amazon EBS, возвращаемый результат неизвестен.
строка (неизвестно)
ansible_ec2_local_ipv4
Приватный IPv4-адрес экземпляра. В случаях, когда присутствует несколько сетевых интерфейсов, это относится к устройству eth0 (устройство с номером устройства 0).
строка 10.0.0.1
ansible_ec2_instance_action
Уведомляет экземпляр о необходимости перезагрузки в подготовке к объединению.
строка none
ansible_ec2_network_interfaces_macs__interface_id
Идентификатор эластичного сетевого интерфейса.
строка eni-12345678
ansible_ec2_iam_security_credentials__expiration
Время истечения срока действия учетных данных IAM-роли.
строка 2017-05-12T09:11:41Z
ansible_ec2_network_interfaces_macs__security_group_ids
Идентификаторы групп безопасности, к которым принадлежит сетевой интерфейс. Возвращается только для экземпляров, запущенных в VPC.
строка sg-01234567,sg-01234568
ansible_ec2_network_interfaces_macs__vpc_ipv6_cidr_blocks
IPv6 CIDR-блок VPC, в котором находится интерфейс. Возвращается только для экземпляров, запущенных в VPC.
строка
ansible_ec2_iam_security_credentials__secretaccesskey
Секретный ключ доступа IAM-роли.
строка
ansible_ec2_instance_identity_document_devpayproductcodes
Коды продуктов для запущенного AMI.
строка
ansible_ec2_block_device_mapping_ebsN
Виртуальные устройства, связанные с томами Amazon EBS, если они есть. Тома Amazon EBS доступны только в метаданных, если они были присутствуют при запуске или при последнем запуске экземпляра. N указывает индекс тома Amazon EBS (например, ebs1 или ebs2).
строка /dev/xvdb
ansible_ec2_network_interfaces_macs__mac
MAC-адрес экземпляра.
строка 00:11:22:33:44:55
ansible_ec2_instance_identity_document_billingproducts
Продукты для выставления счетов за этот экземпляр.
строка
ansible_ec2_iam_security_credentials__token
Токен IAM-роли.
строка
ansible_ec2_instance_identity_document_architecture
Архитектура системы экземпляра.
строка x86_64
ansible_ec2_public_key
Открытый ключ. Доступен только если он был предоставлен при запуске экземпляра.
строка
ansible_ec2_network_interfaces_macs__ipv4_associations_
Приватные IPv4-адреса, которые связаны с каждым общедоступным IP-адресом и назначены этому интерфейсу.
строка
ansible_ec2_ancestor_ami_ids
Идентификаторы AMI любых экземпляров, которые были объединены для создания этого AMI. Это значение будет существовать только в том случае, если файл манифеста AMI содержал ключ ancestor-amis.
строка (неизвестно)
ansible_ec2_instance_identity_pkcs7
Используется для проверки подлинности и содержимого документа по подписи.
строка
ansible_ec2_network_interfaces_macs__public_hostname
Общедоступный DNS-имя интерфейса (IPv4). Если экземпляр находится в VPC, эта категория возвращается только в том случае, если атрибут enableDnsHostnames имеет значение true.
строка ec2-1-2-3-4.compute-1.amazonaws.com
ansible_ec2_instance_id
Идентификатор этого экземпляра.
строка i-XXXXXXXXXXXXXXXXX
ansible_ec2_mac
MAC-адрес экземпляра. В случаях, когда присутствует несколько сетевых интерфейсов, это относится к устройству eth0 (устройство с номером устройства 0).
строка 00:11:22:33:44:55
ansible_ec2_instance_identity_document_imageid
Идентификатор AMI, используемый для запуска экземпляра.
строка ami-01234567
ansible_ec2_iam_security_credentials_
Если с экземпляром связан IAM-роль, role-name — это имя роли, и role-name содержит временные учетные данные, связанные с ролью. В противном случае отсутствует.
строка
ansible_ec2_network_interfaces_macs__device_number
Уникальный номер устройства, связанный с этим интерфейсом. Номер устройства соответствует имени устройства; например, номер устройства 2 относится к устройству eth2. Эта категория соответствует полям DeviceIndex и device-index, которые используются API Amazon EC2 и командами EC2 для AWS CLI.
строка 0
ansible_ec2_instance_type
Тип экземпляра.
строка m4.large
ansible_ec2_metrics_vhostmd
Метрики.
строка
ansible_ec2_network_interfaces_macs__subnet_id
Идентификатор подсети, в которой находится интерфейс. Возвращается только для экземпляров, запущенных в VPC.
строка subnet-01234567
ansible_ec2_network_interfaces_macs__local_hostname
Локальное имя хоста интерфейса.
строка
ansible_ec2_network_interfaces_macs__subnet_ipv4_cidr_block
IPv4 CIDR-блок подсети, в которой находится интерфейс. Возвращается только для экземпляров, запущенных в VPC.
строка 10.0.1.0/24
ansible_ec2_product_codes
Коды продуктов, связанные с экземпляром, если они есть.
строка aw0evgkw8e5c1q413zgy5pjce
ansible_ec2_instance_identity_rsa2048
Используется для проверки подлинности и содержимого документа по подписи.
строка
ansible_ec2_instance_identity_document_instancetype
Тип экземпляра.
строка m4.large
ansible_ec2_block_device_mapping_ephemeralN
Виртуальные устройства, связанные со временными устройствами, если они есть. N указывает индекс временного тома.
строка /dev/xvdc

Примечания

Примечание

  • Параметры для фильтрации ec2_metadata_facts могут быть добавлены позже.

Статус

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

Информация о техническом обслуживании

Дополнительную информацию о поддержке этого модуля компанией Red Hat см. в knowledge base article<https://access.redhat.com/articles/rhel-top-support-policies>

Для получения помощи в разработке модулей, если вы заинтересованы, пожалуйста, ознакомьтесь со статьей Информация о сообществе и участие, Тестирование Ansible и Разработка модулей.

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API