cisco.dnac.sensor_test_template_edit module – Resource module for Sensor Test Template Edit
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.sensor_test_template_edit
.
New in cisco.dnac 3.1.0
Synopsis
Manage operation update of the resource Sensor Test Template Edit.
Intent API to deploy, schedule, or edit and existing SENSOR test template.
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 |
---|---|
The sensor test template unique identifier, generated at test creation time. |
|
Indication of inprogress action. |
|
Sensor Test Template Edit’s apCoverage. |
|
The WIFI bands. |
|
Number of APs to test. |
|
RSSI threshold. |
|
Connection type of test WIRED, WIRELESS, BOTH. |
|
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: |
|
Encryption mode. |
|
Sensor Test Template Edit’s frequency. |
|
Unit of the time value (NANOSECONDS, MICROSECONDS, MILLISECONDS, SECONDS, MINUTES, HOURS, DAYS). |
|
Value of the unit. |
|
Last modify time. |
|
Location string. |
|
Sensor Test Template Edit’s locationInfoList. |
|
Use all sensors in the site for test. Choices:
|
|
Custom Management VLAN. Choices:
|
|
Site UUID. |
|
Site type. |
|
MAC addresses. |
|
Management VLAN. |
|
Site name hierarhy. |
|
Test template object model version (must be 2). |
|
The sensor test template name, which is the same as in ‘templateName’. |
|
Number of associated sensor. |
|
Number of neighboring AP threshold. |
|
Sensor Test Template Edit’s profiles. |
|
Auth protocol. |
|
Authentication type OPEN, WPA2_PSK, WPA2_EAP, WEB_AUTH, MAB, DOT1X, OTHER. |
|
Certificate download URL. |
|
Auth certificate file name. |
|
Certificate password phrase. |
|
Certificate status INACTIVE or ACTIVE. |
|
Certificate transfering protocol HTTP or HTTPS. |
|
Device Type. |
|
WPA2_EAP methods EAP-FAST, PEAP-MSCHAPv2, EAP-TLS, PEAP-TLS, EAP-TTLS-MSCHAPv2, EAP-TTLS-PAP, EAP-TTLS-CHAP, EAP-FAST-GTC, EAP-PEAP-GTC. |
|
Indication of using external WEB Auth. Choices:
|
|
External WEB Auth access URL. |
|
Sensor Test Template Edit’s extWebAuthHtmlTag. |
|
Label. |
|
Tag. |
|
Value. |
|
External authentication portal. |
|
External WEB Auth virtual IP. |
|
Sensor Test Template Edit’s locationVlanList. |
|
Site UUID. |
|
Array of VLANs. |
|
Password string for onboarding SSID. |
|
SSID password type ASCII or HEX. |
|
Profile name. |
|
Password of SSID when passwordType is ASCII. |
|
QoS policy PlATINUM, GOLD, SILVER, BRONZE. |
|
Secure certificate enrollment protocol true or false or null for not applicable. Choices:
|
|
Sensor Test Template Edit’s tests. |
|
Sensor Test Template Edit’s config. |
|
IPerf direction (UPLOAD, DOWNLOAD, BOTH). |
|
DNS domain name. |
|
Downlink test. Choices:
|
|
IPerf end port. |
|
Exit command. |
|
Final prompt. |
|
NDT server. |
|
NDT server path. |
|
NDT server port. |
|
Number of packets. |
|
Password. |
|
Password prompt. |
|
File path for file transfer. |
|
Radius or WEB server port. |
|
Probe type. |
|
Protocol used by file transfer, IPerf, mail server, and radius (TCP, UDP, FTP, POP3, IMAP, CHAP, PAP). |
|
Proxy password. |
|
Proxy port. |
|
Proxy server. |
|
Proxy user name. |
|
Ping, file transfer, mail, radius, ssh, or telnet server. |
|
IPerf server list. |
|
Shared secret. |
|
IPerf start port. |
|
File transfer type (UPLOAD, DOWNLOAD, BOTH). |
|
IPerf UDP bandwidth. |
|
Uplink test. Choices:
|
|
URL. |
|
User name. |
|
User name prompt. |
|
Name of the test. |
|
User name string for onboarding SSID. |
|
VLAN. |
|
Indication of being on allowed list. Choices:
|
|
Radio as sensor removed. Choices:
|
|
RSSI threshold. |
|
Run now (YES, NO). |
|
Bit-wise value of scheduled test days. |
|
Sensor Test Template Edit’s sensors. |
|
Is all sensor addition. Choices:
|
|
Is assigned. Choices:
|
|
Configuration updated YES, NO. |
|
Host name. |
|
Sensor ID. |
|
IP address. |
|
A string-stringList iPerf information. |
|
Site UUID. |
|
MAC address. |
|
Is marked for uninstall. Choices:
|
|
Sensor name. |
|
Run now YES, NO. |
|
Sensor type. |
|
Service policy. |
|
Sensor device status UP, DOWN, REBOOT. |
|
Switch MAC address. |
|
Switch serial number. |
|
Switch device UUID. |
|
Array of target APs. |
|
A string-string test MAC address. |
|
Wired application message. |
|
Wired application status. |
|
Is XOR sensor. Choices:
|
|
Show WLC upgrade banner. Choices:
|
|
Site hierarchy. |
|
Sensor Test Template Edit’s ssids. |
|
Auth protocol. |
|
Authentication type OPEN, WPA2_PSK, WPA2_EAP, WEB_AUTH, MAB, DOT1X, OTHER. |
|
WIFI bands 2.4GHz or 5GHz. |
|
Certificate download URL. |
|
Auth certificate file name. |
|
Certificate password phrase. |
|
Certificate status INACTIVE or ACTIVE. |
|
Certificate transfering protocol HTTP or HTTPS. |
|
WPA2_EAP methods EAP-FAST, PEAP-MSCHAPv2, EAP-TLS, PEAP-TLS, EAP-TTLS-MSCHAPv2, EAP-TTLS-PAP, EAP-TTLS-CHAP, EAP-FAST-GTC, EAP-PEAP-GTC. |
|
Indication of using external WEB Auth. Choices:
|
|
External WEB Auth access URL. |
|
Sensor Test Template Edit’s extWebAuthHtmlTag. |
|
Label. |
|
Tag. |
|
Value. |
|
External authentication portal. |
|
External WEB Auth virtual IP. |
|
Identification number. |
|
Layer 3 WEB Auth email address. |
|
Layer 3 WEB Auth password. |
|
Layer 3 WEB Auth security. |
|
Layer 3 WEB Auth user name. |
|
Number of APs in the test. |
|
Number of Sensors in the test. |
|
Password string for onboarding SSID. |
|
SSID password type ASCII or HEX. |
|
The SSID profile name string. |
|
Proxy server password. |
|
Proxy server port. |
|
Proxy server for onboarding SSID. |
|
Proxy server user name. |
|
Password of SSID when passwordType is ASCII. |
|
QoS policy PlATINUM, GOLD, SILVER, BRONZE. |
|
Secure certificate enrollment protocol true or false or null for not applicable. Choices:
|
|
The SSID string. |
|
WLAN status ENABLED or DISABLED. |
|
Sensor Test Template Edit’s tests. |
|
Sensor Test Template Edit’s config. |
|
IPerf direction (UPLOAD, DOWNLOAD, BOTH). |
|
DNS domain name. |
|
Downlink test. Choices:
|
|
IPerf end port. |
|
Exit command. |
|
Final prompt. |
|
NDT server. |
|
NDT server path. |
|
NDT server port. |
|
Number of packets. |
|
Password. |
|
Password prompt. |
|
File path for file transfer. |
|
Radius or WEB server port. |
|
Probe type. |
|
Protocol used by file transfer, IPerf, mail server, and radius (TCP, UDP, FTP, POP3, IMAP, CHAP, PAP). |
|
Proxy password. |
|
Proxy port. |
|
Proxy server. |
|
Proxy user name. |
|
Ping, file transfer, mail, radius, ssh, or telnet server. |
|
IPerf server list. |
|
Shared secret. |
|
IPerf start port. |
|
File transfer type (UPLOAD, DOWNLOAD, BOTH). |
|
IPerf UDP bandwidth. |
|
Uplink test. Choices:
|
|
URL. |
|
User name. |
|
User name prompt. |
|
Name of the test. |
|
Sensor Test Template Edit’s thirdParty. |
|
True the SSID is third party. Choices:
|
|
User name string for onboarding SSID. |
|
Valid From UTC timestamp. |
|
Valid To UTC timestamp. |
|
Indication of being on allowed list. Choices:
|
|
WLAN ID. |
|
WLC IP addres. |
|
Start time. |
|
Status of the test (RUNNING, NOTRUNNING). |
|
The test template name that is to be edited. |
|
Test schedule mode (ONDEMAND, DEDICATED, SCHEDULED, CONTINUOUS, RUNNOW). |
|
Flag for Cisco DNA Center SDK to enable the validation of request bodies against a JSON schema. Choices:
|
|
The sensor test template version (must be 2). |
|
WLANs list. |
Notes
Note
SDK Method used are sensors.Sensors.edit_sensor_test_template,
Paths used are put /dna/intent/api/v1/AssuranceScheduleSensorTest,
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 Sensors EditSensorTestTemplate
Complete reference of the EditSensorTestTemplate API.
Examples
- name: Update all
cisco.dnac.sensor_test_template_edit:
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}}"
_id: string
actionInProgress: string
apCoverage:
- bands: string
numberOfApsToTest: 0
rssiThreshold: 0
connection: string
encryptionMode: string
frequency:
unit: string
value: 0
lastModifiedTime: 0
location: string
locationInfoList:
- allSensors: true
customManagementVlan: true
locationId: string
locationType: string
macAddressList:
- string
managementVlan: string
siteHierarchy: string
modelVersion: 0
name: string
numAssociatedSensor: 0
numNeighborAPThreshold: 0
profiles:
- authProtocol: string
authType: string
certdownloadurl: string
certfilename: string
certpassphrase: string
certstatus: string
certxferprotocol: string
deviceType: string
eapMethod: string
extWebAuth: true
extWebAuthAccessUrl: string
extWebAuthHtmlTag:
- label: string
tag: string
value: string
extWebAuthPortal: string
extWebAuthVirtualIp: string
locationVlanList:
- locationId: string
vlans:
- string
password: string
passwordType: string
profileName: string
psk: string
qosPolicy: string
scep: true
tests:
- config:
- direction: string
domains:
- string
downlinkTest: true
endPort: 0
exitCommand: string
finalPrompt: string
ndtServer: string
ndtServerPath: string
ndtServerPort: string
numPackets: 0
password: string
passwordPrompt: string
pathToDownload: string
port: 0
probeType: string
protocol: string
proxyPassword: string
proxyPort: string
proxyServer: string
proxyUserName: string
server: string
servers:
- string
sharedSecret: string
startPort: 0
transferType: string
udpBandwidth: 0
uplinkTest: true
url: string
userName: string
userNamePrompt: string
name: string
username: string
vlan: string
whiteList: true
radioAsSensorRemoved: true
rssiThreshold: 0
runNow: string
scheduleInDays: 0
sensors:
- allSensorAddition: true
assigned: true
configUpdated: string
hostName: string
iPerfInfo: {}
id: string
ipAddress: string
locationId: string
macAddress: string
markedForUninstall: true
name: string
runNow: string
sensorType: string
servicePolicy: string
status: string
switchMac: string
switchSerialNumber: string
switchUuid: string
targetAPs:
- string
testMacAddresses: {}
wiredApplicationMessage: string
wiredApplicationStatus: string
xorSensor: true
showWlcUpgradeBanner: true
siteHierarchy: string
ssids:
- authProtocol: string
authType: string
bands: string
certdownloadurl: string
certfilename: string
certpassphrase: string
certstatus: string
certxferprotocol: string
eapMethod: string
extWebAuth: true
extWebAuthAccessUrl: string
extWebAuthHtmlTag:
- label: string
tag: string
value: string
extWebAuthPortal: string
extWebAuthVirtualIp: string
id: 0
layer3webAuthEmailAddress: string
layer3webAuthpassword: string
layer3webAuthsecurity: string
layer3webAuthuserName: string
numAps: 0
numSensors: 0
password: string
passwordType: string
profileName: string
proxyPassword: string
proxyPort: string
proxyServer: string
proxyUserName: string
psk: string
qosPolicy: string
scep: true
ssid: string
status: string
tests:
- config:
- direction: string
domains:
- string
downlinkTest: true
endPort: 0
exitCommand: string
finalPrompt: string
ndtServer: string
ndtServerPath: string
ndtServerPort: string
numPackets: 0
password: string
passwordPrompt: string
pathToDownload: string
port: 0
probeType: string
protocol: string
proxyPassword: string
proxyPort: string
proxyServer: string
proxyUserName: string
server: string
servers:
- string
sharedSecret: string
startPort: 0
transferType: string
udpBandwidth: 0
uplinkTest: true
url: string
userName: string
userNamePrompt: string
name: string
thirdParty:
selected: true
username: string
validFrom: 0
validTo: 0
whiteList: true
wlanId: 0
wlc: string
startTime: 0
status: string
templateName: string
testScheduleMode: string
version: 0
wlans:
- 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: |