junipernetworks.junos.junos_static_route – (устаревшее, удалено после 2022-06-01) Управление статическими маршрутами IP на устройствах Juniper JUNOS
Примечание
Этот плагин входит в состав коллекции junipernetworks.junos (версия 1.3.0).
Для его установки используйте: ansible-galaxy collection install junipernetworks.junos.
Для использования в книге задач укажите: junipernetworks.junos.junos_static_route.
Добавлено в версии 1.0.0: of junipernetworks.junos
УСТАРЕВШЕЕ
- Удалено в
-
основной версии после 2022-06-01
- Почему
-
Выпущены обновленные модули с дополнительными функциями
- Альтернатива
-
Используйте junipernetworks.junos.junos_static_routes вместо этого.
Обзор
- Этот модуль предоставляет декларативное управление статическими маршрутами IP на сетевых устройствах Juniper JUNOS.
Примечание
Этот модуль имеет соответствующий плагин действий.
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- ncclient (>=v0.5.2)
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| active boolean |
| Указывает, активна или деактивирована конфигурация | |
| address string | Сеть адрес с префиксом статического маршрута. алиасы: префикс | ||
| aggregate list / elements=dictionary | Список определений статических маршрутов | ||
| active boolean |
| Указывает, активна или деактивирована конфигурация | |
| address string | Сеть адрес с префиксом статического маршрута. | ||
| next_hop string | Следующий IP-адрес статического маршрута. | ||
| preference integer | Глобальная административная предпочтительность статического маршрута. алиасы: admin_distance | ||
| qualified_next_hop string | Квалифицированный следующий IP-адрес статического маршрута. Квалифицированные следующие адреса позволяют связать предпочтительность с конкретным адресом следующего узла. | ||
| qualified_preference integer | Назначение предпочтения для квалифицированного следующего узла. | ||
| state string |
| Состояние конфигурации статического маршрута. | |
| next_hop string | Следующий IP-адрес статического маршрута. | ||
| preference integer | Глобальная административная предпочтительность статического маршрута. алиасы: admin_distance | ||
| provider dictionary | Устаревший Начиная с Ansible 2.5, мы рекомендуем использовать connection: network_cli или connection: netconf. Для получения дополнительной информации см. руководство Junos OS Platform Options. Объект словаря, содержащий сведения о подключении. | ||
| host string | Указывает имя хоста DNS или адрес для подключения к удаленному устройству через указанный транспорт. Значение параметра host используется в качестве адреса назначения для транспорта. | ||
| password string | Указывает пароль для аутентификации подключения к удаленному устройству. Это значение используется для аутентификации сеанса SSH. Если значение не указано в задаче, вместо него используется значение переменной среды ANSIBLE_NET_PASSWORD. | ||
| port integer | Указывает порт для подключения к удаленному устройству. Значение порта по умолчанию — 22 (для transport=cli) или 830 (для transport=netconf) устройства. | ||
| ssh_keyfile path | Указывает SSH-ключ для аутентификации подключения к удаленному устройству. Это значение — путь к ключу, используемому для аутентификации сеанса SSH. Если значение не указано в задаче, вместо него используется значение переменной среды ANSIBLE_NET_SSH_KEYFILE. | ||
| timeout integer | Указывает время ожидания в секундах для связи с сетевым устройством для подключения или отправки команд. Если время ожидания истечет до завершения операции, модуль вернет ошибку. | ||
| transport string |
| Настраивает транспортное соединение для подключения к удаленному устройству. | |
| username string | Настраивает имя пользователя для аутентификации подключения к удаленному устройству. Это значение используется для аутентификации сеанса SSH. Если значение не указано в задаче, вместо него используется значение переменной среды ANSIBLE_NET_USERNAME. | ||
| qualified_next_hop string | Квалифицированный следующий IP-адрес статического маршрута. Квалифицированные следующие адреса позволяют связать предпочтительность с конкретным адресом следующего узла. | ||
| qualified_preference integer | Назначение предпочтения для квалифицированного следующего узла. | ||
| state string |
| Состояние конфигурации статического маршрута. | |
Примечания
Примечание
- Для работы этого модуля на удаленном управляемом устройстве должна быть включена служба netconf.
- Тестировалось на vSRX JUNOS версии 15.1X49-D15.4, vqfx-10000 JUNOS версии 15.1X53-D60.4.
- Рекомендуемое подключение —
netconf. См. справочник Junos OS Platform Options. - Этот модуль также работает с подключениями
localдля устаревших книг задач. - Дополнительная информация о использовании CLI и netconf см. в руководстве Junos OS Platform Options
- Дополнительная информация о использовании Ansible для управления сетевыми устройствами см. в руководстве по сетям Ansible
- Дополнительная информация об использовании Ansible для управления сетевыми устройствами Juniper см. на странице https://www.ansible.com/ansible-juniper.
Примеры
- name: configure static route
junipernetworks.junos.junos_static_route:
address: 192.168.2.0/24
next_hop: 10.0.0.1
preference: 10
qualified_next_hop: 10.0.0.2
qualified_preference: 3
state: present
- name: delete static route
junipernetworks.junos.junos_static_route:
address: 192.168.2.0/24
state: absent
- name: deactivate static route configuration
junipernetworks.junos.junos_static_route:
address: 192.168.2.0/24
next_hop: 10.0.0.1
preference: 10
qualified_next_hop: 10.0.0.2
qualified_preference: 3
state: present
active: false
- name: activate static route configuration
junipernetworks.junos.junos_static_route:
address: 192.168.2.0/24
next_hop: 10.0.0.1
preference: 10
qualified_next_hop: 10.0.0.2
qualified_preference: 3
state: present
active: true
- name: Configure static route using aggregate
junipernetworks.junos.junos_static_route:
aggregate:
- {address: 4.4.4.0/24, next_hop: 3.3.3.3, qualified_next_hop: 5.5.5.5, qualified_preference: 30}
- {address: 5.5.5.0/24, next_hop: 6.6.6.6, qualified_next_hop: 7.7.7.7, qualified_preference: 12}
preference: 10
- name: Delete static route using aggregate
junipernetworks.junos.junos_static_route:
aggregate:
- address: 4.4.4.0/24
- address: 5.5.5.0/24
state: absent
Возвращаемые значения
Общие возвращаемые значения описаны в разделе здесь, следующие поля уникальны для данного модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| diff.prepared string | при изменении конфигурации и включенном параметре diff. | Разница в конфигурации до и после применения изменений. Пример: [edit routing-options static] route 2.2.2.0/24 { ... } + route 4.4.4.0/24 { next-hop 3.3.3.3; qualified-next-hop 5.5.5.5 { + preference 30; } + preference 10; + } |
Статус
- Этот модуль будет удален в основной версии после 2022-06-01. [устаревшее]
- Для получения дополнительной информации см. УСТАРЕВШЕЕ.
Авторы
- Ganesh Nalawade (@ganeshrn)
© 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/junipernetworks/junos/junos_static_route_module.html