snmp_facts – Получение фактов о устройстве с помощью SNMP
Описание
- Получение фактов о устройстве с помощью SNMP. Факты будут добавлены в ключ ansible_facts.
Требования
Ниже приведены требования, необходимые на хосте, на котором выполняется этот модуль.
- pysnmp
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| authkey строка | Ключ аутентификации. Требуется, если версия — v3. | |
| community строка | Строка сообщества SNMP, требуется, если версия — v2/v2c. | |
| host строка / обязательно | Указывает целевой SNMP-сервер (обычно {{ inventory_hostname }}). | |
| integrity строка |
| Алгоритм хеширования. Требуется, если версия — v3. |
| level строка |
| Уровень аутентификации. Требуется, если версия — v3. |
| privacy строка |
| Алгоритм шифрования. Требуется, если уровень — authPriv. |
| privkey строка | Ключ шифрования. Требуется, если версия — authPriv. | |
| username строка | Имя пользователя для SNMPv3. Требуется, если версия — v3. | |
| version строка / обязательно |
| Используемая версия SNMP, v2/v2c или v3. |
Примеры
- name: Gather facts with SNMP version 2
snmp_facts:
host: '{{ inventory_hostname }}'
version: v2c
community: public
delegate_to: local
- name: Gather facts using SNMP version 3
snmp_facts:
host: '{{ inventory_hostname }}'
version: v3
level: authPriv
integrity: sha
privacy: aes
username: snmp-user
authkey: abc12345
privkey: def6789
delegate_to: localhost
Возвращаемые значения
Общие возвращаемые значения описаны здесь. Ниже приведены поля, уникальные для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| ansible_all_ipv4_addresses список | успех | Список всех адресов IPv4. Пример: ['127.0.0.1', '172.17.0.1'] |
| ansible_interfaces словарь | успех | Словарь каждой сетевой интерфейса и ее метаданных. Пример: {'1': {'adminstatus': 'up', 'description': '', 'ifindex': '1', 'ipv4': [{'address': '127.0.0.1', 'netmask': '255.0.0.0'}], 'mac': '', 'mtu': '65536', 'name': 'lo', 'operstatus': 'up', 'speed': '65536'}, '2': {'adminstatus': 'up', 'description': '', 'ifindex': '2', 'ipv4': [{'address': '192.168.213.128', 'netmask': '255.255.255.0'}], 'mac': '000a305a52a1', 'mtu': '1500', 'name': 'Intel Corporation 82545EM Gigabit Ethernet Controller (Copper)', 'operstatus': 'up', 'speed': '1500'}} |
| ansible_syscontact строка | успех | Текстовая идентификация контактного лица для данного управляемого узла, вместе с информацией о том, как с ним связаться. Пример: Me <me@example.org> |
| ansible_sysdescr строка | успех | Текстовое описание сущности. Пример: Linux ubuntu-user 4.4.0-93-generic |
| ansible_syslocation строка | успех | Физическое расположение узла (например, `телефонный шкаф, 3-й этаж'). Пример: Sitting on the Dock of the Bay |
| ansible_sysname строка | успех | Административно заданное имя этого управляемого узла. Пример: ubuntu-user |
| ansible_sysobjectid строка | успех | Авторская идентификация поставщиком подсистемы управления сетью, содержащейся в сущности. Пример: 1.3.6.1.4.1.8072.3.2.10 |
| ansible_sysuptime целое число | успех | Время (в сотых долях секунды) с момента последней перезагрузки сетевой части системы. Пример: 42388 |
Статус
- Этот модуль не гарантирует обратную совместимость. [превью]
- Этот модуль поддерживается сообществом Ansible. [сообщество]
Авторы
- Patrick Ogenstad (@ogenstad)
Подсказка
Если вы заметили какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.9/modules/snmp_facts_module.html
