Модуль cisco.mso.ndo_tenant_netflow_record — управление записью NetFlow в 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_tenant_netflow_record.

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

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

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

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

Требования

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

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

Параметры

Параметр	Комментарии
description строка	Описание записи NetFlow. Если при создании параметр не задан, по умолчанию используется пустая строка.
host псевдонимы: hostname строка	IP-адрес или имя узла ACI Multi Site Orchestrator. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `MSO_HOST`.
login_domain строка	Имя домена входа для аутентификации. Значение по умолчанию — Local. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `MSO_LOGIN_DOMAIN`. При использовании подключаемого модуля соединения HTTPAPI, если этот атрибут не указан, будет использоваться переменная инвентаря `ansible_httpapi_login_domain`.
match_parameters псевдонимы: match список / элементы=строка	Параметры сопоставления записи NetFlow. Варианты: `"destination_ip"` `"destination_ipv4"` `"destination_ipv6"` `"destination_mac"` `"destination_port"` `"ethertype"` `"ip_protocol"` `"source_ip"` `"source_ipv4"` `"source_ipv6"` `"source_mac"` `"source_port"`
name строка	Имя записи NetFlow.
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`.
state строка	Для удаления используйте `absent`. Для вывода одного или нескольких объектов используйте `query`. Для создания или обновления используйте `present`. Варианты: `"absent"` `"query"` ← (по умолчанию) `"present"`
template строка	Имя шаблона. Шаблон должен быть шаблоном арендатора. Этот параметр или `template_id` является обязательным.
template_id строка	Идентификатор шаблона арендатора. Этот параметр или `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`. По умолчанию используется `false` при использовании подключаемого модуля соединения HTTPAPI (mso или nd) и `true` при использовании устаревшего метода соединения (только для mso). Варианты: `false` `true`
username строка	Имя пользователя для аутентификации. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `MSO_USERNAME` или `ANSIBLE_NET_USERNAME`.
uuid строка	UUID записи NetFlow. Этот параметр обязателен, если требуется обновить `name`.
validate_certs логическое значение	Если `false`, сертификаты SSL проверяться не будут. Значение `false` следует использовать только на сайтах под личным контролем, использующих самоподписанные сертификаты. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `MSO_VALIDATE_CERTS`. Значение по умолчанию — `true`. Варианты: `false` `true`

Примечания

Примечание

Перед использованием этого модуля в плейбуке должен существовать template. Чтобы создать шаблон арендатора, используйте cisco.mso.ndo_template.
Модуль разработан для поддержки Multi Site Orchestrator версии 2.1 и новее. Некоторые или все функции могут не работать в более ранних версиях.

См. также

cisco.mso.ndo_template: Управление шаблонами в Cisco Nexus Dashboard Orchestrator (NDO).

Примеры

- name: Add a NetFlow Record
  cisco.mso.ndo_tenant_netflow_record:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_tenant_template
    name: netflow_record_1
    state: present
  register: add_netflow_record

- name: Update a NetFlow Record name using UUID
  cisco.mso.ndo_tenant_netflow_record:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_tenant_template
    name: netflow_record_1_updated
    uuid: "{{ add_netflow_record.current.uuid }}"
    match_parameters:
      - ethertype
      - destination_mac
    state: present

- name: Query a NetFlow Record using name
  cisco.mso.ndo_tenant_netflow_record:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_tenant_template
    name: netflow_record_1_updated
    state: query
  register: query_one_with_name

- name: Query a NetFlow Record using UUID
  cisco.mso.ndo_tenant_netflow_record:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_tenant_template
    uuid: "{{ add_netflow_record.current.uuid }}"
    state: query
  register: query_one_with_uuid

- name: Query all NetFlow Records
  cisco.mso.ndo_tenant_netflow_record:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_tenant_template
    state: query
  register: query_all

- name: Remove a NetFlow Record using name
  cisco.mso.ndo_tenant_netflow_record:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_tenant_template
    name: netflow_record_1_updated
    state: absent

- name: Remove a NetFlow Record using UUID
  cisco.mso.ndo_tenant_netflow_record:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_tenant_template
    uuid: "{{ add_netflow_record.current.uuid }}"
    state: absent

Авторы

Sabari Jaganathan (@sajagana)

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

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