f5networks.f5_modules.bigip_snmp_community – Управляет сообществами SNMP на BIG-IP.

Примечание

Этот плагин входит в состав коллекции f5networks.f5_modules (версия 1.6.0).

Для его установки используйте: ansible-galaxy collection install f5networks.f5_modules.

Для использования в плейбуке укажите: f5networks.f5_modules.bigip_snmp_community.

Новый в версии 1.0.0: из f5networks.f5_modules

Описание
Параметры
Примечания
Примеры
Возвращаемые значения

Описание

Помогает управлять сообществами Simple Network Management Protocol (SNMP) на системе BIG-IP. Этот модуль поддерживает различные версии SNMP. Обратите внимание на различные параметры, предлагаемые этим модулем, так как разные параметры работают для разных версий SNMP. Это важно, если вы смешиваете версии v2c и 3.

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
access строка		Варианты: ro rw только для чтения чтение/запись	Указывает уровень доступа пользователя к MIB. При создании новой общности, если этот параметр не указан, значение по умолчанию равно `ro`. При `ro`, указывает, что пользователь может просматривать MIB, но не может его изменять. При `rw`, указывает, что пользователь может просматривать и изменять MIB.
community строка			Указывает строку сообщества (пароль) для доступа к MIB. Этот параметр актуален только когда `version` равно `v1` или `v2c`. Если `version` отличается, этот параметр игнорируется.
ip_version строка		Варианты: 4 6	Указывает, относится ли запись к адресам IPv4 или IPv6. При создании новой общности, если это значение не указано, значение по умолчанию равно `4`. Этот параметр актуален только когда `version` равно `v1` или `v2c`. Если `version` отличается, этот параметр игнорируется.
name строка			Имя, идентифицирующее SNMP сообщество. Когда `version` равно `v1` или `v2c`, этот параметр обязателен. Имя `public` является зарезервированным именем на BIG-IP. Этот модуль обрабатывает это имя иначе, чем другие. Функционально, вы не увидите разницы.
oid строка			Указывает идентификатор объекта (OID) для записи. Когда `version` равно `v3`, этот параметр обязателен. Когда `version` равно `v1` или `v2c`, если это значение указано, то `source` не должно быть установлено в `all`.
partition строка		По умолчанию: "Общие"	Раздел устройства для управления ресурсами.
port целое число			Указывает порт для назначения ловушки. Этот параметр актуален только когда `version` равно `v1` или `v2c`. Если `version` отличается, этот параметр игнорируется.
provider словарь добавлен в 1.0.0 f5networks.f5_modules			Объект словаря, содержащий данные подключения.
	auth_provider строка		Настраивает поставщика аутентификации для получения токенов аутентификации от удаленного устройства. Этот параметр используется при работе с устройствами BIG-IQ.
	no_f5_teem булево	Варианты: нет да	Если `yes`, данные телеметрии TEEM не отправляются в F5. Можно опустить этот параметр, установив переменную среды `F5_TEEM`.
	password строка / обязательно		Пароль для учетной записи пользователя, используемой для подключения к BIG-IP. Можно опустить этот параметр, установив переменную среды `F5_PASSWORD`. псевдонимы: pass, pwd
	server строка / обязательно		Хост BIG-IP. Можно опустить этот параметр, установив переменную среды `F5_SERVER`.
	server_port целое число	По умолчанию: 443	Порт сервера BIG-IP. Можно опустить этот параметр, установив переменную среды `F5_SERVER_PORT`.
	timeout целое число		Указывает таймаут в секундах для связи с сетевым устройством при подключении или отправке команд. Если таймаут истекает до завершения операции, модуль выдаст ошибку.
	transport строка	Варианты: rest ←	Настраивает транспортное подключение для использования при подключении к удаленному устройству.
	user строка / обязательно		Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные привилегии на устройстве. Можно опустить этот параметр, установив переменную среды `F5_USER`.
	validate_certs булево	Варианты: нет да ←	Если `no`, сертификаты SSL не проверяются. Используйте только на сайтах, находящихся под вашим контролем, с самозаверенными сертификатами. Можно опустить этот параметр, установив переменную среды `F5_VALIDATE_CERTS`.
