Модуль cisco.dnac.accesspoint_workflow_manager – Автоматизирует массовые изменения конфигурации точек доступа.

Примечание

Этот модуль является частью коллекции cisco.dnac (версия 6.20.0).

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

Для установки используйте: ansible-galaxy collection install cisco.dnac. Для использования этого модуля требуются дополнительные компоненты. Подробности см. в разделе Требования.

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

Добавлен в cisco.dnac 6.17.0

Обзор
Требования
Параметры
Примечания
См. также
Примеры
Возвращаемые значения

Обзор

Автоматизирует массовые изменения конфигурации точек доступа (AP).
Изменяет имена отображения AP, имена AP или другие параметры.
Фильтрует конкретные данные устройства, например, выбирает устройства с именами хостов, соответствующими «NFW-AP1-9130AXE».
Сравнивает входные данные с текущими конфигурациями AP и применяет необходимые изменения только к соответствующим AP.

Требования

Ниже приведены требования, необходимые на хосте, на котором выполняется этот модуль.

dnacentersdk >= 2.7.2
python >= 3.8

Параметры

Параметр	Комментарии
config list / elements=dictionary / required	Список подробных сведений об управляемой точке доступа.
2.4ghz_radio dictionary	Параметры конфигурации для радиоинтерфейса 2,4 ГГц.
admin_status string	Административный статус для радиоинтерфейса 2,4 ГГц. Например, «Включено».
antenna_cable_name string	Название или тип антенного кабеля, используемого для радиоинтерфейса 2,4 ГГц. Например, «другой».
antenna_gain integer	Указывает значение усиления антенны в децибелах (дБ) для радиоинтерфейса 2,4 ГГц, допустимые значения находятся в диапазоне от 0 до 40. Например, 10.
antenna_name string	Название или тип антенны, используемой для радиоинтерфейса 2,4 ГГц. Например, «другой».
cable_loss integer	Потери в кабеле в дБ для радиоинтерфейса 2,4 ГГц. Допустимые значения находятся в диапазоне от 0 до 40. Это значение должно быть меньше, чем усиление антенны. Например, 2.
channel_assignment_mode string	Режим назначения канала для радиоинтерфейса 2,4 ГГц. Принимает «Глобальный» или «Пользовательский». Например, «Пользовательский».
channel_number integer	Пользовательский номер канала, настроенный для радиоинтерфейса 2,4 ГГц. Например, 6.
power_assignment_mode string	Режим назначения мощности для радиоинтерфейса 2,4 ГГц. Принимает «Глобальный» или «Пользовательский». Например, «Пользовательский».
power_level integer	Пользовательский уровень мощности, настроенный для радиоинтерфейса 2,4 ГГц. Например, 3.
radio_role_assignment string	Режим назначения роли для радиоинтерфейса 2,4 ГГц. Принимает «Авто», «Обслуживание клиентов» или «Монитор». Например, «Авто».
5ghz_radio dictionary	Параметры конфигурации для радиоинтерфейса 5 ГГц.
admin_status string	Административный статус для радиоинтерфейса 5 ГГц. Например, «Включено».
antenna_cable_name string	Название или тип антенного кабеля, используемого для радиоинтерфейса 5 ГГц. Например, «другой».
antenna_gain integer	Значение усиления антенны в децибелах (дБ) для радиоинтерфейса 5 ГГц, допустимые значения находятся в диапазоне от 0 до 40. Например, 5.
antenna_name string	Название или тип антенны, используемой для радиоинтерфейса 5 ГГц. Например, «другой».
cable_loss integer	Потери в кабеле в дБ для радиоинтерфейса 5 ГГц. Допустимые значения находятся в диапазоне от 0 до 40. Это значение должно быть меньше, чем усиление антенны. Например, 3.
channel_assignment_mode string	Режим назначения канала для радиоинтерфейса 5 ГГц. Принимает «Глобальный» или «Пользовательский». Например, «Пользовательский».
channel_number integer	Пользовательский номер канала, настроенный для радиоинтерфейса 5 ГГц. Например, 36.
power_assignment_mode string	Режим назначения мощности для радиоинтерфейса 5 ГГц. Принимает «Глобальный» или «Пользовательский». Например, «Пользовательский».
power_level integer	Пользовательский уровень мощности, настроенный для радиоинтерфейса 5 ГГц. Например, 3.
radio_role_assignment string	Режим назначения роли для радиоинтерфейса 5 ГГц. Принимает «Авто», «Обслуживание клиентов» или «Монитор». Например, «Авто».

