Spec-Zone.ru › Ansible

Модуль cisco.aci.aci_interface_policy_leaf_policy_group — управление группами политик интерфейсов leaf-устройств фабрики (infra:AccBndlGrp и infra:AccPortGrp)

Примечание

Этот модуль входит в коллекцию cisco.aci (версия 2.13.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install cisco.aci.

Чтобы использовать коллекцию в плейбуке, укажите: cisco.aci.aci_interface_policy_leaf_policy_group.

  • Краткое описание
  • Параметры
  • Примечания
  • См. также
  • Примеры
  • Возвращаемые значения

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

  • Управление группами политик интерфейсов leaf-устройств фабрик Cisco ACI.

Параметры

Параметр

Комментарии

aep

псевдонимы: aep_name

string

Имя профиля подключенной сущности (AEP), используемого группой политик интерфейса leaf-коммутатора.

annotation

string

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

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

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

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

cdp_policy

псевдонимы: cdp_policy_name

string

Имя политики CDP, используемой группой политик интерфейса leaf-коммутатора.

certificate_name

псевдонимы: cert_name

string

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

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

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

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

copp_policy

псевдонимы: copp_policy_name

string

Имя политики CoPP, используемой группой политик интерфейса leaf-коммутатора.

description

псевдонимы: descr

string

Описание группы политик интерфейса leaf-коммутатора.

dwdm

псевдонимы: dwdm_name

string

Имя DWDM, используемого группой политик интерфейса leaf-коммутатора.

egress_data_plane_policing_policy

псевдонимы: egress_data_plane_policing_policy_name

string

Имя политики ограничения трафика плоскости данных на выходе, используемой группой политик интерфейса leaf-коммутатора.

fibre_channel_interface_policy

псевдонимы: fibre_channel_interface_policy_name

string

Имя политики интерфейса Fibre Channel, используемой группой политик интерфейса leaf-коммутатора.

host

псевдонимы: hostname

string

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

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

ingress_data_plane_policing_policy

псевдонимы: ingress_data_plane_policing_policy_name

string

Имя политики ограничения трафика плоскости данных на входе, используемой группой политик интерфейса leaf-коммутатора.

l2_interface_policy

псевдонимы: l2_interface_policy_name

string

Имя политики интерфейса L2, используемой группой политик интерфейса leaf-коммутатора.

lag_type

псевдонимы: lag_type_name

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

Выбор типа группы политик интерфейса leaf-коммутатора.

leaf для группы политик порта доступа leaf-коммутатора

link для агрегированного канала портов (PC)

node для виртуального агрегированного канала портов (VPC)

Варианты:

  • "leaf"
  • "link"
  • "node"

link_flap_policy

псевдонимы: link_flap_policy_name

string

Имя политики дребезга канала, используемой группой политик интерфейса leaf-коммутатора.

link_level_flow_control

псевдонимы: link_level_flow_control_name

string

Имя управления потоком на уровне канала, используемого группой политик интерфейса leaf-коммутатора.

link_level_policy

псевдонимы: link_level_policy_name

string

Имя политики уровня канала, используемой группой политик интерфейса leaf-коммутатора.

lldp_policy

псевдонимы: lldp_policy_name

string

Имя политики LLDP, используемой группой политик интерфейса leaf-коммутатора.

mac_sec_interface_policy

псевдонимы: mac_sec_interface_policy_name

string

Имя политики интерфейса MACsec, используемой группой политик интерфейса leaf-коммутатора.

mcp_policy

псевдонимы: mcp_policy_name

string

Имя политики MCP, используемой группой политик интерфейса leaf-коммутатора.

monitoring_policy

псевдонимы: monitoring_policy_name

string

Имя политики мониторинга, используемой группой политик интерфейса leaf-коммутатора.

name_alias

string

Псевдоним текущего объекта. Соответствует полю nameAlias в ACI.

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.

owner_key

string

Строка, определяемая пользователем для атрибута ownerKey объекта ACI.

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

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

owner_tag

string

Строка, определяемая пользователем для атрибута ownerTag объекта ACI.

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

Например, чтобы указать, кто создал этот объект.

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

password

string

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

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

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

poe_interface_policy

псевдонимы: poe_interface_policy_name

string

Имя политики интерфейса PoE, используемой группой политик интерфейса leaf-коммутатора.

policy_group

псевдонимы: name, policy_group_name

string

Имя группы политик интерфейса leaf-коммутатора.

port

integer

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

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

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

port_authentication

псевдонимы: port_authentication_name

string

Имя политики аутентификации порта, используемой группой политик интерфейса leaf-коммутатора.

port_channel_policy

псевдонимы: port_channel_policy_name

string

Имя политики агрегированного канала портов, используемой группой политик интерфейса leaf-коммутатора.

port_security_policy

псевдонимы: port_security_policy_name

string

Имя политики безопасности порта, используемой группой политик интерфейса leaf-коммутатора.

priority_flow_control_policy

псевдонимы: priority_flow_control_policy_name

string

Имя политики управления потоком с приоритетами, используемой группой политик интерфейса leaf-коммутатора.

private_key

псевдонимы: cert_key

string

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

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

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

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

slow_drain_policy

псевдонимы: slow_drain_policy_name

string

Имя политики медленного опустошения буфера, используемой группой политик интерфейса leaf-коммутатора.

state

string

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

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

Варианты:

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

storm_control_interface_policy

псевдонимы: storm_control_interface_policy_name

string

Имя политики управления штормовым трафиком для интерфейса, используемой группой политик интерфейса leaf-коммутатора.

stp_interface_policy

псевдонимы: stp_interface_policy_name

string

Имя политики STP для интерфейса, используемой группой политик интерфейса leaf-коммутатора.

suppress_previous

псевдонимы: no_previous, ignore_previous

boolean

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

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

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

ВНИМАНИЕ — в результате предыдущее возвращаемое значение будет пустым.

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

Варианты:

  • false
  • true

suppress_verification

псевдонимы: no_verification, no_verify, suppress_verify, ignore_verify, ignore_verification

boolean

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

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

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

ВНИМАНИЕ — в результате текущее возвращаемое значение будет установлено равным предлагаемому.

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

Варианты:

  • false
  • true

sync_e_interface_policy

псевдонимы: sync_e_interface_policy_name

string

Имя политики интерфейса SyncE, используемой группой политик интерфейса leaf-коммутатора.

Доступно только в APIC версии 5.2 или более поздней.

timeout

integer

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

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

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

transceiver_policy

dictionary

Имя политики трансивера, используемой группой политик интерфейсов leaf-коммутатора.

Доступно только в APIC версии 6.0(2h) или более поздней.

name

aliases: transceiver_policy_name

string / required

Имя политики трансивера.

type

aliases: transceiver_policy_type

string / required

Тип политики трансивера.

Варианты:

  • "zr"
  • "zrp"

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

Примечания

Примечание

  • При использовании модуля выберите соответствующее значение link_aggregation_type (lag_type).
  • link для Port Channel (PC), node для Virtual Port Channel (VPC) и leaf для группы политик портов доступа leaf-коммутатора.

См. также

См. также

Справочник по информационной модели управления APIC

Дополнительная информация о внутренних классах APIC infra:AccBndlGrp и infra:AccPortGrp.

Руководство по Cisco ACI

Подробная информация об управлении инфраструктурой ACI с помощью Ansible.

Разработка модулей Cisco ACI

Подробное руководство по созданию собственных модулей Cisco ACI для внесения вклада в проект.

Примеры

- name: Create a Port Channel (PC) Interface Policy Group
  cisco.aci.aci_interface_policy_leaf_policy_group:
    host: apic
    username: admin
    password: SomeSecretPassword
    lag_type: link
    policy_group: policygroupname
    description: policygroupname description
    link_level_policy: linklevelpolicy
    cdp_policy: cdppolicy
    lldp_policy: lldppolicy
    port_channel_policy: lacppolicy
    state: present
  delegate_to: localhost

- name: Create a Virtual Port Channel (VPC) Interface Policy Group
  cisco.aci.aci_interface_policy_leaf_policy_group:
    host: apic
    username: admin
    password: SomeSecretPassword
    lag_type: node
    policy_group: policygroupname
    link_level_policy: linklevelpolicy
    cdp_policy: cdppolicy
    lldp_policy: lldppolicy
    port_channel_policy: lacppolicy
    state: present
  delegate_to: localhost

- name: Create a Leaf Access Port Policy Group
  cisco.aci.aci_interface_policy_leaf_policy_group:
    host: apic
    username: admin
    password: SomeSecretPassword
    lag_type: leaf
    policy_group: policygroupname
    link_level_policy: linklevelpolicy
    cdp_policy: cdppolicy
    lldp_policy: lldppolicy
    state: present
  delegate_to: localhost

- name: Query all Leaf Access Port Policy Groups of type link
  cisco.aci.aci_interface_policy_leaf_policy_group:
    host: apic
    username: admin
    password: SomeSecretPassword
    lag_type: link
    state: query
  delegate_to: localhost
  register: query_result

- name: Query a specific Lead Access Port Policy Group
  cisco.aci.aci_interface_policy_leaf_policy_group:
    host: apic
    username: admin
    password: SomeSecretPassword
    lag_type: leaf
    policy_group: policygroupname
    state: query
  delegate_to: localhost
  register: query_result

- name: Delete an Interface policy Leaf Policy Group
  cisco.aci.aci_interface_policy_leaf_policy_group:
    host: apic
    username: admin
    password: SomeSecretPassword
    lag_type: leaf
    policy_group: policygroupname
    state: absent
  delegate_to: localhost

Возвращаемые значения

Общие возвращаемые значения описаны здесь; ниже приведены поля, уникальные для этого модуля:

Ключ

Описание

current

list / elements=string

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

Возвращается: success

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

error

dictionary

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

Возвращается: failure

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

filter_string

string

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

Возвращается: failure or debug

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

method

string

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

Возвращается: failure or debug

Пример: "POST"

previous

list / elements=string

Исходная конфигурация из APIC до начала работы модуля

Возвращается: info

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

proposed

dictionary

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

Возвращается: info

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

raw

string

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

Возвращается: parse error

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

response

string

Ответ HTTP от APIC

Возвращается: failure or debug

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

sent

list / elements=string

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

Возвращается: info

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

status

integer

Статус HTTP от APIC

Возвращается: failure or debug

Пример: 200

url

string

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

Возвращается: failure or debug

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

Авторы

  • Bruno Calogero (@brunocalogero)

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

  • Отслеживание проблем
  • Репозиторий (исходный код)

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API