cisco.dnac.sensor_test_template_edit_v1 模块 – 用于传感器测试模板编辑 V1 的资源模块
注意
此模块是 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_v1。
cisco.dnac 3.1.0 中的新增功能
概要
管理资源传感器测试模板编辑 V1 的更新操作。
用于部署、计划或编辑现有 SENSOR 测试模板的 Intent API。
注意
此模块具有相应的 操作插件。
要求
执行此模块的主机上需要满足以下要求。
dnacentersdk >= 2.4.9
python >= 3.5
参数
参数 |
注释 |
|---|---|
传感器测试模板唯一标识符，在测试创建时生成。 |
|
正在进行的操作的指示。 |
|
传感器测试模板编辑的 apCoverage。 |
|
WIFI 频段。 |
|
要测试的 AP 数量。 |
|
RSSI 阈值。 |
|
测试的连接类型 WIRED、WIRELESS、BOTH。 |
|
用于 Cisco DNA Center SDK 以启用调试的标志。 选项
|
|
Cisco DNA Center 主机名。 |
|
用于身份验证的 Cisco DNA Center 密码。 |
|
Cisco DNA Center 端口。 默认值： |
|
用于身份验证的 Cisco DNA Center 用户名。 默认值： |
|
启用或禁用 SSL 证书验证的标志。 选项
|
|
通知 SDK 要使用的 Cisco DNA Center 版本。 默认值： |
|
加密模式。 |
|
传感器测试模板编辑的频率。 |
|
时间值的单位（NANOSECONDS、MICROSECONDS、MILLISECONDS、SECONDS、MINUTES、HOURS、DAYS）。 |
|
单位的值。 |
|
上次修改时间。 |
|
位置字符串。 |
|
传感器测试模板编辑的 locationInfoList。 |
|
使用站点中的所有传感器进行测试。 选项
|
|
自定义管理 VLAN。 选项
|
|
站点 UUID。 |
|
站点类型。 |
|
MAC 地址。 |
|
管理 VLAN。 |
|
站点名称层次结构。 |
|
测试模板对象模型版本（必须为 2）。 |
|
传感器测试模板名称，与“templateName”中的名称相同。 |
|
关联传感器的数量。 |
|
相邻 AP 阈值的数量。 |
|
传感器测试模板编辑的配置文件。 |
|
身份验证协议。 |
|
身份验证类型 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 Auth 的指示。 选项
|
|
外部 WEB Auth 访问 URL。 |
|
传感器测试模板编辑的 extWebAuthHtmlTag。 |
|
标签。 |
|
标签。 |
|
值。 |
|
外部身份验证门户。 |
|
外部 WEB Auth 虚拟 IP。 |
|
传感器测试模板编辑的 locationVlanList。 |
|
站点 UUID。 |
|
VLAN 数组。 |
|
用于加入 SSID 的密码字符串。 |
|
SSID 密码类型 ASCII 或 HEX。 |
|
配置文件名。 |
|
当 passwordType 为 ASCII 时，SSID 的密码。 |
|
QoS 策略 PLATINUM、GOLD、SILVER、BRONZE。 |
|
安全证书注册协议，true 或 false 或 null 表示不适用。 选项
|
|
传感器测试模板编辑的测试。 |
|
传感器测试模板编辑的配置。 |
|
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 地址。 |
|
是否标记为卸载。 选项
|
|
传感器名称。 |
|
立即运行 是、否。 |
|
传感器类型。 |
|
服务策略。 |
|
传感器设备状态 UP、DOWN、REBOOT。 |
|
交换机 MAC 地址。 |
|
交换机序列号。 |
|
交换机设备 UUID。 |
|
目标 AP 数组。 |
|
一个字符串-字符串形式的测试 MAC 地址。 |
|
有线应用程序消息。 |
|
有线应用程序状态。 |
|
是否为 XOR 传感器。 选项
|
|
显示 WLC 升级横幅。 选项
|
|
站点层级结构。 |
|
传感器测试模板编辑的 SSID 列表。 |
|
身份验证协议。 |
|
身份验证类型 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 Auth 的指示。 选项
|
|
外部 WEB Auth 访问 URL。 |
|
传感器测试模板编辑的 extWebAuthHtmlTag。 |
|
标签。 |
|
标签。 |
|
值。 |
|
外部身份验证门户。 |
|
外部 WEB Auth 虚拟 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 状态 ENABLED 或 DISABLED。 |
|
传感器测试模板编辑的测试。 |
|
传感器测试模板编辑的配置。 |
|
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 地址。 |
|
开始时间。 |
|
测试状态 (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，
不支持
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_v1:
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 返回的响应的字典或列表 返回： 始终 示例： |