модуль cisco.mso.ndo_l3out_node_static_route_next_hop — управление следующими переходами статических маршрутов узлов 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_static_route_next_hop.

Добавлено в cisco.mso 2.11.0

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

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

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

Требования

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

Multi Site Orchestrator версии 2.1 или новее

Параметры

Параметр	Комментарии
administrative_distance псевдонимы: admin_distance целое число	Административное расстояние статического маршрута. Значение должно находиться в диапазоне 0–255. При создании по умолчанию используется `administrative_distance=0`, если значение не задано.
description строка	Описание следующего перехода статического маршрута. Пустая строка `description=""` удалит описание следующего перехода статического маршрута.
host псевдонимы: hostname строка	IP-адрес или имя узла ACI Multi Site Orchestrator. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `MSO_HOST`.
ip псевдонимы: ip_address, next_hop строка	IP-адрес следующего перехода статического маршрута.
l3out псевдонимы: l3out_name строка	Имя L3Out. Необходимо указать этот параметр или `l3out_uuid`.
l3out_uuid строка	UUID L3Out. Необходимо указать этот параметр или `l3out`.
login_domain строка	Имя домена входа, используемого для аутентификации. Значение по умолчанию — Local. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `MSO_LOGIN_DOMAIN`. При использовании плагина подключения HTTPAPI, если этот атрибут не указан, будет использоваться переменная инвентаризации `ansible_httpapi_login_domain`.
monitoring_policy псевдонимы: ipsla_monitoring_policy словарь	Используемая политика мониторинга. Пустой словарь `monitoring_policy={}` удалит политику мониторинга из следующего перехода статического маршрута.
name строка	Имя политики мониторинга.
template строка	Имя шаблона, содержащего политику мониторинга. Необходимо указать этот параметр или `monitoring_policy.template_id`.
template_id строка	Идентификатор шаблона, содержащего политику мониторинга. Необходимо указать этот параметр или `monitoring_policy.template`.
monitoring_policy_uuid псевдонимы: ipsla_monitoring_policy_uuid строка	UUID используемой политики мониторинга. Пустая строка `monitoring_policy=""` удалит политику мониторинга из следующего перехода статического маршрута.
node_id псевдонимы: node, border_leaf строка / обязательный	Идентификатор узла.
output_level строка	Определяет состав выходных данных этого модуля MSO. `normal` означает стандартные выходные данные, включая словарь `current` `info` добавляет информационные выходные данные, включая `previous`, `proposed` и словари `sent` `debug` добавляет отладочные выходные данные, включая сведения `filter_string`, `method`, `response`, `status` и `url` Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `MSO_OUTPUT_LEVEL`. Варианты: `"debug"` `"info"` `"normal"` ← (по умолчанию)
password строка	Пароль для аутентификации. Если значение не указано в задаче, вместо него будет использоваться значение одной из переменных среды: `MSO_PASSWORD` или `ANSIBLE_NET_PASSWORD`.
pod_id псевдонимы: pod строка / обязательный	Идентификатор pod узла (пограничного коммутатора leaf).
port целое число	Номер порта для REST-подключения. Значение по умолчанию зависит от параметра `use_ssl`. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `MSO_PORT`.
prefix строка / обязательный	Префикс статического маршрута.
state строка	Определяет требуемое состояние ресурса. Чтобы удалить ресурс, используйте `absent`. Чтобы вывести ресурс, используйте `query`. Чтобы создать или обновить ресурс, используйте `present`. Варианты: `"absent"` `"query"` ← (по умолчанию) `"present"`
template псевдонимы: l3out_template строка	Имя шаблона. Шаблон должен быть шаблоном L3Out. Необходимо указать этот параметр или `template_id`.
template_id псевдонимы: l3out_template_id строка	Идентификатор шаблона L3Out. Необходимо указать этот параметр или `template`.
timeout целое число	Тайм-аут на уровне сокета в секундах. Значение по умолчанию — 30 секунд. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `MSO_TIMEOUT`.
use_proxy логическое значение	Если `false`, прокси использоваться не будет, даже если он задан в переменной среды на целевых узлах. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `MSO_USE_PROXY`. По умолчанию используется `true`. Варианты: `false` `true`
use_ssl логическое значение	Если `false`, вместо HTTPS-подключения по умолчанию будет использоваться HTTP-подключение. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `MSO_USE_SSL`. При использовании плагина подключения HTTPAPI, если этот атрибут не указан, будет использоваться переменная инвентаризации `ansible_httpapi_use_ssl`. При использовании плагина подключения HTTPAPI (mso или nd) по умолчанию используется `false`, а при использовании устаревшего способа подключения (только для mso) — `true`. Варианты: `false` `true`
username строка	Имя пользователя для аутентификации. Если значение не указано в задаче, вместо него будет использоваться значение одной из переменных среды: `MSO_USERNAME` или `ANSIBLE_NET_USERNAME`.
validate_certs логическое значение	Если `false`, проверка SSL-сертификатов выполняться не будет. Значение `false` следует задавать только для сайтов под личным контролем, использующих самоподписанные сертификаты. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `MSO_VALIDATE_CERTS`. По умолчанию используется `true`. Варианты: `false` `true`