6ghz_radio dictionary	Параметры конфигурации для радиоинтерфейса 6 ГГц.
admin_status string	Административный статус для радиоинтерфейса 6 ГГц. Например, «Enabled».
antenna_cable_name string	Название или тип антенного кабеля, используемого для радиоинтерфейса 6 ГГц. Например, «other».
antenna_gain integer	Значение усиления антенны в децибелах (дБ) для радиоинтерфейса 6 ГГц, допустимые значения находятся в диапазоне от 0 до 40. Например, 30.
antenna_name string	Название или тип антенны, используемой для радиоинтерфейса 6 ГГц. Например, «other».
cable_loss integer	Потери в кабеле в дБ для радиоинтерфейса 6 ГГц. Допустимые значения от 0 до 40. Это значение должно быть меньше, чем усиление антенны. Например, 10.
channel_assignment_mode string	Режим назначения канала для радиоинтерфейса 6 ГГц. Принимает «Global» или «Custom». Например, «Custom».
channel_number integer	Пользовательский номер канала, настроенный для радиоинтерфейса 6 ГГц. Например, 6.
power_assignment_mode string	Режим назначения мощности для радиоинтерфейса 6 ГГц. Принимает «Global» или «Custom». Например, «Custom».
power_level integer	Пользовательский уровень мощности, настроенный для радиоинтерфейса 6 ГГц. Например, 3.
radio_role_assignment string	Режим назначения роли для радиоинтерфейса 6 ГГц. Принимает «Auto», «Client-serving» или «Monitor».
admin_status string	Статус конфигурации AP. Принимает «Enabled» или «Disabled». Например, «Enabled».
ap_config_selected_fields string	При включении флага проверки «config_verify» отображаются только поля фильтра конфигурации AP в выходных данных. (например, «mac_address,eth_mac,ap_name,led_brightness_level,led_status,location,radioDTOs»)
ap_mode string	Определяет режим работы точки доступа (AP). Возможные значения включают «Local», «Monitor», «Sniffer» или «Bridge». Например, «Local».
ap_name string	Текущее имя AP, которое необходимо изменить вместе с новым именем AP. Например, «Test2».
ap_selected_fields string	При включении флага проверки «config_verify» отображаются только поля фильтра сведений об AP в выходных данных. (например, «id,hostname,family,type,mac_address,management_ip_address,ap_ethernet_mac_address»)
clean_air_si_2.4ghz string	Статус функции Clean Air Spectrum Intelligence (SI) для диапазона 2,4 ГГц. Указывает, включена ли функция Clean Air Spectrum Intelligence или отключена. Например, «Enabled».
clean_air_si_5ghz string	Статус функции Clean Air Spectrum Intelligence (SI) для диапазона 5 ГГц. Указывает, включена ли функция Clean Air Spectrum Intelligence или отключена. Например, «Enabled».
clean_air_si_6ghz string	Статус функции Clean Air Spectrum Intelligence (SI) для диапазона 6 ГГц. Указывает, включена ли функция Clean Air Spectrum Intelligence или отключена. Например, «Enabled».
failover_priority string	Приоритет порядка отработки отказа в конфигурации AP. Принимает «Low», «Medium», «High» или «Critical».
hostname string / required	Имя хоста, используемое для идентификации устройства. Если указано, его нельзя изменить. Для идентификации конкретной точки доступа требуется хотя бы один из следующих параметров: - mac_address - hostname - management_ip_address
is_assigned_site_as_location string	Настраивает, автоматически ли местоположение точки доступа устанавливается на сайт, назначенный точке доступа. Принимает «Enabled» или «Disabled». Если установлено значение «Enabled», дополнительная конфигурация местоположения не требуется.

led_brightness_level integer	Уровень яркости светодиода AP. Принимает значения от 1 до 8. Например, 3.
led_status string	Состояние светодиода AP. Принимает значения «Enabled» или «Disabled». Например, «Enabled».
location string	Название местоположения AP. Укажите эти данные, если требуется изменение. Например, «Bangalore».
mac_address string / required	MAC-адрес, используемый для идентификации устройства. Если указан, его нельзя изменить. Для идентификации конкретной точки доступа требуется хотя бы один из следующих параметров: - mac_address - hostname - management_ip_address
management_ip_address string / required	Управляющий IP-адрес, используемый для идентификации устройства. Если указан, его нельзя изменить. Для идентификации конкретной точки доступа требуется хотя бы один из следующих параметров: - mac_address - hostname - management_ip_address
primary_controller_name string	Имя или идентификатор основного беспроводного контроллера LAN (WLC), управляющего точкой доступа (AP). Например, «SJ-EWLC-1».
primary_ip_address dictionary	IP-адрес основного беспроводного контроллера LAN (WLC), управляющего точкой доступа (AP).
address string	IP-адрес основного беспроводного контроллера LAN. Например, «10.0.0.3».
reboot_aps dictionary	Перезагрузка одной или нескольких точек доступа (AP), идентифицированных по их MAC-адресам, именам хостов или управляющим IP-адресам. Требуется хотя бы один из следующих параметров: - mac_addresses - hostnames - management_ip_addresses
hostnames list / elements=string	Список имен хостов, используемых для идентификации точек доступа для перезагрузки.
mac_addresses list / elements=string	Список MAC-адресов, используемых для идентификации точек доступа для перезагрузки.
management_ip_addresses list / elements=string	Список управляющих IP-адресов, используемых для идентификации точек доступа для перезагрузки.
rf_profile string	Указывает имя профиля радиочастоты (RF) для точки доступа. Это может быть один из стандартных профилей «HIGH», «LOW», «TYPICAL» или пользовательский профиль, который был создан. Например, «HIGH».
secondary_controller_name string	Имя или идентификатор вторичного беспроводного контроллера LAN (WLC), управляющего точкой доступа (AP). Чтобы изменить только основной контроллер, установите имена вторичного и третичного контроллеров в значение «Inherit from site / Clear».
secondary_ip_address dictionary	IP-адрес вторичного беспроводного контроллера LAN (WLC), управляющего точкой доступа (AP).
address string	IP-адрес основного беспроводного контроллера LAN. Например, «10.0.0.3».
site dictionary	Текущие данные о сайте, где находится точка доступа.
floor dictionary	Данные об этаже текущего сайта.
name string	Название этажа. Например, «FLOOR1».
parent_name string	Родительское имя этажа в иерархии сайта. Например, «Global/USA/New York/BLDNYC».
tertiary_controller_name string	Имя или идентификатор третичного беспроводного контроллера LAN (WLC), управляющего точкой доступа (AP). Чтобы изменить только основной контроллер, установите имена вторичного и третичного контроллеров в значение «Inherit from site / Clear».
tertiary_ip_address dictionary	IP-адрес третичного беспроводного контроллера LAN (WLC), управляющего точкой доступа (AP).

