cisco.aci.aci_interface_policy_leaf_policy_group – Управление политиками интерфейсов ткани, политиками групп листьев (infra:AccBndlGrp, infra:AccPortGrp)

Примечание

Этот плагин является частью коллекции cisco.aci (версия 1.1.1).

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

Для использования в книге задач укажите: cisco.aci.aci_interface_policy_leaf_policy_group.

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

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

Управление политиками интерфейсов ткани, политиками групп листьев на Cisco ACI тканях.

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
aep строка		Выбор используемого профиля присоединённой сущности (AEP) в качестве части создаваемой группы политик листа. псевдонимы: aep_name
annotation строка		Определённая пользователем строка для аннотирования объекта. Если значение не указано в задаче, используется значение переменной окружения `ACI_ANNOTATION`.
cdp_policy строка		Выбор используемой политики cdp в качестве части создаваемой группы политик листа. псевдонимы: cdp_policy_name
certificate_name строка		Имя сертификата X.509, прикреплённого к пользователю APIC AAA, используемому для аутентификации на основе подписи. Если был предоставлён файл с именем `private_key`, по умолчанию используется имя файла `private_key`, без расширения. Если для `private_key` был предоставлен контент в формате PEM, по умолчанию используется значение `username`. Если значение не указано в задаче, используется значение переменной окружения `ACI_CERTIFICATE_NAME`. псевдонимы: cert_name
description строка		Описание создаваемой группы политик листа. псевдонимы: descr
egress_data_plane_policing_policy строка		Выбор используемой политики egress_data_plane_policing в качестве части создаваемой группы политик листа. псевдонимы: egress_data_plane_policing_policy_name
fibre_channel_interface_policy строка		Выбор используемой политики fibre_channel_interface в качестве части создаваемой группы политик листа. псевдонимы: fibre_channel_interface_policy_name
host строка / обязательно		IP-адрес или имя хоста APIC, разрешаемые хостом управления Ansible. Если значение не указано в задаче, используется значение переменной окружения `ACI_HOST`. псевдонимы: hostname
ingress_data_plane_policing_policy строка		Выбор используемой политики ingress_data_plane_policing в качестве части создаваемой группы политик листа. псевдонимы: ingress_data_plane_policing_policy_name
l2_interface_policy строка		Выбор используемой политики l2_interface в качестве части создаваемой группы политик листа. псевдонимы: l2_interface_policy_name
lag_type строка / обязательно	Варианты: лист ссылка узел	Выбор типа группы политик листа, которую мы хотим создать. `leaf` для политики группы доступа порта листа `link` для канала порта (PC) `node` для виртуального канала порта (VPC) псевдонимы: lag_type_name
link_level_policy строка		Выбор используемой политики link_level в качестве части создаваемой группы политик листа. псевдонимы: link_level_policy_name
lldp_policy строка		Выбор используемой политики lldp в качестве части создаваемой группы политик листа. псевдонимы: lldp_policy_name
mcp_policy строка		Выбор используемой политики mcp в качестве части создаваемой группы политик листа. псевдонимы: mcp_policy_name
monitoring_policy строка		Выбор используемой политики мониторинга в качестве части создаваемой группы политик листа. псевдонимы: monitoring_policy_name
name_alias строка		Псевдоним текущего объекта. Он связан с полем nameAlias в ACI.
output_level строка	Варианты: отладка информация обычный ←	Влияет на вывод этого модуля ACI. `normal` означает стандартный вывод, включая `current` словарь `info` добавляет информативный вывод, включая `previous`, `proposed` и `sent` словари `debug` добавляет отладочный вывод, включая `filter_string`, `method`, `response`, `status` и `url` информацию Если значение не указано в задаче, используется значение переменной окружения `ACI_OUTPUT_LEVEL`.
output_path строка		Путь к файлу, который будет использоваться для вывода объектов конфигурации ACI в формате JSON, сгенерированных модулем. Если значение не указано в задаче, используется значение переменной окружения `ACI_OUTPUT_PATH`.
owner_key строка		Определённая пользователем строка для атрибута ownerKey объекта ACI. Этот атрибут представляет собой ключ, позволяющий клиентам владеть своими данными для корреляции сущностей. Если значение не указано в задаче, используется значение переменной окружения `ACI_OWNER_KEY`.
owner_tag строка		Определённая пользователем строка для атрибута ownerTag объекта ACI. Этот атрибут представляет собой метку, позволяющую клиентам добавлять свои собственные данные. Например, для указания того, кто создал этот объект. Если значение не указано в задаче, используется значение переменной окружения `ACI_OWNER_TAG`.
password строка		Пароль для аутентификации. Этот параметр взаимоисключает `private_key`. Если `private_key` также предоставлен, он будет использован вместо него. Если значение не указано в задаче, используется значение переменных окружения `ACI_PASSWORD` или `ANSIBLE_NET_PASSWORD`.
policy_group строка		Имя группы политик листа, которое нужно добавить/удалить. псевдонимы: name, policy_group_name
port целое число		Порт, который будет использоваться для подключения REST. Значение по умолчанию зависит от параметра `use_ssl`. Если значение не указано в задаче, используется значение переменной окружения `ACI_PORT`.
port_channel_policy строка		Выбор используемой политики port_channel в качестве части создаваемой группы политик листа. псевдонимы: port_channel_policy_name
port_security_policy строка		Выбор используемой политики port_security в качестве части создаваемой группы политик листа. псевдонимы: port_security_policy_name
priority_flow_control_policy строка		Выбор используемой политики priority_flow_control в качестве части создаваемой группы политик листа. псевдонимы: priority_flow_control_policy_name
private_key строка		Файл закрытого ключа в формате PEM или содержимое закрытого ключа, используемого для аутентификации на основе подписи. Это значение также влияет на значение по умолчанию `certificate_name`, которое используется. Этот параметр взаимоисключает `password`. Если `password` также предоставлен, он будет проигнорирован. Если значение не указано в задаче, используется значение переменной окружения `ACI_PRIVATE_KEY`. псевдонимы: cert_key
slow_drain_policy строка		Выбор используемой политики slow_drain в качестве части создаваемой группы политик листа. псевдонимы: slow_drain_policy_name
state строка	Варианты: отсутствует существует ← запрос	Используйте `present` или `absent` для добавления или удаления. Используйте `query` для перечисления объекта или нескольких объектов.
storm_control_interface_policy строка		Выбор используемой политики storm_control_interface в качестве части создаваемой группы политик листа. псевдонимы: storm_control_interface_policy_name
stp_interface_policy строка		Выбор используемой политики stp_interface в качестве части создаваемой группы политик листа. псевдонимы: stp_interface_policy_name
timeout целое число	По умолчанию: 30	Таймаут уровня сокета в секундах. Если значение не указано в задаче, используется значение переменной окружения `ACI_TIMEOUT`.
use_proxy булево	Варианты: нет да ←	Если `no`, прокси не будет использоваться, даже если он определён в переменной окружения на целевых хостах. Если значение не указано в задаче, используется значение переменной окружения `ACI_USE_PROXY`.

