Модуль cisco.aci.aci_l3out_bgp_peer — управление BGP-пирами Layer 3 Outside (L3Out) (bgp:PeerP и bgp:InfraPeerP)

address_type_controls

list / elements=string

Элементы управления типом адреса

Варианты:

• "af-ucast"
• "af-mcast"

admin_state

string

Состояние администрирования сеанса BGP

Варианты:

• "enabled"
• "disabled"

allow_self_as_count

integer

Количество разрешённых собственных AS.

Используется только в том случае, если allow-self-as включён в bgp_controls.

annotation

string

Заданная пользователем строка для добавления аннотации к объекту.

Если значение не указано в задаче, вместо него будет использоваться значение переменной среды ACI_ANNOTATION.

Если значение не указано в задаче и переменной среды ACI_ANNOTATION, будет использовано значение по умолчанию.

По умолчанию: "orchestrator:ansible"

bgp_controls

list / elements=string

Элементы управления BGP

Варианты:

• "send-com"
• "send-ext-com"
• "allow-self-as"
• "as-override"
• "dis-peer-as-check"
• "nh-self"
• "send-domain-path"

bgp_infra_peer

aliases: infra

boolean

Пир инфраструктуры BGP (bgp:InfraPeerP).

Варианты:

• false
• true

bgp_password

string

Пароль для пира BGP.

Указание пароля всегда приводит к изменению, поскольку установленный пароль нельзя получить из APIC.

bgp_peer_prefix_policy

aliases: bgp_peer_prefix_policy_name

string

Политика префиксов пира BGP.

Настроить политику префиксов пира BGP можно только при условии bgp_infra_peer=true.

certificate_name

aliases: cert_name

string

Имя сертификата X.509, связанного с пользователем AAA APIC, используемого для аутентификации на основе подписи.

Если указано имя файла private_key, по умолчанию используется имя файла private_key без расширения.

Если для private_key предоставлено содержимое в формате PEM, по умолчанию используется значение username.

Если значение не указано в задаче, вместо него будет использоваться значение переменной среды ACI_CERTIFICATE_NAME.

description

aliases: descr

string

Описание пира BGP.

host

aliases: hostname

string

IP-адрес или имя узла APIC, разрешаемое управляющим узлом Ansible.

Если значение не указано в задаче, вместо него будет использоваться значение переменной среды ACI_HOST.

interface_profile

aliases: interface_profile_name, logical_interface

string

Имя профиля интерфейса.

l3out

aliases: l3out_name

string

Имя существующего L3Out.

local_as_number

aliases: local_as_num

integer

Локальный номер автономной системы (ASN) пира BGP L3Out.

При создании APIC присваивает значение 0, если параметр не задан.

local_as_number_config

aliases: local_as_num_config

string

Конфигурация локального номера автономной системы (ASN) пира BGP L3Out.

При создании APIC присваивает значение none, если параметр не задан.

Варианты:

• "dual-as"
• "no-prepend"
• "none"
• "replace-as"

node_id

string

Узел, на котором будет создан интерфейс для каналов портов и отдельных портов.

Для vPC укажите пару узлов, разделённых дефисом (например, «201-202»).

node_profile

aliases: node_profile_name, logical_node

string

Имя профиля узла.

output_level

string

Управляет выводом этого модуля ACI.

normal означает стандартный вывод, включая словарь current

info добавляет информационный вывод, включая previous, proposed и словари sent

debug добавляет отладочный вывод, включая информацию filter_string, method, response, status и url

Если значение не указано в задаче, вместо него будет использоваться значение переменной среды ACI_OUTPUT_LEVEL.

Варианты:

• "debug"
• "info"
• "normal" ← (по умолчанию)

output_path

string

Путь к файлу, в который будут записываться созданные модулем объекты конфигурации ACI в формате JSON.

Если значение не указано в задаче, вместо него будет использоваться значение переменной среды ACI_OUTPUT_PATH.

password

string

Пароль для аутентификации.

Этот параметр несовместим с private_key. Если также задан private_key, он будет использован вместо этого параметра.

Если значение не указано в задаче, вместо него будет использоваться значение одной из переменных среды: ACI_PASSWORD или ANSIBLE_NET_PASSWORD.

path_ep

string

Путь к интерфейсу

Имя группы портов интерфейса для каналов портов и vPC

Номер порта для отдельных портов (например, «eth1/12»)

peer_controls

list / elements=string

Элементы управления пиром

Варианты:

• "bfd"
• "dis-conn-check"

peer_ip

string

IP-адрес пира BGP.

peer_type

string

Тип пира BGP.

Варианты:

• "sr_mpls"

pod_id

string

Под, на котором будет создан интерфейс.

port

integer

Номер порта для REST-подключения.

Значение по умолчанию зависит от параметра use_ssl.

Если значение не указано в задаче, вместо него будет использоваться значение переменной среды ACI_PORT.

private_asn_controls

list / elements=string

Элементы управления частной AS

Варианты:

• "remove-exclusive"
• "remove-all"
• "replace-as"

private_key

aliases: cert_key

string

Файл закрытого ключа в формате PEM или содержимое закрытого ключа, используемое для аутентификации на основе подписи.

Это значение также влияет на используемое значение certificate_name по умолчанию.

Этот параметр несовместим с password. Если также задан password, он будет проигнорирован.

Если значение не указано в задаче, вместо него будет использоваться значение переменной среды ACI_PRIVATE_KEY или ANSIBLE_NET_SSH_KEYFILE.

remote_asn

integer

Номер автономной системы пира BGP.

route_control_profiles

list / elements=dictionary