snmp_auth_password строка			Указывает пароль для пользователя. При создании нового SNMP `v3` сообщества, этот параметр обязателен. Это значение должно быть не менее 8 символов.
snmp_auth_protocol строка		Варианты: md5 sha none	Указывает метод аутентификации для пользователя. При `md5`, указывает, что система использует алгоритм MD5 для аутентификации пользователя. При `sha`, указывает, что система использует алгоритм SHA для аутентификации пользователя. При `none`, указывает, что аутентификация для пользователя не требуется. При создании нового SNMP `v3` сообщества, если этот параметр не указан, значение по умолчанию равно `sha`.
snmp_privacy_password строка			Указывает пароль для пользователя. При создании нового SNMP `v3` сообщества, этот параметр обязателен. Это значение должно быть не менее 8 символов.
snmp_privacy_protocol строка		Варианты: aes des none	Указывает протокол шифрования. При `aes`, указывает, что система шифрует информацию пользователя с помощью AES (Advanced Encryption Standard). При `des`, указывает, что система шифрует информацию пользователя с помощью DES (Data Encryption Standard). При `none`, указывает, что система не шифрует информацию пользователя. При создании нового SNMP `v3` сообщества, если этот параметр не указан, значение по умолчанию равно `aes`.
snmp_username строка			Указывает имя пользователя, которому необходимо предоставить доступ к SNMP v3 MIB. Этот параметр актуален только когда `version` равно `v3`. Если `version` отличается, этот параметр игнорируется. При создании нового SNMP `v3` сообщества, этот параметр обязателен. Этот параметр нельзя изменить после его установки.
source строка			Указывает исходный адрес для доступа к MIB. Этот параметр может принимать значение `all`. Если этот параметр не указан, значение равно `all`. Этот параметр актуален только когда `version` равно `v1` или `v2c`. Если `version` отличается, этот параметр игнорируется. Если `source` установлено в `all`, невозможно указать `oid`. Это вызовет ошибку. Вы должны указать этот параметр, когда `state` равно `absent`, чтобы удалить правильное сообщество. Чтобы удалить `public` SNMP сообщество, которое поставляется с BIG-IP, этот параметр должен быть `default`.
state строка		Варианты: present ← absent	Когда `present`, гарантирует, что список адресов и записи существуют. Когда `absent`, гарантирует удаление списка адресов.
update_password строка		Варианты: always ← on_create	`always` позволяет пользователям обновлять пароли. `on_create` устанавливает пароль только для вновь созданных ресурсов.
version строка		Варианты: v1 v2c ← v3	Указывает, к какой версии SNMP относится назначение ловушки.

Примечания

Примечание

Дополнительную информацию об использовании Ansible для управления устройствами F5 Networks см. на сайте https://www.ansible.com/integrations/networks/f5.
Требуется версия ПО BIG-IP >= 12.
Модули F5 работают только с текущей конфигурацией продукта F5. Чтобы убедиться, что конфигурация BIG-IP сохранится на диске, обязательно включите хотя бы одну задачу, использующую модуль f5networks.f5_modules.bigip_config для сохранения текущей конфигурации. Обратитесь к документации модуля для правильного использования модуля по сохранению текущей конфигурации.

Примеры

- name: Create an SMNP v2c read-only community
  bigip_snmp_community:
    name: foo
    version: v2c
    source: all
    oid: .1
    access: ro
    provider:
      password: secret
      server: lb.mydomain.com
      user: admin
  delegate_to: localhost

- name: Create an SMNP v3 read-write community
  bigip_snmp_community:
    name: foo
    version: v3
    snmp_username: foo
    snmp_auth_protocol: sha
    snmp_auth_password: secret
    snmp_privacy_protocol: aes
    snmp_privacy_password: secret
    oid: .1
    access: rw
    provider:
      password: secret
      server: lb.mydomain.com
      user: admin
  delegate_to: localhost

- name: Remove the default 'public' SNMP community
  bigip_snmp_community:
    name: public
    source: default
    state: absent
    provider:
      password: secret
      server: lb.mydomain.com
      user: admin
  delegate_to: localhost

Значения возврата

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

Ключ	Возвращаемое значение	Описание
access строка	изменилось	Новый уровень доступа к MIB. Пример: ro
community строка	изменилось	Новое значение сообщества. Пример: community1
ip_version строка	изменилось	Новое значение версии IP. Пример: 0.1
oid строка	изменилось	Новое значение OID. Пример: 0.1
snmp_auth_password строка	изменилось	Новый пароль для данного snmp_username. Пример: secret1
snmp_auth_protocol строка	изменилось	Новый протокол авторизации SNMP. Пример: sha
snmp_privacy_password строка	изменилось	Новый пароль для данного snmp_username. Пример: secret2
snmp_privacy_protocol строка	изменилось	Новый протокол конфиденциальности SNMP. Пример: aes
snmp_username строка	изменилось	Новое имя пользователя SNMP. Пример: user1
source строка	изменилось	Новый адрес источника для доступа к MIB. Пример: 1.1.1.1

Авторы

Tim Rupp (@caphrim007)
Wojciech Wypior (@wojtek0806)

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