address string	IP-адрес основного беспроводного контроллера LAN. Например, «10.0.0.2».
tri_radio dictionary	Параметры конфигурации для радиоинтерфейса TRI.
admin_status string	Административный статус для радиоинтерфейса TRI. Например, «Включено».
antenna_cable_name string	Название или тип антенного кабеля, используемого для радиоинтерфейса TRI. Например, «другой».
antenna_gain integer	Значение усиления антенны в децибелах (дБ) для радиоинтерфейса TRI, допустимые значения находятся в диапазоне от 0 до 40. Например, 16.
antenna_name string	Название или тип антенны, используемой для радиоинтерфейса TRI. Например, «другой».
cable_loss integer	Потери в кабеле в дБ для радиоинтерфейса TRI. Допустимые значения находятся в диапазоне от 0 до 40. Это значение должно быть меньше, чем усиление антенны. Например, 6.
channel_assignment_mode string	Режим назначения канала для радиоинтерфейса TRI. Принимает «Глобальный» или «Пользовательский». Для пользовательского режима принимаются значения, такие как 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, 169, 173. (например, Пользовательский)
channel_number integer	Пользовательский номер канала, настроенный для радиоинтерфейса TRI. Например, 6.
channel_width string	Ширина канала, настроенная для радиоинтерфейса TRI. Принимает значения «20 МГц», «40 МГц», «80 МГц», «160 МГц» или «320 МГц». Например, 20 МГц.
dual_radio_mode string	Режим работы, настроенный для радиоинтерфейса TRI. Указывает, как точка доступа (AP) управляет своей функцией двухдиапазонной работы. Например, Авто.
power_assignment_mode string	Режим назначения мощности для радиоинтерфейса TRI. Принимает «Глобальный» или «Пользовательский». В пользовательском режиме принимаются значения от 1 до 8.
power_level integer	Пользовательский уровень мощности, настроенный для радиоинтерфейса TRI. Например, 3.
radio_role_assignment string	Режим назначения роли для радиоинтерфейса TRI. Принимает «Авто», «Обслуживание клиентов» или «Монитор». Если radio_role_assignment имеет значение «Обслуживание клиентов», то можно изменять только power-level и channel-level.
xor_radio dictionary	Параметры конфигурации для радиоинтерфейса XOR.
admin_status string	Административный статус для радиоинтерфейса XOR. Например, «Включено».
antenna_cable_name string	Название или тип антенного кабеля, используемого для радиоинтерфейса XOR. Например, «другой».
antenna_gain integer	Значение усиления антенны в децибелах (дБ) для радиоинтерфейса XOR, допустимые значения находятся в диапазоне от 0 до 40. Например, 14.
antenna_name string	Название или тип антенны, используемой для радиоинтерфейса XOR. Например, «другой».
cable_loss integer	Потери в кабеле в дБ для радиоинтерфейса XOR. Допустимые значения находятся в диапазоне от 0 до 40. Это значение должно быть меньше, чем усиление антенны. Например, 5.
channel_assignment_mode string	Режим назначения канала для радиоинтерфейса XOR. Принимает «Глобальный» или «Пользовательский». - Для режима «Пользовательский» и радиодиапазона «2,4 ГГц» допустимые значения находятся в диапазоне от 1 до 14. - Для режима «Пользовательский» и радиодиапазона «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, 169, 173. - Для режима «Пользовательский» и радиодиапазона «6 ГГц» допустимые значения равны 1, 5, 9, 13, 17, 21, 25, 29, 33, 37, 41, 45, 49, 53, 57, 61, 65, 69, 73, 77, 81, 85, 89, 93, 97, 101, 105, 109, 113, 117, 121, 125, 129, 133, 137, 141, 145, 149, 153, 157, 161, 165, 169, 173, 177, 181, 185, 189, 193, 197, 201, 205, 209, 213, 217, 221, 225, 229, 233. Например, «Пользовательский».
channel_number integer	Пользовательский номер канала, настроенный для радиоинтерфейса XOR. Например, 6.

