meraki_syslog – Управление настройками сервера syslog в облаке Meraki
Новая версия 2.8.
Обзор
- Позволяет создавать и управлять серверами Syslog в Meraki.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| auth_key строка | Ключ аутентификации, предоставленный панелью управления. Требуется, если переменная окружения MERAKI_KEY не задана. | ||
| host строка | По умолчанию: "api.meraki.com" | Имя хоста панели управления Meraki. Может использоваться для доступа к региональным средам Meraki, таким как Китай. | |
| net_id строка | Идентификационный номер сети. | ||
| net_name строка | Имя сети. Псевдонимы: name, network | ||
| org_id строка | Идентификатор организации, связанной с сетью. | ||
| org_name строка | Имя организации, связанной с сетью. Псевдонимы: organization | ||
| output_level строка |
| Устанавливает объем отладочной информации во время выполнения модуля. | |
| servers - | Список настроек сервера syslog | ||
| host - | IP-адрес или имя хоста сервера Syslog. | ||
| port - | По умолчанию: "514" | Номер порта, на котором сервер Syslog прослушивает подключения. | |
| roles - |
| Список соответствующих ролей сервера syslog. | |
| state строка |
| Запрос или редактирование серверов syslog Для удаления сервера syslog, не включайте сервер в список серверов | |
| timeout целое число | По умолчанию: 30 | Время ожидания для HTTP-запросов. | |
| use_https булево |
| Если no, будет использоваться HTTP. В противном случае будет использоваться HTTPS.Полезно только для внутренних разработчиков Meraki. | |
| use_proxy булево |
| Если no, прокси не будет использоваться, даже если он определен в переменной среды на целевых хостах. | |
| validate_certs булево |
| Производить ли проверку сертификатов HTTP. | |
Примечания
Примечание
- Изменения существующих серверов syslog заменяют существующую конфигурацию. Если необходимо добавить к существующей конфигурации, установите state в query, чтобы получить существующую конфигурацию, а затем измените или добавьте.
- Дополнительную информацию об API Meraki можно найти по адресу https://dashboard.meraki.com/api_docs.
- Некоторые из этих параметров, вероятно, используются только разработчиками Meraki.
Примеры
- name: Query syslog configurations on network named MyNet in the YourOrg organization
meraki_syslog:
auth_key: abc12345
status: query
org_name: YourOrg
net_name: MyNet
delegate_to: localhost
- name: Add single syslog server with Appliance event log role
meraki_syslog:
auth_key: abc12345
status: query
org_name: YourOrg
net_name: MyNet
servers:
- host: 192.0.1.2
port: 514
roles:
- Appliance event log
delegate_to: localhost
- name: Add multiple syslog servers
meraki_syslog:
auth_key: abc12345
status: query
org_name: YourOrg
net_name: MyNet
servers:
- host: 192.0.1.2
port: 514
roles:
- Appliance event log
- host: 192.0.1.3
port: 514
roles:
- Appliance event log
- Flows
delegate_to: localhost
Возвращаемые значения
Общие возвращаемые значения описаны в этом разделе, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание | |
|---|---|---|---|
| data сложное | информация | Информация о созданном или измененном объекте. | |
| host строка | успех | Имя хоста или IP-адрес сервера syslog. Пример: 192.0.1.1 | |
| port строка | успех | Порт для связи syslog. Пример: 443 | |
| roles список | успех | Список ролей, назначенных серверу syslog. Пример: Журнал событий беспроводной сети, URL-адреса | |
Статус
- Этот модуль не гарантирует обратную совместимость интерфейса. [превью]
- Этот модуль поддерживается сообществом 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_syslog_module.html
