Spec-Zone.ru › Ansible 2.11

cisco.meraki.meraki_mr_rf_profile – Управление профилями RF для беспроводных сетей Meraki

Примечание

Этот плагин входит в коллекцию cisco.meraki (версия 2.2.0).

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

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

  • Обзор
  • Параметры
  • Примечания
  • Примеры
  • Значения возврата

Обзор

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

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
ap_band_settings
словарь
Настройки, которые будут включены, если selectionType задан как 'ap'.
band_steering_enabled
булево
    Варианты:
  • no
  • yes
Направляет клиента на наиболее открытую полосу.
mode
строка
    Варианты:
  • 2.4ghz
  • 5ghz
  • dual
Устанавливает, какую полосу RF AP будет поддерживать.

псевдонимы: band_operation_mode
auth_key
строка / обязательно
Ключ аутентификации, предоставленный панелью управления. Требуется, если переменная среды MERAKI_KEY не задана.
band_selection_type
строка
    Варианты:
  • ssid
  • ap
Устанавливает, как назначается выбор полосы: по точке доступа или по SSID.
Этот параметр необходим при создании.
client_balancing_enabled
булево
    Варианты:
  • no
  • yes
Направляет клиента на лучшую доступную точку доступа.
five_ghz_settings
словарь
Настройки, связанные с полосой 5 ГГц.
channel_width
строка
    Варианты:
  • auto
  • 20
  • 40
  • 80
Устанавливает ширину канала (МГц) для полосы 5 ГГц.
max_power
целое число
Устанавливает максимальную мощность (дБм) полосы 5 ГГц.
Может быть целым числом от 8 до 30.
min_bitrate
целое число
    Варианты:
  • 6
  • 9
  • 12
  • 18
  • 24
  • 36
  • 48
  • 54
Устанавливает минимальную скорость передачи данных (Мбит/с) для полосы 5 ГГц.
min_power
целое число
Устанавливает минимальную мощность (дБм) полосы 5 ГГц.
Может быть целым числом от 8 до 30.
rxsop
целое число
Уровень RX-SOP контролирует чувствительность радио.
Настоятельно рекомендуется использовать RX-SOP только после консультации с экспертом по беспроводным сетям.
RX-SOP может быть настроен в диапазоне от -65 до -95 (дБм).
valid_auto_channels
список / элементы=целое число
    Варианты:
  • 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
Устанавливает допустимые автоматически настраиваемые каналы для полосы 5 ГГц.
host
строка
Значение по умолчанию:
"api.meraki.com"
Имя хоста для панели управления Meraki.
Можно использовать для доступа к региональным средам Meraki, например, в Китае.
internal_error_retry_time
целое число
Значение по умолчанию:
60
Количество секунд для повторной попытки, если сервер возвращает ошибку внутренней серверной ошибки.
min_bitrate_type
строка
    Варианты:
  • band
  • ssid
Тип минимальной скорости передачи данных.
name
строка
Уникальное имя нового профиля.
Этот параметр необходим при создании.
net_id
строка
ID сети.
net_name
строка
Название сети.
org_id
строка
ID организации.
org_name
строка
Название организации.

псевдонимы: organization
output_format
строка
    Варианты:
  • snakecase ←
  • camelcase
Указывает модулю, должны ли ключи ответа быть в формате snake case (например, net_id) или camel case (например, netId).
output_level
строка
    Варианты:
  • debug
  • normal ←
Устанавливает количество отладочной информации во время выполнения модуля.
profile_id
строка
Уникальный идентификатор существующего профиля RF.

псевдонимы: id
rate_limit_retry_time
целое число
Значение по умолчанию:
165
Количество секунд для повторной попытки, если срабатывает ограничитель скорости.
state
строка
    Варианты:
  • present ←
  • query
  • absent
Запрос, редактирование или удаление настроек беспроводного профиля RF.
timeout
целое число
Значение по умолчанию:
30
Время ожидания для HTTP-запросов.
two_four_ghz_settings
словарь
Настройки, связанные с полосой 2.4 ГГц.
ax_enabled
булево
    Варианты:
  • no
  • yes
Определяет, включено ли радио AX в полосе 2.4 ГГц.
max_power
целое число
Устанавливает максимальную мощность (дБм) полосы 2.4 ГГц.
Может быть целым числом от 5 до 30.
min_bitrate
вещественное число
    Варианты:
  • 1
  • 2
  • 5.5
  • 6
  • 9
  • 11
  • 12
  • 18
  • 24
  • 36
  • 48
  • 54
