community.network.ce_interface – Управляет физическими атрибутами интерфейсов на коммутаторах HUAWEI CloudEngine.
Примечание
Этот плагин является частью коллекции community.network (версия 2.0.1).
Для его установки используйте: ansible-galaxy collection install community.network.
Для использования в плейбуке укажите: community.network.ce_interface.
Обзор
- Управляет физическими атрибутами интерфейсов на коммутаторах HUAWEI CloudEngine.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| admin_state строка |
| Указывает состояние управления интерфейсом. Значение является перечислением. up, Интерфейс находится в административном состоянии Включено. down, Интерфейс находится в административном состоянии Выключено. |
| description строка | Указывает описание интерфейса. Значение — строка от 1 до 242 символов, чувствительная к регистру, пробелы поддерживаются, но знаки вопроса (?) нет. | |
| interface строка | Полное имя интерфейса, например, 40GE1/0/10, Tunnel1. | |
| interface_type строка |
| Тип интерфейса, который необходимо настроить на устройстве. |
| l2sub логическое значение |
| Указывает, является ли интерфейс под-интерфейсом второго уровня. |
| mode строка |
| Управление состоянием интерфейса второго или третьего уровня. |
| state строка |
| Укажите желаемое состояние ресурса. |
Примечания
Примечание
- Этот модуль также используется для создания логических интерфейсов, таких как vlanif и loopbacks.
- Для работы этого модуля требуется, чтобы на управляемом удалённом устройстве была включена служба netconf.
- Рекомендуемое соединение —
netconf. - Этот модуль также работает с
localсоединениями для устаревших плейбуков.
Примеры
- name: Interface module test
hosts: cloudengine
connection: local
gather_facts: no
vars:
cli:
host: "{{ inventory_hostname }}"
port: "{{ ansible_ssh_port }}"
username: "{{ username }}"
password: "{{ password }}"
transport: cli
tasks:
- name: Ensure an interface is a Layer 3 port and that it has the proper description
community.network.ce_interface:
interface: 10GE1/0/22
description: 'Configured by Ansible'
mode: layer3
provider: '{{ cli }}'
- name: Admin down an interface
community.network.ce_interface:
interface: 10GE1/0/22
admin_state: down
provider: '{{ cli }}'
- name: Remove all tunnel interfaces
community.network.ce_interface:
interface_type: tunnel
state: absent
provider: '{{ cli }}'
- name: Remove all logical interfaces
community.network.ce_interface:
interface_type: '{{ item }}'
state: absent
provider: '{{ cli }}'
with_items:
- loopback
- eth-trunk
- nve
- name: Admin up all 10GE interfaces
community.network.ce_interface:
interface_type: 10GE
admin_state: up
provider: '{{ cli }}'
Возвращаемые значения
Общие значения, возвращаемые модулем, описаны здесь, следующие — поля, уникальные для данного модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| changed логическое значение | всегда | проверка, были ли внесены изменения на устройстве Пример: True |
| end_state словарь | всегда | k/v пары switchport после выполнения модуля Пример: {'admin_state': 'down', 'description': 'None', 'interface': '10GE1/0/10', 'mode': 'layer2'} |
| existing словарь | всегда | k/v пары существующего switchport Пример: {'admin_state': 'up', 'description': 'None', 'interface': '10GE1/0/10', 'mode': 'layer2'} |
| proposed словарь | всегда | k/v пары параметров, переданных в модуль Пример: {'admin_state': 'down', 'interface': '10GE1/0/10'} |
| updates список / элементы=строка | всегда | список команд, отправленных на устройство Пример: ['interface 10GE1/0/10', 'shutdown'] |
Авторы
- QijunPan (@QijunPan)
© 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/community/network/ce_interface_module.html