cisco.dnac.network_device_by_ip_info 模块 – 基于IP信息的网络设备信息模块
注意
此模块是 cisco.dnac 集合 (版本 6.25.0) 的一部分。
如果您使用的是 ansible 包，则可能已经安装了此集合。它不包含在 ansible-core 中。要检查它是否已安装，请运行 ansible-galaxy collection list。
要安装它，请使用： ansible-galaxy collection install cisco.dnac。您需要其他要求才能使用此模块，有关详细信息，请参见 需求。
要在playbook中使用它，请指定： cisco.dnac.network_device_by_ip_info。
cisco.dnac 3.1.0 中的新增功能
概要
此模块表示模块 network_device_by_ip_v1_info 的别名。
注意
此模块具有相应的 action 插件。
需求
在执行此模块的主机上需要以下需求。
dnacentersdk >= 2.4.9
python >= 3.5
参数
参数 |
注释 |
|---|---|
用于Cisco DNA Center SDK以启用调试的标志。 选项
|
|
Cisco DNA Center主机名。 |
|
用于身份验证的Cisco DNA Center密码。 |
|
Cisco DNA Center端口。 默认值： |
|
用于身份验证的Cisco DNA Center用户名。 默认值： |
|
启用或禁用SSL证书验证的标志。 选项
|
|
通知SDK要使用的Cisco DNA Center版本。 默认值： |
|
附加头。 |
|
IpAddress 路径参数。设备IP地址。 |
|
用于Cisco DNA Center SDK的标志，用于启用根据JSON模式验证请求正文。 选项
|
备注
注意
使用的SDK方法是devices.Devices.get_network_device_by_ip_v1，
使用的路径是get /dna/intent/api/v1/network-device/ip-address/{ipAddress}，
需要注意的是，此模块是network_device_by_ip_v1_info的别名。
支持
check_mode插件在控制节点上运行，不使用任何Ansible连接插件，而是使用Cisco DNAC SDK中的嵌入式连接管理器。
以dnac_开头的参数由Cisco DNAC Python SDK用于建立连接。
另请参见
另请参见
- Cisco DNA Center关于Devices GetNetworkDeviceByIPV1的文档
GetNetworkDeviceByIPV1 API的完整参考。
示例
- name: Get Network Device By Ip Info by id
cisco.dnac.network_device_by_ip_info:
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}}"
headers: "{{my_headers | from_json}}"
ipAddress: string
register: result
返回值
常见的返回值已在此处记录 此处，以下是此模块独有的字段
键 |
描述 |
|---|---|
包含Cisco DNAC Python SDK返回的响应的字典或列表。 已返回：始终 示例： |