Модуль cisco.mso.ndo_l3_domain – Управление L3 доменами в 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_l3_domain.

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

Описание

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

Требования

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

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

END_OF_DOCUMENT_MARKER

Параметры

Параметр	Комментарии
description строка	Описание домена L3.
host псевдонимы: имя_хоста строка	IP-адрес или имя хоста хоста ACI Multi Site Orchestrator. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `MSO_HOST`.
l3_domain псевдонимы: имя строка	Имя домена L3.
l3_domain_uuid псевдонимы: uuid строка	UUID домена L3. Этот параметр необходим, когда требуется обновить `l3_domain`.
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`.
pool псевдонимы: vlan_pool строка	Имя пула VLAN. Передача пустой строки удалит пул из домена L3.
port целое число	Номер порта для использования в соединении REST. Значение по умолчанию зависит от параметра `use_ssl`. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `MSO_PORT`.
state строка	Используйте `absent` для удаления. Используйте `query` для перечисления объекта или нескольких объектов. Используйте `present` для создания или обновления. Варианты: `"absent"` `"query"` ← (по умолчанию) `"present"`
template строка / обязательно	Имя шаблона. Шаблон должен быть шаблоном политики Fabric.
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` будет использоваться, если этот атрибут не указан. Значение по умолчанию `false` при использовании плагина подключения HTTPAPI (mso или nd) и `true` при использовании устаревшего метода подключения (только для mso). Варианты: `false` `true`
username строка	Имя пользователя для аутентификации. Если значение не указано в задаче, вместо него будут использованы переменные среды `MSO_USERNAME` или `ANSIBLE_NET_USERNAME`.
validate_certs булево	Если `false`, сертификаты SSL не будут проверены. Это значение должно быть установлено в `false` только при работе на сайтах с собственными подписанными сертификатами. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `MSO_VALIDATE_CERTS`. По умолчанию `true`. Варианты: `false` `true`

Примечания

Примечание

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

Примеры

- name: Create a new L3 domain
  cisco.mso.ndo_l3_domain:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_tenant_template
    l3_domain: ansible_test_l3_domain
    pool: ansible_test_vlan_pool
    state: present

- name: Query a L3 domain with template_name
  cisco.mso.ndo_l3_domain:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_tenant_template
    l3_domain: ansible_test_l3_domain
    state: query
  register: query_one

- name: Query all L3 domains in the template
  cisco.mso.ndo_l3_domain:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_tenant_template
    state: query
  register: query_all

- name: Delete a vlan pool from a L3 domain
  cisco.mso.ndo_l3_domain:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_tenant_template
    l3_domain: ansible_test_l3_domain
    pool: ""
    state: present

- name: Delete a L3 domain
  cisco.mso.ndo_l3_domain:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_tenant_template
    l3_domain: ansible_test_l3_domain
    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_l3_domain_module.html