Spec-Zone.ru › Ansible 2.11

cisco.ios.ios_static_route – (устаревшее, удалено после 2022-06-01) Управление статическими маршрутами IP на устройствах сети Cisco IOS

Примечание

Этот плагин входит в коллекцию cisco.ios (версия 1.3.0).

Для его установки используйте: ansible-galaxy collection install cisco.ios.

Для использования в книге задач укажите: cisco.ios.ios_static_route.

Введено в версии 1.0.0: коллекции cisco.ios

  • УСТАРЕВШИЙ
  • Описание
  • Параметры
  • Примечания
  • Примеры
  • Возвращаемые значения
  • Статус

УСТАРЕВШИЙ

Удалено в

главной версии после 2022-06-01

Почему

Выпущены более новые и обновлённые модули с дополнительными функциями.

Альтернатива

ios_static_routes

Описание

  • Этот модуль предоставляет декларативное управление статическими маршрутами IP на устройствах сети Cisco IOS.

Примечание

Этот модуль имеет соответствующий плагин действий.

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
admin_distance
строка
Административная дистанция статического маршрута.
aggregate
список / элементы=словарь
Список определений статических маршрутов.
admin_distance
строка
Административная дистанция статического маршрута.
interface
строка
Интерфейс статического маршрута.
mask
строка
Маска сети префикса статического маршрута.
name
строка
Имя статического маршрута

псевдонимы: описание
next_hop
строка
IP-адрес следующего узла статического маршрута.
prefix
строка / обязательно
Префикс сети статического маршрута.
state
строка
    Варианты:
  • present
  • absent
Состояние конфигурации статического маршрута.
tag
строка
Установка тега статического маршрута.
track
строка
Отслеживаемый элемент, от которого зависит статический маршрут.
vrf
строка
VRF статического маршрута.
interface
строка
Интерфейс статического маршрута.
mask
строка
Маска сети префикса статического маршрута.
name
строка
Имя статического маршрута

псевдонимы: описание
next_hop
строка
IP-адрес следующего узла статического маршрута.
prefix
строка
Префикс сети статического маршрута.
provider
словарь
Устаревший
Начиная с Ansible 2.5, рекомендуется использовать connection: network_cli.
Для получения дополнительной информации см. руководство IOS Platform Options.
Объект словаря, содержащий данные подключения.
auth_pass
строка
Указывает пароль для входа в привилегированный режим на удалённом устройстве. Если authorize имеет значение false, этот аргумент ничего не делает. Если значение не указано в задаче, используется значение переменной среды ANSIBLE_NET_AUTH_PASS.
authorize
логическое
    Варианты:
  • нет ←
  • да
Указывает модулю войти в привилегированный режим на удалённом устройстве перед отправкой команд. Если не указано, устройство попытается выполнить все команды в режиме без привилегий. Если значение не указано в задаче, используется значение переменной среды ANSIBLE_NET_AUTHORIZE.
host
строка
Указывает имя хоста DNS или адрес для подключения к удалённому устройству через указанный транспорт. Значение хоста используется в качестве адреса назначения для транспорта.
password
строка
Указывает пароль для аутентификации соединения с удалённым устройством. Это значение используется для аутентификации сессии SSH. Если значение не указано в задаче, используется значение переменной среды ANSIBLE_NET_PASSWORD.
port
целое число
Указывает порт для создания соединения с удалённым устройством.
ssh_keyfile
путь
Указывает SSH-ключ для аутентификации соединения с удалённым устройством. Это значение — путь к ключу, используемому для аутентификации сессии SSH. Если значение не указано в задаче, используется значение переменной среды ANSIBLE_NET_SSH_KEYFILE.
timeout
целое число
Указывает время ожидания в секундах для связи с устройством сети для подключения или отправки команд. Если время ожидания истечёт до завершения операции, модуль выдаст ошибку.
username
строка
Настраивает имя пользователя для аутентификации соединения с удалённым устройством. Это значение используется для аутентификации сессии SSH. Если значение не указано в задаче, используется значение переменной среды ANSIBLE_NET_USERNAME.
state
строка
    Варианты:
  • present ←
  • absent
Состояние конфигурации статического маршрута.
tag
строка
Установка тега статического маршрута.
track
строка
Отслеживаемый элемент, от которого зависит статический маршрут.
vrf
строка
VRF статического маршрута.

Примечания

Примечание

  • Тестировалось на IOS 15.6
  • Для получения дополнительной информации об использовании Ansible для управления устройствами сети см. Руководство по сети Ansible
  • Для получения дополнительной информации об использовании Ansible для управления устройствами Cisco см. страницу интеграции Cisco.

Примеры

- name: configure static route
  cisco.ios.ios_static_route:
    prefix: 192.168.2.0
    mask: 255.255.255.0
    next_hop: 10.0.0.1

- name: configure black hole in vrf blue depending on tracked item 10
  cisco.ios.ios_static_route:
    prefix: 192.168.2.0
    mask: 255.255.255.0
    vrf: blue
    interface: null0
    track: 10

- name: configure ultimate route with name and tag
  cisco.ios.ios_static_route:
    prefix: 192.168.2.0
    mask: 255.255.255.0
    interface: GigabitEthernet1
    name: hello world
    tag: 100

- name: remove configuration
  cisco.ios.ios_static_route:
    prefix: 192.168.2.0
    mask: 255.255.255.0
    next_hop: 10.0.0.1
    state: absent

- name: Add static route aggregates
  cisco.ios.ios_static_route:
    aggregate:
    - {prefix: 172.16.32.0, mask: 255.255.255.0, next_hop: 10.0.0.8}
    - {prefix: 172.16.33.0, mask: 255.255.255.0, next_hop: 10.0.0.8}

- name: Remove static route aggregates
  cisco.ios.ios_static_route:
    aggregate:
    - {prefix: 172.16.32.0, mask: 255.255.255.0, next_hop: 10.0.0.8}
    - {prefix: 172.16.33.0, mask: 255.255.255.0, next_hop: 10.0.0.8}
    state: absent

Возвращаемые значения

Общие значения возврата описаны здесь, следующие поля уникальны для этого модуля:

Ключ Возвращаемое значение Описание
commands
список / элементы=строка
всегда
Список команд режима конфигурации для отправки устройству

Пример:
['ip route 192.168.2.0 255.255.255.0 10.0.0.1']


Статус

  • Этот модуль будет удалён в основной версии после 2022-06-01. [устаревший]
  • Для получения дополнительной информации см. УСТАРЕВШИЙ.

Авторы

  • Ricardo Carrillo Cruz (@rcarrillocruz)

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/cisco/ios/ios_static_route_module.html

Spec-Zone.ru

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