Модуль cisco.mso.ndo_l3out_node_routing_policy — управление политиками маршрутизации узлов L3Out в Cisco Nexus Dashboard Orchestrator (NDO).

Примечание

Этот модуль входит в коллекцию cisco.mso (версия 2.13.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните команду ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install cisco.mso. Для работы с этим модулем требуются дополнительные компоненты. Подробнее см. в разделе Требования.

Чтобы использовать модуль в плейбуке, укажите: cisco.mso.ndo_l3out_node_routing_policy.

Краткое описание
Требования
Параметры
Примечания
См. также
Примеры

Краткое описание

Управление политиками маршрутизации узлов L3Out в Cisco Nexus Dashboard Orchestrator (NDO).
Этот модуль поддерживается только в ND v3.1 (NDO v4.3) и более поздних версиях.

Требования

На хосте, выполняющем этот модуль, должны быть соблюдены следующие требования.

Multi Site Orchestrator v2.1 или новее

Параметры

Параметр	Комментарии
as_path_multipath_relax string	Управление выбором наилучшего пути BGP для политики маршрутизации узла L3Out. Если указать пустую строку, параметр `as_path_multipath_relax=""` будет удален из политики маршрутизации узла L3Out. Допустимые значения: `"enabled"` `"disabled"` `""`
bfd_multi_hop_settings dictionary	Конфигурация параметров BFD MultiHop для политики маршрутизации узла L3Out.
admin_state string	Административное состояние параметров BFD MultiHop. При создании по умолчанию включено, если значение не задано. Допустимые значения: `"enabled"` `"disabled"`
detection_multiplier integer	Множитель обнаружения для параметров BFD MultiHop. При создании по умолчанию равен 3, если значение не задано. Значение должно находиться в диапазоне от 1 до 50.
min_receive_interval integer	Минимальный интервал приема для параметров BFD MultiHop. При создании по умолчанию равен 250, если значение не задано. Значение должно находиться в диапазоне от 250 до 999 микросекунд.
min_transmit_interval integer	Минимальный интервал передачи для параметров BFD MultiHop. При создании по умолчанию равен 250, если значение не задано. Значение должно находиться в диапазоне от 250 до 999 микросекунд.
state string	Используйте `enabled` для настройки параметров BFD MultiHop. Используйте `disabled`, чтобы удалить параметры BFD MultiHop. Допустимые значения: `"enabled"` `"disabled"`
bgp_node_settings dictionary	Конфигурация параметров узла BGP для политики маршрутизации узла L3Out.
graceful_restart_helper string	Помощник graceful restart для параметров узла BGP. При создании по умолчанию включен, если значение не задано. Допустимые значения: `"enabled"` `"disabled"`
hold_interval integer	Интервал ожидания для параметров узла BGP. При создании по умолчанию равен 180, если значение не задано. Значение должно быть равно 0 или находиться в диапазоне от 3 до 3600 секунд.
keep_alive_interval integer	Интервал keepalive для параметров узла BGP. При создании по умолчанию равен 60, если значение не задано. Значение должно находиться в диапазоне от 0 до 3600 секунд.
max_as_limit integer	Максимальное ограничение AS для параметров узла BGP. При создании по умолчанию равно 0, если значение не задано. Значение должно находиться в диапазоне от 0 до 2000.
stale_interval integer	Интервал устаревания для параметров узла BGP. При создании по умолчанию равен 300, если значение не задано. Значение должно находиться в диапазоне от 1 до 3600 секунд.
state string	Используйте `enabled` для настройки параметров узла BGP. Используйте `disabled`, чтобы удалить параметры узла BGP. Допустимые значения: `"enabled"` `"disabled"`
description string	Описание политики маршрутизации узла L3Out.
host псевдонимы: hostname string	IP-адрес или имя хоста ACI Multi Site Orchestrator. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `MSO_HOST`.
login_domain string	Имя домена входа, используемое для аутентификации. Значение по умолчанию — Local. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `MSO_LOGIN_DOMAIN`. При использовании плагина подключения HTTPAPI, если этот атрибут не указан, будет использоваться переменная инвентаризации `ansible_httpapi_login_domain`.
name псевдонимы: l3out_node_routing_policy_name string	Имя политики маршрутизации узла L3Out.
output_level string	Управляет выводом этого модуля MSO. `normal` означает стандартный вывод, включая словарь `current` `info` добавляет информационный вывод, включая `previous`, `proposed` и словари `sent` `debug` добавляет отладочный вывод, включая сведения `filter_string`, `method`, `response`, `status` и `url` Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `MSO_OUTPUT_LEVEL`. Допустимые значения: `"debug"` `"info"` `"normal"` ← (по умолчанию)
password string	Пароль для аутентификации. Если значение не указано в задаче, вместо него будет использоваться значение одной из переменных среды `MSO_PASSWORD` или `ANSIBLE_NET_PASSWORD`.
port integer	Номер порта для REST-подключения. Значение по умолчанию зависит от параметра `use_ssl`. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `MSO_PORT`.
state string	Используйте `absent` для удаления. Используйте `query` для получения списка одного или нескольких объектов. Используйте `present` для создания или обновления. Допустимые значения: `"absent"` `"query"` ← (по умолчанию) `"present"`
template string / обязательный	Имя шаблона. Шаблон должен быть шаблоном политик арендатора.
timeout integer	Тайм-аут на уровне сокета в секундах. Значение по умолчанию — 30 секунд. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `MSO_TIMEOUT`.
use_proxy boolean	Если `false`, прокси использоваться не будет, даже если он задан в переменной среды на целевых хостах. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `MSO_USE_PROXY`. Значение по умолчанию — `true`. Допустимые значения: `false` `true`
use_ssl boolean	Если `false`, вместо используемого по умолчанию HTTPS-подключения будет использоваться HTTP-подключение. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `MSO_USE_SSL`. При использовании плагина подключения HTTPAPI, если этот атрибут не указан, будет использоваться переменная инвентаризации `ansible_httpapi_use_ssl`. При использовании плагина подключения HTTPAPI (mso или nd) значение по умолчанию — `false`, а при использовании устаревшего метода подключения (только для mso) — `true`. Допустимые значения: `false` `true`
username string	Имя пользователя для аутентификации. Если значение не указано в задаче, вместо него будет использоваться значение одной из переменных среды `MSO_USERNAME` или `ANSIBLE_NET_USERNAME`.
uuid псевдонимы: l3out_node_routing_policy_uuid string	UUID политики маршрутизации узла L3Out. Этот параметр обязателен, если требуется обновить `name`.
validate_certs boolean	Если `false`, SSL-сертификаты не будут проверяться. Значение `false` следует задавать только для контролируемых вами сайтов, использующих самоподписанные сертификаты. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `MSO_VALIDATE_CERTS`. Значение по умолчанию — `true`. Допустимые значения: `false` `true`

Примечания

Примечание

Перед использованием этого модуля в плейбуке должен существовать template. Используйте cisco.mso.ndo_template для создания шаблона политик арендатора.
Этот модуль разработан для поддержки Multi Site Orchestrator v2.1 или новее. Некоторые или все функции могут не работать в более ранних версиях.

См. также

cisco.mso.ndo_template: Управление шаблонами в Cisco Nexus Dashboard Orchestrator (NDO).

Примеры

- name: Create a new L3Out Node Routing Policy with empty bgp_node and bfd_multi_hop settings
  cisco.mso.ndo_l3out_node_routing_policy:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_tenant_template
    name: nrp_1
    bfd_multi_hop_settings:
      state: enabled
    bgp_node_settings:
      state: enabled
    as_path_multipath_relax: disabled
    state: present

- name: Create a new L3Out Node Routing Policy with full config of bgp_node and bfd_multi_hop settings
  cisco.mso.ndo_l3out_node_routing_policy:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_tenant_template
    name: nrp_2
    bfd_multi_hop_settings:
      admin_state: enabled
      detection_multiplier: 10
      min_receive_interval: 450
      min_transmit_interval: 550
    bgp_node_settings:
      graceful_restart_helper: enabled
      keep_alive_interval: 15
      hold_interval: 115
      stale_interval: 215
      max_as_limit: 25
    as_path_multipath_relax: disabled
    state: present
  register: nrp_2

- name: Update L3Out Node Routing Policy name and bgp_node_settings attributes
  cisco.mso.ndo_l3out_node_routing_policy:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_tenant_template
    uuid: "{{ nrp_2.current.uuid }}"
    name: nrp_2_updated
    bgp_node_settings:
      graceful_restart_helper: disabled
      keep_alive_interval: 20
    state: present

- name: Query a L3Out Node Routing Policies with name
  cisco.mso.ndo_l3out_node_routing_policy:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_tenant_template
    name: nrp_1
    state: query
  register: query_with_name

- name: Query a L3Out Node Routing Policies with UUID
  cisco.mso.ndo_l3out_node_routing_policy:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_tenant_template
    uuid: "{{ query_with_name.current.uuid }}"
    state: query
  register: query_with_uuid

- name: Query all L3Out Node Routing Policies
  cisco.mso.ndo_l3out_node_routing_policy:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_tenant_template
    state: query
  register: query_all

- name: Delete a L3Out Node Routing Policy
  cisco.mso.ndo_l3out_node_routing_policy:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_tenant_template
    name: nrp_1
    state: absent

- name: Delete a L3Out Node Routing Policy using UUID
  cisco.mso.ndo_l3out_node_routing_policy:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_tenant_template
    uuid: "{{ query_with_name.current.uuid }}"
    state: absent

Авторы

Sabari Jaganathan (@sajagana)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/cisco/mso/ndo_l3out_node_routing_policy_module.html