Модуль cisco.mso.ndo_l3out_interface_group_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_interface_group_policy.

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

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

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

Требования

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

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

Параметры

Параметр	Комментарии
bfd dictionary	Конфигурация обнаружения двунаправленной переадресации (BFD). Передача пустого словаря удалит `bfd={}` из политики группы интерфейсов L3Out.
authentication boolean	Включена ли аутентификация BFD. Варианты: `false` `true`
enable boolean	Включена ли BFD. Варианты: `false` `true`
key string	Ключ BFD.
key_id integer	Идентификатор ключа BFD.
bfd_multi_hop dictionary	Конфигурация многопролетной BFD (обнаружения двунаправленной переадресации). Передача пустого словаря удалит `bfd_multi_hop={}` из политики группы интерфейсов L3Out.
authentication boolean	Включена ли аутентификация многопролетной BFD. Варианты: `false` `true`
enable boolean	Включена ли многопролетная BFD. Варианты: `false` `true`
key string	Ключ многопролетной BFD.
key_id integer	Идентификатор ключа многопролетной BFD.
custom_qos_policy dictionary	Конфигурация пользовательской политики QoS. Передача пустого словаря удалит `custom_qos_policy={}` из политики группы интерфейсов L3Out.
name string	Имя пользовательской политики QoS.
template string	Шаблон, связанный с пользовательской политикой QoS. Необходимо указать этот параметр или `custom_qos_policy.template_id`.
template_id string	Идентификатор шаблона, связанного с пользовательской политикой QoS. Необходимо указать этот параметр или `custom_qos_policy.template`.
custom_qos_policy_uuid string	UUID пользовательской политики QoS. Передача пустой строки удалит `custom_qos_policy_uuid=""` из политики группы интерфейсов L3Out.
description string	Описание политики группы интерфейсов L3Out.
host псевдонимы: hostname string	IP-адрес или имя хоста ACI Multi Site Orchestrator. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `MSO_HOST`.
interface_routing_policy dictionary	Конфигурация политики маршрутизации интерфейса. Передача пустого словаря удалит `interface_routing_policy={}` из политики группы интерфейсов L3Out.
name string	Имя политики маршрутизации интерфейса L3Out.
template string	Шаблон, связанный с политикой маршрутизации интерфейса L3Out. Необходимо указать этот параметр или `interface_routing_policy.template_id`.
template_id string	Идентификатор шаблона, связанного с политикой маршрутизации интерфейса L3Out. Необходимо указать этот параметр или `interface_routing_policy.template`.
interface_routing_policy_uuid string	UUID политики маршрутизации интерфейса L3Out. Передача пустой строки удалит `interface_routing_policy_uuid=""` из политики группы интерфейсов L3Out.
l3out псевдонимы: l3out_name string	Имя L3Out. Необходимо указать этот параметр или `l3out_uuid`.
l3out_uuid string	UUID L3Out. Необходимо указать этот параметр или `l3out`.
login_domain string	Имя домена входа, используемого для аутентификации. Значение по умолчанию — Local. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `MSO_LOGIN_DOMAIN`. При использовании подключаемого модуля соединения HTTPAPI, если этот атрибут не указан, будет использоваться переменная инвентаря `ansible_httpapi_login_domain`.
name псевдонимы: l3out_interface_group_policy string	Имя политики группы интерфейсов L3Out.
ospf dictionary	Конфигурация протокола OSPF (Open Shortest Path First). Передача пустого словаря удалит `ospf={}` из политики группы интерфейсов L3Out.
authentication_type string	Тип аутентификации OSPF. Варианты: `"simple"` `"md5"` `"none"`
enable boolean	Включен ли OSPF. Варианты: `false` `true`
key string	Ключ OSPF.
key_id integer	Идентификатор ключа OSPF.
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`.
qos_priority string	Уровень приоритета QoS. Варианты: `"level1"` `"level2"` `"level3"` `"level4"` `"level5"` `"level6"` `"unspecified"`
state string	Определяет требуемое состояние ресурса. Чтобы удалить ресурс, используйте `absent`. Чтобы вывести список ресурсов, используйте `query`. Чтобы создать или обновить ресурс, используйте `present`. Варианты: `"absent"` `"query"` ← (по умолчанию) `"present"`
template псевдонимы: l3out_template string	Имя шаблона. Шаблон должен быть шаблоном L3Out. Необходимо указать этот параметр или `template_id`.
template_id псевдонимы: l3out_template_id string	Идентификатор шаблона L3Out. Необходимо указать этот параметр или `template`.
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`. По умолчанию используется `false` при работе с подключаемым модулем соединения HTTPAPI (mso или nd) и `true` при использовании устаревшего метода соединения (только для mso). Варианты: `false` `true`
username string	Имя пользователя для аутентификации. Если значение не указано в задаче, вместо него будет использоваться значение одной из переменных среды `MSO_USERNAME` или `ANSIBLE_NET_USERNAME`.
validate_certs boolean	Если `false`, SSL-сертификаты проверяться не будут. Значение `false` следует задавать только для контролируемых вами сайтов, использующих самоподписанные сертификаты. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `MSO_VALIDATE_CERTS`. По умолчанию используется `true`. Варианты: `false` `true`

Примечания

Примечание

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

См. также

cisco.mso.ndo_template: Управление шаблонами в Cisco Nexus Dashboard Orchestrator (NDO).
cisco.mso.ndo_l3out_template: Управление L3Out в Cisco Nexus Dashboard Orchestrator (NDO).
cisco.mso.ndo_l3out_interface_routing_policy: Управление политиками маршрутизации интерфейсов L3Out в Cisco Nexus Dashboard Orchestrator (NDO).
cisco.mso.ndo_tenant_custom_qos_policy: Управление пользовательскими политиками QoS в шаблонах политик арендаторов Cisco Nexus Dashboard Orchestrator (NDO).

Примеры

- name: Create an L3Out interface group policy
  cisco.mso.ndo_l3out_interface_group_policy:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: l3out_template
    l3out: l3out
    name: interface_group_policy_1
    description: Test description
    interface_routing_policy:
      name: ansible_l3out_interface_routing_policy
      template: ansible_tenant_template
    bfd:
      enable: true
      authentication: true
      key_id: 1
      key: TestKey
    bfd_multi_hop:
      enable: true
      authentication: true
      key_id: 1
      key: TestKey
    ospf:
      enable: true
      authentication_type: simple
      key_id: 1
      key: TestKey
    custom_qos_policy:
      template: ansible_tenant_template
      name: ansible_custom_qos_policy
    qos_priority: level1
    state: present

- name: Query an existing L3Out interface group policy with name
  cisco.mso.ndo_l3out_interface_group_policy:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: l3out_template
    l3out: l3out
    name: interface_group_policy_1
    state: query
  register: query_with_name

- name: Query all existing L3Out interface group policies under l3out
  cisco.mso.ndo_l3out_interface_group_policy:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: l3out_template
    l3out: l3out
    state: query

- name: Delete an existing L3Out interface group policy with name
  cisco.mso.ndo_l3out_interface_group_policy:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: l3out_template
    l3out: l3out
    name: interface_group_policy_1
    state: absent

Авторы

Shreyas Srish (@shrsr)

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

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