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 строка |
| Состояние конфигурации статического маршрута. | |
| 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 строка |
| Состояние конфигурации статического маршрута. | |
| 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