cisco.dnac.wireless_accespoint_configuration module – Resource module for Wireless Accespoint Configuration
Note
This module is part of the cisco.dnac collection (version 6.20.0).
You might already have this collection installed if you are using the ansible
package.
It is not included in ansible-core
.
To check whether it is installed, run ansible-galaxy collection list
.
To install it, use: ansible-galaxy collection install cisco.dnac
.
You need further requirements to be able to use this module,
see Requirements for details.
To use it in a playbook, specify: cisco.dnac.wireless_accespoint_configuration
.
New in cisco.dnac 3.1.0
Synopsis
Manage operation create of the resource Wireless Accespoint Configuration.
User can configure multiple access points with required options using this intent API. This API does not support configuration of CleanAir or SI for IOS-XE devices with version greater than or equal to 17.9.
Note
This module has a corresponding action plugin.
Requirements
The below requirements are needed on the host that executes this module.
dnacentersdk >= 2.7.2
python >= 3.5
Parameters
Parameter |
Comments |
---|---|
Configure the access point’s admin status. Set this parameter’s value to “true” to enable it and “false” to disable it. Choices:
|
|
Wireless Accespoint Configuration’s apList. |
|
The current host name of the access point. |
|
The modified hostname of the access point. |
|
The ethernet MAC address of the access point. |
|
Configure the access point’s mode for local/flexconnect mode, set “0”; for monitor mode, set “1”; for sniffer mode, set “4”; and for bridge/flex+bridge mode, set “5”. |
|
To change the access point’s admin status, set this parameter’s value to “true”. Choices:
|
|
To change the access point’s mode, set this parameter’s value to “true”. Choices:
|
|
To change the access point’s failover priority, set this parameter’s value to “true”. Choices:
|
|
To change the access point’s HA controller, set this parameter’s value to “true”. Choices:
|
|
To change the access point’s LED brightness level, set this parameter’s value to “true”. Choices:
|
|
To change the access point’s LED status, set this parameter’s value to “true”. Choices:
|
|
To change the access point’s location, set this parameter’s value to “true”. Choices:
|
|
Flag for Cisco DNA Center SDK to enable debugging. Choices:
|
|
The Cisco DNA Center hostname. |
|
The Cisco DNA Center password to authenticate. |
|
The Cisco DNA Center port. Default: |
|
The Cisco DNA Center username to authenticate. Default: |
|
Flag to enable or disable SSL certificate verification. Choices:
|
|
Informs the SDK which version of Cisco DNA Center to use. Default: |
|
Configure the acess point’s failover priority for low, set “1”; for medium, set “2”; for high, set “3”; and for critical, set “4”. |
|
If AP is assigned to a site, then to assign AP location as the site name, set this parameter’s value to “true”. Choices:
|
|
Configure the access point’s LED brightness level by setting a value between 1 and 8. |
|
Configure the access point’s LED status. Set “true” to enable its status and “false” to disable it. Choices:
|
|
Configure the access point’s location. |
|
Configure the hostname for an access point’s primary controller. |
|
Wireless Accespoint Configuration’s primaryIpAddress. |
|
Configure the IP address for an access point’s primary controller. |
|
Wireless Accespoint Configuration’s radioConfigurations. |
|
Configure the admin status on the specified radio for an access point. Set this parameter’s value to “true” to enable it and “false” to disable it. Choices:
|
|
Configure the antenna cable name on the specified radio for an access point. If cable loss needs to be configured, set this parameter’s value to “other”. |
|
Configure the antenna gain on the specified radio for an access point by setting a decimal value (in dBi). To configure “antennaGain”, set “antennaPatternName” value to “other”. |
|
Specify the antenna name on the specified radio for an access point. The antenna name is used to calculate the gain on the radio slot. |
|
Configure the cable loss on the specified radio for an access point by setting a decimal value (in dBi). |
|
Configure the channel assignment mode on the specified radio for an access point for global mode, set “1”; and for custom mode, set “2”. |
|
Configure the channel number on the specified radio for an access point. |
|
Configure the channel width on the specified radio for an access point for 20 MHz, set “3”; for 40 MHz, set “4”; for 80 MHz, set “5”; and for 160 MHz, set “6”. |
|
Configure CleanAir or Spectrum Intelligence on the specified radio for an access point. Set this parameter’s value to “0” to disable the feature or “1” to enable it. |
|
To change the admin status on the specified radio for an access point, set this parameter’s value to “true”. Choices:
|
|
To change the antenna cable name on the specified radio for an access point, set this parameter’s value to “true”. Choices:
|
|
To change the antenna gain on the specified radio for an access point, set the value for this parameter to “true”. Choices:
|
|
To change the channel on the specified radio for an access point, set this parameter’s value to “true”. Choices:
|
|
To change the channel width on the specified radio for an access point, set this parameter’s value to “true”. Choices:
|
|
To enable or disable either CleanAir or Spectrum Intelligence on the specified radio for an access point, set this parameter’s value to “true”. Choices:
|
|
To change the power assignment mode on the specified radio for an access point, set this parameter’s value to “true”. Choices:
|
|
To change the radio role on the specified radio for an access point, set this parameter’s value to “true”. Choices:
|
|
Configure the power assignment mode on the specified radio for an access point for global mode, set “1”; and for custom mode, set “2”. |
|
Configure the power level on the specified radio for an access point by setting a value between 1 and 8. |
|
Configure the band on the specified radio for an access point for 2.4 GHz, set “RADIO24”; for 5 GHz, set “RADIO5”. Any other string is invalid, including empty string. |
|
Configure only one of the following roles on the specified radio for an access point as “AUTO”, “SERVING”, or “MONITOR”. Any other string is invalid, including empty string. |
|
Configure an access point’s radio band for 2.4 GHz, set “1”; for 5 GHz, set “2”; for XOR, set “3”; and for 6 GHz, set “6”. |
|
Configure the hostname for an access point’s secondary controller. |
|
Wireless Accespoint Configuration’s secondaryIpAddress. |
|
Configure the IP address for an access point’s secondary controller. |
|
Configure the hostname for an access point’s tertiary controller. |
|
Wireless Accespoint Configuration’s tertiaryIpAddress. |
|
Configure the IP address for an access point’s tertiary controller. |
|
Flag for Cisco DNA Center SDK to enable the validation of request bodies against a JSON schema. Choices:
|
Notes
Note
SDK Method used are wireless.Wireless.configure_access_points_v1,
Paths used are post /dna/intent/api/v1/wireless/accesspoint-configuration,
Does not support
check_mode
The plugin runs on the control node and does not use any ansible connection plugins, but instead the embedded connection manager from Cisco DNAC SDK
The parameters starting with dnac_ are used by the Cisco DNAC Python SDK to establish the connection
See Also
See also
- Cisco DNA Center documentation for Wireless ConfigureAccessPointsV1
Complete reference of the ConfigureAccessPointsV1 API.
Examples
- name: Create
cisco.dnac.wireless_accespoint_configuration:
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}}"
adminStatus: true
apList:
- apName: string
apNameNew: string
macAddress: string
apMode: 0
configureAdminStatus: true
configureApMode: true
configureFailoverPriority: true
configureHAController: true
configureLedBrightnessLevel: true
configureLedStatus: true
configureLocation: true
failoverPriority: 0
isAssignedSiteAsLocation: true
ledBrightnessLevel: 0
ledStatus: true
location: string
primaryControllerName: string
primaryIpAddress:
address: string
radioConfigurations:
- adminStatus: true
antennaCableName: string
antennaGain: 0
antennaPatternName: string
cableLoss: 0
channelAssignmentMode: 0
channelNumber: 0
channelWidth: 0
cleanAirSI: 0
configureAdminStatus: true
configureAntennaCable: true
configureAntennaPatternName: true
configureChannel: true
configureChannelWidth: true
configureCleanAirSI: true
configurePower: true
configureRadioRoleAssignment: true
powerAssignmentMode: 0
powerlevel: 0
radioBand: string
radioRoleAssignment: string
radioType: 0
secondaryControllerName: string
secondaryIpAddress:
address: string
tertiaryControllerName: string
tertiaryIpAddress:
address: string
Return Values
Common return values are documented here, the following are the fields unique to this module:
Key |
Description |
---|---|
A dictionary or list with the response returned by the Cisco DNAC Python SDK Returned: always Sample: |