модуль cisco.meraki.meraki_mr_radio — управление настройками радиомодуля устройства для беспроводных сетей Meraki
Примечание
Этот модуль входит в коллекцию cisco.meraki (версия 2.23.2).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install cisco.meraki.
Чтобы использовать её в плейбуке, укажите: cisco.meraki.meraki_mr_radio.
УСТАРЕЛО
- Удалён в:
-
версии 3.0.0
- Причина:
-
Выпущены обновлённые модули с расширенной функциональностью
- Альтернатива:
-
cisco.meraki.devices_wireless_radio_settings
Краткое описание
- Позволяет настраивать параметры радиомодуля в беспроводных сетях Meraki MR.
Параметры
Параметр | Комментарии |
|---|---|
auth_key string / обязательный | Ключ аутентификации, предоставленный панелью управления. Обязателен, если переменная среды |
five_ghz_settings dictionary | Ручные настройки радиомодуля для диапазона 5 ГГц. По умолчанию: |
|
channel integer |
Задаёт канал вручную для диапазона 5 ГГц. Варианты:
|
|
channel_width string |
Задаёт канал вручную для диапазона 5 ГГц. Может быть ‘0’, ‘20’, ‘40’ или ‘80’, либо null для автоматического выбора ширины канала. Варианты:
|
|
target_power integer |
Задаёт целевую мощность вручную для диапазона 5 ГГц. Может быть от ‘8’ до ‘30’ либо null для использования автоматического диапазона мощности. |
host string | Имя узла панели управления Meraki. Можно использовать для доступа к региональным средам Meraki, например в Китае. По умолчанию: |
internal_error_retry_time integer | Количество секунд до повторной попытки, если сервер возвращает внутреннюю ошибку. По умолчанию: |
net_id string | Идентификатор сети. |
net_name псевдонимы: network string | Название сети. |
org_id string | Идентификатор организации. |
org_name псевдонимы: organization string | Название организации. |
output_format string | Указывает модулю, следует ли использовать для ключей ответа формат snake case (например, Варианты:
|
output_level string | Задаёт объём отладочной информации во время выполнения модуля. Варианты:
|
rate_limit_retry_time integer | Количество секунд до повторной попытки при срабатывании ограничителя частоты запросов. По умолчанию: |
rf_profile_id string | Идентификатор RF-профиля, назначаемого устройству. Если значение этого параметра равно null, устройству будет назначен соответствующий базовый RF-профиль (для помещений или улицы). Назначение RF-профиля сбросит ВСЕ вручную настроенные переопределения на устройстве (ширину канала, канал, мощность). |
rf_profile_name string | Название RF-профиля, назначаемого устройству. Аналогично ``rf_profile_id``, но требует указать ``net_id`` (предпочтительно) или ``net_name``. |
serial string | Серийный номер устройства для запроса. |
state string | Запрос или изменение настроек радиомодуля на устройстве. Варианты:
|
timeout integer | Время ожидания для HTTP-запросов. По умолчанию: |
two_four_ghz_settings dictionary | Ручные настройки радиомодуля для диапазона 2,4 ГГц. По умолчанию: |
|
channel integer |
Задаёт канал вручную для диапазона 2,4 ГГц. Может быть ‘1’, ‘2’, ‘3’, ‘4’, ‘5’, ‘6’, ‘7’, ‘8’, ‘9’, ‘10’, ‘11’, ‘12’, ‘13’ или ‘14’, либо null для автоматического выбора канала. Варианты:
|
|
target_power integer |
Задаёт целевую мощность вручную для диапазона 2,4 ГГц. Может быть от ‘5’ до ‘30’ либо null для использования автоматического диапазона мощности. |
use_https boolean | Если Полезно только внутренним разработчикам Meraki. Варианты:
|
use_proxy boolean | Если Варианты:
|
validate_certs boolean | Проверять ли HTTP-сертификаты. Варианты:
|
Примечания
Примечание
- Дополнительные сведения об API Meraki см. на странице https://dashboard.meraki.com/api_docs.
- Некоторые параметры, вероятно, предназначены только для разработчиков Meraki.
- Начиная с Ansible 2.9, модули Meraki выводят ключи в формате snake case. Чтобы использовать camel case, задайте для переменной среды
ANSIBLE_MERAKI_FORMATзначениеcamelcase. - Поддержка вывода в формате camel case в модулях Meraki для Ansible будет прекращена в Ansible 2.13. Обновите плейбуки.
- Режим проверки загружает текущую конфигурацию с панели управления, а затем сравнивает с ней изменения. Режим проверки сообщит об изменениях, если конфигурации различаются, но не отправляет изменения в API для их проверки.
Примеры
- name: Query a device's radio configuration
meraki_mr_radio:
auth_key: abc123
org_name: YourOrg
net_name: YourNet
serial: YourSerialNumber
state: query
delegate_to: localhost
- name: Configure a device's radios
meraki_mr_radio:
auth_key: abc123
org_name: YourOrg
net_name: YourNet
serial: YourSerialNumber
state: present
five_ghz_settings:
channel: 56
channel_width: 20
target_power: 10
two_four_ghz_settings:
channel: 6
target_power: 12
rf_profile_name: Test Profile
delegate_to: localhost
Возвращаемые значения
Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:
Ключ | Описание |
|---|---|
data complex | Параметры RF, настроенные на определённом устройстве. Возвращается: success |
|
five_ghz_settings dictionary |
Настроенные вручную параметры радиомодуля для диапазона 5 ГГц. Возвращается: success |
|
channel string |
Настроенный вручную канал для диапазона 5 ГГц. Значение Null означает автоматический выбор канала. Возвращается: success Пример: |
|
channel_width string |
Настроенная вручную ширина канала для диапазона 5 ГГц. Значение Null означает автоматический выбор ширины канала. Возвращается: success Пример: |
|
target_power integer |
Настроенная вручную целевая мощность для диапазона 5 ГГц. Значение Null означает автоматический выбор мощности. Возвращается: success Пример: |
|
rf_profile_id string |
Идентификатор RF-профиля, назначенного устройству. Значение Null означает, что устройству назначен соответствующий базовый RF-профиль (для помещений или улицы). Возвращается: success |
|
serial string |
Серийный номер настроенного устройства. Возвращается: success Пример: |
|
two_four_ghz_settings dictionary |
Настроенные вручную параметры радиомодуля для диапазона 2,4 ГГц. Возвращается: success |
|
channel string |
Настроенный вручную канал для диапазона 2,4 ГГц. Значение Null означает автоматический выбор канала. Возвращается: success Пример: |
|
target_power integer |
Настроенная вручную целевая мощность для диапазона 2,4 ГГц. Значение Null означает автоматический выбор мощности. Возвращается: success Пример: |
Статус
- Этот модуль будет удалён в версии 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_radio_module.html