cisco.aci.aci_vrf_multicast module – Управление объектами многоадресной рассылки VRF (pim:CtxP)
Примечание
Этот модуль входит в коллекцию cisco.aci (версия 2.13.0).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.
Чтобы установить ее, используйте: ansible-galaxy collection install cisco.aci.
Чтобы использовать ее в плейбуке, укажите: cisco.aci.aci_vrf_multicast.
Краткое описание
- Управление объектами многоадресной рассылки VRF на фабриках Cisco ACI.
- Создание с state=present включает независимую от протокола многоадресную рассылку (PIM) в VRF.
- Удаление с state=absent отключает независимую от протокола многоадресную рассылку (PIM) в VRF.
Параметры
Параметр | Комментарии |
|---|---|
annotation string | Строка, заданная пользователем для аннотирования объекта. Если значение не указано в задаче, вместо него будет использовано значение переменной среды Если значение не указано в задаче и переменная среды По умолчанию: |
any_source_multicast aliases: asm, any_source dictionary | Контейнер конфигурации параметров многоадресной рассылки от любого источника (ASM) протокола независимой многоадресной рассылки (PIM). |
|
expiry aliases: expiry_seconds integer |
Время ожидания в секундах. Если при создании значение не задано, APIC использует значение Укажите |
|
max_rate aliases: max_rate_per_second integer |
Максимальная частота в секунду. Если при создании значение не задано, APIC использует значение |
|
aliases: shared_range_policy string |
DN карты маршрутизации. Укажите |
|
source_group_expiry_route_map aliases: sg_expiry_route_map string |
DN карты маршрутизации. Укажите |
|
source_ip aliases: source, source_ip_address string |
IP-адрес источника. |
auto_rp aliases: auto dictionary | Контейнер конфигурации параметров автоматического rendezvous point (Auto-RP) протокола независимой многоадресной рассылки (PIM). |
|
ma_filter aliases: filter, route_map, route_map_dn string |
DN карты маршрутизации. Укажите |
|
rp_updates aliases: control, ctrl list / elements=string |
Состояние управления политикой автоматического rendezvous point (Auto-RP). Укажите Варианты:
|
bootstrap_router aliases: bsr, bootstrap dictionary | Контейнер конфигурации параметров маршрутизатора начальной загрузки (BSR) протокола независимой многоадресной рассылки (PIM). |
|
bsr_filter aliases: filter, route_map, route_map_dn string |
DN карты маршрутизации. Укажите |
|
rp_updates aliases: control, ctrl list / elements=string |
Состояние управления политикой маршрутизатора начальной загрузки (BSR). Укажите Варианты:
|
certificate_name aliases: cert_name string | Имя сертификата X.509, связанного с пользователем AAA в APIC и используемого для аутентификации на основе подписи. Если указано имя файла Если для Если значение не указано в задаче, вместо него будет использовано значение переменной среды |
host aliases: hostname string | IP-адрес или имя узла APIC, доступное для разрешения на управляющем узле Ansible. Если значение не указано в задаче, вместо него будет использовано значение переменной среды |
output_level string | Управление выводом этого модуля ACI.
Если значение не указано в задаче, вместо него будет использовано значение переменной среды Варианты:
|
output_path string | Путь к файлу, в который будут записываться созданные модулем объекты конфигурации ACI в формате JSON. Если значение не указано в задаче, вместо него будет использовано значение переменной среды |
owner_key string | Строка, заданная пользователем для атрибута ownerKey объекта ACI. Этот атрибут представляет собой ключ, позволяющий клиентам владеть своими данными для корреляции сущностей. Если значение не указано в задаче, вместо него будет использовано значение переменной среды |
owner_tag string | Строка, заданная пользователем для атрибута ownerTag объекта ACI. Этот атрибут представляет собой тег, позволяющий клиентам добавлять собственные данные. Например, чтобы указать, кто создал этот объект. Если значение не указано в задаче, вместо него будет использовано значение переменной среды |
password string | Пароль для аутентификации. Этот параметр несовместим с Если значение не указано в задаче, вместо него будут использованы значения переменных среды |
pim_setting dictionary | Контейнер конфигурации параметров протокола независимой многоадресной рассылки (PIM). |
|
control_state aliases: control, ctrl list / elements=string |
Действия, которые необходимо выполнить при обнаружении петли. Укажите Варианты:
|
|
mtu integer |
Размер MTU, поддерживаемый для многоадресной рассылки. Если при создании значение не задано, APIC использует значение |
port integer | Номер порта для REST-подключения. Значение по умолчанию зависит от параметра Если значение не указано в задаче, вместо него будет использовано значение переменной среды |
private_key aliases: cert_key string | Файл закрытого ключа в формате PEM или содержимое закрытого ключа, используемого для аутентификации на основе подписи. Это значение также влияет на используемое значение Этот параметр несовместим с Если значение не указано в задаче, вместо него будут использованы значения переменных среды |
resource_policy dictionary | Контейнер конфигурации политики ресурсов протокола независимой многоадресной рассылки (PIM). |
|
maximum_limit aliases: max integer |
Максимальное количество записей многоадресной рассылки. Если при создании значение не задано, APIC использует значение Укажите |
|
reserved_multicast_entries aliases: rsvd integer |
Зарезервированные записи многоадресной рассылки. Если при создании значение не задано, APIC использует значение Обязательно, если указан |
|
reserved_route_map aliases: route_map, route_map_dn string |
DN карты маршрутизации. Укажите Обязательно, если указан |
source_specific_multicast aliases: ssm, specific_source dictionary | Контейнер конфигурации параметров многоадресной рассылки с указанием источника (SSM) протокола независимой многоадресной рассылки (PIM). |
|
group_range_route_map aliases: group_range_policy string |
DN карты маршрутизации. Укажите |
state string | Используйте Используйте Варианты:
|
suppress_previous aliases: no_previous, ignore_previous boolean | Если Если значение не указано в задаче, вместо него будет использовано значение переменной среды Значение по умолчанию — ПРЕДУПРЕЖДЕНИЕ — в результате возвращаемое предыдущее значение будет пустым. Предыдущее состояние объекта проверяться не будет, а обновление POST будет содержать все свойства. Варианты:
|
suppress_verification aliases: no_verification, no_verify, suppress_verify, ignore_verify, ignore_verification boolean | Если Если значение не указано в задаче, вместо него будет использовано значение переменной среды Значение по умолчанию — ПРЕДУПРЕЖДЕНИЕ — в результате текущее возвращаемое значение будет установлено равным предложенному значению. Текущий объект, включая значения по умолчанию, нельзя будет проверить в рамках одной задачи. Варианты:
|
tenant aliases: tenant_name string | Имя существующего арендатора. |
timeout integer | Тайм-аут на уровне сокета в секундах. Если значение не указано в задаче, вместо него будет использовано значение переменной среды Значение по умолчанию — 30. |
use_proxy boolean | Если Если значение не указано в задаче, вместо него будет использовано значение переменной среды Значение по умолчанию — true. Варианты:
|
use_ssl boolean | Если Если значение не указано в задаче, вместо него будет использовано значение переменной среды При локальном подключении значение по умолчанию — true. Варианты:
|
username aliases: user string | Имя пользователя для аутентификации. Если значение не указано в задаче, вместо него будут использованы значения переменных среды Значение по умолчанию — admin. |
validate_certs boolean | Если Устанавливайте это значение в Если значение не указано в задаче, вместо него будет использовано значение переменной среды Значение по умолчанию — true. Варианты:
|
vrf aliases: vrf_name string | Имя существующей VRF. |
Примечания
Примечание
- Арендатор tenant и VRF vrf должны существовать до использования этого модуля в сценарии. Для этого можно использовать модули cisco.aci.aci_tenant и cisco.aci.aci_vrf.
См. также
См. также
- Справочник информационной модели управления APIC
-
Дополнительная информация о внутреннем классе APIC pim:CtxP.
- Руководство по Cisco ACI
-
Подробная информация об управлении инфраструктурой ACI с помощью Ansible.
- Разработка модулей Cisco ACI
-
Подробное руководство по созданию собственных модулей Cisco ACI для участия в разработке.
Примеры
- name: Enable Multicast on a VRF
cisco.aci.aci_vrf_multicast:
host: apic
username: admin
password: SomeSecretePassword
tenant: ansible_tenant
vrf: ansible_vrf
state: present
delegate_to: localhost
- name: Change Multicast PIM Settings on a VRF
cisco.aci.aci_vrf_multicast:
host: apic
username: admin
password: SomeSecretePassword
tenant: ansible_tenant
vrf: ansible_vrf
pim_setting:
mtu: 2000
control_state: [fast, strict]
state: present
delegate_to: localhost
- name: Change Multicast Resource Policy on a VRF
cisco.aci.aci_vrf_multicast:
host: apic
username: admin
password: SomeSecretePassword
tenant: ansible_tenant
vrf: ansible_vrf
resource_policy:
maximum_limit: 100
reserved_multicast_entries: 20
reserved_route_map: uni/tn-ansible_test/rtmap-ansible_test
state: present
delegate_to: localhost
- name: Remove Route-Map from Multicast Resource Policy on a VRF
cisco.aci.aci_vrf_multicast:
host: apic
username: admin
password: SomeSecretePassword
tenant: ansible_tenant
vrf: ansible_vrf
resource_policy:
reserved_route_map: ""
state: present
delegate_to: localhost
- name: Change Multicast Any Source Multicast (ASM) Settings on a VRF
cisco.aci.aci_vrf_multicast:
host: apic
username: admin
password: SomeSecretePassword
tenant: ansible_tenant
vrf: ansible_vrf
any_source_multicast:
shared_range_route_map: uni/tn-ansible_test/rtmap-ansible_test
source_group_expiry_route_map: uni/tn-ansible_test/rtmap-ansible_test
expiry: 500
max_rate: 64000
source_ip: 1.1.1.1
state: present
delegate_to: localhost
- name: Change Multicast Source Specific Multicast (SSM) Settings on a VRF
cisco.aci.aci_vrf_multicast:
host: apic
username: admin
password: SomeSecretePassword
tenant: ansible_tenant
vrf: ansible_vrf
source_specific_multicast:
group_range_route_map: uni/tn-ansible_test/rtmap-ansible_test
state: present
delegate_to: localhost
- name: Change Multicast Bootstrap Router (BSR) Settings on a VRF
cisco.aci.aci_vrf_multicast:
host: apic
username: admin
password: SomeSecretePassword
tenant: ansible_tenant
vrf: ansible_vrf
bootstrap_router:
bsr_filter: uni/tn-ansible_test/rtmap-ansible_test
rp_updates: [forward, listen]
state: present
delegate_to: localhost
- name: Change Multicast Auto-Rendezvous Point (Auto-RP) Settings on a VRF
cisco.aci.aci_vrf_multicast:
host: apic
username: admin
password: SomeSecretePassword
tenant: ansible_tenant
vrf: ansible_vrf
auto_rp:
ma_filter: uni/tn-ansible_test/rtmap-ansible_test
rp_updates: [forward, listen]
state: present
delegate_to: localhost
- name: Disable Multicast on a VRF
cisco.aci.aci_vrf_multicast:
host: apic
username: admin
password: SomeSecretePassword
tenant: ansible_tenant
vrf: ansible_vrf
state: absent
delegate_to: localhost
- name: Query Multicast Settings for a VRF
cisco.aci.aci_vrf_multicast:
host: apic
username: admin
password: SomeSecretePassword
tenant: ansible_tenant
vrf: ansible_vrf
state: query
delegate_to: localhost
register: query_result
- name: Query Multicast Settings for all VRFs
cisco.aci.aci_vrf_multicast:
host: apic
username: admin
password: SomeSecretePassword
state: query
delegate_to: localhost
register: query_result
Возвращаемые значения
Общие возвращаемые значения описаны здесь; ниже приведены поля, уникальные для этого модуля:
Ключ | Описание |
|---|---|
current list / elements=string | Текущая конфигурация APIC после завершения работы модуля Возвращается: success Пример: |
error dictionary | Информация об ошибке, возвращенная APIC Возвращается: failure Пример: |
filter_string string | Строка фильтра, использованная в запросе Возвращается: failure или debug Пример: |
method string | Метод HTTP, использованный для запроса к APIC Возвращается: failure или debug Пример: |
previous list / elements=string | Исходная конфигурация APIC до начала работы модуля Возвращается: info Пример: |
proposed dictionary | Сформированная конфигурация на основе параметров, предоставленных пользователем Возвращается: info Пример: |
raw string | Необработанные данные, возвращенные REST API APIC (xml или json) Возвращается: ошибка разбора Пример: |
response string | Ответ HTTP от APIC Возвращается: failure или debug Пример: |
sent list / elements=string | Фактическая/минимальная конфигурация, отправленная в APIC Возвращается: info Пример: |
status integer | Статус HTTP от APIC Возвращается: failure или debug Пример: |
url string | URL HTTP, использованный для запроса к APIC Возвращается: failure или debug Пример: |
Ссылки на коллекцию
© 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/aci/aci_vrf_multicast_module.html