meraki_snmp – Управление организациями в облаке Meraki
Новое в версии 2.6.
Обзор
- Позволяет управлять настройками SNMP для Meraki.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| auth_key строка | Ключ аутентификации, предоставленный панелью управления. Требуется, если переменная среды MERAKI_KEY не задана. | |
| host строка | По умолчанию: "api.meraki.com" | Имя хоста панели управления Meraki. Может использоваться для доступа к региональным средам Meraki, таким как Китай. |
| org_id целое число | Идентификатор организации. | |
| org_name строка | Имя организации. псевдонимы: организация | |
| output_level строка |
| Устанавливает объем отладочной информации во время выполнения модуля. |
| peer_ips - | Список IP-адресов, разделенных точкой с запятой, которые могут выполнять запросы SNMP. | |
| state - |
| Указывает, следует ли запрашивать или изменять информацию SNMP. |
| timeout целое число | По умолчанию: 30 | Время ожидания для HTTP-запросов. |
| use_https логический тип |
| Если no, то будет использоваться HTTP. В противном случае будет использоваться HTTPS.Поле полезно только для внутренних разработчиков Meraki. |
| use_proxy логический тип |
| Если no, прокси не будет использоваться, даже если он определён в переменной окружения на целевых хостах. |
| v2c_enabled логический тип |
| Указывает, включен ли SNMPv2c. |
| v3_auth_mode - |
| Устанавливает режим аутентификации для SNMPv3. |
| v3_auth_pass - | Пароль аутентификации для SNMPv3. Длина пароля должна быть не менее 8 символов. | |
| v3_enabled логический тип |
| Указывает, включен ли SNMPv3. |
| v3_priv_mode - |
| Указывает режим конфиденциальности для SNMPv3. |
| v3_priv_pass - | Пароль конфиденциальности для SNMPv3. Длина пароля должна быть не менее 8 символов. | |
| validate_certs логический тип |
| Требовать проверку HTTP-сертификатов. |
Примечания
Примечание
- Дополнительную информацию об API Meraki можно найти по адресу https://dashboard.meraki.com/api_docs.
- Некоторые параметры, вероятно, используются только разработчиками внутри Meraki.
Примеры
- name: Query SNMP values
meraki_snmp:
auth_key: abc12345
org_name: YourOrg
state: query
delegate_to: localhost
- name: Enable SNMPv2
meraki_snmp:
auth_key: abc12345
org_name: YourOrg
state: present
v2c_enabled: yes
delegate_to: localhost
- name: Disable SNMPv2
meraki_snmp:
auth_key: abc12345
org_name: YourOrg
state: present
v2c_enabled: no
delegate_to: localhost
- name: Enable SNMPv3
meraki_snmp:
auth_key: abc12345
org_name: YourOrg
state: present
v3_enabled: true
v3_auth_mode: SHA
v3_auth_pass: ansiblepass
v3_priv_mode: AES128
v3_priv_pass: ansiblepass
peer_ips: 192.0.1.1;192.0.1.2
delegate_to: localhost
Возвращаемые значения
Общие возвращаемые значения описаны здесь, а следующие поля уникальны для этого модуля:
| Ключ | Возвращается | Описание | |
|---|---|---|---|
| data сложный тип | всегда | Информация о настройках SNMP. | |
| hostname строка | успех | Имя хоста сервера SNMP. Пример: n1.meraki.com | |
| peerIps строка | успех | Список IP-адресов, разделенных точкой с запятой, которые могут получать информацию SNMP. Пример: 192.0.1.1 | |
| port строка | успех | Номер порта SNMP. Пример: 16100 | |
| v2cEnabled логический тип | успех | Показывает состояние включения SNMPv2c Пример: True | |
| v2CommunityString строка | Когда SNMPv2c включен. | Автоматически сгенерированная строка сообщества для SNMPv2c. Пример: o/8zd-JaSb | |
| v3AuthMode строка | успех | Режим аутентификации SNMP версии 3, либо MD5, либо SHA. Пример: SHA | |
| v3Enabled логический тип | успех | Показывает состояние включения SNMPv3 Пример: True | |
| v3PrivMode строка | успех | Режим конфиденциальности SNMP версии 3, DES или AES128. Пример: AES128 | |
| v3User строка | Когда SNMPv3 включен. | Автоматически сгенерированное имя пользователя для SNMPv3. Пример: o/8zd-JaSb | |
Статус
- Данный модуль не гарантирует обратной совместимости интерфейса. [превью]
- Этот модуль поддерживается сообществом Ansible. [сообщество]
Авторы
- Kevin Breit (@kbreit)
Подсказка
Если вы обнаружите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 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/meraki_snmp_module.html
