Модуль cisco.mso.ndo_dhcp_relay_policy – Управление политиками DHCP реле на Cisco Nexus Dashboard Orchestrator (NDO).

Примечание

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

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

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

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

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

Описание

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

Требования

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

Multi Site Orchestrator v2.1 или более поздняя версия

END_OF_DOCUMENT_MARKER

Параметры

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

END_OF_DOCUMENT_MARKER

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

- name: Query a dhcp relay policy with template_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 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–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/cisco/mso/ndo_dhcp_relay_policy_module.html