channel_width string	Ширина канала, настроенного для интерфейса радио XOR. Принимает значения «20 МГц», «40 МГц», «80 МГц», «160 МГц» или «320 МГц». Например, 20 МГц.
power_assignment_mode string	Режим назначения мощности для радиоинтерфейса XOR. Принимает значения «Глобальный» или «Пользовательский». В режиме «Пользовательский» допустимые значения варьируются от 1 до 8.
power_level integer	Настроенный уровень мощности для радиоинтерфейса XOR. Например, 3.
radio_band string	Диапазон радиочастот должен быть включен, если назначение роли радиоинтерфейса установлено в режим «Обслуживание клиентов». Принимает значения «2,4 ГГц», «5 ГГц» или «6 ГГц».
radio_role_assignment string	Режим назначения роли для радиоинтерфейса XOR. Принимает значения «Авто», «Обслуживание клиентов» или «Мониторинг». Если «radio_role_assignment» установлено в «Обслуживание клиентов», можно изменить только уровень мощности и номер канала. Кроме того, если в диапазоне радиочастот выбран диапазон 5 ГГц, уровень мощности изменить нельзя. Например, «Авто».
config_verify boolean	Установить в значение True, чтобы проверить конфигурацию Cisco Catalyst Center после применения конфигурации playbook. Варианты: `false` ← (по умолчанию) `true`
dnac_api_task_timeout integer	Количество попыток повторного синхронизирования. По умолчанию: `1200`
dnac_debug boolean	Указывает, включен ли отладчик в Cisco Catalyst Center SDK. Варианты: `false` ← (по умолчанию) `true`
dnac_host string / обязательно	Имя хоста Cisco Catalyst Center.
dnac_log boolean	Флаг для включения/выключения ведения журнала выполнения playbook. При значении True и указанном пути dnac_log_file_path: - создает файл журнала в месте выполнения с указанным именем. При значении True и отсутствии пути dnac_log_file_path: - создает файл журнала в месте выполнения с именем ‘dnac.log’. При значении False: - ведение журнала отключено. Если файл журнала не существует: - он создается в режиме добавления или записи в зависимости от флага «dnac_log_append». Если файл журнала существует: - он перезаписывается или дополняется в зависимости от флага «dnac_log_append». Варианты: `false` ← (по умолчанию) `true`
dnac_log_append boolean	Определяет режим файла. Установите в значение True для режима «добавление». Установите в значение False для режима «запись». Варианты: `false` `true` ← (по умолчанию)
dnac_log_file_path string	Управляет ведением журнала. Журналы записываются, если dnac_log равно True. Если путь не указан: - Когда ‘dnac_log_append’ равно True, ‘dnac.log’ генерируется в текущем каталоге Ansible; логи добавляются. - Когда ‘dnac_log_append’ равно False, ‘dnac.log’ генерируется; логи перезаписываются. Если путь указан: - Когда ‘dnac_log_append’ равно True, файл открывается в режиме добавления. - Когда ‘dnac_log_append’ равно False, файл открывается в режиме записи (w). - В сценариях совместного использования файлов, без режима добавления, содержимое перезаписывается после каждого выполнения модуля. - Для общего файла журнала установите режим добавления в False для первого модуля (для перезаписи); для последующих модулей установите режим добавления в True. По умолчанию: `"dnac.log"`
dnac_log_level string	Устанавливает порог уровня журнала. Сообщения с уровнем, равным или большим этому, будут записаны в журнал. Уровни упорядочены по степени серьезности [CRITICAL, ERROR, WARNING, INFO, DEBUG]. CRITICAL указывает серьезные ошибки, останавливающие программу. Отображаются только сообщения CRITICAL. ERROR указывает проблемы, мешающие выполнению функции. Отображаются сообщения ERROR и CRITICAL. WARNING указывает потенциальные будущие проблемы. Отображаются сообщения WARNING, ERROR, CRITICAL. INFO отслеживает нормальную работу. Отображаются сообщения INFO, WARNING, ERROR, CRITICAL. DEBUG предоставляет подробную диагностическую информацию. Отображаются все сообщения журнала. По умолчанию: `"WARNING"`
dnac_password string	Пароль для аутентификации в Cisco Catalyst Center.
dnac_port string	Указывает номер порта, связанный с Cisco Catalyst Center. По умолчанию: `"443"`
dnac_task_poll_interval integer	Интервал в секундах для опроса Cisco Catalyst Center. По умолчанию: `2`
dnac_username псевдонимы: user string	Имя пользователя для аутентификации в Cisco Catalyst Center. По умолчанию: `"admin"`

