Spec-Zone.ru › Ansible

Модуль cisco.meraki.meraki_mr_rf_profile — Управление профилями радиочастот (RF) для беспроводных сетей Meraki

Примечание

Этот модуль входит в коллекцию cisco.meraki (версия 2.18.2).

Эта коллекция может быть уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install cisco.meraki.

Для использования в плейбуке укажите: cisco.meraki.meraki_mr_rf_profile.

  • УСТАНОВЛЕНО
  • Описание
  • Параметры
  • Примечания
  • Примеры
  • Возвращаемые значения
  • Статус

УСТАНОВЛЕНО

Убрано в:

версии 3.0.0

Почему:

Обновленные модули выпущены с повышенной функциональностью

Альтернатива:

cisco.meraki.networks_wireless_rf_profiles

Описание

  • Позволяет настраивать профили радиочастот (RF) в беспроводных сетях Meraki MR.

Параметры

Параметр

Комментарии

ap_band_settings

dictionary

Параметры, которые будут включены, если selectionType установлен в «ap».

band_steering_enabled

boolean

Переключает клиента на наиболее открытый диапазон.

Варианты:

  • false
  • true

mode

aliases: band_operation_mode

string

Устанавливает, какой диапазон радиочастот будет поддерживать точка доступа.

Варианты:

  • "2.4ghz"
  • "5ghz"
  • "dual"

auth_key

string / required

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

band_selection_type

string

Устанавливает, назначается ли выбор диапазона на точку доступа или SSID.

Этот параметр обязателен при создании.

Варианты:

  • "ssid"
  • "ap"

client_balancing_enabled

boolean

Переключает клиента на лучшую доступную точку доступа.

Варианты:

  • false
  • true

five_ghz_settings

dictionary

Параметры, относящиеся к 5-гигагерцевому диапазону.

channel_width

string

Устанавливает ширину канала (МГц) для 5-гигагерцевого диапазона.

Варианты:

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

max_power

integer

Устанавливает максимальную мощность (дБм) 5-гигагерцевого диапазона.

Может быть целым числом от 8 до 30.

min_bitrate

integer

Устанавливает минимальную скорость передачи данных (Мбит/с) 5-гигагерцевого диапазона.

Варианты:

  • 6
  • 9
  • 12
  • 18
  • 24
  • 36
  • 48
  • 54

min_power

integer

Устанавливает минимальную мощность (дБм) 5-гигагерцевого диапазона.

Может быть целым числом от 8 до 30.

rxsop

integer

Уровень RX-SOP управляет чувствительностью радио.

Настоятельно рекомендуется использовать RX-SOP только после консультации со специалистом по беспроводной связи.

RX-SOP можно настроить в диапазоне от -65 до -95 (дБм).

valid_auto_channels

list / elements=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

host

string

Имя хоста для панели управления Meraki.

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

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

internal_error_retry_time

integer

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

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

min_bitrate_type

string

Тип минимальной скорости передачи данных.

Варианты:

  • "band"
  • "ssid"

name

string

Уникальное имя нового профиля.

Этот параметр обязателен при создании.

net_id

string

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

net_name

string

Имя сети.

org_id

string

ID организации.

org_name

aliases: organization

string

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

output_format

string

Указывает модулю, должны ли ключи ответа быть в нижнем регистре со знаками подчёркивания (например, net_id) или в верхнем регистре со знаками подчёркивания (например, netId).

Варианты:

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

output_level

string

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

Варианты:

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

profile_id

aliases: id

string

Уникальный идентификатор существующего профиля RF.

rate_limit_retry_time

integer

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

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

state

string

Запрос, редактирование или удаление настроек беспроводного профиля RF.

Варианты:

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

timeout

integer

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

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

two_four_ghz_settings

dictionary

Настройки, относящиеся к диапазону 2.4 ГГц

ax_enabled

boolean

Определяет, включен или выключен радиомодуль ax в диапазоне 2.4 ГГц.

Варианты:

  • false
  • true

max_power

integer

Устанавливает максимальную мощность (дБм) диапазона 2.4 ГГц.

Может быть целым числом от 5 до 30.

min_bitrate

float

Устанавливает минимальную скорость передачи данных (Мбит/с) диапазона 2.4 ГГц.

Варианты:

  • 1.0
  • 2.0
  • 5.5
  • 6.0
  • 9.0
  • 11.0
  • 12.0
  • 18.0
  • 24.0
  • 36.0
  • 48.0
  • 54.0

min_power

integer

Устанавливает минимальную мощность (дБм) диапазона 2.4 ГГц.

Может быть целым числом от 5 до 30.

rxsop

integer

Уровень RX-SOP управляет чувствительностью радиомодуля.

Сильно рекомендуется использовать RX-SOP только после консультации с экспертом по беспроводным сетям.

RX-SOP можно настроить в диапазоне от -65 до -95 (дБм).

valid_auto_channels

list / elements=integer

Устанавливает допустимые автоматические каналы для диапазона 2.4 ГГц.

Варианты:

  • 1
  • 6
  • 11

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. Чтобы использовать формат camelCase, установите переменную окружения ANSIBLE_MERAKI_FORMAT в значение camelcase.
  • Модули Meraki Ansible прекратят поддержку вывода camelCase в Ansible 2.13. Пожалуйста, обновите свои плейбуки.
  • Режим проверки загружает текущую конфигурацию с панели управления, а затем сравнивает изменения с этой загрузкой. Режим проверки сообщит об изменениях, если конфигурации отличаются, но не отправляет изменения в API для проверки изменений.

Примеры

