Spec-Zone.ru › Ansible 2.10

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

Примечание

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

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

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

Новое в версии 1.0.0: of 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 или адрес для подключения к удалённому устройству по указанному каналу. Значение host используется в качестве адреса назначения для канала.
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–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/cisco/ios/ios_static_route_module.html

Spec-Zone.ru

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