community.network.icx_ping 模块 – 使用 Ruckus ICX 7000 系列交换机执行 ping 测试连通性

注意

此模块是 community.network 集合 (版本 5.1.0) 的一部分。

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

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

要在剧本中使用它，请指定：community.network.icx_ping。

注意

community.network 集合已被弃用，并将从 Ansible 12 中移除。有关更多信息，请参阅 讨论主题。

已弃用

在以下版本中移除：

6.0.0 版本

原因：

此集合及其中的所有内容均未维护且已弃用。

替代方案：

未知。

摘要

  • 使用交换机测试到远程目标的 ping 连通性。

别名：network.icx.icx_ping

参数

参数

注释

count

整数

要发送的数据包数量。默认为 1。

dest

字符串 / 必需

远程节点的 ip 地址 | 主机名 | vrf vrf-name | ipv6 [ipv6 地址 | 主机名 | vrf vrf-name]（可被交换机解析）。

size

整数

指定 ICMP 数据包数据部分的大小（以字节为单位）。这是有效负载，不包括标头。值范围为 0 到 10000。默认为 16。

source

字符串

用作 ping 数据包来源的 IP 地址。

state

字符串

确定预期结果是成功还是失败。

选项

  • "absent"

  • "present" ← (默认)

timeout

整数

指定设备等待 ping 设备回复的时间（以毫秒为单位）。值范围为 1 到 4294967296。默认为 5000（5 秒）。

ttl

整数

指定生存时间，作为最大跳数。值范围为 1 到 255。默认为 64。

vrf

字符串

指定要 ping 的设备的虚拟路由转发 (VRF) 实例。

备注

注意

  • 针对 ICX 10.1 版本测试

示例

- name: Test reachability to 10.10.10.10
  community.network.icx_ping:
    dest: 10.10.10.10

- name: Test reachability to ipv6 address from source with timeout
  community.network.icx_ping:
    dest: ipv6 2001:cdba:0000:0000:0000:0000:3257:9652
    source: 10.1.1.1
    timeout: 100000

- name: Test reachability to 10.1.1.1 through vrf using 5 packets
  community.network.icx_ping:
    dest: 10.1.1.1
    vrf: x.x.x.x
    count: 5

- name: Test unreachability to 10.30.30.30
  community.network.icx_ping:
    dest: 10.40.40.40
    state: absent

- name: Test reachability to ipv4 with ttl and packet size
  community.network.icx_ping:
    dest: 10.10.10.10
    ttl: 20
    size: 500

返回值

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

键

描述

commands

列表 / 元素=字符串

显示发送的命令。

返回：始终

示例：["ping 10.40.40.40 count 20 source loopback0", "ping 10.40.40.40"]

packet_loss

字符串

数据包丢失百分比。

返回：始终

示例："0%"

packets_rx

整数

成功接收的数据包。

返回：始终

示例：20

packets_tx

整数

成功传输的数据包。

返回：始终

示例：20

rtt

字典

显示 RTT 统计信息。

返回：始终

示例：{"avg": 2, "max": 8, "min": 1}

状态

  • 此模块将在 6.0.0 版本中移除。[已弃用]

  • 有关更多信息，请参见 已弃用。

作者

  • Ruckus Wireless (@Commscope)