Модуль cisco.nxos.nxos_ping — проверка доступности с помощью ping с коммутатора Nexus.
Примечание
Этот модуль входит в коллекцию cisco.nxos (версия 11.2.0).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.
Чтобы установить её, используйте: ansible-galaxy collection install cisco.nxos.
Чтобы использовать её в плейбуке, укажите: cisco.nxos.nxos_ping.
Добавлено в cisco.nxos 1.0.0
Краткое описание
- Проверяет доступность удалённого узла с коммутатора с помощью ping.
- Для сетевого модуля общего назначения см. модуль ansible.netcommon.net_ping.
- Для целевых узлов под управлением Windows используйте модуль ansible.windows.win_ping.
- Для целевых узлов под управлением Python используйте модуль ansible.builtin.ping.
Примечание
Этому модулю соответствует плагин действий.
Псевдонимы: ping
Параметры
Параметр | Комментарии |
|---|---|
count integer | Количество отправляемых пакетов. По умолчанию: |
dest string / обязательный | IP-адрес или имя узла (разрешаемое коммутатором) удалённого узла. |
df_bit boolean | Установить бит DF. Варианты:
|
size integer | Размер отправляемых пакетов. |
source string | Исходный IP-адрес или имя узла (разрешаемое коммутатором) |
state string | Определяет, ожидается ли успешный результат или сбой. Варианты:
|
vrf string | Исходящая 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://www.ansible.com/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 list / elements=string | Отправленная команда Возвращается: всегда Пример: |
packet_loss string | Процент потерянных пакетов Возвращается: всегда Пример: |
packets_rx integer | Успешно полученные пакеты Возвращается: всегда Пример: |
packets_tx integer | Успешно отправленные пакеты Возвращается: всегда Пример: |
rtt dictionary | Статистика RTT Возвращается: всегда Пример: |
Ссылки на коллекцию
© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/cisco/nxos/nxos_ping_module.html
