meraki_network – Управление сетями в облаке Meraki
Новая версия с 2.6.
Обзор
- Позволяет создавать, управлять и получать доступ к сетям в Meraki.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| auth_key строка | Ключ аутентификации, предоставленный панелью управления. Требуется, если переменная среды MERAKI_KEY не установлена. | |
| disable_my_meraki логическое добавлено в 2.7 |
| - Отключает локальные страницы состояния устройства (U[my.meraki.com](my.meraki.com), U[ap.meraki.com](ap.meraki.com), U[switch.meraki.com](switch.meraki.com), U[wired.meraki.com](wired.meraki.com)) |
| host строка | Значение по умолчанию: "api.meraki.com" | Имя хоста для панели управления Meraki. Может использоваться для доступа к региональным средам Meraki, таким как Китай. |
| net_id - | Идентификатор сети. | |
| net_name - | Название сети. псевдонимы: имя, сеть | |
| org_id целое число | Идентификатор организации, связанной с сетью. | |
| org_name строка | Название организации, связанной с сетью. псевдонимы: организация | |
| output_level строка |
| Устанавливает количество вывода отладки во время выполнения модуля. |
| state - |
| Создание или изменение организации. |
| tags список | Список тегов для назначения сети. tags имя конфликтует с параметром тегов в Ansible. Проблемы с отступами могут привести к неожиданному поведению.Ansible 2.8 преобразует это в список из списка, разделенного запятыми. | |
| timeout целое число | Значение по умолчанию: 30 | Время ожидания для HTTP-запросов. |
| timezone - | Часовой пояс, связанный с сетью. Список допустимых часовых поясов см. на https://en.wikipedia.org/wiki/List_of_tz_database_time_zones | |
| type список |
| Тип устройства сети, управляемой сетью. Обязательно при создании сети. Начиная с Ansible 2.8, combined тип больше не поддерживается.Начиная с Ansible 2.8, изменения в этом параметре больше не идемпотентны. псевдонимы: net_type |
| use_https логическое |
| Если no, будет использоваться HTTP. В противном случае используется HTTPS.Полезно только для внутренних разработчиков Meraki. |
| use_proxy логическое |
| Если no, прокси не будет использоваться, даже если он определен в переменной окружения на целевых хостах. |
| validate_certs логическое |
| Подтверждать ли сертификаты HTTP. |
Примечания
Примечание
- Дополнительную информацию об API Meraki можно найти по адресу https://dashboard.meraki.com/api_docs.
- Некоторые параметры, вероятно, используются только для разработчиков Meraki.
Примеры
- name: List all networks associated to the YourOrg organization
meraki_network:
auth_key: abc12345
state: query
org_name: YourOrg
delegate_to: localhost
- name: Query network named MyNet in the YourOrg organization
meraki_network:
auth_key: abc12345
state: query
org_name: YourOrg
net_name: MyNet
delegate_to: localhost
- name: Create network named MyNet in the YourOrg organization
meraki_network:
auth_key: abc12345
state: present
org_name: YourOrg
net_name: MyNet
type: switch
timezone: America/Chicago
tags: production, chicago
delegate_to: localhost
- name: Create combined network named MyNet in the YourOrg organization
meraki_network:
auth_key: abc12345
state: present
org_name: YourOrg
net_name: MyNet
type:
- switch
- appliance
timezone: America/Chicago
tags: production, chicago
delegate_to: localhost
Возвращаемые значения
Общие возвращаемые значения документированы здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание | |
|---|---|---|---|
| data сложный | информация | Информация о созданном или измененном объекте. | |
| disableMyMerakiCom логическое | успешно | Указывает, должны ли быть отключены my.meraki.com и другие порталы устройств. Пример: Истина | |
| id строка | успешно | Идентификационная строка сети. Пример: N_12345 | |
| name строка | успешно | Написанное имя сети. Пример: ВашаСеть | |
| organizationId строка | успешно | Идентификатор организации, владеющей сетью. Пример: 0987654321 | |
| tags строка | успешно | Разделенные пробелами теги, назначенные сети. Пример: производство беспроводная | |
| timeZone строка | успешно | Часовой пояс, в котором находится сеть. Пример: America/Chicago | |
| type строка | успешно | Функциональный тип сети. Пример: коммутатор | |
Статус
- Этот модуль не гарантирует обратную совместимость интерфейса. [превью]
- Этот модуль поддерживается сообществом 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_network_module.html