dnac_verify boolean	Флаг для включения или отключения проверки сертификата SSL. Варианты: `false` `true` ← (по умолчанию)
dnac_version string	Указывает версию Cisco Catalyst Center, которую SDK должен использовать. По умолчанию: `"2.2.3.3"`
next_task_after_interval integer	Время в секундах между выполнением Provision и обновлением AP. По умолчанию: `5`
state string	Желаемое состояние процесса замены устройства. Варианты: `"merged"` ← (по умолчанию) `"deleted"`
validate_response_schema boolean	Флаг для Cisco Catalyst Center SDK, позволяющий включить валидацию тел запросов по схеме JSON. Варианты: `false` `true` ← (по умолчанию)

Примечания

Примечание

Убедитесь, что установлены необходимые зависимости Python, выполнив pip install dnacentersdk.
Используемые методы SDK:
devices.get_device_list
wireless.get_access_point_configuration
sites.get_site
sda.get_device_info
sites.assign_devices_to_site
wireless.ap_provision
wireless.configure_access_points
sites.get_membership
Используемые пути:
GET /dna/intent/api/v1/network-device
GET /dna/intent/api/v1/site
GET /dna/intent/api/v1/business/sda/device
POST /dna/intent/api/v1/wireless/ap-provision
GET /dna/intent/api/v1/membership/{siteId}
GET /dna/intent/api/v1/wireless/accesspoint-configuration/details/{task_id}
POST /dna/intent/api/v2/wireless/accesspoint-configuration
POST /dna/intent/api/v1/assign-device-to-site/{siteId}/device
Не поддерживает check_mode
Плагин работает на контрольном узле и не использует плагины подключения Ansible, вместо этого встроенный менеджер подключений из Cisco Catalyst Center SDK.
Параметры, начинающиеся с dnac_, используются Cisco Catalyst Center Python SDK для установления подключения.

См. также

Документация по Ansible-коллекции Cisco DNAC: Полное руководство по работе с Ansible-коллекцией Cisco DNAC.
Документация API Cisco DNAC: Официальная документация API Cisco DNAC.

Примеры