Список словарей, используемый для привязки профиля подключения пира BGP к профилю управления маршрутами.

direction

string / обязательный

Имя направления профиля управления маршрутами.

l3out

string

Имя L3 Out.

profile

string / обязательный

Имя профиля управления маршрутами.

tenant

string / обязательный

Имя арендатора.

state

string

Для добавления или удаления используйте present или absent.

Для просмотра одного или нескольких объектов используйте query.

Варианты:

• "absent"
• "present" ← (по умолчанию)
• "query"

suppress_previous

aliases: no_previous, ignore_previous

boolean

Если true, перед обновлением POST в APIC запрос GET для проверки предыдущего состояния отправляться не будет.

Если значение не указано в задаче, вместо него будет использоваться значение переменной среды ACI_SUPPRESS_PREVIOUS.

Значение по умолчанию — false.

ПРЕДУПРЕЖДЕНИЕ: возвращаемое предыдущее значение будет пустым.

Предыдущее состояние объекта проверяться не будет, а запрос POST на обновление будет содержать все свойства.

Варианты:

• false
• true

suppress_verification

aliases: no_verification, no_verify, suppress_verify, ignore_verify, ignore_verification

boolean

Если true, после обновления POST в APIC проверочный запрос GET отправляться не будет.

Если значение не указано в задаче, вместо него будет использоваться значение переменной среды ACI_SUPPRESS_VERIFICATION.

Значение по умолчанию — false.

ПРЕДУПРЕЖДЕНИЕ: в качестве текущего возвращаемого значения будет установлено предлагаемое значение.

Текущий объект, включая значения по умолчанию, нельзя будет проверить в рамках одной задачи.

Варианты:

• false
• true

tenant

aliases: tenant_name

string

Имя существующего арендатора.

timeout

integer

Тайм-аут на уровне сокета в секундах.

Если значение не указано в задаче, вместо него будет использоваться значение переменной среды ACI_TIMEOUT.

Значение по умолчанию — 30.

transport_data_plane

string

Тип плоскости передачи данных транспорта.

Варианты:

• "mpls"
• "sr_mpls"

ttl

integer

Время жизни пакета для многопереходного eBGP

use_proxy

boolean

Если false, прокси использоваться не будет, даже если он задан в переменной среды на целевых узлах.

Если значение не указано в задаче, вместо него будет использоваться значение переменной среды ACI_USE_PROXY.

Значение по умолчанию — true.

Варианты:

• false
• true

use_ssl

boolean

Если false, вместо HTTPS-подключения, используемого по умолчанию, будет использоваться HTTP-подключение.

Если значение не указано в задаче, вместо него будет использоваться значение переменной среды ACI_USE_SSL.

При локальном подключении значение по умолчанию — true.

Варианты:

• false
• true

username

aliases: user

string

Имя пользователя для аутентификации.

Если значение не указано в задаче, вместо него будет использоваться значение одной из переменных среды: ACI_USERNAME или ANSIBLE_NET_USERNAME.

Значение по умолчанию — admin.

validate_certs

boolean

Если false, сертификаты SSL проверяться не будут.

Устанавливайте значение false только на сайтах под личным управлением, использующих самоподписанные сертификаты.

Если значение не указано в задаче, вместо него будет использоваться значение переменной среды ACI_VALIDATE_CERTS.

Значение по умолчанию — true.

Варианты:

• false
• true

weight

integer

Вес маршрутов BGP от этого соседа

current

список / элементы=строка

Текущая конфигурация из APIC после завершения работы модуля

Возвращается: при успехе

Пример: [{"fvTenant": {"attributes": {"descr": "Production environment", "dn": "uni/tn-production", "name": "production", "nameAlias": "", "ownerKey": "", "ownerTag": ""}}}]

error

словарь

Сведения об ошибке, возвращенные APIC

Возвращается: при сбое

Пример: {"code": "122", "text": "unknown managed object class foo"}

filter_string

строка

Строка фильтра, использованная для запроса

Возвращается: при сбое или в режиме отладки

Пример: "?rsp-prop-include=config-only"

method

строка

Метод HTTP, использованный для запроса к APIC

Возвращается: при сбое или в режиме отладки

Пример: "POST"

previous

список / элементы=строка

Исходная конфигурация из APIC до запуска модуля

Возвращается: сведения

Пример: [{"fvTenant": {"attributes": {"descr": "Production", "dn": "uni/tn-production", "name": "production", "nameAlias": "", "ownerKey": "", "ownerTag": ""}}}]

proposed

словарь

Собранная конфигурация на основе параметров, предоставленных пользователем

Возвращается: сведения

Пример: {"fvTenant": {"attributes": {"descr": "Production environment", "name": "production"}}}

raw

строка

Необработанный вывод, возвращенный REST API APIC (xml или json)

Возвращается: при ошибке разбора

Пример: "<?xml version=\"1.0\" encoding=\"UTF-8\"?><imdata totalCount=\"1\"><error code=\"122\" text=\"unknown managed object class foo\"/></imdata>"

response

строка

Ответ HTTP от APIC

Возвращается: при сбое или в режиме отладки

Пример: "OK (30 bytes)"

sent

список / элементы=строка

Фактическая/минимальная конфигурация, переданная в APIC

Возвращается: сведения

Пример: {"fvTenant": {"attributes": {"descr": "Production environment"}}}

status

целое число

Статус HTTP от APIC

Возвращается: при сбое или в режиме отладки

Пример: 200

url

строка

URL HTTP, использованный для запроса к APIC

Возвращается: при сбое или в режиме отладки

Пример: "https://10.11.12.13/api/mo/uni/tn-production.json"