cisco.nxos.nxos_ping 模块 – 使用 Nexus 交换机执行 ping 测试可达性。

注意

此模块是 cisco.nxos 集合 (版本 9.2.1) 的一部分。

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

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

要在剧本中使用它，请指定： cisco.nxos.nxos_ping。

cisco.nxos 1.0.0 中的新增功能

概要 

使用交换机测试到远程目标的连通性。
有关通用网络模块的信息，请参阅 ansible.netcommon.net_ping 模块。
对于 Windows 目标，请改用 ansible.windows.win_ping 模块。
对于运行 Python 的目标，请改用 ansible.builtin.ping 模块。

参数 

参数	注释
count 整数	要发送的数据包数量。默认值： `5`
dest 字符串 / 必填	远程节点的 IP 地址或主机名（交换机可解析）。
df_bit 布尔值	设置 DF 位。选项 `false` ← (默认) `true`
size 整数	要发送的数据包大小。
source 字符串	源 IP 地址或主机名（交换机可解析）
state 字符串	确定预期结果是成功还是失败。选项 `"absent"` `"present"` ← (默认)
vrf 字符串	出站 VRF。

备注 

注意

Cisco MDS 不支持
有关通用网络模块的信息，请参阅 ansible.netcommon.net_ping 模块。
对于 Windows 目标，请改用 ansible.windows.win_ping 模块。
对于运行 Python 的目标，请改用 ansible.builtin.ping 模块。
有关使用 CLI 和 NX-API 的信息，请参阅：ref:`NXOS 平台选项指南 <nxos_platform_options>`
有关使用 Ansible 管理网络设备的更多信息，请参阅：ref:`Ansible 网络指南 <network_guide>`
有关使用 Ansible 管理 Cisco 设备的更多信息，请参阅 `Cisco 集成页面 <https://ansible.org.cn/integrations/networks/cisco>`_。

示例 

- name: Test reachability to 8.8.8.8 using mgmt vrf
  cisco.nxos.nxos_ping:
    dest: 8.8.8.8
    vrf: management
    host: 68.170.147.165

- name: Test reachability to a few different public IPs using mgmt vrf
  cisco.nxos.nxos_ping:
    dest: "{{ item }}"
    vrf: management
    host: 68.170.147.165
  with_items:
    - 8.8.8.8
    - 4.4.4.4
    - 198.6.1.4

- name: Test reachability to 8.8.8.8 using mgmt vrf, size and df-bit
  cisco.nxos.nxos_ping:
    dest: 8.8.8.8
    df_bit: true
    size: 1400
    vrf: management

返回值 

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

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

作者

Jason Edelman (@jedelman8)
Gabriele Gerbino (@GGabriele)