cisco.ios.ios_lacp – Модуль ресурсов LACP

Примечание

Этот плагин входит в коллекцию cisco.ios (версия 1.3.0).

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

Для использования в плейбуке укажите: cisco.ios.ios_lacp

Новое в версии 1.0.0: из cisco.ios

Обзор
Параметры
Примечания
Примеры
Возвращаемые значения

Обзор

Этот модуль предоставляет декларативное управление глобальным LACP на устройствах Cisco IOS.

Примечание

Данный модуль имеет соответствующий плагин действий.

Параметры

Параметр			Варианты/Значения по умолчанию	Комментарии
config словарь				Предоставленные конфигурации.
	system словарь			Этот параметр задает параметры системы по умолчанию для LACP.
		priority целое число / обязательно		Приоритет LACP для системы. Обратитесь к документации производителя для допустимых значений.
running_config строка				Этот параметр используется только со значением parsed. Значение этого параметра должно быть выводом устройства IOS, полученным при выполнении команды show lacp sys-id. Состояние parsed считывает конфигурацию из параметра `running_config`, преобразует ее в структурированные данные Ansible в соответствии с параметрами модуля ресурсов, и возвращает значение в ключе parsed результата.
state строка			Варианты: merged ← replaced deleted rendered parsed gathered	Состояние, в котором должна остаться конфигурация Состояния rendered, gathered и parsed не производят никаких изменений на устройстве. Состояние rendered преобразует конфигурацию в параметре `config` в команды CLI, специфичные для платформы, которые будут возвращены в ключе rendered результата. Для состояния rendered не требуется активное подключение к удалённому хосту. Состояние gathered извлечет конфигурацию с устройства и преобразует ее в структурированные данные в формате, соответствующем параметрам модуля ресурсов, и возвращает значение в ключе gathered результата. Состояние parsed считывает конфигурацию из параметра `running_config`, преобразует её в формат JSON, соответствующий параметрам модуля ресурсов, и возвращает значение в ключе parsed результата. Значение параметра `running_config` должно иметь тот же формат, что и вывод команды show running-config \| include ip route\|ipv6 route, выполненной на устройстве. Для состояния parsed не требуется активное подключение к удалённому хосту.

Примечания

Примечание

Проверено на Cisco IOSv версии 15.2 на VIRL.

Примеры

# Using merged
#
# Before state:
# -------------
#
# vios#show lacp sys-id
# 32768, 5e00.0000.8000

- name: Merge provided configuration with device configuration
  cisco.ios.ios_lacp:
    config:
      system:
        priority: 123
    state: merged

# After state:
# ------------
#
# vios#show lacp sys-id
# 123, 5e00.0000.8000

# Using replaced
#
# Before state:
# -------------
#
# vios#show lacp sys-id
# 500, 5e00.0000.8000

- name: Replaces Global LACP configuration
  cisco.ios.ios_lacp:
    config:
      system:
        priority: 123
    state: replaced

# After state:
# ------------
#
# vios#show lacp sys-id
# 123, 5e00.0000.8000

# Using Deleted
#
# Before state:
# -------------
#
# vios#show lacp sys-id
# 500, 5e00.0000.8000

- name: Delete Global LACP attribute
  cisco.ios.ios_lacp:
    state: deleted

# After state:
# -------------
#
# vios#show lacp sys-id
# 32768, 5e00.0000.8000

# Using Gathered

# Before state:
# -------------
#
# vios#show lacp sys-id
# 123, 5e00.0000.8000

- name: Gather listed LACP with provided configurations
  cisco.ios.ios_lacp:
    config:
    state: gathered

# Module Execution Result:
# ------------------------
#
# "gathered": {
#         "system": {
#             "priority": 500
#         }
#     }

# After state:
# ------------
#
# vios#show lacp sys-id
# 123, 5e00.0000.8000

# Using Rendered

- name: Render the commands for provided  configuration
  cisco.ios.ios_lacp:
    config:
      system:
        priority: 123
    state: rendered

# Module Execution Result:
# ------------------------
#
# "rendered": [
#         "lacp system-priority 10"
#     ]

# Using Parsed

# File: parsed.cfg
# ----------------
#
# lacp system-priority 123

- name: Parse the commands for provided configuration
  cisco.ios.ios_lacp:
    running_config: "{{ lookup('file', 'parsed.cfg') }}"
    state: parsed

# Module Execution Result:
# ------------------------
#
# "parsed": {
#         "system": {
#             "priority": 123
#         }
#     }

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

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

Ключ	Возвращаемое значение	Описание
after список / элементы=строка	при изменении	Конфигурация в структурированных данных после завершения модуля. Пример: Возвращаемая конфигурация всегда будет иметь тот же формат, что и вышеуказанные параметры.
before список / элементы=строка	всегда	Конфигурация в структурированных данных перед вызовом модуля. Пример: Возвращаемая конфигурация всегда будет иметь тот же формат, что и вышеуказанные параметры.
commands список / элементы=строка	всегда	Набор команд, отправленных на удаленное устройство. Пример: ['lacp system-priority 10']

Авторы

Sumit Jaiswal (@justjais)

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/cisco/ios/ios_lacp_module.html