Модуль cisco.mso.ndo_dhcp_relay_policy — управление политиками DHCP Relay в 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_dhcp_relay_policy.

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

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

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

Требования

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

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

Параметры

Параметр	Комментарии
description string	Описание политики DHCP Relay.
host псевдонимы: hostname string	IP-адрес или имя хоста ACI Multi Site Orchestrator. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `MSO_HOST`.
login_domain string	Имя домена входа, используемое для аутентификации. Значение по умолчанию — Local. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `MSO_LOGIN_DOMAIN`. При использовании подключаемого модуля подключения HTTPAPI, если этот атрибут не указан, будет использоваться переменная инвентаря `ansible_httpapi_login_domain`.
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`.
providers list / элементы=dictionary	Список провайдеров, связанных с политикой DHCP Relay. Список настроенных провайдеров должен содержать как минимум одного провайдера. Если список провайдеров равен null, обновление не изменит существующую конфигурацию провайдеров.
anp string	Имя профиля приложения (ANP). Этот параметр обязателен, если указан `providers.epg`.
epg string	Имя группы конечных точек (EPG). `providers.epg` и `providers.external_epg` являются взаимоисключающими. `providers.epg` обязателен, если не указан `providers.external_epg`.
external_epg string	Имя внешней группы конечных точек (EPG). `providers.external_epg` и `providers.epg` являются взаимоисключающими. `providers.external_epg` обязателен, если не указан `providers.epg`.
ip string / обязательный	IP-адрес DHCP-сервера.
schema string / обязательный	Имя схемы для (внешней) EPG.
template string / обязательный	Имя шаблона для (внешней) EPG.
use_server_vrf boolean	Использовать VRF сервера. Возможные значения: `false` ← (по умолчанию) `true`
relay_policy псевдонимы: name string	Имя политики DHCP Relay.
relay_policy_uuid псевдонимы: uuid string	UUID политики DHCP Relay. Этот параметр обязателен, если необходимо обновить `relay_policy`.
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`. По умолчанию используется `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`

Примечания

Примечание

Этот модуль разработан для поддержки Multi Site Orchestrator v2.1 или новее. Некоторые или все его функции могут не работать в более ранних версиях.

Примеры

- name: Create a new dhcp relay policy
  cisco.mso.ndo_dhcp_relay_policy:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_tenant_template
    relay_policy: ansible_test_relay_policy
    providers:
      - schema: ansible_test_schema
        template: ansible_test_template
        anp: ansible_test_anp
        epg: ansible_test_epg_1
        ip: 1.1.1.1
    state: present
  register: create

- name: Query a dhcp relay policy with name
  cisco.mso.ndo_dhcp_relay_policy:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_tenant_template
    relay_policy: ansible_test_relay_policy
    state: query
  register: query_one

- name: Query a dhcp relay policy with UUID
  cisco.mso.ndo_dhcp_relay_policy:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_tenant_template
    relay_policy_uuid: '{{ create.current.uuid }}'
    state: query
  register: query_with_uuid

- name: Query all dhcp relay policy in the template
  cisco.mso.ndo_dhcp_relay_policy:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_tenant_template
    state: query
  register: query_all

- name: Delete a dhcp relay policy
  cisco.mso.ndo_dhcp_relay_policy:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_tenant_template
    relay_policy: ansible_test_relay_policy
    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_dhcp_relay_policy_module.html