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