- name: Create RF profile in check mode
  meraki_mr_rf_profile:
    auth_key: abc123
    org_name: YourOrg
    net_name: YourNet
    state: present
    name: Test Profile
    band_selection_type: ap
    client_balancing_enabled: True
    ap_band_settings:
        mode: dual
        band_steering_enabled: true
    five_ghz_settings:
      max_power: 10
      min_bitrate: 12
      min_power: 8
      rxsop: -65
      channel_width: 20
      valid_auto_channels:
        - 36
        - 40
        - 44
    two_four_ghz_settings:
      max_power: 10
      min_bitrate: 12
      min_power: 8
      rxsop: -65
      ax_enabled: false
      valid_auto_channels:
        - 1
  delegate_to: localhost

- name: Query all RF profiles
  meraki_mr_rf_profile:
    auth_key: abc123
    org_name: YourOrg
    net_name: YourNet
    state: query
  delegate_to: localhost

- name: Query one RF profile by ID
  meraki_mr_rf_profile:
    auth_key: abc123
    org_name: YourOrg
    net_name: YourNet
    state: query
    profile_id: '{{ profile_id }}'
  delegate_to: localhost

- name: Update profile
  meraki_mr_rf_profile:
    auth_key: abc123
    org_name: YourOrg
    net_name: YourNet
    state: present
    profile_id: 12345
    band_selection_type: ap
    client_balancing_enabled: True
    ap_band_settings:
        mode: dual
        band_steering_enabled: true
    five_ghz_settings:
      max_power: 10
      min_bitrate: 12
      min_power: 8
      rxsop: -65
      channel_width: 20
      valid_auto_channels:
        - 36
        - 44
    two_four_ghz_settings:
      max_power: 10
      min_bitrate: 12
      min_power: 8
      rxsop: -75
      ax_enabled: false
      valid_auto_channels:
        - 1
  delegate_to: localhost

- name: Delete RF profile
  meraki_mr_rf_profile:
    auth_key: abc123
    org_name: YourOrg
    net_name: YourNet
    state: absent
    profile_id: 12345
  delegate_to: localhost

Значения возврата

Общие значения возврата документированы здесь, ниже приведены поля, уникальные для данного модуля:

Ключ

Описание

data

complex

Список настроек беспроводного профиля RF.

Возвращено: success

ap_band_settings

complex

Настройки, которые будут включены, если selectionType установлен в «ap».

Возвращено: success

band_steering_enabled

boolean

Переключает клиента на наиболее открытый диапазон.

Возвращено: success

Пример: true

mode

string

Задает, какой диапазон RF будет поддерживать точка доступа.

Возвращено: success

Пример: "dual"

band_selection_type

string

Задает, назначается ли выбор диапазона на точку доступа или SSID.

Этот параметр обязателен при создании.

Возвращено: success

Пример: "ap"

client_balancing_enabled

boolean

Переключает клиента на лучшую доступную точку доступа.

Возвращено: success

Пример: true

five_ghz_settings

complex

Настройки, связанные с диапазоном 5 ГГц.

Возвращено: success

channel_width

string

Задает ширину канала (МГц) для диапазона 5 ГГц.

Возвращено: success

Пример: "auto"

max_power

integer

Задает максимальную мощность (дБм) диапазона 5 ГГц.

Может быть целым числом от 8 до 30.

Возвращено: success

Пример: 12

min_bitrate

integer

Задает минимальную скорость передачи данных (Мбит/с) диапазона 5 ГГц.

Возвращено: success

Пример: 6

min_power

integer

Задает минимальную мощность (дБм) диапазона 5 ГГц.

Может быть целым числом от 8 до 30.

Возвращено: success

Пример: 12

rxsop

integer

Уровень RX-SOP управляет чувствительностью радио.

Возвращено: success

Пример: -70

valid_auto_channels

list / elements=string

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

Возвращено: success

id

string

Уникальный идентификатор существующего профиля RF.

Возвращено: success

Пример: "12345"

min_bitrate_type

string

Тип минимальной скорости передачи данных.

Возвращено: success

Пример: "ssid"

name

string

Уникальное имя нового профиля.

Этот параметр обязателен при создании.

Возвращено: success

Пример: "Guest RF profile"

two_four_ghz_settings

complex

Настройки, связанные с диапазоном 2,4 ГГц

Возвращено: success

ax_enabled

boolean

Определяет, включена ли радиочастота ax в диапазоне 2,4 ГГц.

Возвращено: success

Пример: true

max_power

integer

Устанавливает максимальную мощность (dBm) для полосы 2.4 ГГц.

Возвращаемое значение: success

Пример: 12

min_bitrate

float

Устанавливает минимальную скорость передачи данных (Мбит/с) для полосы 2.4 ГГц.

Возвращаемое значение: success

Пример: 5.5

min_power

integer

Устанавливает минимальную мощность (dBm) для полосы 2.4 ГГц.

Возвращаемое значение: success

Пример: 12

rxsop

integer

Уровень RX-SOP регулирует чувствительность радиомодуля.

Возвращаемое значение: success

Пример: -70

valid_auto_channels

list / elements=string

Устанавливает допустимые каналы для автоматического выбора в полосе 2.4 ГГц.

Возвращаемое значение: success

Пример: ["6"]

Статус

  • Этот модуль будет удален в версии 3.0.0. [устаревший]
  • Для получения дополнительной информации см. УСТАРЕВШИЙ.

Авторы

  • Kevin Breit (@kbreit)

Ссылки на сборку

  • Система отслеживания ошибок
  • Репозиторий (источники)

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/cisco/meraki/meraki_mr_rf_profile_module.html

Spec-Zone.ru

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