Spec-Zone.ru › Ansible

Модуль cisco.nxos.nxos_ping — Проверка доступности с помощью ping с коммутатора Nexus.

Примечание

Этот модуль является частью коллекции cisco.nxos (версия 8.1.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

целое число

Количество пакетов для отправки.

По умолчанию: 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 Platform Options `
  • Дополнительная информация по использованию Ansible для управления сетевыми устройствами в руководстве :ref:`Ansible Network Guide `
  • Дополнительная информация по использованию Ansible для управления устройствами Cisco на странице `Cisco integration `_.

Примеры

- 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)

Ссылки на коллекцию

  • Система отслеживания ошибок
  • Репозиторий (источники)

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/cisco/nxos/nxos_ping_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API