cisco.ios.ios_ping 模块 – 使用 IOS 交换机的 ping 测试可达性。

注意

此模块是 cisco.ios 集合（版本 9.0.3）的一部分。

如果您正在使用 ansible 包，您可能已经安装了此集合。它不包含在 ansible-core 中。要检查是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用：ansible-galaxy collection install cisco.ios。

要在 playbook 中使用它，请指定：cisco.ios.ios_ping。

cisco.ios 1.0.0 中的新功能

概要 

使用从交换机到远程目标的 ping 测试可达性。
对于通用网络模块，请参阅 net_ping 模块。
对于 Windows 目标，请改用 win_ping 模块。
对于运行 Python 的目标，请改用 ping 模块。

参数 

参数	注释
afi 字符串	定义回显类型 ip 或 ipv6。选择 `"ip"` ←（默认） `"ipv6"`
count 整数	要发送的数据包数量。
dest 字符串 / 必需	远程节点的 IP 地址或主机名（可由交换机解析）。
df_bit 布尔值	设置 DF 位。选择 `false` ←（默认） `true`
egress 字符串	强制出口接口绕过路由。
ingress 字符串	入口的 LAN 源接口。
size 整数	要发送的数据包大小。
source 字符串	源 IP 地址。
state 字符串	确定预期结果是成功还是失败。选择 `"absent"` `"present"` ←（默认）
timeout 整数	指定超时间隔。
vrf 字符串	用于转发的 VRF。

备注 

注意

在 CML 上针对 Cisco IOSXE 版本 17.3 进行了测试。
对于通用网络模块，请参阅 net_ping 模块。
对于 Windows 目标，请改用 win_ping 模块。
对于运行 Python 的目标，请改用 ping 模块。

示例 

- name: Test reachability to 198.51.100.251 using default vrf
  cisco.ios.ios_ping:
    dest: 198.51.100.251

- name: Test reachability to 198.51.100.252 using prod vrf
  cisco.ios.ios_ping:
    dest: 198.51.100.252
    vrf: prod
    afi: ip

- name: Test un reachability to 198.51.100.253 using default vrf
  cisco.ios.ios_ping:
    dest: 198.51.100.253
    state: absent

- name: Test reachability to 198.51.100.250 using prod vrf and setting count and source
  cisco.ios.ios_ping:
    dest: 198.51.100.250
    source: loopback0
    vrf: prod
    count: 20

- name: Test reachability to 198.51.100.249 using df-bit and size
  cisco.ios.ios_ping:
    dest: 198.51.100.249
    df_bit: true
    size: 1400

- name: Test reachability to ipv6 address
  cisco.ios.ios_ping:
    dest: 2001:db8:ffff:ffff:ffff:ffff:ffff:ffff
    afi: ipv6

返回值 

常见的返回值记录在此处，以下是此模块特有的字段

键	描述
commands 列表 / 元素=字符串	显示发送的命令。返回：始终示例： `["ping vrf prod 198.51.100.251 count 20 source loopback0"]`
packet_loss 字符串	丢失的数据包百分比。返回：始终示例： `"0%"`
packets_rx 整数	成功接收的数据包。返回：始终示例： `20`
packets_tx 整数	成功传输的数据包。返回：始终示例： `20`
rtt 字典	显示 RTT 统计信息。返回：始终示例： `{"avg": 2, "max": 8, "min": 1}`

作者

Jacob McGill (@jmcgill298)
Sagar Paul (@KB-perByte)