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 的别名。
注意
此模块具有相应的 操作插件。
要求
以下要求在执行此模块的主机上是必需的。
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。 默认值： |
|
加密模式。 |
|
传感器测试模板编辑的频率。 |
|
时间值的单位 (纳秒、微秒、毫秒、秒、分钟、小时、天)。 |
|
单位的值。 |
|
上次修改时间。 |
|
位置字符串。 |
|
传感器测试模板编辑的 locationInfoList。 |
|
使用站点中的所有传感器进行测试。 选项
|
|
自定义管理 VLAN。 选项
|
|
站点 UUID。 |
|
站点类型。 |
|
MAC 地址。 |
|
管理 VLAN。 |
|
站点名称层次结构。 |
|
测试模板对象模型版本（必须为 2）。 |
|
传感器测试模板名称，与“templateName”相同。 |
|
关联的传感器数量。 |
|
相邻 AP 阈值的数量。 |
|
传感器测试模板编辑的 profiles。 |
|
身份验证协议。 |
|
身份验证类型：OPEN、WPA2_PSK、WPA2_EAP、WEB_AUTH、MAB、DOT1X、OTHER。 |
|
证书下载 URL。 |
|
身份验证证书文件名。 |
|
证书密码短语。 |
|
证书状态：非活动或活动。 |
|
证书传输协议：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 身份验证虚拟 IP。 |
|
传感器测试模板编辑的 locationVlanList。 |
|
站点 UUID。 |
|
VLAN 数组。 |
|
用于入网 SSID 的密码字符串。 |
|
SSID 密码类型：ASCII 或 HEX。 |
|
配置文件名称。 |
|
当 passwordType 为 ASCII 时的 SSID 密码。 |
|
QoS 策略：PlATINUM、GOLD、SILVER、BRONZE。 |
|
安全证书注册协议：true、false 或 null（表示不适用）。 选项
|
|
传感器测试模板编辑的 tests。 |
|
传感器测试模板编辑的 config。 |
|
IPerf 方向 (上传、下载、两者)。 |
|
DNS 域名。 |
|
下行链路测试。 选项
|
|
IPerf 结束端口。 |
|
退出命令。 |
|
最终提示。 |
|
NDT 服务器。 |
|
NDT 服务器路径。 |
|
NDT 服务器端口。 |
|
数据包数量。 |
|
密码。 |
|
密码提示。 |
|
文件传输的文件路径。 |
|
Radius 或 WEB 服务器端口。 |
|
探测类型。 |
|
文件传输、IPerf、邮件服务器和 Radius 使用的协议 (TCP、UDP、FTP、POP3、IMAP、CHAP、PAP)。 |
|
代理密码。 |
|
代理端口。 |
|
代理服务器。 |
|
代理用户名。 |
|
Ping、文件传输、邮件、Radius、SSH 或 Telnet 服务器。 |
|
IPerf 服务器列表。 |
|
共享密钥。 |
|
IPerf 起始端口。 |
|
文件传输类型（上传、下载、两者）。 |
|
IPerf UDP 带宽。 |
|
上行链路测试。 选项
|
|
URL。 |
|
用户名。 |
|
用户名提示。 |
|
测试名称。 |
|
用于入网 SSID 的用户名字符串。 |
|
VLAN。 |
|
是否在允许列表中。 选项
|
|
无线电作为传感器已移除。 选项
|
|
RSSI 阈值。 |
|
立即运行（是，否）。 |
|
计划测试日的按位值。 |
|
传感器测试模板编辑的传感器。 |
|
是否全部传感器添加。 选项
|
|
是否已分配。 选项
|
|
配置已更新 是，否。 |
|
主机名。 |
|
传感器 ID。 |
|
IP 地址。 |
|
字符串-字符串列表 iPerf 信息。 |
|
站点 UUID。 |
|
MAC 地址。 |
|
是否标记为卸载。 选项
|
|
传感器名称。 |
|
立即运行 是，否。 |
|
传感器类型。 |
|
服务策略。 |
|
传感器设备状态 上线、下线、重启。 |
|
交换机 MAC 地址。 |
|
交换机序列号。 |
|
交换机设备 UUID。 |
|
目标 AP 数组。 |
|
字符串-字符串测试 MAC 地址。 |
|
有线应用消息。 |
|
有线应用状态。 |
|
是否为异或传感器。 选项
|
|
显示 WLC 升级横幅。 选项
|
|
站点层级。 |
|
传感器测试模板编辑的 SSID。 |
|
身份验证协议。 |
|
身份验证类型：OPEN、WPA2_PSK、WPA2_EAP、WEB_AUTH、MAB、DOT1X、OTHER。 |
|
WIFI 频段 2.4GHz 或 5GHz。 |
|
证书下载 URL。 |
|
身份验证证书文件名。 |
|
证书密码短语。 |
|
证书状态：非活动或活动。 |
|
证书传输协议：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 身份验证虚拟 IP。 |
|
识别号。 |
|
三层 WEB 认证电子邮件地址。 |
|
三层 WEB 认证密码。 |
|
三层 WEB 认证安全性。 |
|
三层 WEB 认证用户名。 |
|
测试中的 AP 数量。 |
|
测试中的传感器数量。 |
|
用于入网 SSID 的密码字符串。 |
|
SSID 密码类型：ASCII 或 HEX。 |
|
SSID 配置文件名称字符串。 |
|
代理服务器密码。 |
|
代理服务器端口。 |
|
用于入网 SSID 的代理服务器。 |
|
代理服务器用户名。 |
|
当 passwordType 为 ASCII 时的 SSID 密码。 |
|
QoS 策略：PlATINUM、GOLD、SILVER、BRONZE。 |
|
安全证书注册协议：true、false 或 null（表示不适用）。 选项
|
|
SSID 字符串。 |
|
WLAN 状态 已启用 或 已禁用。 |
|
传感器测试模板编辑的 tests。 |
|
传感器测试模板编辑的 config。 |
|
IPerf 方向 (上传、下载、两者)。 |
|
DNS 域名。 |
|
下行链路测试。 选项
|
|
IPerf 结束端口。 |
|
退出命令。 |
|
最终提示。 |
|
NDT 服务器。 |
|
NDT 服务器路径。 |
|
NDT 服务器端口。 |
|
数据包数量。 |
|
密码。 |
|
密码提示。 |
|
文件传输的文件路径。 |
|
Radius 或 WEB 服务器端口。 |
|
探测类型。 |
|
文件传输、IPerf、邮件服务器和 Radius 使用的协议 (TCP、UDP、FTP、POP3、IMAP、CHAP、PAP)。 |
|
代理密码。 |
|
代理端口。 |
|
代理服务器。 |
|
代理用户名。 |
|
Ping、文件传输、邮件、Radius、SSH 或 Telnet 服务器。 |
|
IPerf 服务器列表。 |
|
共享密钥。 |
|
IPerf 起始端口。 |
|
文件传输类型（上传、下载、两者）。 |
|
IPerf UDP 带宽。 |
|
上行链路测试。 选项
|
|
URL。 |
|
用户名。 |
|
用户名提示。 |
|
测试名称。 |
|
传感器测试模板编辑的第三方。 |
|
如果 SSID 为第三方，则为 True。 选项
|
|
用于入网 SSID 的用户名字符串。 |
|
有效期自 UTC 时间戳。 |
|
有效期至 UTC 时间戳。 |
|
是否在允许列表中。 选项
|
|
WLAN ID。 |
|
WLC IP 地址。 |
|
开始时间。 |
|
测试状态（运行中、未运行）。 |
|
要编辑的测试模板名称。 |
|
测试计划模式（按需、专用、计划、持续、立即运行）。 |
|
用于 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 返回的响应的字典或列表 返回值：始终 示例： |