Примечания

Примечание

Перед использованием этого модуля в сценарии необходимо создать template или template_id. Для этого можно использовать модуль cisco.mso.ndo_template.
Перед использованием этого модуля в сценарии необходимо создать l3out или l3out_uuid. Для этого можно использовать модуль cisco.mso.ndo_l3out_template.
Перед использованием этого модуля в сценарии необходимо создать monitoring_policy или monitoring_policy_uuid. Для этого можно использовать модуль cisco.mso.ndo_ipsla_monitoring_policy.
Этот модуль создан для поддержки Multi Site Orchestrator версии 2.1 или новее. Некоторые или все его функции могут не работать в более ранних версиях.

См. также

cisco.mso.ndo_template: Управление шаблонами в Cisco Nexus Dashboard Orchestrator (NDO).
cisco.mso.ndo_l3out_template: Управление L3Out в Cisco Nexus Dashboard Orchestrator (NDO).
cisco.mso.ndo_ipsla_monitoring_policy: Управление политиками мониторинга IPSLA в Cisco Nexus Dashboard Orchestrator (NDO).

Примеры

- name: Create a L3Out Node Static Route Next Hop
  cisco.mso.ndo_l3out_node_static_route_next_hop:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: l3out_template
    l3out: l3out_name
    pod_id: 1
    node_id: 101
    prefix: 10.0.0.0/24
    ip: 11.0.0.1
    state: present

- name: Update an existing L3Out Node Static Route Next Hop
  cisco.mso.ndo_l3out_node_static_route_next_hop:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template_id: "{{ l3out_template.current.templateId }}"
    l3out_uuid: "{{ l3out.current.uuid }}"
    pod_id: 1
    node_id: 101
    prefix: 10.0.0.0/24
    ip: 11.0.0.1
    description: "Updated static route next hop"
    administrative_distance: 10
    monitoring_policy:
      name: "monitoring_policy_name"
      template: "monitoring_policy_template"
    state: present

- name: Query an existing L3Out Node Static Route Next Hop
  cisco.mso.ndo_l3out_node_static_route_next_hop:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: l3out_template
    l3out: l3out_name
    pod_id: 1
    node_id: 101
    prefix: 10.0.0.0/24
    ip: 10.0.0.1
    state: query
  register: query_with_name

- name: Query all existing L3Out Node Static Route Next Hops in a L3Out Node
  cisco.mso.ndo_l3out_node_static_route_next_hop:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: l3out_template
    l3out: l3out_name
    pod_id: 1
    node_id: 101
    prefix: 10.0.0.0/24
    state: query

- name: Delete an existing L3Out Node Static Route Next Hop
  cisco.mso.ndo_l3out_node_static_route_next_hop:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: l3out_template
    l3out: l3out_name
    pod_id: 1
    node_id: 101
    prefix: 10.0.0.0/24
    ip: 10.0.0.1
    state: absent

Авторы

Akini Ross (@akinross)

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

© 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_static_route_next_hop_module.html