Устанавливает минимальную скорость передачи данных (Мбит/с) для полосы 2.4 ГГц.
min_power
целое число
Устанавливает минимальную мощность (дБм) полосы 2.4 ГГц.
Может быть целым числом от 5 до 30.
rxsop
целое число
Уровень RX-SOP контролирует чувствительность радио.
Настоятельно рекомендуется использовать RX-SOP только после консультации с экспертом по беспроводным сетям.
RX-SOP может быть настроен в диапазоне от -65 до -95 (дБм).
valid_auto_channels
список / элементы=целое число
    Варианты:
  • 1
  • 6
  • 11
Устанавливает допустимые автоматически настраиваемые каналы для полосы 2.4 ГГц.
use_https
булево
    Варианты:
  • no
  • yes ←
Если no, будет использоваться HTTP. В противном случае будет использоваться HTTPS.
Полезно только для внутренних разработчиков Meraki.
use_proxy
булево
    Варианты:
  • no ←
  • yes
Если no, прокси не будет использоваться, даже если он определен в переменной среды на целевых хостах.
validate_certs
булево
    Варианты:
  • no
  • yes ←
Проверять ли сертификаты HTTP.

Примечания

Примечание

  • Дополнительную информацию об 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. Пожалуйста, обновите свои playbooks.
  • Режим проверки скачивает текущую конфигурацию с панели управления, затем сравнивает изменения с этим скачиванием. Режим проверки сообщит о внесенных изменениях, если есть различия в конфигурациях, но не отправляет изменения в 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
success
Список настроек профиля беспроводного радиочастотного диапазона.
ap_band_settings
complex
success
Настройки, которые будут включены, если selectionType задан как 'ap'.
band_steering_enabled
boolean
success
Направляет клиента на наиболее свободный диапазон.

Пример:
True
mode
string
success
Устанавливает, какой радиочастотный диапазон будет поддерживать точка доступа.

Пример:
dual
band_selection_type
string
success
Устанавливает, назначается ли выбор диапазона по точке доступа или SSID.
Этот параметр обязателен при создании.

Пример:
ap
client_balancing_enabled
boolean
success
Направляет клиента на лучшую доступную точку доступа.

Пример:
True
five_ghz_settings
complex
success
Настройки, относящиеся к 5 ГГц диапазону.
channel_width
string
success
Устанавливает ширину канала (МГц) для 5 ГГц диапазона.

Пример:
auto
max_power
integer
success
Устанавливает максимальную мощность (дБм) для 5 ГГц диапазона.
Может быть целым числом от 8 до 30.

Пример:
12
min_bitrate
integer
success
Устанавливает минимальную скорость передачи данных (Мбит/с) для 5 ГГц диапазона.

Пример:
6
min_power
integer
success
Устанавливает минимальную мощность (дБм) для 5 ГГц диапазона.
Может быть целым числом от 8 до 30.

Пример:
12
rxsop
integer
success
Уровень RX-SOP управляет чувствительностью радио.

Пример:
-70
valid_auto_channels
list / elements=string
success
Устанавливает допустимые автоматические каналы для 5 ГГц диапазона.
id
string
success
Уникальный идентификатор существующего профиля RF.

Пример:
12345
min_bitrate_type
string
success
Тип минимальной скорости передачи данных.

Пример:
ssid
name
string
success
Уникальное имя нового профиля.
Этот параметр обязателен при создании.

Пример:
Гостевой профиль RF
two_four_ghz_settings
complex
success
Настройки, относящиеся к 2.4 ГГц диапазону.
ax_enabled
boolean
success
Определяет, включен ли радиомодуль ax в 2.4 ГГц диапазоне.

Пример:
True
max_power
integer
success
Устанавливает максимальную мощность (дБм) для 2.4 ГГц диапазона.

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

Пример:
5.5
min_power
integer
success
Устанавливает минимальную мощность (дБм) для 2.4 ГГц диапазона.

Пример:
12
rxsop
integer
success
Уровень RX-SOP управляет чувствительностью радио.

Пример:
-70
valid_auto_channels
list / elements=string
success
Устанавливает допустимые автоматические каналы для 2.4 ГГц диапазона.

Пример:
6


Авторы

  • Кевин Брайт (@kbreit)

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

Spec-Zone.ru

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