Spec-Zone.ru › Ansible

модуль 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 / обязательный

Ключ аутентификации, предоставленный панелью управления. Обязателен, если переменная среды MERAKI_KEY не задана.

five_ghz_settings

dictionary

Ручные настройки радиомодуля для диапазона 5 ГГц.

По умолчанию: {}

channel

integer

Задаёт канал вручную для диапазона 5 ГГц.

Варианты:

  • 36
  • 40
  • 44
  • 48
  • 52
  • 56
  • 60
  • 64
  • 100
  • 104
  • 108
  • 112
  • 116
  • 120
  • 124
  • 128
  • 132
  • 136
  • 140
  • 144
  • 149
  • 153
  • 157
  • 161
  • 165

channel_width

string

Задаёт канал вручную для диапазона 5 ГГц.

Может быть ‘0’, ‘20’, ‘40’ или ‘80’, либо null для автоматического выбора ширины канала.

Варианты:

  • "auto"
  • "20"
  • "40"
  • "80"

target_power

integer

Задаёт целевую мощность вручную для диапазона 5 ГГц.

Может быть от ‘8’ до ‘30’ либо null для использования автоматического диапазона мощности.

host

string

Имя узла панели управления Meraki.

Можно использовать для доступа к региональным средам Meraki, например в Китае.

По умолчанию: "api.meraki.com"

internal_error_retry_time

integer

Количество секунд до повторной попытки, если сервер возвращает внутреннюю ошибку.

По умолчанию: 60

net_id

string

Идентификатор сети.

net_name

псевдонимы: network

string

Название сети.

org_id

string

Идентификатор организации.

org_name

псевдонимы: organization

string

Название организации.

output_format

string

Указывает модулю, следует ли использовать для ключей ответа формат snake case (например, net_id) или camel case (например, netId).

Варианты:

  • "snakecase" ← (по умолчанию)
  • "camelcase"

output_level

string

Задаёт объём отладочной информации во время выполнения модуля.

Варианты:

  • "debug"
  • "normal" ← (по умолчанию)

rate_limit_retry_time

integer

Количество секунд до повторной попытки при срабатывании ограничителя частоты запросов.

По умолчанию: 165

rf_profile_id

string

Идентификатор RF-профиля, назначаемого устройству.

Если значение этого параметра равно null, устройству будет назначен соответствующий базовый RF-профиль (для помещений или улицы).

Назначение RF-профиля сбросит ВСЕ вручную настроенные переопределения на устройстве (ширину канала, канал, мощность).

rf_profile_name

string

Название RF-профиля, назначаемого устройству.

Аналогично ``rf_profile_id``, но требует указать ``net_id`` (предпочтительно) или ``net_name``.

serial

string

Серийный номер устройства для запроса.

state

string

Запрос или изменение настроек радиомодуля на устройстве.

Варианты:

  • "present" ← (по умолчанию)
  • "query"

timeout

integer

Время ожидания для HTTP-запросов.

По умолчанию: 30

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 для автоматического выбора канала.

Варианты:

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14

target_power

integer

Задаёт целевую мощность вручную для диапазона 2,4 ГГц.

Может быть от ‘5’ до ‘30’ либо null для использования автоматического диапазона мощности.

use_https

boolean

Если no, будет использоваться HTTP. В противном случае будет использоваться HTTPS.

Полезно только внутренним разработчикам Meraki.

Варианты:

  • false
  • true ← (по умолчанию)

use_proxy

boolean

Если no, прокси использоваться не будет, даже если он указан в переменной среды на целевых узлах.

Варианты:

  • false ← (по умолчанию)
  • true

validate_certs

boolean

Проверять ли HTTP-сертификаты.

Варианты:

  • false
  • true ← (по умолчанию)

Примечания

Примечание

  • Дополнительные сведения об 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

Пример: "56"

channel_width

string

Настроенная вручную ширина канала для диапазона 5 ГГц.

Значение Null означает автоматический выбор ширины канала.

Возвращается: success

Пример: "40"

target_power

integer

Настроенная вручную целевая мощность для диапазона 5 ГГц.

Значение Null означает автоматический выбор мощности.

Возвращается: success

Пример: 25

rf_profile_id

string

Идентификатор RF-профиля, назначенного устройству.

Значение Null означает, что устройству назначен соответствующий базовый RF-профиль (для помещений или улицы).

Возвращается: success

serial

string

Серийный номер настроенного устройства.

Возвращается: success

Пример: "xyz"

two_four_ghz_settings

dictionary

Настроенные вручную параметры радиомодуля для диапазона 2,4 ГГц.

Возвращается: success

channel

string

Настроенный вручную канал для диапазона 2,4 ГГц.

Значение Null означает автоматический выбор канала.

Возвращается: success

Пример: "11"

target_power

integer

Настроенная вручную целевая мощность для диапазона 2,4 ГГц.

Значение Null означает автоматический выбор мощности.

Возвращается: success

Пример: 15

Статус

  • Этот модуль будет удалён в версии 3.0.0. [устарело]
  • Дополнительные сведения см. в разделе УСТАРЕЛО.

Авторы

  • Tyler Christiansen (@supertylerc)

Ссылки на коллекцию

  • Отслеживание проблем
  • Репозиторий (исходный код)

© 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API