- name: Provision/Move/Update Wireless Access Point Configuration
  hosts: dnac_servers
  connection: local
  gather_facts: no
  vars_files:
    - "credentials.yml"
  tasks:
    - name: Updating Access Point Site / Configuration details
      cisco.dnac.accesspoint_workflow_manager:
        dnac_host: "{{ dnac_host }}"
        dnac_username: "{{ dnac_username }}"
        dnac_password: "{{ dnac_password }}"
        dnac_verify: "{{ dnac_verify }}"
        dnac_port: "{{ dnac_port }}"
        dnac_version: "{{ dnac_version }}"
        dnac_debug: "{{ dnac_debug }}"
        dnac_log: True
        dnac_log_level: DEBUG
        config_verify: False
        state: merged
        config:
          - mac_address: 90:e9:5e:03:f3:40
            2.4ghz_radio:
              admin_status: "Enabled"
              antenna_name: "AIR-ANT2513P4M-N-2.4GHz"
              radio_role_assignment: "Client-Serving"
              powerlevel: 5
              channel_number: 7
      register: output_list

    - name: Updating Access Point Site / Configuration details
      cisco.dnac.accesspoint_workflow_manager:
        dnac_host: "{{ dnac_host }}"
        dnac_username: "{{ dnac_username }}"
        dnac_password: "{{ dnac_password }}"
        dnac_verify: "{{ dnac_verify }}"
        dnac_port: "{{ dnac_port }}"
        dnac_version: "{{ dnac_version }}"
        dnac_debug: "{{ dnac_debug }}"
        dnac_log: True
        dnac_log_level: DEBUG
        config_verify: False
        state: merged
        config:
          - mac_address: 90:e9:5e:03:f3:40
            2.4ghz_radio:
              admin_status: "Enabled"
              power_assignment_mode: "Global"
      register: output_list

    - name: Updating Access Point Site / Configuration details
      cisco.dnac.accesspoint_workflow_manager:
        dnac_host: "{{ dnac_host }}"
        dnac_username: "{{ dnac_username }}"
        dnac_password: "{{ dnac_password }}"
        dnac_verify: "{{ dnac_verify }}"
        dnac_port: "{{ dnac_port }}"
        dnac_version: "{{ dnac_version }}"
        dnac_debug: "{{ dnac_debug }}"
        dnac_log: True
        dnac_log_level: DEBUG
        config_verify: False
        state: merged
        config:
          - mac_address: 90:e9:5e:03:f3:40
            2.4ghz_radio:
              admin_status: "Enabled"
              channel_assignment_mode: "Global"
      register: output_list

    - name: Updating Access Point Site / Configuration details
      cisco.dnac.accesspoint_workflow_manager:
        dnac_host: "{{ dnac_host }}"
        dnac_username: "{{ dnac_username }}"
        dnac_password: "{{ dnac_password }}"
        dnac_verify: "{{ dnac_verify }}"
        dnac_port: "{{ dnac_port }}"
        dnac_version: "{{ dnac_version }}"
        dnac_debug: "{{ dnac_debug }}"
        dnac_log: True
        dnac_log_level: DEBUG
        config_verify: False
        state: merged
        config:
          - mac_address: 90:e9:5e:03:f3:40
            5ghz_radio:
              admin_status: "Enabled"
              antenna_name: "AIR-ANT2513P4M-N-5GHz"
      register: output_list

    - name: Updating Access Point Site / Configuration details
      cisco.dnac.accesspoint_workflow_manager:
        dnac_host: "{{ dnac_host }}"
        dnac_username: "{{ dnac_username }}"
        dnac_password: "{{ dnac_password }}"
        dnac_verify: "{{ dnac_verify }}"
        dnac_port: "{{ dnac_port }}"
        dnac_version: "{{ dnac_version }}"
        dnac_debug: "{{ dnac_debug }}"
        dnac_log: True
        dnac_log_level: DEBUG
        config_verify: False
        state: merged
        config:
          - mac_address: 90:e9:5e:03:f3:40
            5ghz_radio:
              admin_status: "Enabled"
              antenna_name: "AIR-ANT2513P4M-N-5GHz"
              radio_role_assignment: "Client-Serving"
              channel_number: 44
      register: output_list

    - name: Updating Access Point Site / Configuration details
      cisco.dnac.accesspoint_workflow_manager:
        dnac_host: "{{ dnac_host }}"
        dnac_username: "{{ dnac_username }}"
        dnac_password: "{{ dnac_password }}"
        dnac_verify: "{{ dnac_verify }}"
        dnac_port: "{{ dnac_port }}"
        dnac_version: "{{ dnac_version }}"
        dnac_debug: "{{ dnac_debug }}"
        dnac_log: True
        dnac_log_level: DEBUG
        config_verify: False
        state: merged
        config:
          - mac_address: 90:e9:5e:03:f3:40
            5ghz_radio:
              admin_status: "Enabled"
              antenna_name: "C-ANT9104-Single-D0-5GHz"
              channel_number: 52
              powerlevel: 5
              channel_width: "40 MHz"
      register: output_list

    - name: Updating Access Point Site / Configuration details
      cisco.dnac.accesspoint_workflow_manager:
        dnac_host: "{{ dnac_host }}"
        dnac_username: "{{ dnac_username }}"
        dnac_password: "{{ dnac_password }}"
        dnac_verify: "{{ dnac_verify }}"
        dnac_port: "{{ dnac_port }}"
        dnac_version: "{{ dnac_version }}"
        dnac_debug: "{{ dnac_debug }}"
        dnac_log: True
        dnac_log_level: DEBUG
        config_verify: False
        state: merged
        config:
          - mac_address: 90:e9:5e:03:f3:40
            2.4ghz_radio:
              admin_status: "Enabled"
              antenna_name: "C-ANT9103-2.4GHz"
              channel_number: 9
              powerlevel: 4
            5ghz_radio:
              admin_status: "Enabled"
              antenna_name: "C-ANT9103-5GHz"
              channel_number: 40
              powerlevel: 3
              channel_width: "20 MHz"
      register: output_list

    - name: Provisioning and Re-provisiong Access Point Site details
      cisco.dnac.accesspoint_workflow_manager:
        dnac_host: "{{ dnac_host }}"
        dnac_username: "{{ dnac_username }}"
        dnac_password: "{{ dnac_password }}"
        dnac_verify: "{{ dnac_verify }}"
        dnac_port: "{{ dnac_port }}"
        dnac_version: "{{ dnac_version }}"
        dnac_debug: "{{ dnac_debug }}"
        dnac_log: True
        dnac_log_level: DEBUG
        config_verify: True
        state: merged
        config:
          - mac_address:  90:e9:5e:03:f3:40
            rf_profile: "HIGH"
            site:
              floor:
                name: "FLOOR1"
                parent_name: "Global/USA/New York/BLDNYC"
      register: output_list

    - name: Updating Access Point Update / Controller Name
      cisco.dnac.accesspoint_workflow_manager:
        dnac_host: "{{ dnac_host }}"
        dnac_username: "{{ dnac_username }}"
        dnac_password: "{{ dnac_password }}"
        dnac_verify: "{{ dnac_verify }}"
        dnac_port: "{{ dnac_port }}"
        dnac_version: "{{ dnac_version }}"
        dnac_debug: "{{ dnac_debug }}"
        dnac_log: True
        dnac_log_level: DEBUG
        config_verify: True
        state: merged
        config:
          - mac_address: a4:88:73:d4:d6:60
            ap_name: "Cisco_Test_AP_T003"
            admin_status: "Enabled"
            led_status: "Enabled"
            led_brightness_level: 1
            ap_mode: "Local"
            is_assigned_site_as_location: "Enabled"
            failover_priority: "Low"
            primary_controller_name: "NY-EWLC-1"
            primary_ip_address:
              address: "204.192.6.200"
            secondary_controller_name: "NY-EWLC-20"
            secondary_ip_address:
              address: "fe80::202:b3ff:fe1e:8324"
            tertiary_controller_name: "SJ-EWLC-20"
            tertiary_ip_address:
              address: "fe80::202:b3ff:fe1e:8325"
      register: output_list

    - name: Updating Access Point Update / remove tertiary_controller_name
      cisco.dnac.accesspoint_workflow_manager:
        dnac_host: "{{ dnac_host }}"
        dnac_username: "{{ dnac_username }}"
        dnac_password: "{{ dnac_password }}"
        dnac_verify: "{{ dnac_verify }}"
        dnac_port: "{{ dnac_port }}"
        dnac_version: "{{ dnac_version }}"
        dnac_debug: "{{ dnac_debug }}"
        dnac_log: True
        dnac_log_level: DEBUG
        config_verify: True
        state: merged
        config:
          - mac_address: a4:88:73:d4:d6:60
            ap_name: "Cisco_Test_AP_T003"
            admin_status: "Enabled"
            led_status: "Enabled"
            led_brightness_level: 1
            ap_mode: "Local"
            is_assigned_site_as_location: "Enabled"
            failover_priority: "Low"
            primary_controller_name: "NY-EWLC-10"
            primary_ip_address:
              address: "fe80::202:b3ff:fe1e:8329"
            secondary_controller_name: "NY-EWLC-20"
            secondary_ip_address:
              address: "fe80::202:b3ff:fe1e:8324"
            tertiary_controller_name: "Inherit from site / Clear"
      register: output_list

    - name: Updating Access Point Site / Configuration details
      cisco.dnac.accesspoint_workflow_manager:
        dnac_host: "{{ dnac_host }}"
        dnac_username: "{{ dnac_username }}"
        dnac_password: "{{ dnac_password }}"
        dnac_verify: "{{ dnac_verify }}"
        dnac_port: "{{ dnac_port }}"
        dnac_version: "{{ dnac_version }}"
        dnac_debug: "{{ dnac_debug }}"
        dnac_log: True
        dnac_log_level: DEBUG
        config_verify: False
        state: merged
        config:
          - mac_address: 90:e9:5e:03:f3:40
            rf_profile: "HIGH"
            site:
              floor:
                name: "FLOOR1"
                parent_name: "Global/USA/New York/BLDNYC"
            ap_name: "LTTS-test2"
            admin_status: "Enabled"
            led_status: "Enabled"
            led_brightness_level: 5
            ap_mode: "Local"
            is_assigned_site_as_location: "Enabled"
            failover_priority: "Low"
            2.4ghz_radio:
              admin_status: "Enabled"
              antenna_name: "C-ANT9104-2.4GHz"
              radio_role_assignment: "Client-Serving"
              channel_number: 5
              powerlevel: 2
            5ghz_radio:
              admin_status: "Enabled"
              antenna_name: "AIR-ANT2513P4M-N-5GHz"
              radio_role_assignment: "Client-Serving"
              channel_number: 36
              powerlevel: 2
              channel_width: "40 MHz"
      register: output_list

    - name: Updating Access Point Site / Configuration details
      cisco.dnac.accesspoint_workflow_manager:
        dnac_host: "{{ dnac_host }}"
        dnac_username: "{{ dnac_username }}"
        dnac_password: "{{ dnac_password }}"
        dnac_verify: "{{ dnac_verify }}"
        dnac_port: "{{ dnac_port }}"
        dnac_version: "{{ dnac_version }}"
        dnac_debug: "{{ dnac_debug }}"
        dnac_log: True
        dnac_log_level: DEBUG
        config_verify: True
        state: merged
        config:
          - mac_address: 6c:d6:e3:75:5a:e0
            ap_name: "LTTS_Test_9120_T2"
            admin_status: "Enabled"
            led_status: "Enabled"
            led_brightness_level: 2
            ap_mode: "Local"
            is_assigned_site_as_location: "Enabled"
            failover_priority: "Low"
            primary_controller_name: "NY-IAC-EWLC.cisco.local"
            primary_ip_address:
              address: "204.192.6.200"
            secondary_controller_name: "Inherit from site / Clear"
            tertiary_controller_name: "Inherit from site / Clear"
            xor_radio:
              admin_status: "Enabled"
              radio_role_assignment: "Client-Serving"
              channel_number: 4
              radio_band: "2.4 GHz"
              channel_width: "40 MHz"
            5ghz_radio:
              admin_status: "Enabled"
              antenna_name: "AIR-ANT2513P4M-N-5GHz"
              radio_role_assignment: "Client-Serving"
              channel_number: 40
              powerlevel: 2
              channel_width: "80 MHz"
      register: output_list

    - name: Updating Access Point Configuration
      cisco.dnac.accesspoint_workflow_manager:
        dnac_host: "{{ dnac_host }}"
        dnac_username: "{{ dnac_username }}"
        dnac_password: "{{ dnac_password }}"
        dnac_verify: "{{ dnac_verify }}"
        dnac_port: "{{ dnac_port }}"
        dnac_version: "{{ dnac_version }}"
        dnac_debug: "{{ dnac_debug }}"
        dnac_log: True
        dnac_log_level: DEBUG
        config_verify: True
        state: merged
        config:
          - mac_address: e4:38:7e:42:bc:00
            ap_name: "LTTS_Test_9166_T3"
            admin_status: "Enabled"
            led_status: "Enabled"
            led_brightness_level: 3
            ap_mode: "Local"
            is_assigned_site_as_location: "Enabled"
            failover_priority: "Low"
            primary_controller_name: "NY-IAC-EWLC"
            primary_ip_address:
              address: "204.192.6.200"
            secondary_controller_name: "Inherit from site / Clear"
            tertiary_controller_name: "Inherit from site / Clear"
            2.4ghz_radio:
              admin_status: "Enabled"
              radio_role_assignment: "Client-Serving"
              channel_number: 3
              powerlevel: 3
            5ghz_radio:
              admin_status: "Enabled"
              radio_role_assignment: "Client-Serving"
              channel_number: 44
              powerlevel: 3
              channel_width: "20 MHz"
            xor_radio:
              admin_status: "Enabled"
              radio_role_assignment: "Client-Serving"
              channel_number: 1
              powerlevel: 3
              radio_band: "6 GHz"
              channel_width: "40 MHz"
      register: output_list

    - name: Reboot single or multiple access point
      cisco.dnac.accesspoint_workflow_manager:
        dnac_host: "{{ dnac_host }}"
        dnac_username: "{{ dnac_username }}"
        dnac_password: "{{ dnac_password }}"
        dnac_verify: "{{ dnac_verify }}"
        dnac_port: "{{ dnac_port }}"
        dnac_version: "{{ dnac_version }}"
        dnac_debug: "{{ dnac_debug }}"
        dnac_log: True
        dnac_log_level: DEBUG
        config_verify: True
        state: merged
        config:
          - reboot_aps:
              mac_addresses:
                - "6c:d6:e3:75:5a:e0"
                - "e4:38:7e:42:bc:00"
      register: output_list

    - name: Reboot single or multiple access point by hostname
      cisco.dnac.accesspoint_workflow_manager:
        dnac_host: "{{ dnac_host }}"
        dnac_username: "{{ dnac_username }}"
        dnac_password: "{{ dnac_password }}"
        dnac_verify: "{{ dnac_verify }}"
        dnac_port: "{{ dnac_port }}"
        dnac_version: "{{ dnac_version }}"
        dnac_debug: "{{ dnac_debug }}"
        dnac_log: True
        dnac_log_level: DEBUG
        config_verify: True
        state: merged
        config:
          - reboot_aps:
              hostnames:
                - "cisco_Test_9166_T3"
                - "cisco_Test_9120_T1"
      register: output_list

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

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

