Модуль cisco.mso.ndo_tenant_bgp_peer_prefix_policy — управление политиками префиксов BGP-соседей в шаблонах политик арендаторов в 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_bgp_peer_prefix_policy.

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

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

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

Требования

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

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

Параметры

Параметр	Комментарии
action string	Действие политики префиксов BGP-соседей. Значение по умолчанию: `reject`. Варианты: `"log"` `"reject"` `"restart"` `"shutdown"`
description string	Описание политики префиксов BGP-соседей. Если указать пустую строку, из политики префиксов BGP-соседей будет удалено `description=""`.
host псевдонимы: hostname string	IP-адрес или имя хоста узла ACI Multi Site Orchestrator. Если значение не указано в задаче, вместо него будет использоваться значение переменной окружения `MSO_HOST`.
login_domain string	Имя домена входа, используемого для аутентификации. Значение по умолчанию: Local. Если значение не указано в задаче, вместо него будет использоваться значение переменной окружения `MSO_LOGIN_DOMAIN`. При использовании плагина подключения HTTPAPI, если этот атрибут не указан, будет использоваться переменная инвентаря `ansible_httpapi_login_domain`.
max_number_of_prefixes псевдонимы: max_prefix, max integer	Максимальное количество префиксов для политики префиксов BGP-соседей. Значение должно находиться в диапазоне от 1 до 300000. Значение по умолчанию: 20000 префиксов.
name псевдонимы: bgp_peer_prefix_policy string	Имя политики префиксов BGP-соседей.
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`.
restart_time псевдонимы: restart integer	Время перезапуска политики префиксов BGP-соседей в секундах. Значение должно находиться в диапазоне от 1 до 65535. Значение по умолчанию: 1 секунда.
state string	Для удаления используйте `absent`. Для получения списка одного или нескольких объектов используйте `query`. Для создания или обновления используйте `present`. Варианты: `"absent"` `"query"` ← (по умолчанию) `"present"`
template псевдонимы: tenant_template string / обязательный	Имя шаблона арендатора.
threshold_percentage псевдонимы: threshold integer	Пороговое значение в процентах для политики префиксов BGP-соседей. Значение должно находиться в диапазоне от 1 до 100. Значение по умолчанию: 75%.
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`.
uuid string	UUID политики префиксов BGP-соседей. Этот параметр обязателен, если политику префиксов BGP-соседей `name` необходимо обновить.
validate_certs boolean	Если задано `false`, сертификаты SSL проверяться не будут. Устанавливайте значение `false` только при работе на подконтрольных вам сайтах, использующих самоподписанные сертификаты. Если значение не указано в задаче, вместо него будет использоваться значение переменной окружения `MSO_VALIDATE_CERTS`. Значение по умолчанию: `true`. Варианты: `false` `true`

Примечания

Примечание

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

См. также

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

Примеры

- name: Create a new BGP Peer Prefix Policy object
  cisco.mso.ndo_tenant_bgp_peer_prefix_policy:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: tenant_template
    name: bgp_peer_prefix_policy_1
    action: restart
    max_number_of_prefixes: 1000
    threshold_percentage: 50
    restart_time: 60
    state: present
  register: bgp_peer_prefix_policy_1

- name: Update a BGP Peer Prefix Policy object name with UUID
  cisco.mso.ndo_tenant_bgp_peer_prefix_policy:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: tenant_template
    name: bgp_peer_prefix_policy_2
    uuid: "{{ bgp_peer_prefix_policy_1.current.uuid }}"
    state: present

- name: Query a BGP Peer Prefix Policy object with name
  cisco.mso.ndo_tenant_bgp_peer_prefix_policy:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: tenant_template
    name: bgp_peer_prefix_policy_1
    state: query
  register: query_uuid

- name: Query a BGP Peer Prefix Policy object with UUID
  cisco.mso.ndo_tenant_bgp_peer_prefix_policy:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: tenant_template
    uuid: "{{ bgp_peer_prefix_policy_1.current.uuid }}"
    state: query
  register: query_uuid

- name: Query all BGP Peer Prefix Policy objects in a Tenant Template
  cisco.mso.ndo_tenant_bgp_peer_prefix_policy:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: tenant_template
    state: query
  register: query_all

- name: Delete a BGP Peer Prefix Policy object with name
  cisco.mso.ndo_tenant_bgp_peer_prefix_policy:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: tenant_template
    name: bgp_peer_prefix_policy_1
    state: absent

- name: Delete a BGP Peer Prefix Policy object with UUID
  cisco.mso.ndo_tenant_bgp_peer_prefix_policy:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: tenant_template
    uuid: "{{ bgp_peer_prefix_policy_1.current.uuid }}"
    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_tenant_bgp_peer_prefix_policy_module.html