cisco.iosxr.iosxr_ping 模块 – 使用 IOSXR 交换机上的 ping 测试可达性。

注意

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

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

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

要在 Playbook 中使用它，请指定：cisco.iosxr.iosxr_ping。

概要 

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

参数 

参数	注释
afi 字符串	定义回显类型 ipv4 或 ipv6。选择 `"ipv4"` ← (默认) `"ipv6"`
count 整数	重复计数要发送的数据包数量。
dest 字符串 / 必需	远程节点的 IP 地址或主机名（可由交换机解析）。
df_bit 布尔值	在 IP 标头中设置 DF 位。选择 `false` ← (默认) `true`
size 整数	数据报大小，要发送的数据包大小。
source 字符串	源地址或源接口。
state 字符串	确定预期结果是成功还是失败。选择 `"absent"` `"present"` ← (默认)
sweep 布尔值	扫描 ping。选择 `false` ← (默认) `true`
validate 布尔值	验证返回数据包。选择 `false` ← (默认) `true`
vrf 字符串	用于转发的 VRF。

说明 

注意

已针对 IOSXR 7.2.2 进行测试。
此模块使用连接 network_cli。
对于通用的网络模块，请参阅 net_ping 模块。
对于 Windows 目标，请改用 win_ping 模块。
对于运行 Python 的目标，请改用 ping 模块。

示例 

- name: Test reachability to 198.51.100.251 using default vrf
  cisco.iosxr.iosxr_ping:
    dest: 198.51.100.251

- name: Test reachability to 198.51.100.252 using prod vrf
  cisco.iosxr.iosxr_ping:
    dest: 198.51.100.252
    vrf: prod
    afi: ipv4

- name: Test unreachability to 198.51.100.253 using default vrf
  cisco.iosxr.iosxr_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.iosxr.iosxr_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.iosxr.iosxr_ping:
    dest: 198.51.100.249
    df_bit: true
    size: 1400

- name: Test reachability to ipv6 address
  cisco.iosxr.iosxr_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}`

作者

Sagar Paul (@KB-perByte)