Ключ	Описание
response_1 словарь	Список словарей, содержащих подробности об обновлениях AP и результатах проверки, возвращаемых Catalyst Center Python SDK. Возвращается: всегда Пример: `{"response": [{"changed": true, "response": {"ap_config_update_status": "The update for AP Config Cisco_Test_9120_T1 has been successfully verified."}}]}`
response_2 словарь	Словарь со статусом провайдинга, возвращаемый Catalyst Center Python SDK. Возвращается: всегда Пример: `{"response": [{"changed": true, "response": {"ap_provision_update_status": "AP provision for the site 'Global/Chennai/LTTS/FLOOR1' has been successfully verified."}}]}`
response_3 словарь	Словарь со статусом перезагрузки AP, возвращаемый Catalyst Center Python SDK. Возвращается: всегда Пример: `{"response": {"accesspoints_updates": {"ap_reboot_status": "AP ['6c:d6:e3:69:49:b4', '68:49:92:75:0f:d0'] Rebooted Successfully", "ap_reboot_task_details": {"reboot_api_response": {"apList": [{"apName": "LTTS_Test_9120_T2", "failureReason": null, "rebootStatus": "Success"}, {"apName": "LTTS_Test_9166_T3", "failureReason": null, "rebootStatus": "Success"}], "wlcIP": "204.192.6.200"}}}}}`

Авторы

A Mohamed Rafeek (@mabdulk2)
Sonali Deepthi Kesali (@skesali)
Megha Kandari (@mekandar)
Natarajan (@natarajan)
Madhan Sankaranarayanan (@madhansansel)
Abhishek Maheshwari (@abmahesh)

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

© 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/dnac/accesspoint_workflow_manager_module.html