cisco.dnac.sensor_test_template_edit 模块 – 传感器测试模板编辑资源模块
注意
此模块是 cisco.dnac 集合 (版本 6.25.0) 的一部分。
如果您正在使用 ansible 包，则可能已安装此集合。它不包含在 ansible-core 中。要检查它是否已安装，请运行 ansible-galaxy collection list。
要安装它，请使用： ansible-galaxy collection install cisco.dnac。您需要其他要求才能使用此模块，请参阅 要求 以了解详情。
要在 playbook 中使用它，请指定： cisco.dnac.sensor_test_template_edit。
cisco.dnac 3.1.0 中的新增功能
概要
此模块代表模块 sensor_test_template_edit_v1 的别名
注意
此模块具有相应的 action 插件。
要求
以下是执行此模块的主机所需的条件。
dnacentersdk >= 2.4.9
python >= 3.5
参数
参数 |
注释 |
|---|---|
传感器测试模板的唯一标识符，在测试创建时生成。 |
|
正在进行的操作指示。 |
|
传感器测试模板编辑的 apCoverage。 |
|
WIFI 频段。 |
|
要测试的 AP 数量。 |
|
RSSI 阈值。 |
|
测试的连接类型：有线、无线、两者。 |
|
用于 Cisco DNA Center SDK 的标志，用于启用调试。 选项
|
|
Cisco DNA Center 主机名。 |
|
用于身份验证的 Cisco DNA Center 密码。 |
|
Cisco DNA Center 端口。 默认值： |
|
用于身份验证的 Cisco DNA Center 用户名。 默认值： |
|
启用或禁用 SSL 证书验证的标志。 选项
|
|
告知 SDK 使用哪个版本的 Cisco DNA Center。 默认值： |
|
加密模式。 |
|
传感器测试模板编辑的 frequency。 |
|
时间值的单位 (纳秒、微秒、毫秒、秒、分、小时、天)。 |
|
单位的值。 |
|
最后修改时间。 |
|
位置字符串。 |
|
传感器测试模板编辑的 locationInfoList。 |
|
使用站点中的所有传感器进行测试。 选项
|
|
自定义管理 VLAN。 选项
|
|
站点 UUID。 |
|
站点类型。 |
|
MAC 地址。 |
|
管理 VLAN。 |
|
站点名称层次结构。 |
|
测试模板对象模型版本（必须为 2）。 |
|
传感器测试模板名称，与“templateName”相同。 |
|
关联的传感器数量。 |
|
相邻 AP 阈值数量。 |
|
传感器测试模板编辑的 profiles。 |
|
身份验证协议。 |
|
身份验证类型：OPEN、WPA2_PSK、WPA2_EAP、WEB_AUTH、MAB、DOT1X、OTHER。 |
|
证书下载 URL。 |
|
身份验证证书文件名。 |
|
证书密码短语。 |
|
证书状态：INACTIVE 或 ACTIVE。 |
|
证书传输协议：HTTP 或 HTTPS。 |
|
设备类型。 |
|
WPA2_EAP 方法：EAP-FAST、PEAP-MSCHAPv2、EAP-TLS、PEAP-TLS、EAP-TTLS-MSCHAPv2、EAP-TTLS-PAP、EAP-TTLS-CHAP、EAP-FAST-GTC、EAP-PEAP-GTC。 |
|
使用外部 WEB 身份验证的指示。 选项
|
|
外部 WEB 身份验证访问 URL。 |
|
传感器测试模板编辑的 extWebAuthHtmlTag。 |
|
标签。 |
|
标签。 |
|
值。 |
|
外部身份验证门户。 |
|
外部 WEB Auth 虚拟 IP。 |
|
传感器测试模板编辑的 locationVlanList。 |
|
站点 UUID。 |
|
VLAN 数组。 |
|
用于入网 SSID 的密码字符串。 |
|
SSID 密码类型，ASCII 或 HEX。 |
|
配置文件名称。 |
|
当 passwordType 为 ASCII 时，SSID 的密码。 |
|
QoS 策略，白金、黄金、白银、青铜。 |
|
安全证书注册协议，true、false 或 null（表示不适用）。 选项
|
|
传感器测试模板编辑的 tests。 |
|
传感器测试模板编辑的 config。 |
|
IPerf 方向 (UPLOAD, DOWNLOAD, BOTH)。 |
|
DNS 域名。 |
|
下行链路测试。 选项
|
|
IPerf 结束端口。 |
|
退出命令。 |
|
最终提示。 |
|
NDT 服务器。 |
|
NDT 服务器路径。 |
|
NDT 服务器端口。 |
|
数据包数量。 |
|
密码。 |
|
密码提示。 |
|
文件传输的文件路径。 |
|
Radius 或 WEB 服务器端口。 |
|
探测类型。 |
|
文件传输、IPerf、邮件服务器和 Radius 使用的协议 (TCP, UDP, FTP, POP3, IMAP, CHAP, PAP)。 |
|
代理密码。 |
|
代理端口。 |
|
代理服务器。 |
|
代理用户名。 |
|
Ping、文件传输、邮件、Radius、ssh 或 telnet 服务器。 |
|
IPerf 服务器列表。 |
|
共享密钥。 |
|
IPerf 开始端口。 |
|
文件传输类型 (UPLOAD, DOWNLOAD, BOTH)。 |
|
IPerf UDP 带宽。 |
|
上行链路测试。 选项
|
|
URL。 |
|
用户名。 |
|
用户名提示。 |
|
测试名称。 |
|
用于入网 SSID 的用户名字符串。 |
|
VLAN。 |
|
是否在允许列表中。 选项
|
|
无线电作为传感器已移除。 选项
|
|
RSSI 阈值。 |
|
立即运行 (YES, NO)。 |
|
计划测试日的位值。 |
|
传感器测试模板编辑的 sensors。 |
|
是否所有传感器添加。 选项
|
|
是否已分配。 选项
|
|
配置已更新 YES, NO。 |
|
主机名。 |
|
传感器 ID。 |
|
IP 地址。 |
|
字符串-字符串列表 iPerf 信息。 |
|
站点 UUID。 |
|
MAC 地址。 |
|
是否标记为卸载。 选项
|
|
传感器名称。 |
|
立即运行 YES, NO。 |
|
传感器类型。 |
|
服务策略。 |
|
传感器设备状态 UP、DOWN、REBOOT。 |
|
交换机 MAC 地址。 |
|
交换机序列号。 |
|
交换机设备 UUID。 |
|
目标 AP 数组。 |
|
字符串-字符串测试 MAC 地址。 |
|
有线应用消息。 |
|
有线应用状态。 |
|
是否为 XOR 传感器。 选项
|
|
显示 WLC 升级横幅。 选项
|
|
站点层次结构。 |
|
传感器测试模板编辑的 ssids。 |
|
身份验证协议。 |
|
身份验证类型：OPEN、WPA2_PSK、WPA2_EAP、WEB_AUTH、MAB、DOT1X、OTHER。 |
|
WIFI 频段 2.4GHz 或 5GHz。 |
|
证书下载 URL。 |
|
身份验证证书文件名。 |
|
证书密码短语。 |
|
证书状态：INACTIVE 或 ACTIVE。 |
|
证书传输协议：HTTP 或 HTTPS。 |
|
WPA2_EAP 方法：EAP-FAST、PEAP-MSCHAPv2、EAP-TLS、PEAP-TLS、EAP-TTLS-MSCHAPv2、EAP-TTLS-PAP、EAP-TTLS-CHAP、EAP-FAST-GTC、EAP-PEAP-GTC。 |
|
使用外部 WEB 身份验证的指示。 选项
|
|
外部 WEB 身份验证访问 URL。 |
|
传感器测试模板编辑的 extWebAuthHtmlTag。 |
|
标签。 |
|
标签。 |
|
值。 |
|
外部身份验证门户。 |
|
外部 WEB Auth 虚拟 IP。 |
|
识别号码。 |
|
三层 WEB Auth 电子邮件地址。 |
|
三层 WEB Auth 密码。 |
|
三层 WEB Auth 安全性。 |
|
三层 WEB Auth 用户名。 |
|
测试中的 AP 数量。 |
|
测试中的传感器数量。 |
|
用于入网 SSID 的密码字符串。 |
|
SSID 密码类型，ASCII 或 HEX。 |
|
SSID 配置文件名称字符串。 |
|
代理服务器密码。 |
|
代理服务器端口。 |
|
用于入网 SSID 的代理服务器。 |
|
代理服务器用户名。 |
|
当 passwordType 为 ASCII 时，SSID 的密码。 |
|
QoS 策略，白金、黄金、白银、青铜。 |
|
安全证书注册协议，true、false 或 null（表示不适用）。 选项
|
|
SSID 字符串。 |
|
WLAN 状态 ENABLED 或 DISABLED。 |
|
传感器测试模板编辑的 tests。 |
|
传感器测试模板编辑的 config。 |
|
IPerf 方向 (UPLOAD, DOWNLOAD, BOTH)。 |
|
DNS 域名。 |
|
下行链路测试。 选项
|
|
IPerf 结束端口。 |
|
退出命令。 |
|
最终提示。 |
|
NDT 服务器。 |
|
NDT 服务器路径。 |
|
NDT 服务器端口。 |
|
数据包数量。 |
|
密码。 |
|
密码提示。 |
|
文件传输的文件路径。 |
|
Radius 或 WEB 服务器端口。 |
|
探测类型。 |
|
文件传输、IPerf、邮件服务器和 Radius 使用的协议 (TCP, UDP, FTP, POP3, IMAP, CHAP, PAP)。 |
|
代理密码。 |
|
代理端口。 |
|
代理服务器。 |
|
代理用户名。 |
|
Ping、文件传输、邮件、Radius、ssh 或 telnet 服务器。 |
|
IPerf 服务器列表。 |
|
共享密钥。 |
|
IPerf 开始端口。 |
|
文件传输类型 (UPLOAD, DOWNLOAD, BOTH)。 |
|
IPerf UDP 带宽。 |
|
上行链路测试。 选项
|
|
URL。 |
|
用户名。 |
|
用户名提示。 |
|
测试名称。 |
|
传感器测试模板编辑的 thirdParty。 |
|
True 表示 SSID 为第三方。 选项
|
|
用于入网 SSID 的用户名字符串。 |
|
有效期起始时间（UTC 时间戳）。 |
|
有效期结束时间（UTC 时间戳）。 |
|
是否在允许列表中。 选项
|
|
WLAN ID。 |
|
WLC IP 地址。 |
|
开始时间。 |
|
测试状态 (RUNNING, NOTRUNNING)。 |
|
要编辑的测试模板名称。 |
|
测试计划模式 (ONDEMAND, DEDICATED, SCHEDULED, CONTINUOUS, RUNNOW)。 |
|
用于 Cisco DNA Center SDK 的标志，用于启用根据 JSON 模式验证请求正文。 选项
|
|
传感器测试模板版本（必须为 2）。 |
|
WLAN 列表。 |
注释
注意
使用的 SDK 方法为 sensors.Sensors.edit_sensor_test_template_v1，
使用的路径为 put /dna/intent/api/v1/AssuranceScheduleSensorTest，
需要注意的是，此模块是 sensor_test_template_edit_v1 的别名。
不支持
check_mode插件在控制节点上运行，不使用任何 Ansible 连接插件，而是使用 Cisco DNAC SDK 中的嵌入式连接管理器。
以 dnac_ 开头的参数由 Cisco DNAC Python SDK 用于建立连接。
另请参阅
另请参阅
- Cisco DNA Center 文档，了解 Sensors EditSensorTestTemplateV1。
EditSensorTestTemplateV1 API 的完整参考。
示例
- 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
返回值
常见的返回值已在 此处 记录，以下是此模块特有的字段。
键 |
描述 |
|---|---|
包含 Cisco DNAC Python SDK 返回的响应的字典或列表。 返回：始终返回。 示例： |