Модуль cisco.meraki.meraki_mr_ssid — управление беспроводными SSID в облаке Meraki
Примечание
Этот модуль входит в коллекцию cisco.meraki (версия 2.23.2).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.
Чтобы установить её, используйте: ansible-galaxy collection install cisco.meraki.
Чтобы использовать её в плейбуке, укажите: cisco.meraki.meraki_mr_ssid.
УСТАРЕЛО
- Удалено:
-
в версии 3.0.0
- Причина:
-
Выпущены обновлённые модули с расширенными возможностями
- Альтернатива:
-
cisco.meraki.networks_wireless_ssids
Краткое описание
- Позволяет управлять SSID в беспроводной среде Meraki.
Параметры
Параметр | Комментарии |
|---|---|
ap_availability_tags list / elements=string | Укажите, следует ли точкам доступа (AP) транслировать SSID, если их теги совпадают с любым из тегов в этом списке. Требуется, чтобы |
ap_tags_vlan_ids list / elements=dictionary | Список тегов VLAN. Требуется, чтобы Требуется, чтобы |
|
tags list / elements=string |
Список тегов точек доступа. |
|
vlan_id integer |
Числовой идентификатор, назначенный VLAN. |
auth_key string / обязательный | Ключ аутентификации, предоставленный панелью управления. Обязателен, если переменная окружения |
auth_mode string | Задайте режим аутентификации сети. Варианты:
|
available_on_all_aps boolean | Укажите, должны ли все точки доступа транслировать SSID или его следует ограничить точками доступа, совпадающими с любыми тегами доступности. Если задано значение Варианты:
|
band_selection string | Задайте режим выбора диапазона. Варианты:
|
concentrator_network_id string | Концентратор, используемый для «роуминга уровня 3 с концентратором» или «VPN». |
default_vlan_id integer | Идентификатор VLAN по умолчанию. Требуется, чтобы |
enabled boolean | Включите или отключите сеть SSID. Варианты:
|
encryption_mode string | Задайте режим шифрования сети. Варианты:
|
enterprise_admin_access string | Указывает, доступен ли SSID администраторам предприятия. Варианты:
|
host string | Имя узла панели управления Meraki. Можно использовать для доступа к региональным средам Meraki, например в Китае. По умолчанию: |
internal_error_retry_time integer | Количество секунд до повторной попытки, если сервер возвращает внутреннюю ошибку. По умолчанию: |
ip_assignment_mode string | Метод, используемый SSID для назначения IP-адресов. Варианты:
|
lan_isolation_enabled boolean | Включите или отключите изоляцию локальной сети уровня 2. Требуется, чтобы Варианты:
|
min_bitrate float | Минимальная скорость передачи данных (Мбит/с), допустимая для SSID. Варианты:
|
name string | Имя SSID. |
net_id string | Идентификатор сети. |
net_name string | Имя сети. |
number псевдонимы: ssid_number integer | Номер SSID в сети. |
org_id string | Идентификатор организации. |
org_name псевдонимы: organization string | Название организации. |
output_format string | Указывает модулю, следует ли использовать для ключей ответа формат snake case (например, Варианты:
|
output_level string | Задайте уровень отладочного вывода во время выполнения модуля. Варианты:
|
per_client_bandwidth_limit_down integer | Максимальная пропускная способность загрузки для устройств в сети SSID, в Мбит/с. |
per_client_bandwidth_limit_up integer | Максимальная пропускная способность передачи данных для устройств в сети SSID, в Мбит/с. |
psk string | Пароль беспроводной сети. Для этого параметра auth_mode должен иметь значение psk. |
radius_accounting_enabled boolean | Включите или отключите учет RADIUS. Варианты:
|
radius_accounting_servers list / elements=dictionary | Список серверов RADIUS для учета RADIUS. |
|
host string / обязательный |
IP-адрес или имя узла сервера RADIUS. |
|
port integer |
Номер порта, на котором сервер RADIUS ожидает соединения. |
|
secret string |
Пароль RADIUS. Установка пароля не является идемпотентной. |
radius_coa_enabled boolean | Включите или отключите CoA RADIUS (изменение авторизации) для SSID. Варианты:
|
radius_failover_policy string | Задайте политику доступа клиентов на случай недоступности серверов RADIUS. Варианты:
|
radius_load_balancing_policy string | Задайте политику балансировки нагрузки, если указано несколько серверов RADIUS. Варианты:
|
radius_proxy_enabled boolean | Включите или отключите прокси-сервер RADIUS для SSID. Варианты:
|
radius_servers list / elements=dictionary | Список серверов RADIUS. |
|
host string / обязательный |
IP-адрес или имя узла сервера RADIUS. |
|
port integer |
Номер порта, на котором сервер RADIUS ожидает соединения. |
|
secret string |
Пароль RADIUS. Установка пароля не является идемпотентной. |
rate_limit_retry_time integer | Количество секунд до повторной попытки при срабатывании ограничения частоты запросов. По умолчанию: |
splash_guest_sponsor_domains list / elements=string | Список допустимых доменов электронной почты спонсоров для гостевого портала со спонсорским доступом. |
splash_page string | Включите заставку и укажите ее тип. Варианты:
|
state string | Указывает, следует ли получать или изменять сведения SNMP. Варианты:
|
timeout integer | Время ожидания для HTTP-запросов. По умолчанию: |
use_https boolean | Если Полезно только для внутренних разработчиков Meraki. Варианты:
|
use_proxy boolean | Если Варианты:
|
use_vlan_tagging boolean | Укажите, следует ли использовать тегирование VLAN. Требуется задать Варианты:
|
validate_certs boolean | Указывает, следует ли проверять сертификаты HTTP. Варианты:
|
visible boolean | Включите или отключите трансляцию этого SSID точками доступа. Варианты:
|
vlan_id integer | Идентификатор VLAN для SSID. Требуется, чтобы |
walled_garden_enabled boolean | Включите или отключите функциональность «огороженного сада». Варианты:
|
walled_garden_ranges list / elements=string | Список диапазонов «огороженного сада». |
wpa_encryption_mode string | Режим шифрования в спецификации WPA. Варианты:
|
Примечания
Примечание
- Удаление SSID не приводит к удалению серверов RADIUS.
- Дополнительные сведения об API Meraki можно найти по адресу https://dashboard.meraki.com/api_docs.
- Некоторые параметры, вероятно, используются только разработчиками Meraki.
- Начиная с Ansible 2.9, модули Meraki выводят ключи в формате snake case. Чтобы использовать camel case, задайте переменную окружения
ANSIBLE_MERAKI_FORMATсо значениемcamelcase. - Модули Meraki для Ansible прекратят поддерживать вывод в формате camel case в Ansible 2.13. Обновите свои сценарии.
- Режим проверки загружает текущую конфигурацию с панели управления, а затем сравнивает изменения с загруженными данными. В режиме проверки будет сообщено об изменениях, если конфигурации различаются, но изменения не отправляются в API для проверки.
Примеры
- name: Enable and name SSID
meraki_ssid:
auth_key: abc123
state: present
org_name: YourOrg
net_name: WiFi
name: GuestSSID
enabled: true
visible: true
delegate_to: localhost
- name: Set PSK with invalid encryption mode
meraki_ssid:
auth_key: abc123
state: present
org_name: YourOrg
net_name: WiFi
name: GuestSSID
auth_mode: psk
psk: abc1234
encryption_mode: eap
ignore_errors: true
delegate_to: localhost
- name: Configure RADIUS servers
meraki_ssid:
auth_key: abc123
state: present
org_name: YourOrg
net_name: WiFi
name: GuestSSID
auth_mode: open-with-radius
radius_servers:
- host: 192.0.1.200
port: 1234
secret: abc98765
delegate_to: localhost
- name: Enable click-through splash page
meraki_ssid:
auth_key: abc123
state: present
org_name: YourOrg
net_name: WiFi
name: GuestSSID
splash_page: Click-through splash page
delegate_to: localhost
Возвращаемые значения
Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:
Ключ | Описание |
|---|---|
data complex | Список беспроводных SSID. Возвращается: при успешном выполнении |
|
auth_mode string |
Метод аутентификации. Возвращается: при успешном выполнении Пример: |
|
band_selection string |
Радиочастота беспроводной сети, в диапазоне которой она будет транслироваться. Возвращается: при успешном выполнении Пример: |
|
enabled boolean |
Состояние беспроводной сети (включена или выключена). Возвращается: при успешном выполнении Пример: |
|
encryption_mode string |
Метод шифрования беспроводного трафика. Возвращается: при успешном выполнении Пример: |
|
ip_assignment_mode string |
Метод назначения IP-адресов клиентам беспроводной сети. Возвращается: при успешном выполнении Пример: |
|
min_bitrate integer |
Минимальная скорость передачи данных, при которой клиент может подключиться к беспроводной сети. Возвращается: при успешном выполнении Пример: |
|
name string |
Имя беспроводного SSID. Это имя транслируется в эфир. Возвращается: при успешном выполнении Пример: |
|
number integer |
Индекс SSID, начиная с нуля. Возвращается: при успешном выполнении Пример: |
|
per_client_bandwidth_limit_down integer |
Максимальная пропускная способность для загрузки данных, доступная клиенту. Возвращается: при успешном выполнении Пример: |
|
per_client_bandwidth_limit_up integer |
Максимальная пропускная способность для отправки данных, доступная клиенту. Возвращается: при успешном выполнении Пример: |
|
psk string |
Секретный пароль беспроводной сети. Возвращается: при успешном выполнении Пример: |
|
splash_page string |
Страница-заставка, отображаемая при аутентификации пользователя. Возвращается: при успешном выполнении Пример: |
|
ssid_admin_accessible boolean |
Доступен ли SSID для администрирования. Возвращается: при успешном выполнении Пример: |
|
wpa_encryption_mode string |
Включенные версии WPA. Возвращается: при успешном выполнении Пример: |
Статус
- Этот модуль будет удален в версии 3.0.0. [устарел]
- Дополнительные сведения см. в разделе УСТАРЕВШИЕ ФУНКЦИИ.
Ссылки на коллекцию
© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/cisco/meraki/meraki_mr_ssid_module.html