use_ssl boolean	Варианты: no yes ←	Если `no`, будет использовано HTTP-соединение вместо стандартного HTTPS-соединения. Если значение не указано в задаче, будет использовано значение переменной окружения `ACI_USE_SSL`.
username string	По умолчанию: "admin"	Имя пользователя для аутентификации. Если значение не указано в задаче, будет использовано значение переменных окружения `ACI_USERNAME` или `ANSIBLE_NET_USERNAME`. псевдонимы: user
validate_certs boolean	Варианты: no yes ←	Если `no`, сертификаты SSL не будут проверены. Это следует устанавливать в `no` только при работе с сайтами, контролируемыми лично, использующими самозаверяющие сертификаты. Если значение не указано в задаче, будет использовано значение переменной окружения `ACI_VALIDATE_CERTS`.

Примечания

Примечание

При использовании модуля, пожалуйста, выберите соответствующий тип агрегации каналов (lag_type). link для Port Channel (PC), node для Virtual Port Channel (VPC) и leaf для Leaf Access Port Policy Group.

См. также

Ссылка на руководство по модели управления информацией 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: whateverlinklevelpolicy
    cdp_policy: whatevercdppolicy
    lldp_policy: whateverlldppolicy
    port_channel_policy: whateverlacppolicy
    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: whateverlinklevelpolicy
    cdp_policy: whatevercdppolicy
    lldp_policy: whateverlldppolicy
    port_channel_policy: whateverlacppolicy
    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: whateverlinklevelpolicy
    cdp_policy: whatevercdppolicy
    lldp_policy: whateverlldppolicy
    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 список / элементы=строка	успех	Существующая конфигурация из APIC после завершения модуля Пример: [{'fvTenant': {'attributes': {'descr': 'Производственная среда', 'dn': 'uni/tn-production', 'name': 'production', 'nameAlias': '', 'ownerKey': '', 'ownerTag': ''}}}]
error словарь	ошибка	Информация об ошибке, возвращённая APIC Пример: {'code': '122', 'text': 'неизвестный класс управляемого объекта foo'}
filter_string строка	ошибка или отладка	Строка фильтра, используемая для запроса Пример: ?rsp-prop-include=config-only
method строка	ошибка или отладка	HTTP-метод, используемый для запроса к APIC Пример: POST
previous список / элементы=строка	информация	Исходная конфигурация из APIC до запуска модуля Пример: [{'fvTenant': {'attributes': {'descr': 'Производство', 'dn': 'uni/tn-production', 'name': 'production', 'nameAlias': '', 'ownerKey': '', 'ownerTag': ''}}}]
proposed словарь	информация	Собранная конфигурация из предоставленных пользователем параметров Пример: {'fvTenant': {'attributes': {'descr': 'Производственная среда', 'name': 'production'}}}
raw строка	ошибка разбора	Необработанный результат, возвращённый API REST APIC (xml или json) Пример: <?xml version="1.0" encoding="UTF-8"?><imdata totalCount="1"><error code="122" text="неизвестный класс управляемого объекта foo"/></imdata>
response строка	ошибка или отладка	HTTP-ответ от APIC Пример: OK (30 байт)
sent список / элементы=строка	информация	Фактическая/минимальная конфигурация, отправленная в APIC Пример: {'fvTenant': {'attributes': {'descr': 'Производственная среда'}}}
status целое число	ошибка или отладка	HTTP-статус от APIC Пример: 200
url строка	ошибка или отладка	HTTP-URL, используемый для запроса к APIC Пример: https://10.11.12.13/api/mo/uni/tn-production.json

Авторы

Bruno Calogero (@brunocalogero)

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/cisco/aci/aci_interface_policy_leaf_policy_group_module.html